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

# Sobre Midaz

> Explora el servicio Ledger de Midaz, sus dominios de Onboarding y Transacción, y sus capacidades integradas de CRM y Fees.

export const GAccountType = ({children}) => <Tooltip headline="Tipo de cuenta" tip="Una clasificación que define la naturaleza y propósito de una cuenta — como corriente, ahorro, depósito en garantía o liquidación — permitiendo el enrutamiento adecuado de transacciones." cta="Ver glosario" href="/es/glossary">
    {children}
  </Tooltip>;

export const GAuditTrail = ({children}) => <Tooltip headline="Registro de auditoría" tip="Un registro cronológico e inmutable de cada acción y transacción en el sistema — esencial para el cumplimiento regulatorio y la resolución de disputas." cta="Ver glosario" href="/es/glossary">
    {children}
  </Tooltip>;

export const GOperation = ({children}) => <Tooltip headline="Operación" tip="La unidad atómica de movimiento en el ledger — un solo débito o crédito. Cada transacción se compone de una o más operaciones, proporcionando trazabilidad precisa para cumplimiento y reportes." cta="Ver glosario" href="/es/glossary">
    {children}
  </Tooltip>;

export const GOperationRoute = ({children}) => <Tooltip headline="Operation Route" tip="Una plantilla reutilizable que define las reglas para una etapa de una transacción financiera — especificando qué cuentas participan, en qué dirección y bajo qué anotación contable." cta="Ver glosario" href="/es/glossary">
    {children}
  </Tooltip>;

export const GTransactionRoute = ({children}) => <Tooltip headline="Accounting Route" tip="Un plano completo de transacción compuesto por múltiples Operation Routes — definiendo todos los débitos y créditos involucrados en un tipo de transacción, asegurando el cumplimiento de partida doble." cta="Ver glosario" href="/es/glossary">
    {children}
  </Tooltip>;

export const GSegment = ({children}) => <Tooltip headline="Segmento" tip="Una clasificación aplicada a cuentas que comparten características — como niveles de clientes (VIP, Estudiante) o divisiones regionales — permitiendo reglas y precios diferenciados." cta="Ver glosario" href="/es/glossary">
    {children}
  </Tooltip>;

export const GPortfolio = ({children}) => <Tooltip headline="Portfolio" tip="Una agrupación de cuentas pertenecientes al mismo cliente, unidad de negocio o propósito — uniendo cuentas corrientes, de ahorro e inversión en una vista unificada." cta="Ver glosario" href="/es/glossary">
    {children}
  </Tooltip>;

export const GAsset = ({children}) => <Tooltip headline="Asset" tip="Una unidad de valor rastreada en el ledger — monedas tradicionales (BRL, USD), monedas digitales (BTC) o unidades personalizadas como puntos de fidelidad. Cada cuenta está vinculada a exactamente un asset." cta="Ver glosario" href="/es/glossary">
    {children}
  </Tooltip>;

export const GSourceAvailable = ({children}) => <Tooltip headline="Source-available" tip="Un modelo de licencia donde el código fuente es públicamente accesible para inspección, modificación y auto-hospedaje, mientras que ciertos usos comerciales pueden requerir una licencia." cta="Ver glosario" href="/es/glossary">
    {children}
  </Tooltip>;

export const GDoubleEntry = ({children}) => <Tooltip headline="Partida doble" tip="Cada movimiento financiero se registra como al menos dos operaciones: un débito de una cuenta y un crédito en otra, asegurando que el sistema siempre esté balanceado." cta="Ver glosario" href="/es/glossary">
    {children}
  </Tooltip>;

export const GLedger = ({children}) => <Tooltip headline="Ledger" tip="El libro financiero central que registra todas las transacciones, saldos y operaciones de una organización — la fuente única de verdad para las finanzas de una unidad de negocio." cta="Ver glosario" href="/es/glossary">
    {children}
  </Tooltip>;

Midaz es un <GLedger>ledger</GLedger> central de código fuente disponible (<GSourceAvailable>source-available</GSourceAvailable>). Las instituciones financieras lo usan para construir, operar y escalar sus transacciones sobre una base modular. Mantienes el control total de tu stack.

El servicio Ledger de Midaz tiene dos dominios principales: **Onboarding** y **Transacción**. También integra CRM para titulares e instrumentos, y Fees. Juntos, proporcionan los componentes para configurar, ejecutar y gobernar flujos financieros.

<Note>
  Esta arquitectura orientada a dominios (*domain-driven*) garantiza que la configuración (Onboarding) y la ejecución (Transacción) permanezcan claramente separadas, pero totalmente integradas — lo que permite rendimiento, trazabilidad y agilidad de negocio.
</Note>

## Dominios y APIs

***

### Dominio de Onboarding

En el **Dominio de Onboarding**, las instituciones estructuran sus operaciones financieras. Configuran las entidades esenciales de su ledger. Este dominio define las reglas, cuentas y relaciones que rigen cómo el ledger registra e interpreta las transacciones.

#### Componentes del dominio de Onboarding

* **Organizaciones**: Una entidad comercial que opera en Midaz — como un banco, fintech o subsidiaria. Cada organización posee sus propios ledgers, configuraciones y controles de acceso. Así, una sola plataforma admite operaciones multientidad.

* **Ledgers**: El libro financiero central de una organización. Los <GLedger>ledgers</GLedger> rastrean cada saldo, transacción y operación. Protegen la integridad de todos los datos financieros. Piensa en un ledger como la fuente única de verdad para las finanzas de una unidad de negocio.

* **<GAsset>Activos</GAsset>**: Las unidades de valor que el ledger rastrea — como BRL, USD, BTC o puntos de fidelidad. Con esta flexibilidad, las instituciones gestionan monedas tradicionales, activos digitales y programas de recompensas personalizados en el mismo sistema.

* **<GAccountType>Tipos de Cuenta</GAccountType>**: Clasificaciones que definen la naturaleza y el propósito de las cuentas — por ejemplo, corriente, ahorro, custodia o liquidación. Con `validateAccountType` activado, el `type` de una Cuenta nueva no externa debe coincidir con un valor registrado. Las Rutas de Operación validan las Cuentas por separado durante el procesamiento de la ruta.

* **Cuentas**: Las unidades fundamentales de almacenamiento de valor — donde el dinero, o cualquier activo, realmente reside. Cada cuenta siempre se vincula a un activo. Puedes agrupar cuentas en segmentos o portafolios para reflejar tu estructura de negocio.

* **<GPortfolio>Portafolios</GPortfolio>**: Un grupo de cuentas que pertenecen al mismo cliente, unidad de negocio o propósito. Por ejemplo, un cliente puede tener cuentas corrientes, de ahorro y de inversión en diferentes monedas. Un portafolio las une para una vista unificada.

* **<GSegment>Segmentos</GSegment>**: Grupos de cuentas que comparten características, como niveles de cliente o divisiones regionales — por ejemplo, VIP o Estudiante. Los segmentos te ayudan a aplicar reglas, precios o beneficios diferentes en toda tu base de clientes.

<Tip>
  El Dominio de Onboarding configura cómo se estructura tu mundo financiero, asegurando la coherencia antes de que ocurra cualquier transacción.
</Tip>

### Dominio de Transacción

Después de configurar el Dominio de Onboarding, el **Dominio de Transacción** toma el control. Impulsa la ejecución, el movimiento y la conciliación de fondos en tiempo real.

#### Componentes del dominio de Transacción

* **Saldos**: El saldo actual de cualquier cuenta, incluidos sus montos disponibles y en espera (*on-hold*). Esta instantánea en tiempo real respalda validaciones, comprobaciones previas a la transacción y visualizaciones orientadas al cliente.

* **<GOperationRoute>Rutas de Operación</GOperationRoute>**: Plantillas reutilizables que definen las reglas para cada tramo (*leg*) de una transacción financiera. Una ruta especifica qué cuentas participan, en qué dirección (origen o destino) y bajo qué anotación contable. Así, cada tipo de transacción sigue reglas de negocio consistentes.

* **<GOperation>Operaciones</GOperation>**: La unidad atómica de movimiento en el ledger — un único débito o crédito. El ledger descompone cada movimiento financiero en operaciones. Esto ofrece un <GAuditTrail>rastro de auditoría</GAuditTrail> completo y trazabilidad precisa para cumplimiento y reportes.

* **<GTransactionRoute>Rutas Contables</GTransactionRoute>**: Planos de transacción completos que combinan múltiples Rutas de Operación. Por ejemplo, una ruta de Transferencia Pix define todos los débitos y créditos involucrados. Cuando habilitas la validación de Rutas Contables, aplica el cumplimiento de <GDoubleEntry>doble entrada</GDoubleEntry> para ese tipo de transacción. La API la expone como el recurso `transactionRoute`.

* **Transacciones**: El movimiento real de valor entre cuentas. Una transacción puede involucrar múltiples **Operaciones**, como comisiones, impuestos o divisiones. Esto admite flujos financieros complejos, como pagos de marketplace o liquidaciones multiparte, en un solo evento atómico.

<Tip>
  El Dominio de Transacción garantiza que cada movimiento se procese con precisión, transparencia y en conformidad con las reglas de negocio y contables configuradas previamente.
</Tip>

## En resumen

***

Midaz es una plataforma de ledger orientada a dominios para la fiabilidad, la flexibilidad y la gobernanza.

| Dominio         | Propósito                                                        | APIs Clave                                                                                   |
| :-------------- | :--------------------------------------------------------------- | :------------------------------------------------------------------------------------------- |
| **Onboarding**  | Estructura y configuración del ecosistema financiero.            | Organizaciones, Ledgers, Activos, Tipos de cuenta, Cuentas, Portafolios, Segmentos.          |
| **Transacción** | Ejecución, movimiento y contabilidad de operaciones financieras. | Saldos, Rutas Contables (`transactionRoute`), Transacciones, Rutas de operación, Operaciones |

Con esta arquitectura, las instituciones financieras estructuran sus datos con precisión y operan a escala. Mantienes el control total y la transparencia sobre tu ecosistema financiero.
