Configuración y gestión de Ledgers
Al incorporarte a Midaz, sigue estos pasos clave para establecer una base sólida para tu entorno bancario:Paso 1: Configura la Organización
Tu Organización en Midaz representa tu banco. Si aún no se ha creado, configúrala ahora. Asegúrate de que todos los detalles, como el nombre y la información legal, sean precisos, ya que esta entidad sirve como contexto principal para todas las operaciones financieras.Paso 2: Crea el/los Ledger(s)
Configura un Ledger bajo tu Organización. Las mejores prácticas sugieren comenzar con un ledger principal para todas las cuentas de clientes. Ya sea usando Midaz Console o API, asegúrate de que cada ledger tenga un nombre claro (por ejemplo, “Main Banking Ledger”). Inicialmente, el ledger no contendrá cuentas, pero sirve como base para las transacciones y la gestión de cuentas.Paso 3: Define los tipos de Activo
Define todos los tipos de Activo que usará tu institución. Esto incluye monedas (por ejemplo, BRL, USD, EUR) y otros activos como puntos de recompensa o criptomonedas. Establecerlos con anticipación permite una integración fluida en la configuración de tu ledger. Se pueden introducir activos adicionales a medida que se expanda tu cartera de productos.Paso 4: Configura el Plan de Cuentas
Desde el principio, define tu Plan de Cuentas para categorizar y enrutar transacciones de manera efectiva. Identifica categorías clave de cuentas como tarifas, intereses y pagos, mapeándolas a cuentas marcadoras de posición o categorías de cuentas. Una buena práctica es establecer cuentas internas para categorías como “Fees Receivable” e “Interest Payable”, vinculándolas a tipos de transacciones a través del Plan de Cuentas. Esta estructura garantiza un seguimiento financiero y reportes precisos.Paso 5: Administración del Ledger
Para mantener un sistema financiero organizado, establece procesos claros para la gestión del ledger:- Asigna roles de usuario apropiados con el sistema RBAC de Midaz para controlar el acceso y los permisos.
- Planifica ledgers adicionales si es necesario, documentando su propósito y administradores asignados.
- Revisa regularmente la configuración del ledger para mantener la precisión y garantizar la integridad financiera. Midaz aplica contabilidad de doble entrada, pero conciliar totales, especialmente cuando se usan cuentas de liquidación externas, ayuda a mantener la consistencia.
Configuración de Cuentas, Portafolios y Segmentos
Este flujo de trabajo te guía a través de la incorporación de clientes, configuración de cuentas y gestión de segmentación.Paso 1: Crea un Portafolio para el cliente
Al incorporar un nuevo cliente, individual o corporativo, crea un Portafolio bajo el ledger apropiado. Usa el Entity ID del cliente (de tu sistema CRM o el plugin CRM de Midaz) en los metadatos del Portafolio para un mapeo fluido.Paso 2: Configura las Cuentas del cliente
Para cada producto financiero o activo al que se suscriba el cliente, crea una Cuenta dentro de su Portafolio:- Una cuenta corriente denominada en BRL sería una entrada separada.
- Una cuenta en USD o BTC sería una cuenta adicional bajo el mismo Portafolio.
- Asigna alias de cuenta significativos para facilitar la referencia.
Paso 3: Aplica la segmentación
Determina si la cuenta del cliente pertenece a un segmento específico (por ejemplo, Standard, Premium, Student). Si usas Segmentos del Midaz, etiqueta portfolios o cuentas en consecuencia. Esto permite la elegibilidad automatizada para beneficios como exenciones de tarifas o tasas de interés escalonadas.Paso 4: Establece sub-cuentas
Para empresas o casos de uso específicos que requieran sub-cuentas, configúralas bajo la cuenta principal. Usa convenciones de nomenclatura jerárquica (por ejemplo, “ABC Corp USD - Project X”) para mantener la claridad.Paso 5: Financiamiento inicial y configuración de saldo
Si se requiere un depósito inicial, ejecuta una transacción para acreditar la nueva cuenta mientras debitas la fuente de financiamiento correspondiente. Esto garantiza el cumplimiento de los principios de doble entrada: no se permiten ajustes manuales de saldo.Paso 6: Verifica y revisa
Confirma que:- El Portafolio incluye todas las cuentas necesarias.
- Las cuentas muestran los tipos de activos correctos y saldos iniciales.
- Las asignaciones de segmentos se reflejan correctamente a través de la API o Midaz Console.
Paso 7: Gestión continua de Accounts
Mantén la precisión de las cuentas implementando flujos de trabajo para:- Actualizar metadatos de cuentas.
- Cerrar cuentas asegurando saldos cero.
- Ajustar la segmentación del Portafolio según las actualizaciones del cliente.
Implementación de gestión de transacciones de doble entrada
Midaz aplica principios de doble entrada, asegurando que todas las operaciones financieras se ejecuten a través de transacciones en lugar de manipulaciones directas de saldo.Paso 1: Define transacciones
Para cada evento financiero (depósito, transferencia, retiro, cargo por tarifa), define un objeto Transacción especificando:- Cuentas de origen y destino.
- Montos de débito y crédito.
- Metadatos relevantes de la transacción.
Paso 2: Usa el DSL de transacciones de Midaz o la API
Aprovecha el Transacción DSL (Gold Language) o la API de Midaz para crear transacciones de manera eficiente:- La API permite un control preciso sobre las cargas útiles de transacciones.
- El DSL simplifica la declaración de transacciones con sintaxis de alto nivel.
Paso 3: Garantiza el cumplimiento de doble entrada
Midaz valida automáticamente las transacciones para garantizar la integridad del saldo. Si los débitos y créditos no coinciden, la transacción se rechaza, evitando la corrupción del ledger.Paso 4: Enruta transacciones a través del Plan de Cuentas
Al publicar transacciones, incluye referencias relevantes del Plan de Cuentas para garantizar una categorización precisa. Por ejemplo, etiquetar una operación de tarifa con"FEE_INCOME" agiliza los reportes financieros.
Paso 5: Implementa idempotencia y seguimiento
Para evitar transacciones duplicadas debido a fallos de red, utiliza las claves de idempotencia de Midaz. Envía una referencia de transacción única con cada solicitud de API; si se necesita un reintento, Midaz lo reconocerá y evitará duplicaciones no deseadas.Paso 6: Monitorea transacciones y concilia
Aprovecha las herramientas de monitoreo de Midaz para:- Auditar transacciones publicadas.
- Identificar operaciones fallidas o revertidas.
- Conciliar transacciones diarias con flujos esperados.
Paso 7: Maneja reversiones y correcciones
En lugar de eliminar transacciones, publica transacciones correctivas que reviertan operaciones anteriores. Mantén rastros de auditoría claros vinculando reversiones a sus transacciones originales correspondientes.Paso 8: Optimiza flujos de trabajo de múltiples pasos
Para operaciones complejas como cálculos de intereses o pagos por lotes:- Agrupa operaciones en una sola transacción cuando sea posible.
- Utiliza el soporte de Midaz para transacciones de múltiples operaciones para mejorar la eficiencia y mantener la atomicidad.