Skip to main content
O Módulo Midaz fica mais fácil de configurar quando você segue a ordem de dependências 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 existam.

​
Ordem recomendada

1

Crie sua Organização

Comece pelo dono legal e operacional do ambiente.Use o Onboarding do Módulo Midaz se esta for sua primeira configuração. Se a Organização já existir e você quiser adicionar outra, vá direto para Criar uma Organização.
2

Crie seu primeiro Ledger

O Ledger é o workspace onde saldos, Contas e Transações têm escopo.Vá para Criar um novo Ledger.
3

Revise as configurações do Ledger

Decida se habilitará a validação de Rotas Contábeis antes que os usuários comecem a criar Transações. Essa configuração é opcional e tem padrão false.Você pode definir essas configurações ao criar o Ledger em Criar um novo Ledger, ou atualizá-las depois em Gerenciar 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 ao serem criadas.Vá para Criar um Ativo.
5

Crie Tipos de Conta

Defina Tipos de Conta quando regras configuradas de Contas ou Rotas precisarem dessas classificações.Vá para Criar um Tipo de Conta.
6

Crie Contas

Contas mantêm saldos e são a origem ou o destino das Transações.Vá para Criar uma Conta.
7

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

São estruturas de apoio persistentes. Configure-as quando o fluxo precisar de contexto de titularidade, agrupamento, cálculo de taxas ou regras com escopo.Use:
8

Crie Rotas Contábeis

As Rotas Contábeis definem regras opcionais de participantes e contabilização. O Midaz as aplica quando a validação de rotas está habilitada.Vá para Criar 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. Uma Rota Contábil compatível só é necessária quando a validação de rotas está habilitada.Vá para Criar uma Transação.
10

Configure o Fees Engine após a configuração central estar estável

O Fees Engine é integrado ao Midaz, mas é opcional. Habilite-o em Configurações > Plugins e configure seus pacotes de taxas somente depois que o modelo base 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 crie pelo menos um Ativo e uma Conta.

Preciso modelar a estrutura de Contas

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

Preciso controlar como o dinheiro se movimenta

Crie primeiro as Contas, depois defina Rotas Contábeis e teste com uma Transação.

Preciso estimar taxas

Habilite o Fees Engine em Configurações > Plugins e configure-o somente depois que a estrutura central do Ledger já estiver no lugar.

​
Erros comuns de sequenciamento

Você precisa 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 o dropdown fica vazio. Crie os Tipos de Conta primeiro ou desative a validação até que estejam prontos.
Os usuários costumam tentar modelar Rotas cedo demais. Na prática, as regras de Rota são mais fáceis de definir depois que as Contas de treasury, customer, fee e settlement já existem.
A criação de Transações depende das Contas serem pesquisáveis e estruturalmente válidas. Se os operadores não conseguem identificar rapidamente a origem e o destino, pare e corrija primeiro o modelo de Contas.
Quando você documenta a configuração ou treina um time cliente, ensine esta ordem primeiro. As páginas CRUD ficam muito mais fáceis quando a cadeia de dependências está explícita.