> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Gerenciando Rotas Contábeis

> Crie, edite e exclua Rotas Contábeis pelo Console para controlar como Transações e operações fluem.

Use o **Módulo Midaz** para gerenciar **Rotas Contábeis**, a configuração para roteamento de transações no Midaz. Um assistente guiado de 3 etapas conduz você pela definição da Rota Contábil, adição das Rotas de Operação e revisão da configuração final.

<Card title="Regras contábeis" icon="route" href="/pt/lerian-console/midaz-console/mc-accounting">
  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.
</Card>

Uma Rota Contábil define a lógica completa de roteamento de uma transação: os metadados no nível da transação (título e descrição), as Rotas de Operação que especificam quais contas participam e em qual direção, e os Cenários Contábeis que controlam como os lançamentos são registrados em diferentes tipos de transação.

Para detalhes técnicos sobre as entidades subjacentes, consulte a página [Entidades de Rotas Contábeis](/pt/midaz/transaction-routing-entities).

## Conceitos-chave

***

### Tipos de Rota de Operação

Cada Rota de Operação dentro de uma Rota Contábil recebe 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 para onde os fundos são enviados (lado de crédito)
* **Bidirecional** — Aplica-se a ambos os lados da transação, atuando como origem e destino

<Note>
  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.
</Note>

<Tip>
  Como uma rota bidirecional funciona como origem e destino, ela é considerada em **ambos** os lados quando uma transação é criada — 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.
</Tip>

### Tipos de Validação

Cada Rota de Operação valida contas usando 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 os lançamentos de débito e crédito são registrados para cada Rota de Operação. Você pode configurar lançamentos para três 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:
  * **Reserva de Valor** — Lançamentos registrados quando os fundos são reservados
  * **Confirmação da Reserva** — Lançamentos registrados quando a reserva é confirmada
  * **Cancelamento da Reserva** — Lançamentos registrados caso a reserva seja cancelada
* **Estorno** — Lançamentos registrados quando uma transação concluída é revertida

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.

<Tip>
  Quais lados de lançamento estão disponíveis depende do tipo da Rota de Operação e da fase do cenário. A regra geral é:

  * **Origem** — Lançamentos de débito em todas as fases. Lançamentos de crédito apenas na Reserva de Valor e no Cancelamento (não na Transação Direta nem na Confirmação).
  * **Destino** — Apenas lançamentos de crédito, exibidos na Transação Direta e na Confirmação. As fases de Reserva de Valor e Cancelamento não estão disponíveis.
  * **Bidirecional** — Lançamentos de débito e crédito em todas as fases, incluindo Estorno.
</Tip>

## Acessando a página de Rotas Contábeis

***

<Info>
  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**.
</Info>

<Warning>
  **Validação de Rotas Contábeis desabilitada** — Se você acessar esta página pela URL com **Validar Rotas** desligado, um banner informativo aparece no topo da tela. O Ledger ainda não processa as Rotas Contábeis cadastradas aqui; os lançamentos só seguem essas regras depois que você habilita a validação de **Rotas Contábeis** nas configurações do Ledger. Você ainda pode visualizar e editar as rotas, mas elas não têm efeito até que a validação seja habilitada.
</Warning>

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 Contábeis do Ledger atual como uma **lista de cards-acordeão**: cada Rota de Transação é um card recolhível que 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 as Rotas de Operação associadas, cada uma mostrando seu ID, título, código e Tipo de Operação. Os Tipos de Operação são destacados por cor — **origem** em vermelho, **destino** em verde e **bidirecional** em cinza. Uma rota sem Rotas de Operação é exibida como um card estático (não expansível).

### Ações disponíveis

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

<Columns cols={2}>
  <Card title="Criar uma Rota Contábil" icon="plus" horizontal href="/pt/lerian-console/midaz-console/creating-an-accounting-route">
    Definir uma nova Rota Contábil com Rotas de Operação e Cenários Contábeis.
  </Card>

  <Card title="Editar uma Rota Contábil" icon="pen" horizontal href="/pt/lerian-console/midaz-console/editing-an-accounting-route">
    Modificar uma Rota Contábil existente e suas Rotas de Operação.
  </Card>
</Columns>

## Casos de uso comuns

***

<AccordionGroup>
  <Accordion title="Transferências Pix">
    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.
  </Accordion>

  <Accordion title="Autorização de pagamento em duas etapas">
    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.
  </Accordion>

  <Accordion title="Operações de tesouraria com estorno">
    Crie uma Rota Contábil com uma Rota de Operação de origem usando validação por alias (`@treasury_main`) e uma Rota de Operação de destino para Tipos de Conta `department_budget`. Habilite os cenários de Transação Direta e Estorno para lidar com movimentações padrão e seus estornos.
  </Accordion>
</AccordionGroup>

## Boas práticas

***

<Steps>
  <Step title="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`).
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>
