Skip to main content
Una implementación confiable de Midaz depende de algunas decisiones estructurales que tomas al inicio. Evita los errores comunes de abajo para mantener los saldos exactos y el acceso bajo control.

​
Mala estructuración del Ledger

  • Error: Diseñas Ledgers demasiado complejos o demasiado simples. Por ejemplo, un Ledger por cliente genera fragmentación. Agrupar procesos no relacionados genera confusión.
  • Mejor práctica: Estructura los Ledgers en torno a áreas de negocio clave o entidades legales. Usa agrupaciones organizadas en lugar de un enfoque uno a uno. Esto mejora la capacidad de gestión y las transferencias internas.

​
No usar Portafolios para clientes

  • Error: Tratas cada cuenta de forma aislada en lugar de agruparla bajo un portafolio. Esto dificulta el seguimiento de todas las cuentas vinculadas a un único cliente.
  • Mejor práctica: Crea un portafolio para cada cliente. Agrupa sus cuentas para consultas simples, gestión de relaciones y reportes.

​
Mezclar Activos en una Cuenta

  • Error: Gestionas múltiples monedas o tipos de activos en una sola cuenta, a menudo mediante la sobrescritura de metadatos. Esto genera saldos poco claros e inconsistencias en los reportes.
  • Mejor práctica: Asigna un solo activo por cuenta. Si un cliente necesita soporte multidivisa, crea cuentas separadas. Usa convenciones de nomenclatura o portafolios para estructurarlas.

​
Rutas Contables Inadecuadas

  • Error: Envías transacciones sin Rutas de Operación (Operation Routes) o Rutas Contables (Transaction Routes en la API) configuradas correctamente. Esto causa validaciones inconsistentes, fondos mal dirigidos y datos de Ledger no fiables.
  • Mejor práctica: Define Rutas Contables que reflejen tu lógica de negocio y tus requisitos de cumplimiento, y después establece el ajuste del Ledger accounting.validateRoutes en true para exigir su cumplimiento. Su valor predeterminado es false. Usa Rutas de Operación para validar el origen y el destino de cada operación cuando la validación de rutas esté habilitada. Las rutas estructuradas mantienen cada transacción auditable.

​
Descuidar el manejo de Cuentas Externas

  • Error: Manejas incorrectamente las transacciones externas. Por ejemplo, eliminas una cuenta cuando los fondos salen del banco, lo que provoca desequilibrios.
  • Mejor práctica: Usa la Cuenta externa canónica @external/<asset-code> de cada Activo (por ejemplo, @external/BRL) para el dinero que entra y sale de Midaz. Esto mantiene el Ledger equilibrado y coincide con los extractos bancarios reales.

​
Fallos de seguridad en el control de acceso

  • Error: Otorgas privilegios excesivos a los administradores o usas cuentas compartidas. Esto compromete la seguridad y la rendición de cuentas.
  • Mejor práctica: Implementa el control de acceso basado en roles (RBAC) desde el inicio. No uses cuentas root o admin para operaciones diarias. Aplica una gestión estricta de credenciales. Audita los permisos con regularidad para prevenir la escalada de privilegios no autorizada.

​
Manejo de errores inapropiado en transacciones

  • Error: No gestionas las transacciones fallidas en la capa de integración. Esto lleva a suposiciones erróneas sobre operaciones exitosas.
  • Mejor práctica: Valida siempre las respuestas de la API de transacciones. Implementa mecanismos de reintento con backoff para errores transitorios. Registra los fallos permanentes. Asegúrate de que los sistemas ascendentes, como las aplicaciones de core banking, manejen las transacciones rechazadas y notifiquen al usuario.

​
Asegurando una implementación robusta de Midaz

Aborda estas trampas a tiempo y Midaz seguirá siendo una base financiera confiable. Tu equipo dedica su tiempo a nuevas funcionalidades, no a problemas evitables.