Skip to main content
O Módulo Midaz é mais fácil de configurar quando você segue a ordem de dependência que o produto espera. A maior parte da confusão dos usuários vem de tentar criar Contas, Rotas ou Transações antes que as peças estruturais já existam.

​
Ordem recomendada

1

Crie a sua Organização

Comece pelo proprietário legal e operacional do ambiente.Use o onboarding do Módulo Midaz se esta for a sua primeira configuração. Se a organização já existe e você quer adicionar outra, vá diretamente para Criando uma Organização.
2

Crie o seu primeiro Ledger

O Ledger é o espaço de trabalho que delimita saldos, Contas e Transações.Vá para Criando um novo Ledger.
3

Revise as configurações do Ledger

Decida se vai habilitar a validação de Rota Contábil antes que os usuários comecem a criar Transações. Essa configuração é opcional e o padrão é false.Você pode configurar essas definições ao criar o Ledger em Criando um novo Ledger, ou atualizá-las depois em Gerenciando Ledgers.
4

Crie Ativos

Ativos definem uma unidade de valor para a Organização, como BRL, USD ou um token personalizado. As Contas referenciam um Ativo quando você as cria.Vá para Criando um Ativo.
5

Crie Tipos de Conta

Defina Tipos de Conta quando as regras configuradas de Conta ou Rota precisarem dessas classificações.Vá para Criando um Tipo de Conta.
6

Crie Contas

As Contas mantêm saldos e são a origem ou o destino de transações.Vá para Criando uma Conta.
7

Adicione Portfólios, Segmentos, Titulares e Aliases quando necessário

Essas são estruturas de apoio persistidas. Configure-as quando o seu workflow precisar de contexto de titularidade, agrupamento, resolução de tarifas ou regras com escopo definido.Use:
8

Crie Rotas Contábeis

Rotas Contábeis definem regras opcionais de participante e de lançamento. O Midaz as aplica quando a validação de rota está ativada.Vá para Criando uma Rota Contábil.
9

Crie Transações

Crie Transações depois que a Organização tiver um Ativo e o Ledger tiver as Contas necessárias. Você precisa de uma Rota Contábil correspondente apenas quando a validação de rota está ativada.Vá para Criando uma Transação.
10

Configure o Fees Engine depois que a configuração principal estiver estável

O Fees Engine faz parte do Midaz, mas é opcional. Habilite-o em Configurações > Plugins e depois configure os pacotes de tarifas dele quando o modelo básico do ledger já estiver claro.Vá para Configurações do módulo Midaz.

​
Caminho rápido por objetivo

Preciso do meu primeiro ledger funcionando

Use o onboarding e depois crie pelo menos um Ativo e uma Conta.

Preciso modelar a estrutura de contas

Comece pelas configurações do Ledger, Tipos de Conta, Contas e Segmentos.

Preciso controlar como o dinheiro se move

Crie as contas primeiro e depois defina Rotas Contábeis e teste com uma transação.

Preciso estimar tarifas

Habilite o Fees Engine em Configurações > Plugins e depois configure-o quando a estrutura principal do ledger já estiver pronta.

​
Erros comuns de sequenciamento

Você deve vincular toda Conta a um Ativo. Se o Ativo ainda não existir, a criação da conta trava imediatamente.
Isso torna o campo de tipo obrigatório, mas a lista suspensa fica vazia. Crie os Tipos de Conta primeiro ou desabilite a validação até que eles estejam prontos.
Os usuários costumam tentar modelar rotas cedo demais. As regras de rota ficam mais fáceis de definir depois que as contas de tesouraria, cliente, tarifa e liquidação já existem.
A criação de transações depende de as contas serem pesquisáveis e estruturalmente válidas. Se os operadores não conseguem identificar rapidamente as contas de origem e destino, pare e corrija primeiro o modelo de contas.
Quando você documentar a configuração ou treinar a equipe de um cliente, ensine essa ordem primeiro. As páginas de CRUD ficam muito mais fáceis quando a cadeia de dependência é explícita.