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

# Configuración inicial

> Sigue el orden recomendado para configurar el Midaz Module y asegúrate de que cada pantalla cuente con los prerrequisitos que espera antes de operarla.

El Midaz Module es más fácil de configurar cuando se sigue el orden de dependencias que espera el producto. La mayor parte de la confusión surge al intentar crear Cuentas, Rutas o Transacciones antes de que existan las piezas estructurales.

## Orden recomendado

***

<Steps>
  <Step title="Crea tu Organización">
    Comienza por el propietario legal y operativo del entorno.

    Usa [Onboarding del Midaz Module](/es/midaz/console/midaz-console-onboarding) si es tu primera configuración. Si la Organización ya existe y quieres añadir otra, ve directamente a [Crear una Organización](/es/midaz/console/creating-an-organization).
  </Step>

  <Step title="Crea tu primer Ledger">
    El Ledger es el espacio de trabajo donde se delimitan balances, Cuentas y Transacciones.

    Ve a [Crear un nuevo Ledger](/es/midaz/console/creating-a-new-ledger).
  </Step>

  <Step title="Revisa la configuración del Ledger">
    Decide si habilitarás la validación de Rutas Contables antes de que los usuarios empiecen a crear Transacciones. Esta configuración es opcional y su valor predeterminado es `false`.

    Puedes configurar estos ajustes al crear el Ledger en [Crear un nuevo Ledger](/es/midaz/console/creating-a-new-ledger#ledger-settings), o actualizarlos más adelante desde [Gestionar Ledgers](/es/midaz/console/managing-ledgers-via-console#ledger-settings).
  </Step>

  <Step title="Crea Activos">
    Los Activos definen una unidad de valor para la Organización, como `BRL`, `USD` o un token personalizado. Las Cuentas referencian un Activo al crearse.

    Ve a [Crear un Activo](/es/midaz/console/creating-an-asset).
  </Step>

  <Step title="Crea Tipos de Cuenta">
    Define Tipos de Cuenta cuando las reglas configuradas de Cuentas o rutas necesiten esas clasificaciones.

    Ve a [Crear un Tipo de Cuenta](/es/midaz/console/creating-an-account-type).
  </Step>

  <Step title="Crea Cuentas">
    Las Cuentas mantienen los balances y son el origen o destino de las transacciones.

    Ve a [Crear una Cuenta](/es/midaz/console/creating-an-account).
  </Step>

  <Step title="Añade Portafolios, Segmentos, Titulares y Aliases cuando los necesites">
    Son estructuras de apoyo persistentes. Configúralas cuando el flujo necesite contexto de titularidad, agrupación, cálculo de tarifas o reglas con alcance.

    Usa:

    * [Crear un Portafolio](/es/midaz/console/creating-a-portfolio)
    * [Crear un Segmento](/es/midaz/console/creating-a-segment)
    * [Crear un Titular](/es/midaz/console/crm-creating-a-holder)
    * [Crear una Cuenta Alias](/es/midaz/console/crm-creating-alias-account)
  </Step>

  <Step title="Crea Rutas Contables">
    Las Rutas Contables definen reglas opcionales de participantes y asiento. Midaz las aplica cuando la validación de rutas está habilitada.

    Ve a [Crear una Ruta Contable](/es/midaz/console/creating-an-accounting-route).
  </Step>

  <Step title="Crea Transacciones">
    Crea Transacciones después de que la Organización tenga un Activo y el Ledger tenga las Cuentas necesarias. Una Ruta Contable coincidente solo es necesaria cuando la validación de rutas está habilitada.

    Ve a [Crear una Transacción](/es/midaz/console/creating-a-transaction).
  </Step>

  <Step title="Habilita plugins después de que la configuración central sea estable">
    Funcionalidades como Fees Engine amplían el comportamiento. Actívalas solo después de que el modelo base del ledger esté claro.

    Ve a [Configuración del Midaz Module](/es/platform/console/plugin-settings).
  </Step>
</Steps>

## Atajo por objetivo

***

<CardGroup cols={2}>
  <Card title="Necesito mi primer ledger funcionando" icon="play" href="/es/midaz/console/midaz-console-onboarding">
    Usa el onboarding y luego crea al menos un Activo y una Cuenta.
  </Card>

  <Card title="Necesito modelar la estructura de Cuentas" icon="layer-group" href="/es/midaz/console/creating-an-account-type">
    Empieza por la configuración del Ledger, los Tipos de Cuenta, las Cuentas y los Segmentos.
  </Card>

  <Card title="Necesito controlar cómo se mueve el dinero" icon="route" href="/es/midaz/console/creating-an-accounting-route">
    Crea primero las Cuentas, luego define Rutas Contables y prueba con una transacción.
  </Card>

  <Card title="Necesito estimar fees" icon="calculator" href="/es/midaz/fees/console/managing-fee-calculations">
    Habilita Fees Engine solo cuando la estructura central del ledger ya esté en su lugar.
  </Card>
</CardGroup>

## Errores comunes de secuenciación

***

<AccordionGroup>
  <Accordion title="Crear una Cuenta antes de crear un Activo">
    Debes vincular toda Cuenta a un Activo. Si el Activo aún no existe, la creación de la Cuenta se queda bloqueada de inmediato.
  </Accordion>

  <Accordion title="Activar la validación de Tipo de Cuenta antes de definir Tipos de Cuenta">
    Esto hace obligatorio el campo de tipo, pero el desplegable queda vacío. Crea primero los Tipos de Cuenta o desactiva la validación hasta que estén listos.
  </Accordion>

  <Accordion title="Diseñar Rutas Contables antes de conocer las Cuentas reales">
    Los usuarios suelen intentar modelar rutas demasiado pronto. En la práctica, las reglas de la route son más fáciles de definir cuando ya existen las Cuentas de treasury, customer, fee y settlement.
  </Accordion>

  <Accordion title="Intentar crear Transacciones antes de que los aliases o Cuentas estén listos">
    La creación de transacciones depende de que las Cuentas sean buscables y estructuralmente válidas. Si los operadores no pueden identificar rápido el origen y el destino, detente y arregla primero el modelo de Cuentas.
  </Accordion>
</AccordionGroup>

<Note>
  Cuando documentes la configuración o formes a un equipo cliente, enseña este orden primero. Las páginas CRUD resultan mucho más fáciles cuando la cadena de dependencias es explícita.
</Note>
