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

get

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

Autorizações

Bearer

AuthorizationstringObrigatório

Token JWT de Autenticação Token obtido através do endpoint /authentication. Formato: Bearer {seu_token_jwt} Exemplo: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... Validade: Sem expiração

Parâmetros de consulta

ultima_modificacaostring · datetimeOpcional

Filtrar apenas representantes modificados após esta data (formato ISO 8601)

Example: 2023-01-01T00:00:00Z

pageintegerOpcional

Número da página (padrão: 1, 100 itens por página)

Example: 1

Respostas

200

Lista de representantes

Lista com representantes ativosLista vaziaapplication/json

401

Não autorizado

application/json

get

/representantes

HTTPcURLJavaScriptPython

GET /api/v2/representantes HTTP/1.1
Host: api.maino.com.br
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "value": {
    "representantes": [
      {
        "uuid": "550e8400-e29b-41d4-a716-446655440001",
        "nome": "João Silva Santos",
        "email": "[email protected]",
        "ddd": "11",
        "telefone": "999887766",
        "ativo": true
      },
      {
        "uuid": "550e8400-e29b-41d4-a716-446655440002",
        "nome": "Maria Oliveira Costa",
        "email": "[email protected]",
        "ddd": "21",
        "telefone": "988776655",
        "ativo": true
      },
      {
        "uuid": "550e8400-e29b-41d4-a716-446655440003",
        "nome": "Carlos Pereira Lima",
        "email": "[email protected]",
        "ddd": "31",
        "telefone": "977665544",
        "ativo": false
      }
    ],
    "pagination": {
      "total": 3,
      "previous_page": null,
      "next_page": null
    }
  }
}