Saltar al contenido principal
Una Operación es la unidad más pequeña de actividad financiera en Midaz – esencialmente una entrada de libro contable única, que es un débito o un crédito en una cuenta específica. Las Operaciones son los bloques de construcción de las transacciones. Cada transacción está compuesta de dos o más operaciones (Figura 1). Cada operación registra un cambio en el saldo de una cuenta:
  • Una operación de débito registra valor que sale de una cuenta — el origen.
  • Una operación de crédito registra valor que entra en una cuenta — el destino.
El efecto sobre el saldo almacenado depende de la direction del saldo: una cuenta normal (el caso común) disminuye con un débito y aumenta con un crédito. Si desglosamos una transacción, es una colección de operaciones que juntas deben sumar cero desde la perspectiva del libro contable. Por ejemplo, un pago P2P con una comisión podría incluir:
  • un débito de $100 de la cuenta del remitente.
  • un crédito de $98 a la cuenta del destinatario.
  • un crédito de $2 a la cuenta de comisiones de la plataforma.
Midaz garantiza que las transacciones siempre estén equilibradas antes de que se confirmen. Las Operaciones también llevan metadatos como marcas de tiempo y referencias a la transacción a la que pertenecen. En la API o DSL de Midaz, al crear una transacción, debe especificar un conjunto de operaciones, cada una con una cantidad, activo, cuenta de origen/destino, etc., y el sistema valida que se equilibren antes de confirmarlas.

​
Características clave

  • Cada operación pertenece a una transacción y hace referencia a una cuenta y activo específicos.
  • Las operaciones incluyen metadatos como cantidad, dirección (débito/crédito), tipo, marcas de tiempo, referencias y más.
  • Las operaciones se crean cuando inicia una transacción y se completan con los datos que proporciona.
  • Midaz valida todas las operaciones contra las reglas configuradas antes de confirmarlas en el libro contable.
Cada operación tiene una direction (debit o credit) — la base de la partida doble descrita arriba — y un type que clasifica el movimiento. Más allá de los estándar CREDIT y DEBIT, el type captura movimientos especiales: ON_HOLD y RELEASE (reservas de fondos de dos fases), OVERDRAFT (operaciones acompañantes generadas por el sistema en el saldo interno de overdraft), y BLOCK y UNBLOCK (producidos por los endpoints dedicados de bloqueo y desbloqueo). direction siempre mantiene su significado débito/crédito independientemente del type.

​
Rutas de Operación

Con las Rutas Contables, la ejecución de una operación ahora se conecta con la lógica de validación estructurada — y ahí es donde entran las Rutas de Operación.

​
¿Qué es una Ruta de Operación?

Una Ruta de Operación es una regla de validación que define qué tipos de cuenta o cuentas específicas deben usarse en un componente de transacción, junto con la dirección contable (origen/destino) y anotación descriptiva. Funciona como una capa de validación entre la entrada de transacción y la estructura del libro contable, asegurando que cada operación enviada por los usuarios cumpla con los requisitos de cuenta predefinidos y las reglas de negocio.
En resumen: Las Transacciones contienen múltiples Operaciones. Las Rutas de Operación validan cada Operación contra las reglas de validación configuradas.

​
Relación Operación > Ruta de Operación

Cuando se envía una transacción a Midaz, contiene múltiples Operaciones. Con Tipos de Cuenta y Rutas Contables habilitados, cada una de estas operaciones se valida contra las reglas definidas en las Rutas de Operación para asegurar:
  • La cuenta especificada coincide con el tipo de cuenta esperado o requisito de cuenta específica.
  • La dirección de la operación (débito/crédito) se alinea con la definición de la ruta.
Esto agrega una poderosa capa de validación, consistencia e integridad al procesamiento de transacciones — especialmente cuando se trata de requisitos financieros estructurados.
Si las operaciones enviadas no coinciden con los requisitos de Ruta de Operación configurados, la transacción fallará la validación y será rechazada.

​
Gestión de Operaciones

Midaz genera automáticamente operaciones como parte de un flujo de transacción. No puede crearlas directamente, pero puede consultar una operación según sea necesario.