> ## 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 y configuración del entorno hasta la creación de tu primera estructura de ledger y el registro de una transacción de prueba.

<Tip>
  **Esta guía está pensada para desarrolladores** que configuran Midaz por primera vez. Si buscas un resumen de negocio de cómo funciona Midaz, consulta [¿Qué es Midaz?](/es/products/midaz/what-is-midaz). Para conocer las opciones de despliegue, consulta [SaaS y BYOC](/es/start-here/evaluate-and-deploy/deployment-models).
</Tip>

Sigue estos pasos para configurar Midaz.

## Paso 1 - Configura tu entorno

***

Para configurar tu entorno de Midaz, sigue los pasos de la página [Instalación del monorepo de Midaz](/es/products/midaz/midaz-setup).

* Esto instalará Midaz Ledger.

### Autenticación y autorización

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

Si necesitas una solución lista para usar, puedes habilitar **Access Manager**, una función opcional desarrollada por Lerian. Se encarga tanto de la autenticación como de la autorización en todo tu ecosistema Lerian, incluidos Midaz y el resto de los productos de Lerian.

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

## Paso 2 - Crea tu estructura de Midaz

***

Empieza por crear la estructura de datos que usan tus workflows.

### Paso 2.1 - Crea 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/products/midaz/v2/create-organization)

<Tip>
  Si tu organización tiene varias sucursales, puedes crear varias organizaciones y designar una **organización principal**.

  Por ejemplo, si la empresa XYZ tiene sucursales en Nueva York y Brasil, puedes crear una organización para la empresa XYZ y establecerla como principal de XYZ Nueva York y XYZ Brasil.
</Tip>

Para ver la lista completa de endpoints para gestionar tu organización, expande la siguiente sección:

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

### Paso 2.2 - Crea un ledger

Cada organización debe tener **al menos** un ledger. Sin embargo, puedes tener varios ledgers dentro de cada organización si lo necesitas.

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

Para ver la lista completa de endpoints para gestionar tu ledger, expande la siguiente sección:

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

### Paso 2.3 - Crea los activos

Tu organización puede tener varios activos. Sin embargo, cada activo debe crearse de forma individual, lo que permite configuraciones específicas como la cantidad de decimales.

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

<Tip>
  Cuando creas un activo, Midaz configura automáticamente una cuenta externa si aún no existe una. La cuenta externa respalda todas las transacciones que entran y salen del ledger.
</Tip>

Para ver la lista completa de endpoints para gestionar tus activos, expande la siguiente sección:

<Accordion title="Gestionar activos">
  * Recupera todos los activos con el endpoint [Listar activos](/es/reference/products/midaz/v2/list-assets).
  * Recupera un activo específico con el endpoint [Recuperar un activo](/es/reference/products/midaz/v2/get-asset-by-id).
  * Actualiza los detalles de un activo con el endpoint [Actualizar un activo](/es/reference/products/midaz/v2/update-asset).
  * Elimina un activo con el endpoint [Eliminar un activo](/es/reference/products/midaz/v2/delete-asset).
</Accordion>

### Paso 2.4 - Crea un segmento (opcional)

Si quieres, puedes usar el **ID de segmento** como una etiqueta de agrupación personalizada que agrupa cuentas según políticas definidas por el usuario.

* [**Para crear un producto, usa el endpoint Crear un segmento.**](/es/reference/products/midaz/v2/create-segment)

Para ver la lista completa de endpoints para gestionar tu segmento, expande la siguiente sección:

<Accordion title="Gestionar segmento">
  * Recupera todos los segmentos con el endpoint [Listar segmentos](/es/reference/products/midaz/v2/list-segments).
  * Recupera un segmento específico con el endpoint [Recuperar un segmento](/es/reference/products/midaz/v2/get-segment-by-id).
  * Actualiza los detalles de un segmento con el endpoint [Actualizar un segmento](/es/reference/products/midaz/v2/update-segment).
  * Elimina un segmento con el endpoint [Eliminar un segmento](/es/reference/products/midaz/v2/delete-segment).
</Accordion>

### Paso 2.5 - Crea un portafolio

Crea un portafolio para agrupar tus cuentas de distintos activos.

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

Para ver la lista completa de endpoints para gestionar tus portafolios, expande la siguiente sección:

<Accordion title="Gestionar portafolios">
  * Recupera todos los portafolios con el endpoint [Listar portafolios](/es/reference/products/midaz/v2/list-portfolios).
  * Recupera un portafolio específico con el endpoint [Recuperar un portafolio](/es/reference/products/midaz/v2/get-portfolio-by-id).
  * Actualiza los detalles de un portafolio con el endpoint [Actualizar un portafolio](/es/reference/products/midaz/v2/update-portfolio).
  * Elimina un portafolio con el endpoint [Eliminar un portafolio](/es/reference/products/midaz/v2/delete-portfolio).
</Accordion>

### Paso 2.6 - Crea las cuentas

Ahora puedes agregar las cuentas relacionadas con los activos que quieres usar con el ledger. Debes crear una cuenta por cada activo.

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

Para ver la lista completa de endpoints para gestionar tus cuentas, expande la siguiente sección:

<Accordion title="Gestionar cuentas">
  * Recupera todas las cuentas con el endpoint [Listar cuentas](/es/reference/products/midaz/v2/list-accounts).
  * Recupera una cuenta específica con el endpoint [Recuperar una cuenta](/es/reference/products/midaz/v2/get-account-by-id).
  * Actualiza los detalles de una cuenta con el endpoint [Actualizar una cuenta](/es/reference/products/midaz/v2/update-account).
  * Elimina una cuenta con el endpoint [Eliminar una cuenta](/es/reference/products/midaz/v2/delete-account).
</Accordion>

## Paso 3 - Explora nuestras API

***

Consulta la [referencia de la API](/es/reference/introduction) para conocer más sobre Midaz, desde el manejo de metadatos hasta la idempotencia.

## ¿Necesitas ayuda?

***

* Explora nuestro [centro de documentación](/es/start-here/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 recibir asistencia personalizada.
