Produtos vendidos no período (planilha Excel)
**Sempre retorna um arquivo Excel (`.xlsx`)** com os produtos vendidos. As datas de período são **opcionais** (sem elas, não há filtro de data). A empresa é localizada por `cnpj`.
Authorization
userToken Token de usuário do ssOtica, obtido na tela de perfil do sistema. Enviado como
Authorization: Bearer {token}.
In: header
Query Parameters
CNPJ/CPF da empresa (com ou sem máscara). Informe cnpj e/ou empresa.
Início do período (YYYY-MM-DD).
Fim do período (YYYY-MM-DD).
Response Body
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
application/json
curl -X GET "https://example.com/integracoes/produtos/vendidos/periodo?cnpj=12345678000199""string"{ "error": "Unauthenticated."}Resumo de vendas por funcionário e produto (toda a rede) GET
Vendas agrupadas por data × produto × funcionário, varrendo todas as empresas ativas da rede (não recebe `cnpj`/`empresa`). Chaves em rótulos PT-BR. Suporta `saida=csv`.
Buscar produtos e estoque (integrações) GET
Mesma busca de estoque da rota legada, no **padrão da API Consultiva**: a empresa é identificada por `cnpj` e/ou `empresa` e os erros usam o envelope padrão (`{ "error", "error_info" }`). Resposta **paginada** — informe `page`. Suporta busca por referência/SKU/ID e os mesmos filtros avançados (grupo, grife, fornecedor, faixa de preço/estoque). Recomendada para novas integrações; a rota antiga continua disponível.