Skip to main content
Use o Módulo Midaz para gerenciar Rotas Contábeis, a configuração para roteamento de transações no Midaz. Um assistente guiado conduz você por três etapas: defina a Rota de Transação, adicione as Rotas de Operação e revise a configuração. Uma Rota Contábil define a lógica completa de roteamento de uma transação. Ela tem três partes:
  • Os metadados no nível da transação — o título e a descrição.
  • As Rotas de Operação — definem quais contas participam e em qual direção.
  • Os Cenários Contábeis — controlam como o ledger registra os lançamentos para cada tipo de transação.

Regras contábeis

Comece por aqui se precisar decidir entre usar cenários de Origem, Destino, Bidirecional, validação por Tipo de Conta, validação por alias, Direta, Duas Etapas ou Estorno.
Para detalhes técnicos sobre as entidades subjacentes, consulte a página Entidades de Rotas Contábeis.

​
Conceitos-chave

​
Tipos de Rota de Operação

Cada Rota de Operação dentro de uma Rota Contábil tem um dos três tipos:
  • Origem — Define regras de validação para contas de onde os fundos se originam (lado de débito)
  • Destino — Define regras de validação para contas que recebem os fundos (lado de crédito)
  • Bidirecional — Aplica-se a ambos os lados da transação como origem e destino
Uma Rota Contábil válida requer pelo menos uma Rota de Operação de origem e uma de destino, ou pelo menos uma Rota de Operação bidirecional.
Uma rota bidirecional funciona como origem e destino. O Midaz a considera em ambos os lados quando você cria uma transação. Ela aparece tanto na lista de rotas de origem quanto na de destino, de modo que uma única rota pode cobrir as duas pontas de um fluxo.

​
Tipos de Validação

Cada Rota de Operação valida contas por um dos dois métodos:
  • Tipo de Conta — Valida contra uma ou mais categorias de Tipo de Conta (ex.: checking, savings). Use quando qualquer conta de um determinado tipo for válida.
  • @Alias — Valida contra um alias específico de conta (ex.: @treasury_main). Use quando precisar direcionar uma conta exata.

​
Cenários Contábeis

Os Cenários Contábeis definem como o ledger registra os lançamentos de débito e crédito para cada Rota de Operação. Você pode configurar lançamentos para cinco tipos de transação:
  • Transação Direta — Transação padrão de uma etapa. Defina os códigos de conta e descrições de débito e crédito para liquidação imediata.
  • Transação em Duas Etapas — Transações que passam por um ciclo de reserva e confirmação. Configure lançamentos para:
    • Hold (Reserva de Valor) — Lançamentos registrados quando o ledger reserva os fundos
    • Commit (Confirmação da Reserva) — Lançamentos registrados quando você confirma a reserva
    • Cancel (Cancelamento da Reserva) — Lançamentos registrados quando você cancela a reserva
  • Estorno — Lançamentos registrados quando você reverte uma transação concluída
  • Overdraft — Lançamentos registrados quando um débito excede os fundos disponíveis da conta e utiliza uma linha de cheque especial. Disponível para as Rotas de Operação Origem e Bidirecional, e exige os dois lançamentos, de débito e de crédito, em cada tipo de rota compatível. Quando você o ativa, o Midaz também ativa o cenário Direta.
  • Block/Unblock — Lançamentos registrados quando você retém e libera fundos no saldo da conta. A aba do cenário tem o rótulo Block. Disponível para todos os tipos de Rota de Operação.
Cada lançamento de cenário inclui um Código da Conta e uma Descrição para ambos os lados de débito e crédito.
Os lados de lançamento disponíveis dependem do tipo da Rota de Operação e da fase do cenário. A regra geral é:
  • Origem — Lançamentos de débito em Direct, Hold, Commit e Cancel. Lançamentos de crédito apenas em Hold e Cancel.
  • Destino — Apenas lançamentos de crédito, em Direct e Commit. Hold e Cancel não estão disponíveis.
  • Bidirecional — Lançamentos de débito e crédito em todas as fases, incluindo Estorno.
  • Block/Unblock — Disponível para todos os tipos de rota. Retém e libera fundos no saldo da conta.

​
Acessando a página de Rotas Contábeis

O menu de Rotas Contábeis só é visível quando a configuração Validar Rotas está habilitada para o Ledger atual. Para habilitá-la, abra os detalhes do Ledger, vá até a aba Configurações e ative o interruptor Validar Rotas.
Validação de Rotas Contábeis desabilitada — Se você acessar esta página pela URL com Validar Rotas desligado, um banner aparece no topo da tela. O Ledger ainda não processa as Rotas Contábeis cadastradas aqui. Os lançamentos seguem essas regras apenas depois que você habilita Validar Rotas nas configurações do Ledger. Você ainda pode visualizar e editar as rotas, mas elas não têm efeito até que você habilite a validação.
Para abrir a página de Rotas Contábeis, selecione Rotas Contábeis na seção Contábil do menu lateral esquerdo. A página de Rotas Contábeis exibe suas rotas do Ledger atual como uma lista de cards-acordeão. Cada Rota de Transação é um card recolhível. O card mostra seu título, o ID da Rota de Transação e um selo com a contagem de operações. Expanda um card para visualizar suas Rotas de Operação. Cada uma mostra seu ID, título, código e Tipo de Operação. O Console destaca os Tipos de Operação por cor: origem em vermelho, destino em verde e bidirecional em cinza. Uma rota sem Rotas de Operação aparece como um card estático (não expansível).

​
Ações disponíveis

Na página de Rotas Contábeis, você pode:

Criar uma Rota Contábil

Definir uma nova Rota Contábil com Rotas de Operação e Cenários Contábeis.

Editar uma Rota Contábil

Modificar uma Rota Contábil existente e suas Rotas de Operação.

​
Casos de uso comuns

Crie uma Rota Contábil com uma Rota de Operação bidirecional que valide Tipos de Conta checking e savings. Habilite cenários de Transação Direta com os códigos apropriados do plano de contas para lançamentos de liquidação Pix.
Crie uma Rota Contábil com Rotas de Operação separadas de origem e destino. Habilite cenários de Transação em Duas Etapas para registrar os lançamentos de Reserva de Valor, Confirmação da Reserva e Cancelamento da Reserva opcional de forma independente.
Crie uma Rota Contábil com uma Rota de Operação bidirecional que use validação por alias (@treasury_main). Habilite os cenários de Transação Direta e Estorno para lidar com movimentações padrão e seus estornos. Os lançamentos de estorno exigem uma Rota de Operação bidirecional.

​
Boas práticas

1

Use títulos descritivos

Nomeie suas Rotas Contábeis de forma clara para indicar o tipo de transação que elas processam (ex.: Pix Transfer Route em vez de Route 1).
2

Escolha o Tipo de Operação correto

Use Bidirecional quando as mesmas regras de validação se aplicarem a ambos os lados. Use Rotas de Operação separadas de Origem e Destino quando cada lado tiver requisitos diferentes de conta.
3

Configure os Cenários Contábeis cedo

Defina os lançamentos do plano de contas durante a criação da rota. Isso garante que as transações processadas pela rota produzam registros contábeis corretos desde o início.
4

Revise antes de confirmar

O assistente inclui uma etapa de Revisão. Use-a para verificar todas as Rotas de Operação, regras de validação e lançamentos contábeis antes de criar a rota.