# 05. 👨‍💼 Representantes

**Consulta de representantes comerciais** Listagem de representantes e vendedores cadastrados no sistema. **Funcionalidades:**

* Listar representantes e vendedores
* Filtrar por data de última modificação
* Verificar status do cadastro (ativo/inativo)

## Lista representantes/vendedores

> \*\*Lista representantes/vendedores cadastrados\*\*\
> \
> Retorna lista paginada dos representantes/vendedores\
> cadastrados no sistema. Útil para consulta de equipe comercial\
> e seleção em formulários.\
> \
> \*\*Funcionalidades:\*\*\
> \- Listagem paginada (100 itens por página)\
> \- Filtro por data de última modificação\
> \- Ordenação por data de criação\
> \
> \*\*Filtros disponíveis:\*\*\
> \- ultima\_modificacao: Filtra representantes alterados após uma data específica\
> \
> \*\*Campos retornados:\*\*\
> \- uuid: Identificador único do representante\
> \- nome: Nome completo\
> \- email: Email para contato\
> \- ddd: Código de área do telefone\
> \- telefone: Número do telefone\
> \- ativo: Indica se o cadastro está ativo\
> \
> \*\*Uso típico:\*\*\
> \- Seleção de vendedores em pedidos\
> \- Relatórios de equipe comercial\
> \- Sincronização de dados\
> \- Listagens administrativas

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"tags":[{"name":"05. 👨‍💼 Representantes","description":"**Consulta de representantes comerciais**\nListagem de representantes e vendedores cadastrados no sistema.\n**Funcionalidades:**\n- Listar representantes e vendedores\n- Filtrar por data de última modificação\n- Verificar status do cadastro (ativo/inativo)"}],"servers":[{"url":"https://api.maino.com.br/api/v2","description":"Servidor de Produção"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"**Token JWT de Autenticação**\nToken obtido através do endpoint `/authentication`.\n**Formato:** `Bearer {seu_token_jwt}`\n**Exemplo:** `Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`\n**Validade:** Sem expiração"}}},"paths":{"/representantes":{"get":{"summary":"Lista representantes/vendedores","tags":["05. 👨‍💼 Representantes"],"description":"**Lista representantes/vendedores cadastrados**\n\nRetorna lista paginada dos representantes/vendedores\ncadastrados no sistema. Útil para consulta de equipe comercial\ne seleção em formulários.\n\n**Funcionalidades:**\n- Listagem paginada (100 itens por página)\n- Filtro por data de última modificação\n- Ordenação por data de criação\n\n**Filtros disponíveis:**\n- ultima_modificacao: Filtra representantes alterados após uma data específica\n\n**Campos retornados:**\n- uuid: Identificador único do representante\n- nome: Nome completo\n- email: Email para contato\n- ddd: Código de área do telefone\n- telefone: Número do telefone\n- ativo: Indica se o cadastro está ativo\n\n**Uso típico:**\n- Seleção de vendedores em pedidos\n- Relatórios de equipe comercial\n- Sincronização de dados\n- Listagens administrativas","parameters":[{"name":"ultima_modificacao","in":"query","schema":{"type":"string","format":"datetime"},"required":false,"description":"Filtrar apenas representantes modificados após esta data (formato ISO 8601)"},{"name":"page","in":"query","required":false,"description":"Número da página (padrão: 1, 100 itens por página)","schema":{"type":"integer"}}],"responses":{"200":{"description":"Lista de representantes","content":{"Lista com representantes ativos":{},"Lista vazia":{},"application/json":{"schema":{"type":"object","properties":{"representantes":{"type":"array","description":"Lista dos representantes cadastrados","items":{"type":"object","properties":{"uuid":{"type":"string","description":"Identificador único do representante"},"nome":{"type":"string","description":"Nome completo"},"email":{"type":"string","format":"email","nullable":true,"description":"Email para contato"},"ddd":{"type":"string","nullable":true,"description":"Código de área do telefone"},"telefone":{"type":"string","nullable":true,"description":"Número do telefone"},"ativo":{"type":"boolean","description":"Indica se o representante está ativo no sistema"}},"required":["uuid","nome","ativo"]}},"pagination":{"type":"object","description":"Informações de paginação","properties":{"total":{"type":"integer","description":"Total de representantes cadastrados"},"previous_page":{"type":"string","description":"URL da página anterior","nullable":true},"next_page":{"type":"string","description":"URL da próxima página","nullable":true}},"required":["total"]}},"required":["representantes","pagination"]}}}},"401":{"description":"Não autorizado","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Erro de autenticação"}}}}}}}}}}}
```