> ## 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 de Midaz — Organizaciones, Ledgers, Cuentas y Transacciones — y cómo se combinan para modelar tu operación.

Este diagrama muestra cómo los bloques de construcción principales de Midaz se conectan para soportar operaciones financieras a escala. La Figura 1 ofrece una visión general de cómo funciona el 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

Midaz está en el centro. Coordina todo, desde la persistencia de datos hasta la lógica de negocio.

### Capa de datos

Todos los datos fluyen hacia la **capa de datos** persistente. Esta capa aporta durabilidad, consistencia y rendimiento al sistema.

## Dominios y relaciones

***

### Organizaciones

Cada organización es un entorno distinto en Midaz. Puede contener uno o varios ledgers, según cómo estructures tus datos.

### Ledgers

Un ledger contiene 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 el tipo de valor que rastreas.
* **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 usa un activo específico.

### Portafolios

Los portafolios agrupan cuentas por lógica de negocio. Puedes crear tantos portafolios como necesites para organizar tu estructura financiera. Cada portafolio contiene una o más cuentas.

### Cuentas y Segmentos

Una cuenta pertenece a un portafolio y representa un saldo individual. Los **Segmentos** agrupan cuentas, para que puedas aislar datos por cliente, producto, región o cualquier otra dimensión. Los segmentos te ayudan a rastrear e informar con precisión.

Los **Tipos de Cuenta** clasifican las cuentas por naturaleza y propósito. Permiten el enrutamiento de transacciones y la validación operativa entre 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 tiene una `balanceKey` (p. ej. `default`, `collateral`, `operational`) para particionar fondos sin dividir la cuenta.
* Una **cuenta externa** tiene un solo saldo (`default`).
* Si omites `balanceKey` en una transacción, Midaz usa el saldo predeterminado.
* Midaz deriva los saldos automáticamente de las operaciones del ledger. Puedes listarlos, consultarlos o (en escenarios de administración o prueba) ajustarlos manualmente.
* La clave de caché de Valkey incluye `balanceKey` en su formato: `balance:{transactions}:<orgId>:<ledgerId>:<alias>#<balanceKey>`.

### Transacciones

Una transacción mueve valor entre cuentas. Cada transacción contiene **operaciones** (débitos y créditos). Esto mantiene tu lógica consistente, trazable y alineada con tu modelo de negocio y tus políticas contables.

### Entidades de Rutas Contables

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

Tiene dos partes:

* **Rutas de Operación:** definen comportamientos atómicos de transacción. Cada ruta establece cómo Midaz anota y dirige un movimiento financiero, según tus reglas de negocio y estándares contables.
* **Rutas Contables:** orquestan múltiples Rutas de Operación en eventos financieros balanceados. Aplican la validación de doble entrada y mantienen la integridad de la transacción en todas las cuentas. (La API lo llama `transactionRoute`.)

Este par forma un sistema autogobernado. Midaz valida automáticamente cada transacción para una anotación y una dirección de flujo correctas.

## En resumen

***

Midaz te ofrece una estructura modular:

* Las Organizaciones gestionan ledgers.
* Los Ledgers contienen activos, portafolios y estructuras contables.
* Los Portafolios contienen cuentas, agrupadas por segmento.
* Las Transacciones mueven valor y desencadenan tratamientos contables.
* Tus datos permanecen sincronizados, trazables y 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 de tu organización. Esto aplica tanto si empiezas desde cero como si optimizas una configuración existente.

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