> ## 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.

# Caminho de configuração

> Siga a ordem de configuração recomendada para o Módulo Midaz, para que cada tela do Console tenha a Organização, o Ledger, os Ativos e as Contas dos quais depende.

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](https://docs.lerian.studio/pt/products/midaz/console/midaz-console-onboarding.md) 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](https://docs.lerian.studio/pt/products/midaz/console/creating-an-organization.md).

**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](https://docs.lerian.studio/pt/products/midaz/console/creating-a-new-ledger.md).

**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](https://docs.lerian.studio/pt/products/midaz/console/creating-a-new-ledger.md#ledger-settings), ou atualizá-las depois em [Gerenciando Ledgers](https://docs.lerian.studio/pt/products/midaz/console/managing-ledgers-via-console#ledger-settings).

**4. Crie Ativos**

Ativos definem uma unidade de valor para o Ledger, como `BRL`, `USD` ou um token personalizado. As Contas referenciam um Ativo quando você as cria.

Vá para [Criando um Ativo](https://docs.lerian.studio/pt/products/midaz/console/creating-an-asset.md).

**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](https://docs.lerian.studio/pt/products/midaz/console/creating-an-account-type.md).

**6. Crie Contas**

As Contas mantêm saldos e são a origem ou o destino de transações.

Vá para [Criando uma Conta](https://docs.lerian.studio/pt/products/midaz/console/creating-an-account.md).

**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:

* [Criando um Portfólio](https://docs.lerian.studio/pt/products/midaz/console/creating-a-portfolio.md)
* [Criando um Segmento](https://docs.lerian.studio/pt/products/midaz/console/creating-a-segment.md)
* [Criando um Titular](https://docs.lerian.studio/pt/products/midaz/console/crm-creating-a-holder.md)
* [Criando uma Conta de Alias](https://docs.lerian.studio/pt/products/midaz/console/crm-creating-alias-account.md)

**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](https://docs.lerian.studio/pt/products/midaz/console/creating-an-accounting-route.md).

**9. Crie Transações**

Crie Transações depois que o Ledger tiver um Ativo e 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](https://docs.lerian.studio/pt/products/midaz/console/creating-a-transaction.md).

**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](https://docs.lerian.studio/pt/platform/console/plugin-settings.md).

## Caminho rápido por objetivo

***

> [card] [Preciso do meu primeiro ledger funcionando](https://docs.lerian.studio/pt/products/midaz/console/midaz-console-onboarding.md)
>
> Use o onboarding e depois crie pelo menos um Ativo e uma Conta.

> [card] [Preciso modelar a estrutura de contas](https://docs.lerian.studio/pt/products/midaz/console/creating-an-account-type.md)
>
> Comece pelas configurações do Ledger, Tipos de Conta, Contas e Segmentos.

> [card] [Preciso controlar como o dinheiro se move](https://docs.lerian.studio/pt/products/midaz/console/creating-an-accounting-route.md)
>
> Crie as contas primeiro e depois defina Rotas Contábeis e teste com uma transação.

> [card] [Preciso estimar tarifas](https://docs.lerian.studio/pt/products/midaz/fees/console/managing-fee-calculations)
>
> 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

***

> [accordion] Criar uma Conta antes de criar um Ativo
>
> Você deve vincular toda Conta a um Ativo. Se o Ativo ainda não existir, a criação da conta trava imediatamente.

> [accordion] Habilitar a validação de Tipo de Conta antes de definir os Tipos de Conta
>
> O campo Tipo passa a listar apenas Tipos de Conta registrados, então a lista fica vazia. Crie os Tipos de Conta primeiro ou desabilite a validação até que eles estejam prontos.

> [accordion] Projetar Rotas Contábeis antes de conhecer as contas reais
>
> 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.

> [accordion] Tentar criar Transações antes que os aliases ou as contas estejam prontos
>
> 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.

> [!NOTE]
>
> Quando você documentar a configuração ou treinar a equipe de uma instituição, ensine essa ordem primeiro. As páginas de CRUD ficam muito mais fáceis quando a cadeia de dependência é explícita.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.