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

# Acerca de Midaz

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

export const GMetadata = ({children}) => <Tooltip headline="Metadatos" tip="Información adicional de clave-valor asociada a entidades como cuentas o transacciones, como IDs externos, números de referencia o códigos de departamento." cta="Ver glosario" href="/es/start-here/glossary">
    {children}
  </Tooltip>;

export const GAccountType = ({children}) => <Tooltip headline="Tipo de cuenta" tip="Una clasificación que define la naturaleza y el propósito de una cuenta, como corriente, de ahorro, de garantía o de liquidación, que permite el enrutamiento correcto de las transacciones." cta="Ver glosario" href="/es/start-here/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 normativo y la resolución de disputas." cta="Ver glosario" href="/es/start-here/glossary">
    {children}
  </Tooltip>;

export const GOperation = ({children}) => <Tooltip headline="Operación" tip="La unidad atómica de movimiento en el ledger, un único débito o crédito. Cada transacción se compone de una o más operaciones, lo que brinda una trazabilidad precisa para el cumplimiento normativo y los informes." cta="Ver glosario" href="/es/start-here/glossary">
    {children}
  </Tooltip>;

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

export const GTransactionRoute = ({children}) => <Tooltip headline="Ruta contable" tip="Un plano completo de transacción compuesto por varias rutas de operación, que define todos los débitos y créditos involucrados en un tipo de transacción, garantizando el cumplimiento de partida doble en todo momento. Se expone como transactionRoute en la API." cta="Ver glosario" href="/es/start-here/glossary">
    {children}
  </Tooltip>;

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

export const GPortfolio = ({children}) => <Tooltip headline="Portafolio" tip="Una agrupación de cuentas que pertenecen al mismo cliente, unidad de negocio o propósito. Reúne cuentas corrientes, de ahorro y de inversión en una vista unificada." cta="Ver glosario" href="/es/start-here/glossary">
    {children}
  </Tooltip>;

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

export const GSourceAvailable = ({children}) => <Tooltip headline="Source-available" tip="Un modelo de licenciamiento donde el código fuente es de acceso público para su inspección, modificación y autohospedaje, aunque ciertos usos comerciales pueden requerir una licencia." cta="Ver glosario" href="/es/start-here/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 en una cuenta y un crédito en otra, lo que garantiza que el sistema siempre cuadra." cta="Ver glosario" href="/es/start-here/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. Es la única fuente de verdad de las finanzas de una unidad de negocio." cta="Ver glosario" href="/es/start-here/glossary">
    {children}
  </Tooltip>;

Midaz es <GSourceAvailable>source-available</GSourceAvailable>, un <GLedger>ledger</GLedger> central. 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 centrales: **Onboarding** y **Transaction**. También integra CRM para titulares e instrumentos, y Fees. Juntos, entregan los componentes para configurar, ejecutar y gobernar los flujos financieros.

<Note>
  Esta arquitectura orientada a dominios mantiene la configuración (Onboarding) y la ejecución (Transaction) separadas pero integradas.
</Note>

## Dominios y API

***

### Dominio Onboarding

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

#### Componentes del Dominio Onboarding

* **Organizaciones**: una entidad de negocio que opera sobre Midaz, como un banco, una fintech o una subsidiaria. Cada organización tiene sus propios ledgers, configuraciones y controles de acceso. Una plataforma admite entonces operaciones multi-entidad.

* **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 única fuente 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 administran 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, de ahorro, escrow o de liquidación. Con `validateAccountType` habilitado, el `type` de una nueva cuenta no externa debe coincidir con un valor registrado. Las rutas de operación validan las cuentas por separado durante el procesamiento de rutas.

* **Cuentas**: las unidades fundamentales de almacenamiento de valor, donde vive el dinero o cualquier activo. Cada cuenta siempre se vincula a un activo. Puedes agrupar las cuentas en segmentos o portafolios para reflejar la estructura de tu 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 distintas monedas. Un portafolio las une para dar 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 distintos en toda tu base de clientes.

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

### Dominio Transaction

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

#### Componentes del Dominio Transaction

* **Saldos**: el saldo actual de cualquier cuenta, incluidos sus montos disponibles y retenidos. Esta instantánea en tiempo real sustenta validaciones, verificaciones previas a la transacción y pantallas para el cliente.

* **<GOperationRoute>Rutas de operación</GOperationRoute>**: plantillas reutilizables que definen las reglas de cada tramo 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 solo débito o crédito. El ledger descompone cada movimiento financiero en operaciones. Esto da un <GAuditTrail>registro de auditoría</GAuditTrail> completo y trazabilidad precisa para cumplimiento e informes.

* **<GTransactionRoute>Rutas contables</GTransactionRoute>**: planos completos de transacción que combinan varias rutas de operación. Por ejemplo, una ruta de transferencia Pix define sus reglas de origen y destino. Cuando habilitas la validación de rutas contables, Midaz valida la ruta de transacción y sus rutas de operación para ese tipo de transacción. La API expone esto como el recurso `transactionRoute`.

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

<Tip>
  El Dominio Transaction procesa cada movimiento en cumplimiento de las reglas de negocio y contables que configuras upstream.
</Tip>

## Referencia de dominios

***

Midaz es una plataforma de ledger orientada a dominios.

| Dominio         | Propósito                                                               | API clave                                                                                    |
| :-------------- | :---------------------------------------------------------------------- | :------------------------------------------------------------------------------------------- |
| **Onboarding**  | Estructura y configuración del ecosistema financiero.                   | Organizaciones, Ledgers, Activos, Tipos de cuenta, Cuentas, Portafolios, Segmentos           |
| **Transaction** | Ejecución, movimiento y contabilización de las operaciones financieras. | Saldos, Rutas contables (`transactionRoute`), Transacciones, Rutas de operación, Operaciones |
