Fluxo de conciliação

Nesta página, você encontrará os detalhes sobre os fluxos de conciliação na API do Koncili.

---

Criação de conciliação

• Nova conciliação: Enviada pelo integrador
• API Koncili: Valida, processa e encaminha os dados
• Koncili: Armazena as informações e prepara os dados para o envio de lançamentos

Validações

A requisição enviada via POST /reconciliation passa por diversas etapas de validação antes de ser aceita:

1. Validação do canal (account):
   A conta informada no payload deve estar habilitada para importações via API. Caso contrário, a requisição será rejeitada

2. Validação do período da conciliação:
   O campo periodInitDate deve ser anterior ao periodEndDate

3. Validação de conflitos de período:

   • Verifica se já existe uma conciliação ativa para o canal informado
   • Verifica se o novo período enviado entra em conflito com qualquer período já cadastrado, seja por sobreposição total ou parcial

Envio de lançamentos

Validações

A requisição enviada via POST /reconciliation/release passa por diversas etapas de validação antes de ser aceita:

1. Validação do canal (account):
   A conta informada no payload deve estar habilitada para importações via API. Caso contrário, a requisição será rejeitada

2. Validação do tipo de lançamento:
   O campo releaseType deve ser IN_CASH para lançamentos de pedidos

3. Validação dos lançamentos:
   Os tipos de lançamentos aceitos são: COMISSION, SHIP, RETURN_COMISSION, RETURN_SHIP e SALE. Além disso, são validados os sinais dos valores de cada um dos lançamentos

4. Valida conflito no lançamentos: Os lançamentos não podem existir, caso exista retornará um erro

Informação

O processo de conciliação acontece de forma assíncrona. Após o envio dos lançamentos, o Koncili processa as informações e notifica o integrador quando a conciliação foi concluída, a notificação é via URL cadastrada (para mais informações sobre as notificações acesse: Notificações)