ReferênciaVendas

Resumo de vendedores (vendas + OS)

Consolida, por funcionário, vendas e ordens de serviço do período. A empresa é localizada apenas por `cnpj` (não aceita chave `empresa`). Suporta `saida=csv`.

GET
/integracoes/dashboard/resumo-vendedores

Authorization

userToken
AuthorizationBearer <token>

Token de usuário do ssOtica, obtido na tela de perfil do sistema. Enviado como Authorization: Bearer {token}.

In: header

Query Parameters

cnpj*string

CNPJ/CPF da empresa (com ou sem máscara). Informe cnpj e/ou empresa.

inicio_periodo*string

Início do período (YYYY-MM-DD).

fim_periodo*string

Fim do período (YYYY-MM-DD).

saida?string

Formato de saída.

callback?string

Se presente, a resposta é retornada como JSONP.

Response Body

application/json

application/json

curl -X GET "https://example.com/integracoes/dashboard/resumo-vendedores?cnpj=12345678000199&inicio_periodo=2026-06-01&fim_periodo=2026-06-30"
[  {    "id": 123,    "nome": "MARIA SILVA",    "numVendas": 12,    "totalVendas": 8500,    "numOS": 3,    "totalOS": 1200,    "numTotal": 15,    "totalGeral": 9700,    "tiqueteMedio": 646.67  }]

{  "error": "DATA_INVALIDA",  "error_info": "O campo \"inicio_periodo\" contém uma data inválida. Utilize o formato AAAA-MM-DD (ex.: 2026-06-30)."}

{  "error": "Unauthenticated."}

Vendas detalhadas por período GET

Vendas detalhadas (itens, formas de pagamento, cliente, funcionário, OS vinculada). **Paginação opt-in:** envie `page` e/ou `perPage` para receber o envelope paginado; sem eles, a resposta é a lista completa. Intervalo máximo de 180 dias.

Resumo diário de vendedores GET

Como o resumo de vendedores, porém com detalhamento diário aninhado por funcionário. Suporta `saida=csv` e `saida=xls`. Datas de `detalhamentoDiario[].data` saem em `DD/MM/YYYY`.