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

# Entidades de Midaz

> Aprende a trabajar con las entidades centrales, cuentas y transacciones de Midaz

Este diagrama muestra cómo los bloques de construcción principales de Midaz se conectan para soportar operaciones financieras a escala. En la figura, puedes encontrar una visión general de la operación del sistema.

<Frame caption="Figura 1. Midaz y sus dominios interconectados y estructura modular.">
  <img src="https://mintcdn.com/lerian-49cb71fc/ZrZBZTM4DWnrahSd/images/es/d2/midaz-entities-v3.svg?fit=max&auto=format&n=ZrZBZTM4DWnrahSd&q=85&s=c521dd8447cfc8558455a097c3ba404f" alt="Bloques fundamentales de Midaz y cómo sus dominios interconectados encajan para soportar operaciones financieras a escala" width="1603" height="1395" data-path="images/es/d2/midaz-entities-v3.svg" />
</Frame>

## Componentes centrales

***

### Midaz

En el centro de todo. Midaz coordina cada elemento, desde la persistencia de datos hasta la lógica de negocio, para que puedas enfocarte en lo esencial.

### Capa de datos

Toda la información fluye hacia la **capa de datos** persistente, asegurando **durabilidad**, **consistencia** y **rendimiento** en todo el sistema.

## Dominios y relaciones

***

### Organizaciones

Cada organización representa un entorno distinto que utiliza Midaz. Puede contener uno o varios *Ledgers*, dependiendo de cómo estructures tus datos.

### Ledgers

Los Ledgers son donde ocurre toda la actividad financiera. Rastrea saldos, almacena activos e impulsa transacciones. Cada *Ledger* pertenece a una organización.

Desde aquí, el sistema se ramifica en:

* **Activos**: definen qué tipo de valor se rastrea.
* **Portafolios**: agrupan cuentas relacionadas bajo un propósito compartido.

### Activos

Los activos definen las unidades de valor, como BRL, USD, puntos o *tokens*. Cada cuenta está vinculada a un activo específico.

### Portafolios

Las Portafolios agrupan cuentas por lógica de negocio. Puedes tener tantas portafolios como necesites para organizar tu estructura financiera. Cada cartera contiene una o más cuentas.

### Cuentas y Segmentos

Las Cuentas están vinculadas a Portafolios y representan saldos individuales. Se agrupan por **Segmentos**, que te ayudan a aislar datos por cliente, producto, región o cualquier otra dimensión. Los segmentos facilitan el seguimiento y la elaboración de informes con precisión.

Además, las Cuentas pueden clasificarse lógicamente por **Tipos de Cuenta**, los cuales definen la naturaleza y el propósito de las cuentas dentro de la estructura financiera, permitiendo un enrutamiento de transacciones adecuado y la validación operativa en diferentes categorías de cuentas.

### Saldos

Un **Saldo** representa el monto neto que una **Cuenta** mantiene de un **Activo** determinado en un **Ledger** específico.

* Una cuenta puede tener **múltiples saldos**, cada uno identificado por una `balanceKey` (por ejemplo, `default`, `collateral`, `operational`), para particionar fondos sin dividir cuentas.
* Las **cuentas externas** están limitadas a un único saldo (predeterminado).
* Si se omite `balanceKey` en una transacción, se utiliza el saldo predeterminado.
* Los saldos se derivan automáticamente de las operaciones del *Ledger*. Pueden ser listados, consultados o (en escenarios de administración/pruebas) ajustados manualmente.
* La clave de caché (Valkey) también incluye `balanceKey` en su formato: `<org_id>:<ledger_id>:<account_alias>:<balance_key>`.

### Transacciones

Las transacciones mueven valor entre cuentas. Cada transacción se compone de **Operaciones** (débitos y créditos). Esto mantiene tu lógica consistente, **trazable** y alineada tanto con tu modelo de negocio como con tus políticas contables.

### Entidades de Rutas Contables

Las [entidades de Rutas Contables](/es/midaz/transaction-routing-entities) amplían las capacidades de Midaz creando un ecosistema estructurado que garantiza anotaciones correctas y direcciones de flujo financiero adecuadas.

Se componen de:

* **Rutas de Operación (*Operation Routes*)**: Definen comportamientos atómicos de transacción, especificando cómo se anota y dirige cada movimiento financiero de acuerdo con reglas de negocio predefinidas y estándares contables.
* **Rutas Contables (*Accounting Routes*, `transactionRoute` en la API)**: Orquestan múltiples Rutas de Operación en eventos financieros balanceados, aplicando la validación de doble entrada y manteniendo la integridad de la transacción en todas las cuentas.

Este dúo crea un ecosistema autogobernado donde las transacciones son validadas automáticamente para una anotación correcta y una dirección de flujo adecuada.

## En resumen

***

Midaz te ofrece una estructura potente y modular:

* Las **Organizaciones** gestionan *Ledgers*.
* Los **Ledgers** contienen activos, portafolios y estructuras contables.
* Las **Portafolios** contienen cuentas, agrupadas por segmento.
* Las **Transacciones** mueven valor y desencadenan tratamientos contables.
* Todos los datos están sincronizados, son trazables y están listos para la elaboración de informes financieros.

<Tip>
  **¿Necesitas ayuda para diseñar tu configuración de Midaz?**

  Nuestro servicio de consultoría puede ayudarte a adaptar la estructura a las necesidades únicas de tu organización, ya sea que estés comenzando desde cero u optimizando una configuración existente.

  [Contáctanos](https://lerian.studio/contact) para obtener más información.
</Tip>
