Skip to main content
Una operación es la unidad más pequeña de una transacción. Cada transacción contiene 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. Una transacción es un conjunto de operaciones que debe sumar cero desde la perspectiva del libro contable. Por ejemplo, un pago P2P con una comisión incluye:
  • 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 se asegura de que una transacción esté equilibrada antes de confirmarla. Las operaciones también llevan metadatos como marcas de tiempo y referencias a la transacción a la que pertenecen. Creas una transacción a través de la API JSON de Midaz. Para cada transacción, especificas un conjunto de operaciones. Cada operación tiene una cantidad, un activo y una cuenta de origen o destino. Luego Midaz comprueba que las operaciones estén equilibradas 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.
  • Midaz crea las operaciones cuando inicias una transacción y las completa con los datos que proporcionas.
  • 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) y un type. La direction es la base de la partida doble descrita arriba. El type clasifica el movimiento. Más allá de los estándar CREDIT y DEBIT, el type marca 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.
  • BLOCK y UNBLOCK — la etiqueta que se aplica a todas las operaciones de una transacción creada a través de los endpoints dedicados de bloqueo y desbloqueo. La etiqueta solo sobrescribe el type de la operación, nunca su dirección ni su monto.
La direction siempre mantiene su significado de débito o crédito, independientemente del type.

​
Rutas de Operación

Con las Rutas Contables, cada operación se conecta con la lógica de validación estructurada. Esa lógica vive en las Rutas de Operación.

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

Una Ruta de Operación es una regla de validación. Define qué tipos de cuenta o cuentas específicas puede usar un componente de transacción. También establece la dirección contable (origen o destino) y una anotación descriptiva. Funciona como una capa de validación entre la entrada de la transacción y la estructura del libro contable. Cada operación que envías debe cumplir con los requisitos de cuenta 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 envías una transacción a Midaz, contiene múltiples Operaciones. Con los Tipos de Cuenta y las Rutas Contables habilitados, Midaz valida cada operación contra las reglas de las Rutas de Operación. Esto asegura que:
  • La cuenta especificada coincide con el tipo de cuenta esperado o el 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 capa de validación, consistencia e integridad al procesamiento de transacciones. Importa sobre todo para requisitos financieros estructurados.
Si las operaciones que envías no coinciden con los requisitos de Ruta de Operación configurados, Midaz falla la validación y rechaza la transacción.

​
Gestión de Operaciones

Midaz genera las operaciones automáticamente como parte de un flujo de transacción. No puedes crear una operación directamente. Puedes consultar una operación según sea necesario.