> ## 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 problemas comunes del Midaz Module en Lerian Console: menús faltantes, menús desplegables vacíos, transacciones bloqueadas y ajustes de validación del Ledger que no coinciden.

Usa esta página cuando la Console no muestra una opción que esperabas, o cuando no puedes completar un formulario. Úsala también cuando una transacción no se comporta como esperas. La mayoría de los problemas vienen de requisitos previos faltantes, o de ajustes del Ledger que habilitaste antes de que existiera la configuración de soporte.

## Primeras verificaciones

***

Antes de solucionar problemas en una pantalla específica, confirma estos aspectos básicos:

* Seleccionaste la **Organización** y el **Ledger** correctos.
* El Ledger ya tiene los **Assets** requeridos.
* Los ajustes del Ledger coinciden con el workflow que quieres usar.
* Los **Account Types**, las **Accounts** y las **Accounting Routes** requeridos existen antes de que crees transacciones.
* Usas cada alias de cuenta exactamente como está registrado, con el prefijo `@`.

<Card title="Ruta de configuración" icon="clipboard-list-check" href="/es/products/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 puedo ver el menú de Account Types">
    El menú **Account Types** aparece cuando habilitas **Validate Account Type** en los ajustes actuales del Ledger.

    Para solucionarlo:

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

    <Warning>
      Después de habilitar este ajuste, las nuevas Accounts deben usar un Account Type válido. Crea los tipos requeridos antes de pedirles a los operadores que creen cuentas.
    </Warning>
  </Accordion>

  <Accordion title="No puedo crear una Account porque el campo Asset está vacío">
    Cada Account debe vincularse a un Asset existente. Si no existe ningún Asset en el Ledger seleccionado, no puedes completar el formulario de Account.

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

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

    Crea al menos un Account Type en [Crear un Tipo de cuenta](/es/products/midaz/console/creating-an-account-type). Si tu workflow no necesita validación de tipo, desactiva **Validate Account Type** en los ajustes del Ledger.
  </Accordion>

  <Accordion title="No encuentro una Account al crear una Transaction">
    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 Asset de la cuenta coincide con el Asset que seleccionaste para la Transaction.

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

  <Accordion title="Mi Transaction falla en la validación de ruta">
    El ajuste **Validate Routes** controla la validación de ruta. Cuando lo habilitas, las transacciones deben coincidir con una Accounting Route existente.

    Verifica que:

    * La Accounting Route existe en el Ledger seleccionado.
    * La ruta tiene al menos una ruta de operación de origen válida y una de destino válida, o una ruta bidireccional.
    * La validación de Account Type o de alias coincide con las cuentas usadas en la transacción.
    * El tipo de transacción coincide con el escenario contable configurado en la ruta.

    Empieza con [Gestionar Rutas contables](/es/products/midaz/console/managing-accounting-routes) y luego revisa [Crear una Ruta contable](/es/products/midaz/console/creating-an-accounting-route).
  </Accordion>

  <Accordion title="Los montos de mi Transaction no cuadran">
    En transacciones complejas, el total que debitas de las cuentas de origen debe ser igual al total que acreditas a las cuentas de destino.

    Revisa cada operación antes de enviar la transacción. Para modelar comisiones, incluye la cuenta de comisiones como un destino adicional para que el total de créditos coincida con el total de débitos.
  </Accordion>

  <Accordion title="No puedo eliminar una entidad">
    No puedes eliminar algunas entidades después de que registros posteriores las usan. Por ejemplo, trata un Asset que usan las Accounts, o una Account que usan las Transactions, como parte del historial del ledger.

    En su lugar, edita los metadatos opcionales, desactiva el uso futuro donde la Console lo permita, o crea una entidad de reemplazo para las operaciones nuevas.
  </Accordion>

  <Accordion title="Los saldos no se ven correctos después de una Transaction">
    Empieza desde la página de detalles de la transacción y verifica:

    * Las cuentas de origen y de destino.
    * El Asset usado en la transacción.
    * Cada operación de débito y de crédito.
    * El estado de la transacción: direct, pending, committed, cancelled o reversed.

    Luego abre el saldo de la cuenta y el historial de operaciones de las cuentas involucradas.
  </Accordion>
</AccordionGroup>

## Referencias de la API

***

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

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

  <Card title="Consultar una Cuenta" icon="magnifying-glass" href="/es/reference/products/midaz/v2/get-account-by-id">
    Inspecciona los detalles de la cuenta, como tipo, activo y metadatos.
  </Card>

  <Card title="Listar Transacciones" icon="receipt-text" href="/es/reference/products/midaz/v2/get-all-transactions">
    Revisa el historial de transacciones de un Ledger.
  </Card>

  <Card title="Consultar una Transacción" icon="file-search" href="/es/reference/products/midaz/v2/get-transaction">
    Inspecciona el estado y los detalles de las operaciones de la transacción.
  </Card>
</CardGroup>
