Cómo se relacionan las primitivas
Midaz convierte eventos de negocio en asientos balanceados del ledger a través de un pequeño conjunto de primitivas que se construyen unas sobre otras:
Plan de Cuentas
La estructura de saldos que tu producto necesita. Midaz no tiene una API dedicada de Plan de Cuentas — el PdC se modela a través de la combinación de assets, cuentas, segments, portfolios y tipos de cuenta en un ledger. El campocode de los Asientos Contables (ej. 1.1.1.001) lleva la numeración tradicional de cuentas para cada asiento.
Tipos de Cuenta
Plantillas que definen cómo se comportan las cuentas (operaciones permitidas, internas vs. externas, reglas de conciliación) y las clasifican dentro de tu estructura financiera.Asientos Contables (Rúbricas)
Mapeos que resuelven qué cuentas se debitan y se acreditan para cada acción de transacción.Operaciones
Los movimientos balanceados resultantes en el ledger. Una Operación es un único tramo de una transacción — un débito o un crédito sobre una cuenta específica. Como Midaz aplica la partida doble, cada transacción genera al menos dos operaciones (un débito, un crédito) de modo que el total de débitos sea igual al total de créditos. Para la trazabilidad contable, cada operación lleva unrouteCode y un routeDescription (el Asiento Contable resuelto), un transactionId que la vincula con su transacción padre, y el amount y el assetCode del movimiento.
Cada Operación registrada por Midaz lleva un
routeCode (el code de la Rúbrica Contable resuelta para la acción y dirección de esa operación) y un transactionId. En conjunto, estos campos proporcionan una pista de auditoría completa desde la transacción → operación → rúbrica, permitiendo que los equipos rastreen exactamente qué regla contable se aplicó a cada movimiento — sin búsquedas adicionales.Flujo de trabajo de las primitivas contables

