Mapa de conceptos

Entiende cómo se relacionan Organizaciones, Ledgers, Activos, Cuentas, Rutas y Transacciones antes de configurar el Midaz Module y operar en la Console.

El Midaz Module utiliza un conjunto reducido de objetos clave con dependencias explícitas. Organización, Ledger, Activos y Cuentas son la configuración central; Tipos de Cuenta, registros de CRM, Portafolios, Segmentos y Rutas Contables se configuran cuando el flujo los necesita.

​

Jerarquía principal

---

​

Qué significa cada objeto

---

Objeto	Qué representa	Por qué existe antes o después
Organization	El propietario legal u operativo de la configuración	Es el límite de nivel superior. Nada por debajo existe sin él.
Ledger	El entorno contable donde se registran balances y movimientos	Agrupa la estructura que un equipo operará en el día a día.
Asset	La unidad de valor que se mueve en el ledger, como BRL o USD	Las Cuentas y las transacciones dependen de él.
Account	Un contenedor de balance que puede enviar o recibir valor	Las transacciones ocurren entre Cuentas.
Account Type	Una clasificación opcional como checking, treasury o expense	Úsala cuando las reglas configuradas de Cuentas o rutas la necesiten.
Portfolio	Un agrupamiento de Cuentas, a menudo por cliente o estructura de wallet	Útil para reporting y organización, pero no es prerrequisito para toda Cuenta.
Segment	Un agrupamiento persistente de Cuentas con alcance de Ledger, como departamento, región o tier	Útil cuando el negocio necesita segmentar o agrupar por políticas.
Holder	La persona o entidad propietaria de Cuentas en flujos de CRM	Necesario cuando la titularidad de la Cuenta es relevante operativamente.
Alias	Un identificador legible utilizado para encontrar o referirse a una Cuenta	Especialmente importante al crear transacciones.
Accounting Route	Un conjunto opcional de reglas para participantes y comportamiento de asiento	Midaz aplica las reglas configuradas cuando la validación de rutas está habilitada.
Transaction	El movimiento de balance real registrado en el ledger	Es el resultado final de toda la configuración.

​

Cómo depende realmente una transacción de la configuración previa

---

Los prerrequisitos dependen de la Transacción y de la configuración del Ledger. Los Activos y las Cuentas son necesarios; las Rutas Contables solo son necesarias cuando la validación de rutas está habilitada.

​

Lectura práctica de la UI

---

Usa esta interpretación al guiar a los usuarios:

• Foundation define dónde vive el sistema: Organización, Ledger, Activo.

• Accounting define reglas opcionales de participación y asiento: Tipos de Cuenta y Rutas Contables.

• Accounts define quién mantiene balances y cómo los clasificas: Cuentas, Titulares, Aliases, Segmentos, Portafolios.

• Transactions ejercita la estructura configurada.

• Plugins extiende el modelo después de que el comportamiento principal ya funciona.

​

Dónde se suelen perder los usuarios

---

Cuenta vs Titular vs Alias

La Cuenta es el contenedor de balance. El Titular es la identidad de CRM. Una Cuenta Alias es un Instrumento opcional del CRM vinculado a un Titular y a una Cuenta existente del Ledger; el alias de la propia Cuenta es su identificador legible.

Tipo de Cuenta vs Segmento vs Portafolio

El Tipo de Cuenta es una clasificación opcional. Segmento y Portafolio son agrupamientos persistentes de Cuentas con alcance de Ledger; no son simples etiquetas ni relaciones directas con un Titular.

Ruta Contable vs Transacción

La Ruta es una regla reutilizable opcional. La Transacción es el movimiento individual; solo se comprueba contra reglas de rutas configuradas cuando la validación de rutas está habilitada.

Por qué el ledger importa tan pronto

Casi todos los objetos por debajo de él están delimitados por ledger. Los usuarios que tratan al ledger como un contenedor cosmético suelen configurar mal Cuentas y rutas más adelante.

Combina esta página con Configuración inicial al hacer onboarding de nuevos usuarios. Una página explica el modelo. La otra explica el orden.