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

# Solução de problemas

> Resolva os problemas mais comuns de configuração e operação ao usar o Módulo Midaz no Lerian Console.

Use esta página quando a Console não mostrar a opção esperada, um formulário não puder ser concluído ou uma Transação não se comportar como o esperado. A maioria dos problemas vem de pré-requisitos ausentes ou de configurações do Ledger habilitadas antes que a configuração de apoio existisse.

## Verificações iniciais

***

Antes de investigar uma tela específica, confirme estes pontos básicos:

* Você selecionou a **Organização** e o **Ledger** corretos.
* O Ledger já tem os **Ativos** necessários.
* As configurações do Ledger combinam com o fluxo que você quer usar.
* Os **Tipos de Conta**, **Contas** e **Rotas Contábeis** necessários existem antes de criar Transações.
* Você está usando os aliases das Contas exatamente como foram cadastrados, incluindo o prefixo `@`.

<Card title="Configuração" icon="clipboard-list-check" href="/pt/lerian-console/midaz-console/midaz-console-setup-path">
  Revise a ordem de configuração recomendada antes de mexer em telas individuais.
</Card>

## Problemas comuns

***

<AccordionGroup>
  <Accordion title="Não consigo ver o menu Tipos de Conta">
    O menu **Tipos de Conta** aparece quando **Validar Tipo de Conta** está habilitado nas configurações atuais do Ledger.

    Para resolver:

    1. Abra **Fundação > Ledgers**.
    2. Abra os detalhes do Ledger desejado.
    3. Vá até a aba **Configurações**.
    4. Habilite **Validar Tipo de Conta**.
    5. Volte para a barra lateral e abra **Contábil > Tipos de Conta**.

    <Warning>
      Uma vez habilitada essa opção, novas Contas precisarão usar um Tipo de Conta válido. Crie os tipos necessários antes de pedir aos operadores que criem Contas.
    </Warning>
  </Accordion>

  <Accordion title="Não consigo criar uma Conta porque o campo Ativo está vazio">
    Contas precisam estar vinculadas a um Ativo existente. Se nenhum Ativo existir no Ledger selecionado, o formulário de Conta não pode ser concluído.

    Crie o Ativo primeiro em [Criar um Ativo](/pt/lerian-console/midaz-console/creating-an-asset) e depois volte para [Criar uma Conta](/pt/lerian-console/midaz-console/creating-an-account).
  </Accordion>

  <Accordion title="O dropdown de Tipo de Conta está vazio">
    Isso geralmente significa que **Validar Tipo de Conta** está habilitado, mas nenhum Tipo de Conta foi criado para o Ledger selecionado.

    Crie pelo menos um Tipo de Conta em [Criar um Tipo de Conta](/pt/lerian-console/midaz-console/creating-an-account-type). Se a validação por tipo não é necessária para o seu fluxo, desabilite **Validar Tipo de Conta** nas configurações do Ledger.
  </Accordion>

  <Accordion title="Não consigo encontrar uma Conta ao criar uma Transação">
    A criação de Transações pesquisa Contas pelo alias. Confirme que:

    * A Conta existe no Ledger selecionado.
    * O alias inclui o prefixo `@`.
    * A Conta permite a direção esperada: enviar para Contas de origem, receber para Contas de destino.
    * O Ativo da Conta é igual ao Ativo selecionado para a Transação.

    Se o alias estiver ausente ou incorreto, abra os detalhes da Conta em [Gerenciar Contas](/pt/lerian-console/midaz-console/managing-accounts).
  </Accordion>

  <Accordion title="Minha Transação falha na validação de rota">
    A validação de rota é controlada por **Validar Rotas** nas configurações do Ledger. Quando essa opção está habilitada, as Transações precisam corresponder a uma Rota Contábil existente.

    Verifique se:

    * A Rota Contábil existe no Ledger selecionado.
    * A Rota tem ao menos uma Rota de Operação válida de origem e uma de destino, ou uma Rota de Operação bidirecional.
    * A validação de Tipo de Conta ou alias corresponde às Contas usadas na Transação.
    * O tipo de Transação corresponde ao cenário contábil configurado na Rota.

    Comece por [Gerenciar Rotas Contábeis](/pt/lerian-console/midaz-console/managing-accounting-routes) e depois revise [Criar uma Rota Contábil](/pt/lerian-console/midaz-console/creating-an-accounting-route).
  </Accordion>

  <Accordion title="Os valores da minha Transação não batem">
    Em Transações complexas, o total debitado das Contas de origem precisa ser igual ao total creditado nas Contas de destino.

    Revise cada operação antes de enviar a Transação. Se você está modelando fees, inclua a Conta de fees como destino adicional para que o total de créditos bata com o total de débitos.
  </Accordion>

  <Accordion title="Não consigo excluir uma entidade">
    Algumas entidades não podem ser excluídas depois de serem usadas por registros derivados. Por exemplo, um Ativo usado por Contas ou uma Conta usada por Transações deve ser tratada como parte do histórico do Ledger.

    Prefira editar metadados opcionais, desabilitar o uso futuro onde for possível ou criar uma entidade substituta para as novas operações.
  </Accordion>

  <Accordion title="Os saldos não parecem certos após uma Transação">
    Comece pela página de detalhes da Transação e verifique:

    * As Contas de origem e destino.
    * O Ativo usado na Transação.
    * Cada operação de débito e crédito.
    * Se a Transação é direta, pendente, confirmada, cancelada ou estornada.

    Depois abra o saldo da Conta e o histórico de operações das Contas envolvidas.
  </Accordion>
</AccordionGroup>

## Referências de API

***

Quando um problema na Console exigir uma inspeção mais profunda, use as referências de API correspondentes:

<CardGroup cols={2}>
  <Card title="Listar Contas" icon="list" href="/pt/reference/midaz/list-accounts">
    Confirme se a Conta existe no Ledger selecionado.
  </Card>

  <Card title="Recuperar uma Conta" icon="magnifying-glass" href="/pt/reference/midaz/retrieve-an-account">
    Inspecione os detalhes da Conta, incluindo tipo, Ativo e metadados.
  </Card>

  <Card title="Listar Transações" icon="receipt-text" href="/pt/reference/midaz/list-transactions">
    Revise o histórico de Transações de um Ledger.
  </Card>

  <Card title="Recuperar uma Transação" icon="file-search" href="/pt/reference/midaz/retrieve-a-transaction">
    Inspecione o status e os detalhes das operações da Transação.
  </Card>
</CardGroup>