Visão Geral

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 de 200 dias no passado Consultamos no máximo 200 dias retroativos (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.

CNPJ obrigatório O cnpjLoja é obrigatório e filtra todos os canais. Sem ele, a requisição falha na validação antes de qualquer consulta ao banco.