Skip to main content
Usa el Módulo Midaz para gestionar Rutas Contables, la configuración para el enrutamiento de transacciones en Midaz. Un asistente guiado te lleva por tres pasos: define la Ruta de Transacción, agrega las Rutas de Operación y revisa la configuración. Una Ruta Contable define la lógica completa de enrutamiento de una transacción. Tiene tres partes:
  • Los metadatos a nivel de transacción — el título y la descripción.
  • Las rutas de operación — definen 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

Comienza aquí si necesitas decidir entre usar escenarios de Origen, Destino, Bidireccional, validación por Tipo de Cuenta, validación por alias, Directa, Dos Pasos o Reversión.
Para más detalles técnicos sobre las entidades subyacentes, consulta la página de Entidades de Rutas Contables.

​
Conceptos clave

​
Tipos de rutas de operación

Cada ruta de operación dentro de una Ruta Contable tiene uno de tres tipos:
  • Source — Define reglas de validación para las cuentas donde se originan los fondos (lado débito)
  • Destination — Define 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 destino
Una Ruta Contable válida requiere al menos una ruta de operación de origen y una de destino, o al menos una ruta bidireccional.
Una ruta bidireccional funciona como origen y destino. Midaz la considera en ambos lados cuando creas una transacción. Aparece tanto en la lista de rutas de origen como en la de destino, de modo que una sola ruta puede cubrir los dos extremos de un flujo.

​
Tipos de validación

Cada ruta de operación valida cuentas por uno de dos métodos:
  • Account Type — Valida contra una o más categorías de tipo de cuenta (por ejemplo, checking, savings). Úsalo cuando cualquier cuenta de un cierto tipo sea válida.
  • @Alias — Valida contra un alias de cuenta específico (por ejemplo, @treasury_main). Úsalo 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 reserva y confirmación. Configura asientos para:
    • Hold (Reserva de Valor) — Asientos registrados cuando el ledger reserva los fondos
    • Commit (Confirmación de Reserva) — Asientos registrados cuando confirmas la reserva
    • Cancel (Cancelación de Reserva) — 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 las Rutas de Operación Source y Bidirectional, y requiere ambos asientos, de débito y de crédito, en cada tipo de ruta compatible. Cuando lo activas, Midaz también activa el escenario Direct.
  • Block/Unblock — Asientos registrados cuando retienes y liberas fondos en el saldo de la cuenta. La pestaña del escenario se etiqueta Block. Disponible para todos los tipos de ruta de operación.
Cada asiento de escenario incluye un Account Code y una Description tanto para el lado débito como para el 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 crédito en todas las fases, incluyendo Reversal.
  • Block/Unblock — Disponible para todos los tipos de ruta. Retiene y libera fondos en el saldo de la cuenta.

​
Acceder a la página de Rutas Contables

El menú de 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.
Accounting Routes validation disabled — Si abres esta página por URL con Validate Routes desactivado, aparece un banner en la parte superior de la pantalla. El Ledger aún no procesa las Rutas Contables registradas aquí. Los asientos siguen estas reglas solo después de que habilites Validate Routes en los ajustes del Ledger. Aún puedes ver y editar las 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-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 conteo 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 Consola distingue los tipos de operación por color: origen en rojo, destino en verde y bidireccional 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

Definir una nueva Ruta Contable con Rutas de Operación y escenarios contables.

Editar una Ruta Contable

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

​
Casos de uso comunes

Crea una Ruta Contable con una ruta de operación bidireccional que valide los tipos de cuenta checking y savings. Habilita escenarios de Transacción Directa con los códigos de plan de cuentas apropiados para los asientos de liquidación Pix.
Crea una Ruta Contable con rutas de origen y destino separadas. Habilita escenarios de Transacción en Dos Pasos para registrar los asientos de reserva de valor, confirmación de reserva y cancelación de reserva opcional de forma independiente.
Crea una Ruta Contable con una ruta de operación bidireccional que use validación por alias (@treasury_main). Habilita los escenarios de Transacción Directa y Reversión para manejar movimientos estándar y sus reversiones. Los asientos de reversión requieren una ruta bidireccional.

​
Mejores prácticas

1

Usa títulos descriptivos

Nombra tus Rutas Contables de forma clara para indicar el tipo de transacción que manejan (por ejemplo, Pix Transfer Route en lugar 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 de Source y Destination separadas cuando cada lado tenga diferentes requisitos de cuenta.
3

Configura los escenarios contables temprano

Define tus asientos del plan de cuentas durante la creación de la ruta. Esto asegura que las transacciones procesadas a través de la ruta produzcan registros contables correctos desde el inicio.
4

Revisa antes de confirmar

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