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

# Troubleshooting

> Fix common Midaz Module issues in Lerian Console — missing menus, empty dropdowns, blocked transactions, and Ledger validation setting mismatches.

Use this page when the Console does not show an option you expected, or when you cannot complete a form. Also use it when a transaction does not behave as you expect. Most issues come from missing prerequisites, or from Ledger settings you enabled before the supporting configuration existed.

## First checks

***

Before you troubleshoot a specific screen, confirm these basics:

* You selected the correct **Organization** and **Ledger**.
* The Ledger already has the required **Assets**.
* The Ledger settings match the workflow you want to use.
* The required **Account Types**, **Accounts**, and **Accounting Routes** exist before you create transactions.
* You use each account alias exactly as registered, with the `@` prefix.

<Card title="Setup path" icon="clipboard-list-check" href="/en/midaz/console/midaz-console-setup-path">
  Review the recommended setup order before you change individual screens.
</Card>

## Common issues

***

<AccordionGroup>
  <Accordion title="I cannot see the Account Types menu">
    The **Account Types** menu appears when you enable **Validate Account Type** in the current Ledger settings.

    To fix it:

    1. Open **Foundation > Ledgers**.
    2. Open the target Ledger details.
    3. Go to the **Settings** tab.
    4. Enable **Validate Account Type**.
    5. Return to the sidebar and open **Accounting > Account Types**.

    <Warning>
      After you enable this setting, new Accounts must use a valid Account Type. Create the required types before you ask operators to create accounts.
    </Warning>
  </Accordion>

  <Accordion title="I cannot create an Account because the Asset field is empty">
    Each Account must link to an existing Asset. If no Asset exists in the selected Ledger, you cannot complete the Account form.

    Create the Asset first in [Creating an Asset](/en/midaz/console/creating-an-asset), then return to [Creating an Account](/en/midaz/console/creating-an-account).
  </Accordion>

  <Accordion title="The Account Type dropdown is empty">
    This usually means you enabled **Validate Account Type** but created no Account Types for the selected Ledger.

    Create at least one Account Type in [Creating an Account Type](/en/midaz/console/creating-an-account-type). If your workflow does not need type validation, disable **Validate Account Type** in Ledger settings.
  </Accordion>

  <Accordion title="I cannot find an Account when creating a Transaction">
    Transaction creation searches accounts by alias. Confirm that:

    * The account exists in the selected Ledger.
    * The alias includes the `@` prefix.
    * The account allows the expected direction: source accounts can send, destination accounts can receive.
    * The account Asset matches the Asset you selected for the Transaction.

    If the alias is wrong or does not exist, open the account details from [Managing Accounts](/en/midaz/console/managing-accounts).
  </Accordion>

  <Accordion title="My Transaction fails route validation">
    The **Validate Routes** setting controls route validation. When you enable it, transactions must match an existing Accounting Route.

    Check that:

    * The Accounting Route exists in the selected Ledger.
    * The route has at least one valid source and one valid destination operation route, or one bidirectional route.
    * Account Type or alias validation matches the accounts used in the transaction.
    * The transaction type matches the accounting scenario configured in the route.

    Start with [Managing Accounting Routes](/en/midaz/console/managing-accounting-routes) and then review [Creating an Accounting Route](/en/midaz/console/creating-an-accounting-route).
  </Accordion>

  <Accordion title="My Transaction amounts do not balance">
    For complex transactions, the total you debit from source accounts must equal the total you credit to destination accounts.

    Review every operation before you send the transaction. To model fees, include the fee account as an additional destination so the total credits match the total debits.
  </Accordion>

  <Accordion title="I cannot delete an entity">
    You cannot delete some entities after downstream records use them. For example, treat an Asset that Accounts use, or an Account that Transactions use, as part of the ledger history.

    Instead, edit optional metadata, disable future use where the Console supports it, or create a replacement entity for new operations.
  </Accordion>

  <Accordion title="Balances do not look right after a Transaction">
    Start from the transaction details page and check:

    * The source and destination accounts.
    * The Asset used in the transaction.
    * Each debit and credit operation.
    * The transaction state: direct, pending, committed, cancelled, or reversed.

    Then open the account balance and operation history for the accounts involved.
  </Accordion>
</AccordionGroup>

## API references

***

When a Console issue needs deeper inspection, use the corresponding API references:

<CardGroup cols={2}>
  <Card title="List Accounts" icon="list" href="/en/reference/midaz/list-accounts">
    Confirm whether the account exists in the selected Ledger.
  </Card>

  <Card title="Retrieve an Account" icon="magnifying-glass" href="/en/reference/midaz/retrieve-an-account">
    Inspect account details such as type, asset, and metadata.
  </Card>

  <Card title="List Transactions" icon="receipt-text" href="/en/reference/midaz/list-transactions">
    Review transaction history for a Ledger.
  </Card>

  <Card title="Retrieve a Transaction" icon="file-search" href="/en/reference/midaz/retrieve-a-transaction">
    Inspect transaction status and operation details.
  </Card>
</CardGroup>