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

# Estructurar operaciones bancarias con Midaz

> Diseña Organizaciones, Ledgers, Portafolios y Segmentos para banca minorista y corporativa, con mejores prácticas para jerarquías escalables.

Midaz admite banca minorista y corporativa mediante una jerarquía de entidades clara. Esta página ofrece mejores prácticas para estructurar organizaciones, ledgers, cuentas, portafolios y segmentos. Una buena estructura mantiene simples las operaciones a medida que creces.

## Jerarquía óptima de Organizaciones y Ledgers

***

### Una Organización o varias

Un banco que opera como una única entidad legal necesita una Organización en Midaz. Para un grupo bancario con subsidiarias, usa una organización principal sobre varias organizaciones hijas. Esta estructura corresponde a tu gobierno corporativo. También aísla los datos por entidad.

<Note>
  La estructura de la organización debe reflejar tu estructura corporativa.
</Note>

### Usar varios Ledgers

Dentro de una organización, elige el número de ledgers según tus necesidades operativas. Mantén un **ledger principal** para las transacciones de los clientes. Agrega ledgers para propósitos especiales, como operaciones de tesorería o segmentación regulatoria.

<Note>
  Usa varios ledgers solo cuando sea necesario para mantener baja la complejidad. Una transferencia entre ledgers necesita orquestación externa a través de la API.
</Note>

## Estructuración eficiente de cuentas para banca minorista y corporativa

***

### Clientes minoristas: un Portafolio por cliente

Para la banca minorista, crea un **Portafolio para cada cliente**. Cada portafolio contiene una cuenta por tipo de activo, como cuenta corriente, ahorros o tarjeta de crédito. Esta estructura hace que los saldos sean fáciles de leer por cliente.

<Tip>
  Usa [CRM](/es/products/midaz/crm/crm-data-security) para gestionar datos personales como identificaciones fiscales, direcciones y alias bancarios, todo en un solo lugar.
</Tip>

### Clientes corporativos: cuentas jerárquicas

Para la banca corporativa, usa **cuentas hijas** dentro de los portafolios para reflejar la estructura interna. Una empresa puede tener una cuenta principal para sus fondos generales. Puede agregar cuentas hijas para subdivisiones, como nómina o control de gastos.

### Cuentas internas

Crea cuentas internas para ingresos, gastos y flujos de liquidación. Las cuentas con nombre como "Fee Income – USD" o "Interest Expense – USD" mantienen clara la contabilidad financiera.

## Ejemplo práctico: un banco digital típico

***

Este ejemplo muestra cómo un banco digital puede estructurar su implementación de Midaz. El banco ofrece cuentas corrientes, ahorros y transferencias Pix.

```
Organization: "Neobank S.A."
│
├── Ledger: "Main Ledger (BRL)"
│   │
│   ├── Segments
│   │   ├── "Standard" (default tier)
│   │   ├── "VIP" (premium customers)
│   │   └── "Business" (corporate accounts)
│   │
│   ├── Account Types
│   │   ├── "checking" → everyday transactions
│   │   ├── "savings" → interest-bearing deposits
│   │   ├── "settlement" → internal clearing
│   │   └── "fee-revenue" → bank fee collection
│   │
│   ├── Internal Accounts
│   │   ├── Settlement Account (clearing for Pix, TED)
│   │   ├── Fee Revenue Account
│   │   └── Interest Expense Account
│   │
│   └── Customer Portfolios
│       ├── Portfolio: "Maria Silva"
│       │   ├── Checking Account (BRL) — Segment: VIP
│       │   └── Savings Account (BRL) — Segment: VIP
│       │
│       └── Portfolio: "Tech Corp Ltda."
│           ├── Main Checking (BRL) — Segment: Business
│           ├── Payroll Account (BRL) — Segment: Business
│           └── Expense Account (BRL) — Segment: Business
│
└── Ledger: "Treasury"
    └── FX and interbank positions
```

### Cómo fluye una transferencia Pix por esta estructura

<Steps>
  <Step title="Transacción iniciada">
    Maria envía R\$ 500 vía Pix desde su cuenta corriente.
  </Step>

  <Step title="La Transaction Route valida">
    Se aplica la Transaction Route "Pix Out". Define un débito de la cuenta corriente de Maria y un crédito a la Settlement Account. También puede agregar una operación de comisión.
  </Step>

  <Step title="Las operaciones se ejecutan">
    Midaz crea cuatro operaciones de forma atómica. Debita R$ 500 de Maria y acredita R$ 500 a Settlement. También debita una comisión de R$ 0.50 de Maria y acredita R$ 0.50 a Fee Revenue.
  </Step>

  <Step title="Evento publicado">
    Cuando el streaming está habilitado, `STREAMING_BROKERS` y la fuente del roster del Ledger están configurados, y la transacción alcanza un estado del ciclo de vida elegible, Midaz emite un CloudEvent de ciclo de vida de transacción. El servicio de notificaciones del banco lee el evento y envía a Maria una notificación push.
  </Step>

  <Step title="Liquidación externa">
    Una integración externa concilia la Settlement Account con la infraestructura Pix del banco central.
  </Step>
</Steps>

### Guía de decisión: cuándo dividir ledgers

| Escenario                                     | Recomendación                                                        |
| :-------------------------------------------- | :------------------------------------------------------------------- |
| Una sola moneda, una sola unidad de negocio   | Un ledger es suficiente                                              |
| Varias monedas con FX ocasional               | Un ledger, cuentas de activo separadas por moneda                    |
| Entidades legales o subsidiarias separadas    | Un ledger por entidad, bajo organizaciones separadas                 |
| Requisito regulatorio de aislamiento de datos | Ledgers separados, u organizaciones separadas para aislamiento total |
| Operaciones de tesorería y trading            | Ledger de tesorería dedicado junto al ledger operativo               |

<Tip>
  Ante la duda, empieza con un solo ledger. Siempre puedes dividir más adelante a medida que crece la complejidad operativa. Si divides demasiado pronto, agregas sobrecarga de orquestación sin un beneficio claro.
</Tip>
