Skip to main content
A seção Contabilidade é onde você define regras opcionais para transações. Você faz isso por meio de Rotas Contábeis. Uma Rota Contábil é uma regra reutilizável para um tipo de transação, como uma transferência via Pix, uma compra no cartão ou uma cobrança de tarifa. Cada rota responde a três perguntas:
  • Quais contas podem atuar no lado de origem?
  • Quais contas podem atuar no lado de destino?
  • Quais lançamentos de débito e crédito a rota registra quando a transação é executada?
Exemplo. Uma rota Pix transfer pode exigir uma conta customer no lado de origem e uma conta merchant no lado de destino. A rota então define lançamentos diretos de débito e crédito entre elas. Quando você habilita a validação de rota, uma transação Pix que referencia a rota valida as contas e aplica as regras configuradas. As Rotas Contábeis oferecem validação de rota opcional. O Midaz as impõe apenas quando você habilita a configuração de Ledger accounting.validateRoutes (padrão false). Quando habilitada, as transações devem referenciar rotas válidas e as operações devem corresponder às regras configuradas. As rotas ficam mais fáceis de modelar quando você já sabe quais contas representam clientes, tesouraria, tarifas, liquidação, receita e despesas.

Como as peças se encaixam


Como contas, tipos de conta e rotas contábeis se encaixam para que uma solicitação de transação seja validada e registrada como lançamentos de débito e crédito

Escolhendo o tipo de operação


Use Origem para contas onde o valor se origina.Exemplo: uma conta de cliente pode enviar fundos em um fluxo de pagamento.
Use Destino para contas onde o valor chega.Exemplo: uma conta de estabelecimento pode receber fundos em um fluxo de pagamento.
Use Bidirecional quando a mesma classe de conta pode enviar e receber.Exemplo: contas correntes podem transferir valor para outras contas correntes.
Uma rota deve incluir uma rota de operação de Origem e uma de Destino, ou pelo menos uma rota de operação Bidirecional.

Escolhendo a regra de validação


Uma Rota de Operação pode incluir opcionalmente uma regra de conta (Tipos de Conta registrados ou um @Alias). O Midaz impõe uma regra presente quando você habilita a validação de rota. Use a validação por Tipo de Conta para fluxos escaláveis. Use a validação por alias para contas operacionais fixas, como contas de tesouraria, tarifa, liquidação ou suspense.

Padrões comuns de rota


Cliente para estabelecimento

Use rotas de Origem e Destino separadas quando cada lado tiver um papel diferente.

Transferência ponto a ponto

Use uma rota Bidirecional quando o mesmo tipo de conta puder ser origem e destino.

Coleta de tarifas

Use uma rota de Destino com validação por alias quando as tarifas deverem sempre chegar a uma única conta operacional.

Cenários contábeis


Não habilite a validação de rota nas configurações do Ledger antes que as rotas necessárias existam. Se você a habilitar sem rotas correspondentes, as transações falham na validação.

Páginas disponíveis


Configurando a contabilidade no Console

Um guia passo a passo, focado no Console, para construir o seu modelo contábil, do plano de contas a um pagamento Pix funcional. Nenhuma chamada de API é necessária.

Gerenciar Rotas Contábeis

Configure rotas contábeis com regras de operação e cenários contábeis em um assistente unificado.