Skip to main content
A seção Contábil é onde você define regras opcionais para as Transações. Isso é feito por meio das Rotas Contábeis. Uma Rota Contábil é uma regra reutilizável para um tipo específico de Transação, como uma transferência Pix, uma compra com cartão ou uma cobrança de taxa. 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. Em seguida, a rota define lançamentos diretos de débito e crédito entre as duas. Quando a validação de rotas está habilitada, uma transação Pix que referencia a rota valida as Contas e aplica as regras configuradas. As Rotas Contábeis fornecem validação opcional de rotas. O Midaz só a aplica quando a configuração do Ledger accounting.validateRoutes está habilitada (padrão: false). Quando habilitada, as Transações devem referenciar rotas válidas e as Operações devem cumprir as regras configuradas. As rotas são mais fáceis de modelar quando você já sabe quais Contas representam clientes, treasury, fees, settlement, revenues e expenses.

Como as peças se encaixam


Como as contas, os tipos de conta e as 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 Source para Contas onde o valor se origina.Exemplo: uma Conta de cliente pode enviar fundos em um fluxo de pagamento.
Use Destination para Contas onde o valor chega.Exemplo: uma Conta de merchant pode receber fundos em um fluxo de pagamento.
Use Bidirectional quando a mesma classe de Conta pode enviar e receber.Exemplo: Contas checking podem transferir valor para outras Contas checking.
Uma Rota deve incluir uma Rota de Operação Source e uma Destination, ou ao menos uma Rota de Operação Bidirectional.

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 aplica uma regra presente quando a validação de rotas está habilitada. Use validação por Tipo de Conta para fluxos escaláveis. Use validação por alias para Contas operacionais fixas, como treasury, fee, settlement ou suspense.

Padrões comuns de Rota


Cliente para comerciante

Use Rotas Source e Destination separadas quando cada lado tem um papel diferente.

Transferência peer-to-peer

Use uma Rota Bidirectional quando o mesmo Tipo de Conta pode ser origem e destino.

Cobrança de taxas

Use uma Rota Destination com validação por alias quando as taxas precisam sempre cair em uma única Conta operacional.

Cenários contábeis


Não habilite a validação de Rotas nas configurações do Ledger até 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 na Console

Um guia passo a passo, centrado na Console, para construir seu modelo contábil — do plano de contas até um pagamento Pix funcionando, sem chamadas de API.

Gerenciar Rotas Contábeis

Configure Rotas de Transação com Rotas de Operação e cenários contábeis em um assistente unificado.