Saltar al contenido principal
Midaz proporciona una base contable moderna diseñada para sistemas financieros en tiempo real. Combina la robustez de la contabilidad de partida doble tradicional con la flexibilidad requerida para productos digitales, finanzas embebidas y operaciones de alto volumen. Esta página introduce los principios contables centrales dentro de Midaz, cómo sus primitivas se mapean a prácticas contables estándar, y cómo puedes diseñar un plan de cuentas completo usando la plataforma. Midaz es intencionalmente centrado en el libro mayor: cada saldo, movimiento, asiento y conciliación se aplica a nivel del libro mayor—ofreciendo trazabilidad, auditabilidad y consistencia por defecto.

​
1. Conceptos contables centrales en Midaz

Antes de profundizar en cómo Midaz implementa la contabilidad, es útil revisar cómo funciona conceptualmente la contabilidad en cualquier sistema financiero.

​
Contabilidad de partida doble

Midaz está construido sobre reglas estrictas de partida doble:
  • Cada transacción debe tener al menos un débito y un crédito.
  • Los débitos totales deben ser iguales a los créditos totales.
  • Cada movimiento impacta el libro mayor de manera balanceada.
Esto asegura:
  • Sin desviaciones en los saldos
  • Pistas de auditoría precisas
  • Estados financieros listos para regulación

​
Plan de Cuentas

En la contabilidad tradicional, el Plan de Cuentas (PdC) define:
  • Categorías de cuentas (Activos, Pasivos, Patrimonio, Ingresos, Gastos)
  • Jerarquías
  • Cómo se clasifican los movimientos
Midaz proporciona herramientas para que tu producto pueda reflejar o adaptar esta estructura digitalmente.

​
Eventos contables y asientos

Cada cambio en valor genera un evento que contiene:
  • Qué sucedió
  • Qué cuentas fueron afectadas
  • Cuánto se movió
  • Metadatos para auditoría y cumplimiento
Midaz traduce acciones de negocio (“retiro”, “comisión”, “captura”, “liquidación”) en asientos contables estructurados.

​
2. Cómo Midaz implementa la contabilidad

Midaz implementa la contabilidad usando un conjunto de primitivas flexibles:
  • Assets (Activos)
  • Account Types (Tipos de Cuenta)
  • Accounts (Cuentas)
  • Segments (Segmentos)
  • Portfolios (Carteras)
  • Operation Routes (Rutas de Operación)
  • Transaction Routes (Rutas de Transacción)
  • Transactions (Transacciones)
Juntos, forman un motor contable programable.

​
Assets (Activos)

Un asset define qué se está moviendo:
  • Monedas (BRL, USD, EUR)
  • Puntos o millas
  • Tokens criptográficos
  • Unidades internas de valor (créditos, tokens de saldo)
Los assets definen:
  • Precisión decimal
  • Metadatos regulatorios
  • Formato operacional
Midaz garantiza la consistencia de assets en todos los asientos.

​
Account Types (Tipos de cuenta)

Los Account Types representan plantillas para las cuentas en tu libro mayor. Ejemplos:
  • CASH (EFECTIVO)
  • CUSTOMER_FUNDS (FONDOS_CLIENTE)
  • FEES (COMISIONES)
  • RESERVES (RESERVAS)
  • TREASURY (TESORERÍA)
  • RECEIVABLES (CUENTAS_POR_COBRAR)
Cada tipo define cómo se comportan las cuentas en términos de:
  • Operaciones permitidas
  • Asociación con entidades o portfolios
  • Cuentas internas vs externas
  • Reglas de conciliación
Puedes definir tus propios account types para reflejar tu modelo financiero.

​
Accounts (Cuentas)

Una account representa un contenedor de saldo dentro del libro mayor. Cada cuenta pertenece a:
  • Un portfolio
  • Un segment
  • Un account type
  • Un código de asset
Midaz permite:
  • Cuentas jerárquicas
  • Múltiples saldos por cuenta (vía balance keys)
  • Cuentas externas (ej. @external/BRL)
  • Enrutamiento basado en alias
Esto hace posible modelar desde billeteras simples hasta estructuras de liquidez complejas.

​
Segments (Segmentos)

Los segments te permiten categorizar y aislar cuentas. Casos de uso:
  • Separar fondos de clientes de fondos internos
  • Gestionar unidades de negocio
  • Implementar separación multi-tenant
  • Rastrear diferentes líneas de producto
Los segments son poderosos para gobernanza y reportes.

​
Portfolios (Carteras)

Los portfolios agrupan cuentas que comparten un propósito común o pertenecen a la misma entidad. Los portfolios te ayudan a:
  • Asociar todas las cuentas de un cliente a un solo portfolio
  • Aislar entidades legales
  • Rastrear el desempeño financiero de un grupo
Midaz permite múltiples portfolios por entidad dependiendo de tu modelo.

​
Operation Routes (Rutas de operación)

Las Operation Routes definen la lógica contable en sí misma. Responden a la pregunta:
“Cuando este tipo de operación ocurre, ¿qué cuentas deben ser debitadas y acreditadas?”
Por ejemplo:
  • Una transferencia saliente (retiro)
  • Un depósito (ingreso)
  • Una cobranza de comisión
  • Una liquidación
  • Una reversión
Cada ruta describe:
  • Cuentas origen
  • Cuentas destino
  • Balance keys
  • Lógica del libro mayor
  • Reglas de validación
Las Operation Routes son el núcleo de la gobernanza contable en Midaz.

​
Transaction Routes (Rutas de transacción)

Las Transaction Routes definen el evento de negocio que dispara la contabilidad. Si las Operation Routes definen cómo ocurren los movimientos, Las Transaction Routes definen cuándo. Ejemplos:
  • PIX_CASH_OUT
  • PIX_INSTANT_PAYMENT
  • PIX_REFUND
  • WALLET_TRANSFER
  • BANK_SLIP_SETTLEMENT
Cada Transaction Route mapea una acción de negocio a:
  • Validaciones requeridas
  • Contexto operacional
  • Las Operation Routes asociadas
Esto le da a tu sistema tanto flexibilidad como control.

​
3. Construyendo tu Plan de Cuentas en Midaz

Midaz te da todas las primitivas para diseñar un plan de cuentas completo. A continuación se presenta un proceso recomendado.

​
Paso 1 — Mapea tu modelo financiero

Lista los tipos de saldos necesarios:
  • ¿Saldos de clientes?
  • ¿Cuentas internas?
  • ¿Cuentas de reserva o liquidación?
  • ¿Cuentas de comisiones e ingresos?
Esto se convierte en tu plano inicial del PdC.

​
Paso 2 — Define los account types

Para cada categoría conceptual, crea un Account Type. Ejemplo:
  • CASH → fondos líquidos del cliente
  • SETTLEMENT → fondos pendientes de compensación
  • FEE_REVENUE → comisiones cobradas
  • FEE_EXPENSE → comisiones de proveedores
  • TREASURY → operaciones internas
Los Account Types mantienen tu libro mayor consistente.

​
Paso 3 — Crea segments y portfolios

Los segments separan dominios de negocio. Los portfolios gestionan propiedad y agrupación. Ejemplo:
  • Segment: CUSTOMER_FUNDS
  • Portfolio: customer_12345_wallet
Esto permite arquitecturas multi-producto y multi-tenant.

​
Paso 4 — Crea las cuentas

Para cada saldo lógico, crea una cuenta en el libro mayor. Ejemplos:
  • Cuenta BRL del cliente
  • Cuenta de tesorería corporativa
  • Cuenta de gastos de comisiones de proveedores
  • Cuenta de liquidación de comerciantes
Las cuentas se identifican por alias, haciendo el enrutamiento más intuitivo.

​
Paso 5 — Define las operation routes

Las Operation Routes mapean la lógica contable a transacciones reales. Ejemplo para un Pix de retiro:
  • Débito: cuenta BRL del cliente
  • Crédito: cuenta BRL externa (@external/BRL)
Midaz asegura:
  • Los saldos existen
  • Débitos ≤ saldo disponible
  • Los assets coinciden
  • El libro mayor permanece balanceado

​
Paso 6 — Define las transaction routes

Las Transaction Routes representan tus operaciones de negocio. Cada ruta:
  • Referencia Operation Routes
  • Define validaciones
  • Puede aplicar reglas de negocio
Esto crea un cerebro financiero programable.

​
4. Cómo Midaz ayuda con la contabilidad

Midaz está diseñado para hacer la contabilidad automática, rastreable, auditable y extensible.

​
Libro mayor en tiempo real

Cada transacción:
  • Actualiza saldos instantáneamente
  • Crea registros de auditoría inmutables
  • Genera metadatos para conciliación
  • Asegura corrección de partida doble

​
Lógica financiera determinística

Las Operation Routes y Transaction Routes previenen:
  • Débitos incorrectos
  • Desviaciones en saldos
  • Uso no autorizado de cuentas
  • Asientos inconsistentes
Tu equipo nunca necesita manejar manualmente la lógica contable en código.

​
Múltiples saldos por cuenta

Los Balance Keys te permiten separar:
  • Fondos bloqueados vs disponibles
  • Montos pendientes vs liquidados
  • Límites
  • Capas multi-moneda
Perfecto para Pix, tarjetas y pagos.

​
Reversiones y ajustes

Midaz soporta:
  • Reversiones de transacciones
  • Reembolsos
  • Contracargos
  • Correcciones financieras
Todo con trazabilidad completa.

​
Pista de auditoría completa

Cada movimiento almacena:
  • Origen
  • Ruta
  • Metadatos
  • Transacción padre (cuando aplica)
A los reguladores les encanta esto. A tus auditores también.

​
5. Escenarios contables típicos con Midaz

​
Pix de Retiro (Cash-Out)

  • La cuenta del cliente es debitada
  • La cuenta de liquidación externa es acreditada
  • El libro mayor permanece balanceado
  • El flujo SPI se concilia automáticamente

​
Reembolso Pix

  • Una transacción de reversión refleja la original
  • La transacción padre está vinculada
  • Las reglas de cumplimiento se aplican

​
Escrow de Marketplace

  • Los fondos se recolectan en una cuenta de retención
  • Las comisiones se asignan transparentemente
  • Las liquidaciones a comerciantes se disparan vía Operation Routes

​
Motor de Comisiones

  • Las cuentas de ingresos y gastos por comisiones se actualizan automáticamente
  • Sin intervención manual necesaria

​
6. Próximos Pasos — De la contabilidad a los reportes con Reporter

La contabilidad sola no cierra el ciclo — los datos financieros deben transformarse en reportes estructurados, auditables y conformes con la regulación. Aquí es donde Lerian Reporter se convierte en una extensión natural de la capa contable de Midaz. Reporter consume eventos del libro mayor, portfolios, segments, saldos y metadatos de transacciones para producir salidas financieras de alta fidelidad, alineadas con tus necesidades operacionales y regulatorias.

​
Cómo Reporter encaja en tu flujo contable

Reporter actúa como un motor de extracción y transformación de datos, diseñado para convertir el libro mayor estructurado de Midaz en:
  • Reportes operacionales diarios
  • Archivos de conciliación
  • Estados financieros
  • Salidas de cumplimiento
  • Integraciones con proveedores
Su diseño asegura consistencia entre lo que sucede en el libro mayor y lo que tu negocio reporta externamente.

​
COSIF y alineamiento regulatorio

Si tu institución necesita cumplir con COSIF (estándar contable brasileño) u otros marcos regulatorios similares, Reporter proporciona:
  • Una capa de mapeo flexible para traducir cuentas del libro mayor y segments a líneas COSIF
  • Soporte para estructuras jerárquicas
  • Reglas automatizadas de agrupación y agregación
  • Salidas determinísticas adecuadas para envío regulatorio
Midaz gestiona la lógica contable. Reporter transforma esa lógica en archivos de grado regulatorio.

​
¿Por qué usar Reporter junto con Midaz?

Juntos, cierran el ciclo contable:
  1. Midaz Ledger asegura eventos financieros estructurados, en tiempo real y de partida doble.
  2. Transaction Routes y Operation Routes proporcionan comportamiento contable determinístico.
  3. Reporter extrae, agrega y compone artefactos financieros y regulatorios.
Esto le da a tu institución:
  • Trazabilidad completa
  • Registros listos para auditoría
  • Narrativas financieras consistentes
  • Mapeo COSIF sin fricción
  • Flujos de cumplimiento automatizados