Skip to main content
Usa el Midaz Module para gestionar las Rutas contables, la configuración del enrutamiento de transacciones en Midaz. Un asistente guiado te lleva por tres pasos: definir la ruta de transacción, agregar las rutas de operación y revisar la configuración. Una Ruta contable define toda la lógica de enrutamiento de una transacción. Tiene tres partes:
  • Los metadatos de la transacción son el título y la descripción.
  • Las rutas de operación determinan qué cuentas participan y en qué dirección.
  • Los escenarios contables controlan cómo el ledger registra los asientos para cada tipo de transacción.

Reglas contables

Empieza aquí si necesitas decidir si usar Source, Destination, Bidirectional, validación por Account Type, validación por alias, o escenarios Direct, Two-Step o Reversal.
Para más detalles técnicos sobre las entidades subyacentes, consulta la página Entidades de Rutas contables.

​
Conceptos clave

​
Tipos de ruta de operación

Cada ruta de operación dentro de una Ruta contable tiene uno de tres tipos:
  • Source: define las reglas de validación para las cuentas donde se originan los fondos (lado débito)
  • Destination: define las reglas de validación para las cuentas que reciben los fondos (lado crédito)
  • Bidirectional: se aplica a ambos lados de la transacción, como origen y como destino
Una Ruta contable válida requiere al menos una ruta de operación source y una destination, o al menos una ruta bidirectional.
Una ruta bidirectional funciona como source y como destination a la vez. Midaz la hace coincidir en ambos lados cuando creas una transacción. Aparece tanto en la lista de rutas source como en la de destination, así que una sola ruta puede cubrir los dos extremos de un flujo.

​
Tipos de validación

Cada ruta de operación valida las cuentas mediante uno de dos métodos:
  • Account Type: valida contra una o más categorías de tipo de cuenta (por ejemplo, checking, savings). Úsala cuando cualquier cuenta de un tipo determinado sea válida.
  • @Alias: valida contra un alias de cuenta específico (por ejemplo, @treasury_main). Úsala cuando necesites apuntar a una cuenta exacta.

​
Escenarios contables

Los escenarios contables definen cómo el ledger registra los asientos de débito y crédito para cada ruta de operación. Puedes configurar asientos para cinco tipos de transacción:
  • Direct Transaction: transacción estándar de un solo paso. Define los códigos de cuenta y las descripciones de débito y crédito para la liquidación inmediata.
  • Two-Step Transaction: transacciones que pasan por un ciclo de hold y luego commit. Configura los asientos para:
    • Hold (Value Reserve): asientos registrados cuando el ledger reserva fondos
    • Commit (Reservation Confirmation): asientos registrados cuando confirmas la reserva
    • Cancel (Reservation Cancellation): asientos registrados cuando cancelas la reserva
  • Reversal: asientos registrados cuando reviertes una transacción completada
  • Overdraft: asientos registrados cuando un débito excede los fondos disponibles de la cuenta y recurre a una línea de sobregiro. Disponible para rutas de operación Source y Bidirectional, y requiere asientos de débito y de crédito en cada tipo de ruta admitido. Al habilitarlo, Midaz también habilita el escenario Direct.
  • Block/Unblock: asientos registrados cuando retienes y liberas fondos del saldo de la cuenta. La pestaña del escenario se llama Block. Disponible para todos los tipos de ruta de operación.
Cada asiento de escenario incluye un Account Code y una Description para los lados de débito y de crédito.
Los lados de asiento disponibles dependen del tipo de ruta de operación y de la fase del escenario. La regla general es:
  • Source: asientos de débito en Direct, Hold, Commit y Cancel. Asientos de crédito solo en Hold y Cancel.
  • Destination: solo asientos de crédito, en Direct y Commit. Hold y Cancel no están disponibles.
  • Bidirectional: asientos de débito y de crédito en todas las fases, incluida Reversal.
  • Block/Unblock: disponible para todos los tipos de ruta. Retiene y libera fondos del saldo de la cuenta.

​
Acceder a la página de Rutas contables

El menú Accounting Routes aparece solo cuando habilitas la configuración Validate Routes para el Ledger actual. Para habilitarla, abre los detalles del Ledger, ve a la pestaña Settings y activa el interruptor Validate Routes.
Validación de Rutas contables deshabilitada. Si abres esta página por URL mientras Validate Routes está desactivado, aparece un aviso en la parte superior de la pantalla. El Ledger todavía no procesa las rutas contables registradas aquí. Los asientos siguen estas reglas solo después de que habilites Validate Routes en la configuración del Ledger. Aún puedes ver y editar rutas, pero no tienen efecto hasta que habilites la validación.
Para abrir la página Accounting Routes, selecciona Accounting Routes en la sección Accounting del menú lateral izquierdo. La página Accounting Routes muestra tus rutas del Ledger actual como una lista de tarjetas en acordeón. Cada ruta de transacción es una tarjeta plegable. La tarjeta muestra su título, el ID de la ruta de transacción y una insignia con el número de operaciones. Expande una tarjeta para ver sus rutas de operación. Cada una muestra su ID, título, código y tipo de operación. La Console distingue los tipos de operación por color: source en rojo, destination en verde y bidirectional en gris. Una ruta sin rutas de operación aparece como una tarjeta estática (no expandible).

​
Acciones disponibles

Desde la página Accounting Routes, puedes:

Crear una Ruta contable

Define una nueva ruta de transacción con rutas de operación y escenarios contables.

Editar una Ruta contable

Modifica una ruta contable existente y sus rutas de operación.

​
Casos de uso comunes

Crea una Ruta contable con una ruta de operación bidirectional que valide los tipos de cuenta checking y savings. Habilita escenarios Direct Transaction con los códigos del plan de cuentas adecuados para los asientos de liquidación de Pix.
Crea una Ruta contable con rutas source y destination separadas. Habilita escenarios Two-Step Transaction para registrar de forma independiente los asientos de hold (reserva), commit (confirmación) y, opcionalmente, cancel (cancelación).
Crea una Ruta contable con una ruta de operación bidirectional que use validación por alias (@treasury_main). Habilita los escenarios Direct Transaction y Reversal para manejar los movimientos estándar y sus reversiones. Los asientos de Reversal requieren una ruta bidirectional.

​
Mejores prácticas

1

Usa títulos descriptivos

Nombra tus Rutas contables con claridad para indicar el tipo de transacción que manejan (por ejemplo, Pix Transfer Route en vez de Route 1).
2

Elige el tipo de operación correcto

Usa Bidirectional cuando las mismas reglas de validación se apliquen a ambos lados. Usa rutas Source y Destination separadas cuando cada lado tenga requisitos de cuenta distintos.
3

Configura los escenarios contables desde el inicio

Define los asientos de tu plan de cuentas durante la creación de la ruta. Esto asegura que las transacciones procesadas por la ruta generen registros contables correctos desde el principio.
4

Revisa antes de confirmar

El asistente incluye un paso de revisión. Úsalo para verificar todas las rutas de operación, las reglas de validación y los asientos contables antes de crear la ruta.