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

# Actualización de Documentación #3 — Fin del Ciclo de Lanzamiento

> Cierre del ciclo de lanzamiento con la nueva estructura de Guides y API Reference, el lanzamiento del Partners Hub, Account Types, Transaction Routing, transacciones en dos fases y disponibilidad del sandbox.

<Badge color="gray" size="lg">28 de julio de 2025</Badge> <Badge color="purple">Actualizado</Badge>

Hemos cerrado el último ciclo de lanzamiento con una ronda importante de actualizaciones en toda la documentación de Lerian. Desde reglas de enrutamiento flexibles hasta flujos de trabajo de plugins más inteligentes y una estructura de sitio más intuitiva, esta versión facilita la construcción, prueba y crecimiento con confianza.

## Nueva estructura, navegación más clara

***

Hemos reestructurado tanto las **[Guías](/es/welcome-to-our-guides)** como la **[Referencia de API](/es/reference/introduction)** para hacer la navegación más rápida e intuitiva.

El nuevo diseño separa conceptos principales, plugins y SDKs, ayudándote a enfocarte en lo que más importa, ya sea que estés comenzando o en plena implementación.

## Partner's Hub

***

También lanzamos el **[Hub de Partners](/es/partners-hub/introduction)**: un espacio centralizado para nuestros socios de desarrollo. Incluye estándares técnicos, reglas de documentación y mejores prácticas para ayudar a que tus plugins se integren sin problemas con el ecosistema de Midaz.

## Mejoras generales

***

### Midaz Core

* Los campos `amount` y `scale` fueron reemplazados por un campo unificado `value` de tipo `string` (que debe contener un valor numérico).
* Los campos `chartOfAccountsGroup` y `chartOfAccounts` han sido deprecados.
* El campo type en la **API de Cuentas** ahora es condicional:
* Cuando la funcionalidad de Tipos de Cuentas está **deshabilitada**, type es opcional y acepta cualquier cadena de texto libre.
* Cuando está **habilitada**, type se vuelve **obligatorio** y debe coincidir con uno de los valores registrados de la API de Tipos de Cuenta.

### Limpieza de encabezados de solicitud

El encabezado `X-Lerian-Id` fue eliminado de los endpoints de plugins para simplificar la integración.

### Nueva bandera pending

Ahora puedes establecer la bandera pending en el payload de [Crear Transacción Usando JSON](/es/reference/midaz/create-a-transaction-using-json), que soporta flujos de dos fases usando endpoints commit/cancel.

## Sandbox ya está disponible

Todas las APIs de Midaz y plugins ahora soportan **Pruébalo** en la documentación.

* También hemos publicado una [guía de Sandbox](/es/reference/using-our-sandbox) para ayudarte a probar de forma segura y rápida.

| APIs                                | URLs Sandbox                                                                              |
| :---------------------------------- | :---------------------------------------------------------------------------------------- |
| **Midaz - Onboarding**              | [https://onboarding.sandbox.lerian.net](https://onboarding.sandbox.lerian.net/)           |
| **Midaz - Transaction**             | [https://transaction.sandbox.lerian.net](https://transaction.sandbox.lerian.net/)         |
| **Access Manager - Authentication** | [https://auth.sandbox.lerian.net](https://auth.sandbox.lerian.net/)                       |
| **Access Manager - Identity**       | [https://identity.sandbox.lerian.net](https://identity.sandbox.lerian.net/)               |
| **CRM**                             | [https://crm.sandbox.lerian.net](https://crm.sandbox.lerian.net/)                         |
| **Fee Engine**                      | [https://fees.sandbox.lerian.net](https://fees.sandbox.lerian.net/)                       |
| **Smart Templates**                 | [https://smart-templates.sandbox.lerian.net](https://smart-templates.sandbox.lerian.net/) |

## Guías nuevas y actualizadas

***

### Conceptos principales

Hemos añadido nuevas guías conceptuales y de implementación para apoyar el lanzamiento de dos nuevas funcionalidades principales:

* **Tipos de Cuenta** – Define y gestiona categorías de cuentas personalizadas (ej., activo, pasivo, ingresos) utilizadas en toda tu organización. Ahora se referencian al crear cuentas.
* **Enrutamiento de Transacción** – Enruta transacciones y operaciones automáticamente basándose en tipo y metadatos—sin necesidad de codificar alias de cuentas o IDs.

Estas actualizaciones ayudan a los equipos a construir lógica financiera más limpia y escalable en los libros contables.

#### Nueva página

* [Entidades de Enrutamiento de Transacciones](/es/midaz/transaction-routing-entities) – Nueva página sobre cómo usar Transacción y Rutas de Operación.

#### Páginas actualizadas

* [Acerca de Midaz](/es/midaz/about-midaz)
* [Modelo de Datos](/es/midaz/data-model)
* [Entidades Principales](/es/midaz/core-entities)
* [Cuentas](/es/midaz/accounts)
* [Transacciones](/es/midaz/transactions)
* [Operaciones](/es/midaz/operations)

### Guías de UI de Plugins

Agregamos orientación práctica para usar plugins directamente desde Midaz Console:

* **[Usando Access Manager con Midaz Console](/es/platform/access-manager/using-access-manager-with-midaz-console)** – Gestiona usuarios y aplicaciones usando un modelo RBAC centralizado.
* **[Usando CRM con Midaz Console](/es/midaz/crm/using-crm-with-midaz-console)** – Crea y actualiza Titulares y Cuenta Aliases desde la UI.
* **[Usando Fee Engine con Midaz Console](/es/midaz/plugins/fees-engine/using-fee-engine-with-midaz-console)** – Interfaz visual para crear paquetes y reglas.
* **[Usando Reporter con Midaz Console](/es/reporter/using-reporter-with-midaz-console)** – Sube archivos .tpl, filtra datos y genera reportes.

### Actualizaciones de referencia

* [**Reintentos e Idempotencia**](/es/reference/retries-idempotency) – Ampliado con ejemplos y estrategias.
* [**FAQ**](/es/midaz/faq#idempotency) – Ahora cubre preguntas comunes sobre idempotencia y reintentos de errores.
* [**Observabilidad en Midaz**](/es/midaz/observability-in-midaz) – Actualizado con el nuevo stack de telemetría y flujo basado en OpenTelemetry.

### Licencia de Lerian

* [**Página de Licencia de Lerian**](/es/reference/lerians-license) – Una nueva página que describe los términos de licencia de Lerian ahora está disponible en la Referencia.

### Midaz Console

* **Nuevas etiquetas de botones** – Hemos actualizado la terminología en la Console para editar Organizaciones, Ledgers, Activos, Segmentos, Portafolios y Cuentas.

## APIs nuevas y actualizadas

***

Nuevas APIs y endpoints ampliados facilitan la automatización de la lógica contable, el control del flujo de transacciones y la generación de reportes dinámicos.

## Puertos de red predeterminados

***

Hemos añadido una nueva página que lista los puertos predeterminados utilizados por Midaz y sus plugins: [**Puertos de red predeterminados**](/es/reference/default-network-ports).

Si estás desplegando en un entorno autohospedado, esta guía ayuda a asegurar que tu infraestructura esté configurada correctamente.

### Dominio de Transacciones

Hemos introducido una nueva funcionalidad poderosa: Enrutamiento de transacciones. Estas APIs te permiten incorporar lógica contable directamente en tus flujos financieros, automatizando cómo se clasifican y registran las operaciones.

* [**API de Rutas de Transacción**](/es/reference/midaz/create-transaction-route) – Define cómo deben enrutarse las transacciones completas según el tipo. Esto permite el mapeo dinámico de flujos de transacciones a tu plan de cuentas.
* [**API de Rutas de Operación**](/es/reference/midaz/create-an-operation-route) – Establece reglas sobre cómo las operaciones de débito y crédito individuales se enrutan a tipos de cuentas específicos, reduciendo la necesidad de codificar cuentas en las transacciones.

Estas herramientas te ayudan a lograr mayor automatización, auditabilidad y alineación con la estructura contable de tu organización.

### Dominio de Onboarding – Tipos de Cuenta

* [**API de Tipos de Cuenta**](/es/reference/midaz/create-an-account-type) – Define y gestiona categorías de cuentas personalizadas. Una vez habilitados, estos tipos se vuelven obligatorios en el proceso de creación de cuentas, asegurando consistencia en tu libro contable.

### Saldos en tiempo real

La sección de **Saldos** ahora incluye endpoints para monitorear posiciones en tiempo real—crítico para casos de uso de tesorería, cumplimiento y reconciliación:

* [**Recuperar Saldo por Alias de Cuenta**](/es/reference/midaz/retrieve-a-balance-by-account-alias) – Obtén el saldo de cualquier cuenta usando su alias legible.
* [**Recuperar Saldo de una Cuenta Externa**](/es/reference/midaz/retrieve-a-balance-of-an-external-account) – Obtén saldos actuales de cuentas externas como `@external/BRL`, típicamente usadas para rastrear entradas y salidas fuera de tu libro contable interno.

### Transacciones de dos fases

También hemos introducido **Transacciones de Dos Fases**, dándote un control más estricto sobre la finalización de transacciones:

* [**Confirmar una Transacción Pendiente**](/es/reference/midaz/commit-a-pending-transaction) – Finaliza una transacción que fue marcada previamente como pendiente.
* [**Cancelar una Transacción Pendiente**](/es/reference/midaz/cancel-a-pending-transaction) – Cancela una transacción pendiente antes de que se registre en el libro contable.

Esto desbloquea flujos de trabajo avanzados como pre-validación de transacciones, ejecución retrasada o aprobaciones condicionales.

## Mejoras en Plugins

***

### Fees Engine

El Fees Engine fue actualizado para soportar las mejoras realizadas en Midaz Core y brindar más control sobre cómo se calculan y registran las tarifas.

Qué hay de nuevo:

* Campos como `transactionRoute`, `routeFrom` y `routeTo` ahora permiten enrutamiento más granular por ítem de tarifa.
* La bandera `isDeductibleFrom` ayuda a definir si una tarifa debe deducirse proporcionalmente del total de la transacción.
* Los débitos y créditos de tarifas ahora están separados por cuenta, mejorando la claridad.
* Los antiguos campos `chartOfAccounts` fueron eliminados.
* Los montos ahora usan un campo unificado `value` de tipo `string`.

Estos cambios te ayudan a aplicar tarifas con precisión, a través de múltiples rutas contables, y asegurar el cumplimiento con la lógica de enrutamiento interna.

### Smart Templates

El plugin Smart Templates ahora incluye nuevas APIs que te permiten generar filtros dinámicos basados en la estructura de tu fuente de datos.

* **[Listar Fuentes de Datos](/es/reference/reporter/list-data-sources)** – Devuelve todas las fuentes disponibles conectadas al plugin.
* **[Recuperar una Fuente de Datos por id](/es/reference/reporter/retrieve-data-source)** – Devuelve tablas y campos de una fuente específica.

Estos endpoints te ayudan a construir reportes más flexibles, sin necesidad de conocer el esquema completo de antemano.

**Todos los endpoints existentes también han sido actualizados para alinearse con las mejoras de Midaz Core.**
