Saltar al contenido principal
Midaz proporciona una base contable moderna para sistemas financieros en tiempo real, combinando la contabilidad estricta de partida doble con la flexibilidad necesaria para productos digitales, finanzas embebidas y operaciones de alto volumen. Es intencionalmente centrado en el ledger: cada saldo, movimiento y asiento se aplica a nivel del ledger, ofreciéndote trazabilidad, auditabilidad y consistencia por defecto. Esta página es el punto de entrada de la sección de Contabilidad. Presenta las primitivas centrales y cómo encajan entre sí, y luego te dirige a las páginas de referencia dedicadas — y a una guía práctica para implementar la contabilidad de principio a fin.

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 campo code 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 un routeCode 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.
En resumen, el flujo es:
Diagrama que muestra el flujo de trabajo de las primitivas contables

Flujo de trabajo de las primitivas contables

Como Midaz aplica la partida doble a nivel del ledger, cada transacción siempre balancea: el total de débitos es igual al total de créditos, los saldos nunca se desvían y cada movimiento es totalmente rastreable para auditoría y cumplimiento.
¿Eres nuevo en la contabilidad en Midaz? Comienza con la Guía de Contabilidad para un recorrido práctico, paso a paso, desde el plan de cuentas hasta un ejemplo funcional de pago Pix.