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

> Corrija problemas comuns do Módulo Midaz no Lerian Console: menus ausentes, listas suspensas vazias, transações bloqueadas e configurações de validação do Ledger incompatíveis.

Use esta página quando o Console não mostrar uma opção que você esperava, ou quando você não conseguir concluir um formulário. Use-a também quando uma transação não se comportar como você espera. A maioria dos problemas vem de pré-requisitos ausentes, ou de configurações do Ledger que você habilitou antes que a configuração de suporte existisse.

## Primeiras verificações

***

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 correspondem ao workflow que você quer usar.
* Os **Tipos de Conta**, as **Contas** e as **Rotas Contábeis** necessários existem antes de você criar transações.
* Você usa cada alias de conta exatamente como registrado, com o prefixo `@`.

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

## Problemas comuns

***

<AccordionGroup>
  <Accordion title="Não consigo ver o menu Tipos de Conta">
    O menu **Tipos de Conta** aparece quando você habilita **Validar Tipo de Conta** nas configurações do Ledger atual.

    Para corrigir isso:

    1. Abra **Fundamentos > Ledgers**.
    2. Abra os detalhes do Ledger de destino.
    3. Vá para a aba **Configurações**.
    4. Habilite **Validar Tipo de Conta**.
    5. Volte para o menu lateral e abra **Contabilidade > Tipos de Conta**.

    <Warning>
      Depois que você habilita essa configuração, novas Contas devem 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">
    Toda Conta deve estar vinculada a um Ativo existente. Se não existir nenhum Ativo no Ledger selecionado, você não consegue concluir o formulário de Conta.

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

  <Accordion title="A lista suspensa de Tipo de Conta está vazia">
    Isso geralmente significa que você habilitou **Validar Tipo de Conta**, mas não criou nenhum Tipo de Conta para o Ledger selecionado.

    Crie pelo menos um Tipo de Conta em [Criando um Tipo de Conta](/pt/products/midaz/console/creating-an-account-type). Se o seu workflow não precisar de validação de tipo, desabilite **Validar Tipo de Conta** nas configurações do Ledger.
  </Accordion>

  <Accordion title="Não encontro uma Conta ao criar uma Transação">
    A criação de transações pesquisa contas por alias. Confirme que:

    * A conta existe no Ledger selecionado.
    * O alias inclui o prefixo `@`.
    * A conta permite a direção esperada: contas de origem podem enviar, contas de destino podem receber.
    * O Ativo da conta corresponde ao Ativo que você selecionou para a Transação.

    Se o alias estiver errado ou não existir, abra os detalhes da conta em [Gerenciando Contas](/pt/products/midaz/console/managing-accounts).
  </Accordion>

  <Accordion title="A minha Transação falha na validação de rota">
    A configuração **Validar Rotas** controla a validação de rota. Quando você a habilita, as transações devem corresponder a uma Rota Contábil existente.

    Verifique se:

    * A Rota Contábil existe no Ledger selecionado.
    * A rota tem pelo menos uma rota de operação de origem válida e uma de destino válida, ou uma rota bidirecional.
    * A validação por 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 [Gerenciando Rotas Contábeis](/pt/products/midaz/console/managing-accounting-routes) e depois revise [Criando uma Rota Contábil](/pt/products/midaz/console/creating-an-accounting-route).
  </Accordion>

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

    Revise cada operação antes de enviar a transação. Para modelar tarifas, inclua a conta de tarifa como um destino adicional, para que o total de créditos corresponda ao total de débitos.
  </Accordion>

  <Accordion title="Não consigo excluir uma entidade">
    Você não pode excluir algumas entidades depois que registros posteriores as usam. Por exemplo, trate um Ativo usado por Contas, ou uma Conta usada por Transações, como parte do histórico do ledger.

    Em vez disso, edite metadados opcionais, desabilite o uso futuro onde o Console oferecer suporte a isso, ou crie uma entidade substituta para novas operações.
  </Accordion>

  <Accordion title="Os saldos não parecem corretos depois de 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.
    * O estado da transação: direto, pendente, confirmado, cancelado ou estornado.

    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 do Console exigir uma investigação mais profunda, use as referências de API correspondentes:

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

  <Card title="Recuperar uma Conta" icon="magnifying-glass" href="/pt/reference/products/midaz/v2/get-account-by-id">
    Inspecione detalhes da conta, como tipo, ativo e metadados.
  </Card>

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

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