Pular para o conteúdo principal
Use o Módulo Midaz para gerenciar Rotas de Operação, que definem os Tipos de Conta ou Contas específicas usadas em um componente de transação, junto com a direção contábil (origem ou destino) e anotações. Rotas de Operação atuam como uma camada de validação entre a entrada do usuário e o design do Ledger, garantindo que cada operação siga as regras de Conta e lógica de negócio exigidas antes de ser processada.

O que são Rotas de Operação?


Rotas de Operação servem como blocos de construção para Rotas de Transação. Elas especificam:
  • Regras de validação de Conta - Quais Contas ou Tipos de Conta podem participar de uma operação
  • Direção da operação - Se a rota se aplica ao lado de origem (débito) ou destino (crédito)
  • Tipos de regra - Validação por Alias de Conta específico ou por categorias de Tipo de Conta
Quando combinadas com Rotas de Transação, Rotas de Operação criam uma estrutura completa de validação que garante que transações financeiras cumpram a estrutura contábil da sua organização. Para detalhes técnicos, consulte a seção Rotas de Operação na página Operações.

Conceitos principais


  • Operações de Origem - Definem regras de validação para Contas de onde os fundos originam (lado do débito). Garantem que apenas Contas autorizadas possam enviar fundos.
  • Operações de Destino - Definem regras de validação para Contas para onde os fundos são enviados (lado do crédito). Garantem que fundos só cheguem a Contas de destino válidas.
  • Validação por Alias - Valida contra um Alias de Conta específico (ex: @treasury_main). Use quando precisar mirar uma Conta exata.
  • Validação por Tipo de Conta - Valida contra um ou mais Tipos de Conta (ex: savings, checking). Use quando qualquer Conta de determinado tipo é válida.

Acessando a página de Rotas de Operação


Para abrir a página de Rotas de Operação, selecione a opção Rotas de Operação na seção Contábil do menu lateral esquerdo. A página de Rotas de Operação exibe uma tabela listando todas as Rotas de Operação que você criou para o Ledger atual, incluindo:
  • Nome - O título da Rota de Operação
  • Descrição - Breve descrição do propósito da rota
  • Tipo de Operação - Se é uma rota origem ou destino
  • Tipo de Regra - Se a validação usa alias ou tipo_de_conta
  • Datas de Criação/Atualização - Timestamps para rastreamento de mudanças

Ações disponíveis

Na página de Rotas de Operação, você pode:

Casos de uso comuns


Crie Rotas de Operação separadas para origens e destinos de Contas de tesouraria para garantir que fundos de tesouraria sejam adequadamente rastreados e validados.Exemplo:
  • Rota de origem com alias @treasury_main para saques
  • Rota de destino com alias @treasury_main para depósitos
Use validação por Tipo de Conta para permitir operações em todas as Contas de clientes de tipos específicos sem criar rotas individuais por Conta.Exemplo:
  • Rota de destino com Tipos de Conta checking, savings para depósitos de clientes
  • Rota de origem com Tipos de Conta checking, savings para saques de clientes
Defina Rotas de Operação que validam Contas específicas de departamentos para manter limites contábeis internos adequados.Exemplo:
  • Rota de origem com Tipo de Conta department_operations
  • Rota de destino com Tipo de Conta department_cost_center

Melhores práticas


1

Use nomes descritivos

Nomeie Rotas de Operação de forma clara para indicar seu propósito (ex: Destino Depósito Cliente em vez de Rota 1).
2

Documente suas regras

Use o campo de descrição para explicar quando e por que esta Rota de Operação deve ser usada.
3

Escolha o tipo de regra certo

  • Use Alias quando precisar de controle estrito sobre Contas específicas
  • Use Tipo de Conta quando quiser flexibilidade em múltiplas Contas
4

Teste antes da produção

Verifique se as Rotas de Operação funcionam corretamente com Rotas de Transação antes de usá-las em transações de produção.
Rotas de Operação só entram em vigor quando associadas a uma Rota de Transação. Certifique-se de vincular suas Rotas de Operação a Rotas de Transação para habilitar a validação. Veja Gerenciando Rotas de Transação para mais informações.