Skip to main content
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


1

Crea tu Organización

Comienza por el propietario legal y operativo del entorno.Usa Onboarding del Midaz Module si es tu primera configuración. Si la Organización ya existe y quieres añadir otra, ve directamente a Crear una Organización.
2

Crea tu primer Ledger

El Ledger es el espacio de trabajo donde se delimitan balances, Cuentas y Transacciones.Ve a Crear un nuevo Ledger.
3

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, o actualizarlos más adelante desde Gestionar Ledgers.
4

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

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

Crea Cuentas

Las Cuentas mantienen los balances y son el origen o destino de las transacciones.Ve a Crear una Cuenta.
7

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:
8

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

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

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.

Atajo por objetivo


Necesito mi primer ledger funcionando

Usa el onboarding y luego crea al menos un Activo y una Cuenta.

Necesito modelar la estructura de Cuentas

Empieza por la configuración del Ledger, los Tipos de Cuenta, las Cuentas y los Segmentos.

Necesito controlar cómo se mueve el dinero

Crea primero las Cuentas, luego define Rutas Contables y prueba con una transacción.

Necesito estimar fees

Habilita Fees Engine solo cuando la estructura central del ledger ya esté en su lugar.

Errores comunes de secuenciación


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