Pular para o conteúdo principal
As Rotas Contábeis são criadas por meio de um assistente guiado de 3 etapas que conduz você pela definição da Rota de Transação, configuração das Rotas de Operação com Cenários Contábeis e revisão da configuração final.

Etapa 1: Informações básicas


1
Na página de Rotas Contábeis, clique em Nova Rota.
2
O assistente de criação abre na Etapa 1 — Informações básicas.
3
Preencha as informações básicas:
title
string
obrigatório
Título — Um nome descritivo para esta Rota de Transação (máx. 50 caracteres).
description
string
Descrição — Uma descrição opcional da finalidade da rota (máx. 250 caracteres).
4
Clique em Próximo para prosseguir à Etapa 2.

Etapa 2: Rotas de Operação


Nesta etapa, você adiciona e configura as Rotas de Operação que definem como as contas são validadas e como os lançamentos contábeis são registrados.
1
Clique em Adicionar Rota de Operação para criar seu primeiro card de Rota de Operação.
2
Configure a Rota de Operação:
description
string
Descrição — Uma descrição da finalidade desta Rota de Operação.
operationType
enum
obrigatório
Tipo de Operação — A direção contábil para esta rota:
  • Origem — Identifica contas de onde os fundos se originam (lado de débito)
  • Destino — Identifica contas para onde os fundos são enviados (lado de crédito)
  • Bidirecional — Aplica-se a ambos os lados da transação
O Tipo de Operação não pode ser alterado após a criação.
account.ruleType
enum
Tipo de Validação — Como as contas são validadas:
  • Tipo de Conta — Selecione um ou mais Tipos de Conta no dropdown
  • @Alias — Insira um alias específico de conta (ex.: @treasury_main)
Se deixado vazio, nenhuma validação de conta é aplicada — qualquer conta pode ser utilizada nesta Rota de Operação.
account.validIf
string | array
Tipo de Conta ou Alias — Depende do Tipo de Validação selecionado:
  • Se Tipo de Conta: Selecione um ou mais Tipos de Conta
  • Se Alias: Insira o alias da conta para validação
Se deixado vazio, nenhuma validação de conta é aplicada — qualquer conta pode ser utilizada nesta Rota de Operação.
3
(Opcional) Configure os Cenários Contábeis para definir como os lançamentos são registrados. Ative os cenários que precisar:
Transação padrão de uma etapa. Defina o Código da Conta e a Descrição para:
  • Débito — O código da conta debitada na execução
  • Crédito — O código da conta creditada na execução
Para Transações Diretas, quais lados aparecem depende do Tipo de Operação. Rotas de Operação de Origem exibem apenas débito, de Destino exibem apenas crédito, e Bidirecionais exibem ambos. Outros cenários podem diferir — consulte a aba Transação em Duas Etapas para mais detalhes.
4
(Opcional) Clique em Adicionar Rota de Operação novamente para adicionar mais Rotas de Operação a esta Rota Contábil.
Você deve adicionar pelo menos uma Rota de Operação de origem e uma de destino, ou pelo menos uma Rota de Operação bidirecional. O assistente não prosseguirá sem uma configuração de rota válida.
5
Clique em Próximo para prosseguir à Etapa 3.

Etapa 3: Revisão


1
Revise a configuração completa:
  • Título e descrição da Rota de Transação
  • Cada Rota de Operação com seu tipo, regras de validação e lançamentos contábeis
  • Cenários Contábeis com lançamentos de débito e crédito por tipo de transação
2
Se algo precisar ser ajustado, clique em Anterior para voltar.
3
Clique em Criar Rota de Transação para criar a Rota Contábil.

Exemplo rápido


Rota de Transação
CampoValor
TítuloPix Transfer Route
DescriçãoHandles Pix instant transfers between checking accounts
Rota de Operação 1 — Bidirecional
CampoValor
DescriçãoChecking account validation for Pix
Tipo de OperaçãoBidirecional
Tipo de ValidaçãoTipo de Conta
Tipos de Contachecking
Cenário de Transação Direta
LadoCódigo da ContaDescrição
Débito1.1.1.001Customer checking — outbound
Crédito1.1.1.002Customer checking — inbound
Transação em Duas Etapas — Reserva de Valor
LadoCódigo da ContaDescrição
Débito1.1.1.001Customer checking — reserve
Crédito2.1.1.001Pending settlement — hold
Transação em Duas Etapas — Confirmação da Reserva
LadoCódigo da ContaDescrição
Débito2.1.1.001Pending settlement — release
Crédito1.1.1.002Customer checking — settled