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

# Organizaciones

> Define la Organización de nivel superior que posee tus Ledgers de Midaz — representa bancos, fintechs y jerarquías padre-hijo para subsidiarias.

Una **Organización** es la entidad de más alto nivel en Midaz. Representa a una institución financiera, como un banco o una fintech. Una Organización posee y gobierna los datos financieros de esa institución. Es el contenedor principal para todas las operaciones financieras.

Un banco o grupo financiero se registra como una Organización en Midaz. La Organización le da a sus operaciones un entorno estructurado.

<Note>
  **Entornos SaaS y multi-tenant** — Midaz limita cada Organización a tu tenant automáticamente. Cuando listas Organizaciones, ves solo las de tu cuenta. La plataforma aplica el [aislamiento de tenants](/es/multi-tenancy) por ti. No filtras por tenant ni agregas un identificador de tenant a tus solicitudes.
</Note>

### Sub-Organizaciones

Las Organizaciones admiten **jerarquías padre-hijo**. Un banco las usa para representar subsidiarias, sucursales regionales o unidades de negocio separadas en un mismo marco.

Esta estructura se ajusta a grupos financieros que operan varias entidades legales. Cada entidad posee sus propios [Ledgers](/es/midaz/ledgers) y se mantiene operativamente independiente. El vínculo padre-hijo registra cómo se relacionan las entidades.

### Estructura de organización

* **Organización > Ledgers:** Cada Organización posee uno o más Ledgers. Cada Ledger contiene sus registros financieros, como cuentas y transacciones, y pertenece a una sola Organización.

### Características clave

* Las Organizaciones son el nivel más alto en la jerarquía.
* Cada Organización gobierna sus propios Ledgers y define sus límites operativos.

## Jerarquías flexibles

***

Midaz admite jerarquías organizacionales para estructuras complejas.

Si tu empresa tiene varias ubicaciones o divisiones, puedes crear **organizaciones hijas** para sucursales, oficinas o subdivisiones específicas. Cada organización hija se conecta a una **organización padre**.

Cada Organización mantiene sus propios datos. Los registros de una Organización no pasan a otra.

<Note>
  Si un solo grupo gestiona varias Organizaciones, usa esta jerarquía para establecer límites claros entre ellas.
</Note>

### Ejemplo

**La Empresa XPTO** es una empresa brasileña con sucursales en São Paulo y Nueva York. Su estructura es la siguiente:

* **Organización Padre**: XPTO Ltda
* **Organizaciones Hijas**:
  * XPTO Nueva York
  * XPTO São Paulo

Con esta estructura, la empresa puede:

* Definir un rol distinto para cada sucursal.
* Hacer seguimiento de cada sucursal por separado.
* Adaptar los flujos de trabajo a cada sucursal.

## Beneficios de la estructuración organizacional

***

* **Escalabilidad**: Agrega o cambia sucursales a medida que el negocio crece.
* **Eficiencia**: Gestiona todos los niveles desde una sola jerarquía.
* **Personalización**: Configura cada sucursal por separado.

Midaz se adapta a la estructura de tu empresa, ya sea simple o compleja.

<Tip>
  ¿Necesitas ayuda con tu configuración de Midaz? Nuestro servicio de consultoría puede ayudarte a diseñar la estructura para tu organización, desde cero o a partir de una configuración existente.

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

## Gestionando Organizaciones

***

Gestionas tu Organización a través de la API o Lerian Console.

### Vía API

* [Crear una Organización](/es/reference/midaz/create-an-organization) — Registra una nueva Organización.
* [Listar Organizaciones](/es/reference/midaz/list-organizations) — Ver todas las Organizaciones en tu espacio de trabajo.
* [Recuperar una Organización](/es/reference/midaz/retrieve-an-organization) — Obtener detalles de una Organización específica.
* [Actualizar una Organización](/es/reference/midaz/update-an-organization) — Editar una Organización existente.
* [Eliminar una Organización](/es/reference/midaz/delete-an-organization) — Marcar una Organización como eliminada.

<Note>
  Cuando eliminas una Organización, Midaz no la elimina del sistema.

  En su lugar, Midaz establece una marca de tiempo `deletedAt`. A partir de ese momento la Organización queda excluida de todas las lecturas y ya no se puede usar. Su `status.code` no cambia, lo que preserva los datos históricos para las auditorías.
</Note>

### Vía Lerian Console

Visualizas, creas, editas y eliminas Organizaciones desde la página de **Organizaciones** en el Módulo Midaz de Lerian Console.

[**Aprende más en la guía de Gestión de Organizaciones.**](/es/midaz/console/managing-organizations)

<Tip>
  Cuando creas tu **primera Organización** en Lerian Console, lo haces como parte del flujo de incorporación. Para obtener más información, consulta la guía de [Incorporación al Módulo Midaz](/es/midaz/console/midaz-console-onboarding).
</Tip>