> ## 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 nivel superior en Midaz. Representa 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.

<Note>
  **Entornos SaaS y multi-tenant**: Midaz limita automáticamente cada Organización a tu tenant. Cuando listas las Organizaciones, solo ves las de tu cuenta. La plataforma aplica el [aislamiento de tenants](/es/platform/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 independientes en un mismo framework.

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

### Estructura de la 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 Organización.

### Características clave

* Las Organizaciones son el nivel más alto de la jerarquía.
* Cada Organización gobierna sus propios Ledgers y establece 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 administra varias Organizaciones, usa esta jerarquía para establecer límites claros entre ellas.
</Note>

### Ejemplo

**Company 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 New 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 workflows a cada sucursal.

## Beneficios de la estructuración organizacional

***

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

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

## Gestión de Organizaciones

***

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

### A través de la API

* [Crear una Organización](/es/reference/products/midaz/v2/create-organization): Registra una nueva Organización.
* [Listar Organizaciones](/es/reference/products/midaz/v2/list-organizations): Consulta todas las Organizaciones en tu workspace.
* [Recuperar una Organización](/es/reference/products/midaz/v2/get-organization-by-id): Obtén los detalles de una Organización específica.
* [Actualizar una Organización](/es/reference/products/midaz/v2/update-organization): Edita una Organización existente.
* [Eliminar una Organización](/es/reference/products/midaz/v2/delete-organization): Marca 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`. Luego, Midaz excluye la Organización de cada lectura, y ya no puedes usarla. Midaz deja su `status.code` sin cambios, lo que preserva los datos históricos para el registro de auditoría.
</Note>

### A través de Lerian Console

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

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

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