Saltar al contenido principal
Usa el Módulo Midaz para gestionar Rutas Contables, la configuración para el enrutamiento de transacciones en Midaz. Un asistente guiado de 3 pasos te lleva a través de la definición de la Ruta Contable, la adición de Rutas de Operación y la revisión de la configuración final.

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.
Una Ruta Contable define la lógica completa de enrutamiento de una transacción: los metadatos a nivel de transacción (título y descripción), las rutas de operación que especifican qué cuentas participan y en qué dirección, y los escenarios contables que controlan cómo se registran los asientos para diferentes tipos de transacció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 se asigna a uno de tres tipos:
  • Source — Define reglas de validación para las cuentas de donde se originan los fondos (lado débito)
  • Destination — Define reglas de validación para las cuentas a donde se envían los fondos (lado crédito)
  • Bidirectional — Se aplica a ambos lados de la transacción, actuando 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.
Como una ruta bidireccional funciona como origen y destino, se considera en ambos lados cuando se crea 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 usando 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 se registran los asientos de débito y crédito para cada ruta de operación. Puedes configurar asientos para cuatro 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:
    • Value Reserve — Asientos registrados cuando se reservan los fondos
    • Reservation Confirmation — Asientos registrados cuando se confirma la reserva
    • Reservation Cancellation — Asientos registrados si la reserva es cancelada
  • Reversal — Asientos registrados cuando se revierte 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; al activarlo se activa automáticamente el escenario Direct.
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 todas las fases. Asientos de crédito solo en Reserva de Valor y Cancelación (no en Transacción Directa ni Confirmación).
  • Destination — Solo asientos de crédito, mostrados en Transacción Directa y Confirmación. Las fases de Reserva de Valor y Cancelación no están disponibles.
  • Bidirectional — Asientos de débito y crédito en todas las fases, incluyendo Reversión.

​
Acceder a la página de Rutas Contables

El menú de Accounting Routes solo es visible cuando la configuración Validate Routes está habilitada 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 llegas a esta página por URL con Validate Routes desactivado, aparece un banner informativo en la parte superior de la pantalla. El Ledger aún no procesa las Rutas Contables registradas aquí; los asientos solo siguen estas reglas después de que habilites la validación de Accounting Routes en los ajustes del Ledger. Aún puedes ver y editar las rutas, pero no tienen efecto hasta que se habilite 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 Contables del Ledger actual como una lista de tarjetas-acordeón: cada Ruta de Transacción es una tarjeta plegable que 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 las rutas de operación asociadas, cada una mostrando su ID, título, código y tipo de operación. Los tipos de operación se distinguen por color — origen en rojo, destino en verde y bidireccional en gris. Una ruta sin rutas de operación se muestra 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 origen usando validación por alias (@treasury_main) y una ruta de destino para tipos de cuenta department_budget. Habilita tanto los escenarios de Transacción Directa como de Reversión para manejar movimientos estándar y sus reversiones.

​
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.