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.