Fluxo de Baixa e Resolução de Pedidos
O processo de baixa e resolução de pedidos representa o ciclo completo de integração entre o Koncili e o ERP:
- O Koncili identifica os pedidos conciliados e disponibiliza via API.
- O ERP consulta os lançamentos/títulos disponíveis.
- O ERP processa e efetua a baixa do título e a contabilização.
- O ERP retorna ao Koncili a confirmação da ação realizada.
- O Koncili atualiza o status da conciliação.
Etapas do fluxo
- Consulta de lançamentos pendentes no Koncili
- O ERP consome o endpoint da API de Integração Financeira para obter títulos disponíveis para conciliação, que estão com CONCILIED
- Processamento no ERP
- O ERP interpreta os dados, aplica suas próprias regras contábeis e registra a baixa no sistema financeiro/fiscal.
- Confirmação do ERP ao Koncili
- Após registrar o evento, o ERP retorna ao Koncili informando o status final:
- RESOLVIDO (lançamento conciliado e baixado);
- Caso o evento não seja resolvido o ERP deve marca-lo como lido no endpoint
- Após registrar o evento, o ERP retorna ao Koncili informando o status final:
Disponibilidade das Conciliações
🕒 Quando uma conciliação está pronta para consulta?
As conciliações só ficam disponíveis via API após a finalização completa do processamento da PDR (Planilha de Repasse) no Koncili.
Isso garante que o ERP sempre receba dados validados, consistentes e confiáveis.
Quando todo o ciclo abaixo for concluído com sucesso:
- Recebimento da PDR (Planilha de Repasse) - o marketplace envia a planilha de repasse.
- Leitura completa - a PDR é carregada integralmente pelo Koncili.
- Validações - são aplicadas regras estruturais (formato, integridade) e financeiras (valores, consistência).
- Cruzamento de dados - os lançamentos são associados aos pedidos já existentes na plataforma.
- Geração das conciliações - o Koncili cria os registros conciliados com status inicial ABERTA assim que ela é analisada fica com status FINALIZADA
Somente quando uma conciliação fica com o status de Finalizada, os LANÇAMENTOS de repasses ficam disponíveis para consulta no endpoint da API de Integração Financeira.
Exemplos de Pedidos e Lançamentos
🛒 Exemplo de Pedido
Um pedido representa a transação original realizada em um marketplace. Abaixo um exemplo simplificado:
| Campo | Valor | Descrição |
|---|---|---|
| pedidoId | PED-12345 | Identificador único do pedido no Koncili |
| marketplace | Amazon | Canal de origem do pedido |
| data | 2025-09-10 | Data da venda |
| cliente | João da Silva | Comprador |
| valorTotal | 100.00 | Valor bruto da venda (sem descontos) |
💰 Exemplo de Lançamentos de um Pedido
Cada pedido pode ter lançamentos financeiros associados, que representam entradas e saídas.
| lançamentoId | tipo | valor | natureza | descrição |
|---|---|---|---|---|
| LAN-1 | SALE | 100.00 | Entrada | Valor bruto da venda repassado pelo marketplace |
| LAN-2 | COMISSION | -10.00 | Saída | Comissão cobrada pelo marketplace |
| LAN-3 | SHIP | 20.00 | Entrada | Frete pago pelo cliente e repassado ao seller |
📊 Resultado da Conciliação
| Campo | Valor | Descrição |
|---|---|---|
| pedidoId | PED-12345 | Identificador único do pedido no Koncili |
| marketplace | Amazon | Canal de origem do pedido |
| data | 2025-09-10 | Data da venda |
| cliente | João da Silva | Comprador |
| valorTotal | 100.00 | Valor bruto da venda (sem descontos) |
No exemplo acima, o pedido PED-12345 tem:
- Entradas: R$ 100,00 (SALE) + R$ 20,00 (SHIP)
- Saídas: R$ 10,00 (COMISSION)
➡️ Saldo líquido conciliado: R$ 110,00
As vezes podem ocorrer divergências nos valores do Repasse gerando lançamentos divergentes do esperado, isso acontece no caso de cancelamentos, devoluções, ou até mesmo no próprio valor da comissão, nestes casos enquanto os lançamentos não são analisados a conciliação não será Finalizada, garantindo assim que somente dados consistentes serão enviados ao ERP.