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

# Guía de inicio rápido

> Configura Midaz por primera vez, desde la instalación del entorno hasta la creación de tu primera estructura de ledger.

<Tip>
  **Esta guía está dirigida a desarrolladores** que configuran Midaz por primera vez. Si buscas una visión general a nivel de negocio de cómo funciona Midaz, consulta [¿Qué es Midaz?](/es/midaz/what-is-midaz). Para opciones de despliegue, consulta [SaaS y BYOC](/es/deployment-models).
</Tip>

Comenzar con Midaz es sencillo. Sigue estos pasos para construir tu base y explorar las posibilidades.

## Paso 1 - Configura tu entorno

***

Para configurar tu entorno de Midaz, sigue los pasos en la página [Instalando el monorepo de Midaz](/es/midaz/midaz-setup).

### Autenticación y autorización

Midaz no incluye un sistema integrado de autenticación o autorización. Esto te da la flexibilidad de integrarlo con tu proveedor de identidad existente o pila de seguridad.

Si necesitas una solución lista para usar, puedes habilitar **Access Manager**, una funcionalidad opcional desarrollada por Lerian. Maneja tanto la autenticación como la autorización, facilitando el control de quién puede acceder a qué en todo tu ecosistema de Lerian — incluyendo Midaz y todos los demás productos de Lerian.

<Tip>
  Access Manager soporta estándares de identidad comunes como OAuth2 y OIDC y se integra nativamente con todos los productos de Lerian. Para más detalles, consulta la guía de [Access Manager](/es/platform/access-manager/access-manager).
</Tip>

## Paso 2 - Crea tu estructura de Midaz

***

Comienza creando la estructura de datos que impulsa tus flujos de trabajo.

### Paso 2.1 - Crear una Organización

El primer paso es crear tu Organización dentro de Midaz.

* [**Para crear una Organización, usa el endpoint Crear una Organización.**](/es/reference/midaz/create-an-organization)

<Tip>
  Si tu organización tiene múltiples sucursales, puedes crear varias Organizaciones y designar una **Organización Padre**.

  Por ejemplo, si la Compañía XYZ tiene sucursales en Nueva York y Brasil, puedes crear una Organización para la Compañía XYZ y establecerla como la padre de XYZ Nueva York y XYZ Brasil.
</Tip>

Para una lista completa de endpoints para gestionar tu Organización, expande la sección a continuación:

<Accordion title="Gestionar Organizaciones">
  * Recupera todas las Organizaciones usando el endpoint [Listar Organizaciones](/es/reference/midaz/list-organizations).
  * Recupera una Organización específica con [Recuperar una Organización](/es/reference/midaz/retrieve-an-organization)
  * Actualiza los detalles de la Organización usando el endpoint [Actualizar una Organización](/es/reference/midaz/update-an-organization).
  * Elimina una Organización en Homologación usando el endpoint [Eliminar una Organización](/es/reference/midaz/delete-an-organization).
    * Para Organizaciones en Producción, la eliminación requiere contactar al soporte de Lerian por razones de seguridad.
</Accordion>

### Paso 2.2 - Crear un Ledger

Cada organización debe tener **al menos** un Ledger. Sin embargo, puedes tener múltiples Ledgers dentro de cada Organización si es necesario.

* [**Para crear un Ledger, usa el endpoint Crear un Ledger.**](/es/reference/midaz/create-a-ledger)

Para una lista completa de endpoints para gestionar tu Ledger, expande la sección a continuación:

<Accordion title="Gestionar Ledgers">
  * Recupera todos los Ledgers usando el endpoint [Listar Ledgers](/es/reference/midaz/list-ledgers).
  * Recupera un Ledger específico con el endpoint [Recuperar un Ledger](/es/reference/midaz/retrieve-a-ledger).
  * Actualiza los detalles del Ledger usando el endpoint [Actualizar un Ledger](/es/reference/midaz/update-a-ledger).
  * Elimina un Ledger en Homologación usando el endpoint [Eliminar un Ledger](/es/reference/midaz/delete-a-ledger).
    * Para Ledgers en Producción, la eliminación requiere contactar al soporte de Lerian por razones de seguridad.
</Accordion>

### Paso 2.3 - Crear los Activos

Tu Organización puede tener múltiples Activos. Sin embargo, cada Activo debe crearse individualmente, permitiendo configuraciones específicas como lugares decimales.

* [**Para crear un Activo, usa el endpoint Crear un Activo.**](/es/reference/midaz/create-an-asset)

<Tip>
  Cuando creas un Activo, Midaz configura automáticamente una Cuenta Externa si no existe una ya. Esto asegura un respaldo sin problemas para todas las transacciones que fluyen dentro y fuera del Ledger.
</Tip>

Para una lista completa de endpoints para gestionar tus Activos, expande la sección a continuación:

<Accordion title="Gestionar Activos">
  * Recupera todos los Activos usando el endpoint [Listar Activos](/es/reference/midaz/list-assets).
  * Recupera un Activo específico con el endpoint [Recuperar un Activo](/es/reference/midaz/retrieve-an-asset).
  * Actualiza los detalles del Activo usando el endpoint [Actualizar un Activo](/es/reference/midaz/update-an-asset).
  * Elimina un Activo con el endpoint [Eliminar un Activo](/es/reference/midaz/delete-an-asset).
</Accordion>

### Paso 2.4 - Crear un Segmento (opcional)

Si lo deseas, puedes usar el **ID de Segmento** como una etiqueta de agrupación personalizada que permite agrupar cuentas según políticas definidas por el usuario, soportando una segmentación y gestión eficiente de cuentas.

* [**Para crear un Producto, usa el endpoint Crear un Segmento.**](/es/reference/midaz/create-a-segment)

Para una lista completa de endpoints para gestionar tu Segmento, expande la sección a continuación:

<Accordion title="Gestionar Segmentos">
  * Recupera todos los Segmentos usando el endpoint [Listar Segmentos](/es/reference/midaz/list-segments).
  * Recupera un Segmento específico con el endpoint [Recuperar un Segmento](/es/reference/midaz/retrieve-a-segment).
  * Actualiza los detalles del Segmento usando el endpoint [Actualizar un Segmento](/es/reference/midaz/update-a-segment).
  * Elimina un Segmento usando el endpoint [Eliminar un Segmento](/es/reference/midaz/delete-a-segment).
</Accordion>

### Paso 2.5 - Crear un Portafolio

Crea un Portafolio para agrupar tus cuentas de diferentes Activos.

* [**Para crear un Portafolio, usa el endpoint Crear un Portafolio.**](/es/reference/midaz/create-a-portfolio)

Para una lista completa de endpoints para gestionar tus Portafolios, expande la sección a continuación:

<Accordion title="Gestionar PorPortafoliostfolios">
  * Recupera todos los Portafolios usando el endpoint [Listar Portafolios](/es/reference/midaz/list-portfolios).
  * Recupera un Portafolio específico con el endpoint [Recuperar un Portafolio](/es/reference/midaz/retrieve-a-portfolio).
  * Actualiza los detalles del Portafolio usando el endpoint [Actualizar un Portafolio](/es/reference/midaz/update-a-portfolio).
  * Elimina un Portafolio con el endpoint [Eliminar un Portafolio](/es/reference/midaz/delete-a-portfolio).
</Accordion>

### Paso 2.6 - Crear las Cuentas

Ahora puedes agregar las cuentas relacionadas con los Activos que deseas usar con el Ledger. Tendrás que crear una cuenta para cada Activo.

* [**Para crear una cuenta, usa el endpoint Crear una Cuenta.**](/es/reference/midaz/create-an-account)

Para una lista completa de endpoints para gestionar tus Cuentas, expande la sección a continuación:

<Accordion title="Gestionar Cuentas">
  * Recupera todas las Cuentas usando el endpoint [Listar Cuentas](/es/reference/midaz/list-accounts).
  * Recupera una Cuenta específica con el endpoint [Recuperar una Cuenta](/es/reference/midaz/retrieve-an-account).
  * Actualiza los detalles de la Cuenta usando el endpoint [Actualizar una Cuenta](/es/reference/midaz/update-an-account).
  * Elimina una Cuenta con el endpoint [Eliminar una Cuenta](/es/reference/midaz/delete-an-account).
</Accordion>

## Paso 3 - Explora nuestras APIs

***

Sumérgete en la [referencia de API](/es/reference/introduction) para aprender más sobre cómo Midaz puede elevar tus operaciones. Desde el manejo de metadatos hasta la idempotencia, cada detalle está diseñado para simplicidad y eficiencia.

## ¿Necesitas ayuda?

***

No estás solo. Estamos aquí para apoyarte en cada paso del camino.

* Explora nuestro [Centro de documentación](/es/welcome-to-our-guides) para guías y recursos detallados.

* Únete a la [comunidad de Discord](https://discord.lerian.studio/).

* [Contacta a nuestro equipo de soporte](https://lerian.studio/support) para asistencia personalizada.
