28 de julio de 2025
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.
Hemos reestructurado tanto las Guías como la Referencia de API 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.
También lanzamos el Hub de Partners: 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.
Todas las APIs de Midaz y plugins ahora soportan Pruébalo en la documentación.
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.
Hemos añadido una nueva página que lista los puertos predeterminados utilizados por Midaz y sus plugins: Puertos de red predeterminados.Si estás desplegando en un entorno autohospedado, esta guía ayuda a asegurar que tu infraestructura esté configurada correctamente.
Nueva estructura, navegación más clara
Hemos reestructurado tanto las Guías como la Referencia de API 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.
Hub de Partners
También lanzamos el Hub de Partners: 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
amountyscalefueron reemplazados por un campo unificadovaluede tipostring(que debe contener un valor numérico). - Los campos
chartOfAccountsGroupychartOfAccountshan 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 encabezadoX-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, 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 para ayudarte a probar de forma segura y rápida.
| APIs | URLs Sandbox |
|---|---|
| Midaz - Onboarding | https://onboarding.sandbox.lerian.net |
| Midaz - Transaction | https://transaction.sandbox.lerian.net |
| Access Manager - Authentication | https://auth.sandbox.lerian.net |
| Access Manager - Identity | https://identity.sandbox.lerian.net |
| CRM | https://crm.sandbox.lerian.net |
| Fee Engine | https://fees.sandbox.lerian.net |
| Smart Templates | 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.
Nueva página
- Entidades de Enrutamiento de Transacciones – Nueva página sobre cómo usar Transacción y Rutas de Operación.
Páginas actualizadas
Guías de UI de Plugins
Agregamos orientación práctica para usar plugins directamente desde Midaz Console:- Usando Access Manager con Midaz Console – Gestiona usuarios y aplicaciones usando un modelo RBAC centralizado.
- Usando CRM con Midaz Console – Crea y actualiza Titulares y Cuenta Aliases desde la UI.
- Usando Fee Engine con Midaz Console – Interfaz visual para crear paquetes y reglas.
- Usando Reporter con Midaz Console – Sube archivos .tpl, filtra datos y genera reportes.
Actualizaciones de referencia
- Reintentos e Idempotencia – Ampliado con ejemplos y estrategias.
- FAQ – Ahora cubre preguntas comunes sobre idempotencia y reintentos de errores.
- Observabilidad en Midaz – Actualizado con el nuevo stack de telemetría y flujo basado en OpenTelemetry.
Licencia de Lerian
- Página de Licencia de Lerian – 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.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 – 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 – 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.
Dominio de Onboarding – Tipos de Cuenta
- API de Tipos de Cuenta – 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 – Obtén el saldo de cualquier cuenta usando su alias legible.
- Recuperar Saldo de una Cuenta Externa – 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 – Finaliza una transacción que fue marcada previamente como pendiente.
- Cancelar una Transacción Pendiente – Cancela una transacción pendiente antes de que se registre en el libro contable.
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,routeFromyrouteToahora permiten enrutamiento más granular por ítem de tarifa. - La bandera
isDeductibleFromayuda 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
chartOfAccountsfueron eliminados. - Los montos ahora usan un campo unificado
valuede tipostring.
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 – Devuelve todas las fuentes disponibles conectadas al plugin.
- Recuperar una Fuente de Datos por id – Devuelve tablas y campos de una fuente específica.