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

# Solución de problemas

> Resuelve los problemas más comunes de configuración y operación del Midaz Module en Lerian Console.

Usa esta página cuando la Console no muestre la opción que esperabas, no puedas completar un formulario o una transacción no se comporte como esperabas. La mayoría de los problemas se deben a prerrequisitos faltantes o a ajustes del Ledger habilitados antes de que existiera la configuración de soporte.

## Comprobaciones iniciales

***

Antes de investigar una pantalla concreta, confirma estos puntos básicos:

* Has seleccionado la **Organization** y el **Ledger** correctos.
* El Ledger ya tiene los **Assets** necesarios.
* La configuración del Ledger coincide con el flujo de trabajo que vas a usar.
* Los **Account Types**, **Accounts** y **Accounting Routes** necesarios existen antes de crear transacciones.
* Estás usando los aliases de la Cuenta exactamente como se registraron, incluyendo el prefijo `@`.

<Card title="Configuración inicial" icon="clipboard-list-check" href="/es/lerian-console/midaz-console/midaz-console-setup-path">
  Revisa el orden de configuración recomendado antes de cambiar pantallas individuales.
</Card>

## Problemas comunes

***

<AccordionGroup>
  <Accordion title="No veo el menú Account Types">
    El menú **Account Types** aparece cuando **Validate Account Type** está habilitado en la configuración actual del Ledger.

    Para solucionarlo:

    1. Abre **Foundation > Ledgers**.
    2. Abre los detalles del Ledger correspondiente.
    3. Ve a la pestaña **Settings**.
    4. Habilita **Validate Account Type**.
    5. Vuelve a la barra lateral y abre **Accounting > Account Types**.

    <Warning>
      Una vez habilitada esta opción, las nuevas Cuentas deberán usar un Tipo de Cuenta válido. Crea los tipos necesarios antes de pedir a los operadores que creen Cuentas.
    </Warning>
  </Accordion>

  <Accordion title="No puedo crear una Cuenta porque el campo Asset está vacío">
    Las Cuentas deben estar vinculadas a un Activo existente. Si no hay ningún Activo en el Ledger seleccionado, el formulario de Cuenta no puede completarse.

    Crea primero el Activo en [Crear un Activo](/es/lerian-console/midaz-console/creating-an-asset) y luego vuelve a [Crear una Cuenta](/es/lerian-console/midaz-console/creating-an-account).
  </Accordion>

  <Accordion title="El desplegable de Account Type está vacío">
    Esto suele significar que **Validate Account Type** está habilitado, pero no se ha creado ningún Tipo de Cuenta para el Ledger seleccionado.

    Crea al menos un Tipo de Cuenta en [Crear un Tipo de Cuenta](/es/lerian-console/midaz-console/creating-an-account-type). Si la validación por tipo no es necesaria para tu flujo, desactiva **Validate Account Type** en la configuración del Ledger.
  </Accordion>

  <Accordion title="No encuentro una Cuenta al crear una Transacción">
    La creación de transacciones busca Cuentas por alias. Confirma que:

    * La Cuenta existe en el Ledger seleccionado.
    * El alias incluye el prefijo `@`.
    * La Cuenta permite la dirección esperada: enviar para Cuentas de origen, recibir para Cuentas de destino.
    * El Activo de la Cuenta coincide con el Activo seleccionado para la Transacción.

    Si el alias falta o es incorrecto, abre los detalles de la Cuenta desde [Gestionar Accounts](/es/lerian-console/midaz-console/managing-accounts).
  </Accordion>

  <Accordion title="Mi Transacción falla en la validación de route">
    La validación de route se controla mediante **Validate Routes** en la configuración del Ledger. Cuando esta opción está habilitada, las transacciones deben coincidir con una Ruta Contable existente.

    Verifica que:

    * La Ruta Contable existe en el Ledger seleccionado.
    * La route tiene al menos una operation route válida de origen y una de destino, o una operation route bidireccional.
    * La validación de Tipo de Cuenta o alias coincide con las Cuentas usadas en la transacción.
    * El tipo de transacción coincide con el accounting scenario configurado en la route.

    Comienza en [Gestionar Accounting Routes](/es/lerian-console/midaz-console/managing-accounting-routes) y luego revisa [Crear una Ruta Contable](/es/lerian-console/midaz-console/creating-an-accounting-route).
  </Accordion>

  <Accordion title="Los importes de mi Transacción no cuadran">
    En transacciones complejas, el importe total debitado de las Cuentas de origen debe ser igual al importe total acreditado en las Cuentas de destino.

    Revisa cada operación antes de enviar la transacción. Si estás modelando fees, incluye la Cuenta de fees como destino adicional para que los créditos totales coincidan con los débitos totales.
  </Accordion>

  <Accordion title="No puedo eliminar una entidad">
    Algunas entidades no se pueden eliminar una vez que son utilizadas por registros derivados. Por ejemplo, un Activo usado por Cuentas o una Cuenta usada por Transacciones debe tratarse como parte del histórico del ledger.

    Mejor edita metadatos opcionales, deshabilita su uso futuro donde se permita o crea una entidad de reemplazo para las nuevas operaciones.
  </Accordion>

  <Accordion title="Los balances no se ven bien después de una Transacción">
    Empieza desde la página de detalles de la transacción y comprueba:

    * Las Cuentas de origen y destino.
    * El Activo usado en la transacción.
    * Cada operación de débito y crédito.
    * Si la transacción es directa, pendiente, comprometida, cancelada o revertida.

    Después abre el balance de la Cuenta y el historial de operaciones de las Cuentas involucradas.
  </Accordion>
</AccordionGroup>

## Referencias de API

***

Cuando un problema de la Console requiera una inspección más profunda, usa las referencias de API correspondientes:

<CardGroup cols={2}>
  <Card title="Listar Accounts" icon="list" href="/es/reference/midaz/list-accounts">
    Confirma si la Cuenta existe en el Ledger seleccionado.
  </Card>

  <Card title="Recuperar una Account" icon="magnifying-glass" href="/es/reference/midaz/retrieve-an-account">
    Inspecciona los detalles de la Cuenta, incluidos tipo, asset y metadatos.
  </Card>

  <Card title="Listar Transactions" icon="receipt-text" href="/es/reference/midaz/list-transactions">
    Revisa el historial de transacciones de un Ledger.
  </Card>

  <Card title="Recuperar una Transaction" icon="file-search" href="/es/reference/midaz/retrieve-a-transaction">
    Inspecciona el estado y los detalles de las operaciones de la transacción.
  </Card>
</CardGroup>