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

# Configuração

> Siga a ordem recomendada para configurar o Módulo Midaz de modo que cada tela já tenha os pré-requisitos esperados.

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

***

<Steps>
  <Step title="Crie sua Organização">
    Comece pelo dono legal e operacional do ambiente.

    Use o [Onboarding do Módulo Midaz](/pt/lerian-console/midaz-console/midaz-console-onboarding) se esta for sua primeira configuração, ou vá direto para [Criar uma Organização](/pt/lerian-console/midaz-console/creating-an-organization) se a Organização já existir e você estiver adicionando outra.
  </Step>

  <Step title="Crie seu primeiro Ledger">
    O Ledger é o workspace onde vivem saldos, Contas e Transações. Nada abaixo dele funciona sem ele.

    Vá para [Criar um novo Ledger](/pt/lerian-console/midaz-console/creating-a-new-ledger).
  </Step>

  <Step title="Revise as configurações do Ledger">
    Decida se o Ledger vai aplicar validação de Tipo de Conta e outras regras estruturais antes que os usuários comecem a criar Contas.

    Você pode definir essas configurações ao criar o Ledger em [Criar um novo Ledger](/pt/lerian-console/midaz-console/creating-a-new-ledger#ledger-settings), ou atualizá-las depois em [Gerenciar Ledgers](/pt/lerian-console/midaz-console/managing-ledgers-via-console#ledger-settings).
  </Step>

  <Step title="Crie Ativos">
    Ativos definem qual unidade de valor o Ledger pode movimentar, como `BRL`, `USD` ou um token personalizado.

    Vá para [Criar um Ativo](/pt/lerian-console/midaz-console/creating-an-asset).
  </Step>

  <Step title="Crie Tipos de Conta">
    Se o seu Ledger usa validação por tipo, defina as classes de Conta que poderão ser selecionadas depois na criação de Contas e Rotas.

    Vá para [Criar um Tipo de Conta](/pt/lerian-console/midaz-console/creating-an-account-type).
  </Step>

  <Step title="Crie Contas">
    Contas mantêm saldos e são a origem ou o destino das Transações.

    Vá para [Criar uma Conta](/pt/lerian-console/midaz-console/creating-an-account).
  </Step>

  <Step title="Adicione Portfólios, Segmentos, Titulares e Aliases quando necessário">
    São estruturas de apoio. Elas ajudam a classificar ou identificar Contas, mas não são a primeira coisa a configurar, a menos que seu fluxo dependa delas.

    Use:

    * [Criar um Portfólio](/pt/lerian-console/midaz-console/creating-a-portfolio)
    * [Criar um Segmento](/pt/lerian-console/midaz-console/creating-a-segment)
    * [Criar um Titular](/pt/lerian-console/midaz-console/crm-creating-a-holder)
    * [Criar uma Conta Alias](/pt/lerian-console/midaz-console/crm-creating-alias-account)
  </Step>

  <Step title="Crie Rotas Contábeis">
    As Rotas definem quais Contas podem participar de uma operação e como os lançamentos são registrados.

    Vá para [Criar uma Rota Contábil](/pt/lerian-console/midaz-console/creating-an-accounting-route).
  </Step>

  <Step title="Crie Transações">
    Crie Transações apenas depois que o Ledger tiver pelo menos um Ativo, as Contas necessárias e um modelo de Rota compatível com o movimento desejado.

    Vá para [Criar uma Transação](/pt/lerian-console/midaz-console/creating-a-transaction).
  </Step>

  <Step title="Habilite plugins após a configuração central estar estável">
    Plugins como o Fees Engine estendem o comportamento. Ative-os somente depois que o modelo base do Ledger já estiver claro.

    Vá para [Configurações do Módulo Midaz](/pt/lerian-console/midaz-console/plugin-settings).
  </Step>
</Steps>

## Caminho rápido por objetivo

***

<CardGroup cols={2}>
  <Card title="Preciso do meu primeiro Ledger funcionando" icon="play" href="/pt/lerian-console/midaz-console/midaz-console-onboarding">
    Use o onboarding e crie pelo menos um Ativo e uma Conta.
  </Card>

  <Card title="Preciso modelar a estrutura de Contas" icon="layer-group" href="/pt/lerian-console/midaz-console/creating-an-account-type">
    Comece pelas configurações do Ledger, depois Tipos de Conta, Contas e Segmentos.
  </Card>

  <Card title="Preciso controlar como o dinheiro se movimenta" icon="route" href="/pt/lerian-console/midaz-console/creating-an-accounting-route">
    Crie primeiro as Contas, depois defina Rotas Contábeis e teste com uma Transação.
  </Card>

  <Card title="Preciso estimar taxas" icon="calculator" href="/pt/lerian-console/midaz-console/managing-fee-calculations">
    Habilite o Fees Engine somente depois que a estrutura central do Ledger já estiver no lugar.
  </Card>
</CardGroup>

## Erros comuns de sequenciamento

***

<AccordionGroup>
  <Accordion title="Criar uma Conta antes de criar um Ativo">
    Toda Conta precisa estar vinculada a um Ativo. Se o Ativo ainda não existir, a criação da Conta trava imediatamente.
  </Accordion>

  <Accordion title="Ativar a validação de Tipo de Conta antes de definir Tipos de Conta">
    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.
  </Accordion>

  <Accordion title="Desenhar Rotas Contábeis antes de conhecer as Contas reais">
    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.
  </Accordion>

  <Accordion title="Tentar criar Transações antes de aliases ou Contas estarem prontos">
    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.
  </Accordion>
</AccordionGroup>

<Note>
  Se você está documentando ou treinando um time cliente, ensine a configuração nesta ordem primeiro. As páginas CRUD ficam muito mais fáceis quando a cadeia de dependências está explícita.
</Note>