Visão Geral
Visão Geral
Canais integrados, estrutura da resposta e restrições de período.
O que consolidamos
Nossa integração coleta dados de vendas de quatro canais distintos e os entrega à FullStore em um único JSON estruturado, permitindo que a plataforma calcule comissões e analise o desempenho de cada vendedor sem precisar acessar diretamente os bancos de dados internos.
PDV
Vendas realizadas no balcão da loja física, com itens e NF-e.
Trocas
Devoluções e trocas vinculadas à NF da venda original.
Omni
Pedido criado pelo vendedor na loja com entrega em domicílio ou retirada em outra unidade.
E-commerce
Pedidos do site processados pelo sistema Linx (SQL Server).
Sistemas envolvidos
| Sistema | Papel | Banco |
|---|---|---|
| ERP OSK (loja) | Fonte de dados — PDV, Trocas, Omni | MySQL |
| Linx | Fonte de dados — E-commerce e BI | SQL Server LX_ZERO_300 |
| FullStore | Consumidora da API | — |
Ação disponível
Disponibilizamos uma única ação: getVendas. Ela recebe CNPJ da loja e intervalo de datas, consulta os quatro canais em sequência e retorna tudo consolidado.
Estrutura da resposta
{
"success": true,
"message": "Vendas retornadas com sucesso!",
"data": {
"vendas": [ /* PDV — vendas com itens agrupados */ ],
"trocas": [ /* Trocas agrupadas por NF original */ ],
"omni": [ /* Pedidos omni com entrega/retirada */ ],
"vendas_ecommerce": [ /* Pedidos e-commerce vindos do SQL Server */ ],
"fallback": null /* Preenchido se o período exceder o limite */
}
}Restrições de período
LIMITE_DIAS_CONSULTA = 200). Se dataInicio ou dataFim estiver além desse limite, retornamos success: true com todos os arrays vazios e o objeto fallback preenchido com os parâmetros recebidos — sem erro de sistema.cnpjLoja é obrigatório e filtra todos os canais. Sem ele, a requisição falha na validação antes de qualquer consulta ao banco.