Vendas detalhadas por período

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.

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.

empresa?string

Chave de contrato da empresa. 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).

tipo_periodo?string

Campo de data usado no filtro.

page?integer

Página.

perPage?integer

Itens por página, 1–100 (nos endpoints de período, ativa a paginação).

callback?string

Se presente, a resposta é retornada como JSONP.

Response Body

`application/json`

curl -X GET "https://example.com/integracoes/vendas/periodo?inicio_periodo=2026-06-01&fim_periodo=2026-06-30"

[  {    "id": 98765,    "data": "2026-06-01",    "hora": "14:32:10",    "status": "FINALIZADA",    "numero": 4521,    "valor_bruto": 1500,    "acrescimo": 0,    "desconto": 100,    "credito_troca": 0,    "valor_liquido": 1400,    "itens": [      {}    ],    "formas_pagamento": [      {}    ],    "cliente": {},    "funcionario": {},    "origensCliente": [      "string"    ]  }]

{  "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

Authorization

Query Parameters

Response Body

200application/json

400application/json

401application/json

Example data_invalida

Example periodo_invalido

Example empresa

Example parametro

`application/json`

`application/json`

`application/json`