> ## 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 la Lerian Console con diagnósticos, causas y pasos de solución.

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

## Comprobaciones iniciales

***

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

* Seleccionaste 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 quieres usar.
* Los **Account Types**, **Accounts** y **Accounting Routes** necesarios existen antes de que crees transacciones.
* Usas los aliases de la Cuenta exactamente como se registraron, con el prefijo `@`.

<Card title="Configuración inicial" icon="clipboard-list-check" href="/es/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 habilitas **Validate Account Type** 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>
      Después de habilitar 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">
    Cada Cuenta debe vincularse a un Activo existente. Si no hay ningún Activo en el Ledger seleccionado, no puedes completar el formulario de Cuenta.

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

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

    Crea al menos un Tipo de Cuenta en [Crear un Tipo de Cuenta](/es/midaz/console/creating-an-account-type). Si tu flujo no necesita la validación por tipo, 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: las Cuentas de origen pueden enviar, las Cuentas de destino pueden recibir.
    * El Activo de la Cuenta coincide con el Activo que seleccionaste para la Transacción.

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

  <Accordion title="Mi Transacción falla en la validación de route">
    El ajuste **Validate Routes** controla la validación de route. Cuando lo habilitas, 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/midaz/console/managing-accounting-routes) y luego revisa [Crear una Ruta Contable](/es/midaz/console/creating-an-accounting-route).
  </Accordion>

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

    Revisa cada operación antes de enviar la transacción. Para modelar 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">
    No puedes eliminar algunas entidades una vez que los registros derivados las utilizan. Por ejemplo, trata un Activo que usan las Cuentas, o una Cuenta que usan las Transacciones, como parte del histórico del ledger.

    En su lugar, edita metadatos opcionales, deshabilita el uso futuro donde la Console lo 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.
    * El estado de la transacción: 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, como 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>
