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

***

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

    Use o [onboarding do Módulo Midaz](/pt/products/midaz/console/midaz-console-onboarding) 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](/pt/products/midaz/console/creating-an-organization).
  </Step>

  <Step title="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](/pt/products/midaz/console/creating-a-new-ledger).
  </Step>

  <Step title="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](/pt/products/midaz/console/creating-a-new-ledger#ledger-settings), ou atualizá-las depois em [Gerenciando Ledgers](/pt/products/midaz/console/managing-ledgers-via-console#ledger-settings).
  </Step>

  <Step title="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](/pt/products/midaz/console/creating-an-asset).
  </Step>

  <Step title="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](/pt/products/midaz/console/creating-an-account-type).
  </Step>

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

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

  <Step title="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](/pt/products/midaz/console/creating-a-portfolio)
    * [Criando um Segmento](/pt/products/midaz/console/creating-a-segment)
    * [Criando um Titular](/pt/products/midaz/console/crm-creating-a-holder)
    * [Criando uma Conta de Alias](/pt/products/midaz/console/crm-creating-alias-account)
  </Step>

  <Step title="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](/pt/products/midaz/console/creating-an-accounting-route).
  </Step>

  <Step title="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](/pt/products/midaz/console/creating-a-transaction).
  </Step>

  <Step title="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](/pt/platform/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/products/midaz/console/midaz-console-onboarding">
    Use o onboarding e depois crie pelo menos um Ativo e uma Conta.
  </Card>

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

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

  <Card title="Preciso estimar tarifas" icon="calculator" href="/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.
  </Card>
</CardGroup>

## Erros comuns de sequenciamento

***

<AccordionGroup>
  <Accordion title="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>

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

  <Accordion title="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>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

<Note>
  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.
</Note>