Crear una Ruta Contable

Construye una Ruta Contable con el asistente de la Console para definir cómo se enrutan las Transacciones y sus operaciones entre Cuentas del Ledger.

Creas una Ruta Contable a través de un asistente guiado de 3 pasos. El asistente te lleva por la Ruta de Transacción, las Rutas de Operación con sus escenarios contables y una revisión final.

​

Antes de empezar

---

Crea los Tipos de Cuenta y las Cuentas que la ruta valida. Si todavía no has elegido el Operation Type, el Validation Type y los escenarios contables, lee primero Reglas contables.

Si habilitas Validate Routes para el Ledger, cada transacción debe coincidir con una ruta existente. No habilites la validación de rutas hasta que las Rutas Contables necesarias estén listas.

​

Paso 1: Información básica

---

1. Desde la página Accounting Routes, haz clic en New Route.

2. El asistente de creación se abre en el Paso 1 — Información básica.

3. Completa la información básica:

   • Title (obligatorio): un nombre descriptivo para esta Ruta de Transacción. Debes completar este campo para continuar.
   • Description (opcional): una descripción del propósito de la ruta. Si la dejas vacía, el asistente envía un valor de descripción vacío.
4. Haz clic en Next para avanzar al Paso 2.

​

Paso 2: Rutas de Operación

---

En este paso, añades y configuras las Rutas de Operación. Las Rutas de Operación definen cómo el ledger valida las cuentas y registra los asientos contables.

Una Ruta de Operación Bidirectional actúa como origen y destino. Cuando luego creas una transacción, el ledger considera una ruta bidireccional en ambos lados, origen y destino. Una sola ruta puede entonces validar los dos extremos del flujo.

1. Haz clic en Add Operation Route para crear tu primera tarjeta de Ruta de Operación.

2. Configura la Ruta de Operación:

   • Title (obligatorio): un nombre para esta Ruta de Operación. La Ruta de Operación tiene un único campo de texto obligatorio y ningún campo de descripción separado. No puedes avanzar al siguiente paso hasta que lo completes.
   • Operation Type: Source, Destination o Bidirectional.
   • Validation Type: Configura opcionalmente Account Type o @Alias para validar cuentas. Una Ruta de Operación puede omitir la regla de validación de cuentas.
   • Account Type or Alias: los valores de Tipo de Cuenta seleccionados o el alias de cuenta específico.
3. (Opcional) Configura los Accounting Scenarios para definir cómo el ledger registra los asientos. Activa los escenarios que necesites:

   Direct Transaction

   Transacción estándar de un solo paso. Define el Account Code y la Description para:

   • Debit — El código de cuenta debitado en la ejecución
   • Credit — El código de cuenta acreditado en la ejecución

   En las Direct Transactions, los lados que aparecen dependen del Operation Type. Las rutas Source muestran solo débito, las rutas Destination muestran solo crédito, y las rutas Bidirectional muestran ambos. Otros escenarios pueden diferir — consulta la pestaña Two-Step Transaction para más detalles.

   Two-Step Transaction

   Transacciones con un ciclo de retención y confirmación. Configura los asientos para cada fase:

   • Hold (Value Reserve) — Asientos que registran los fondos reservados
   • Commit (Reservation Confirmation) — Asientos que confirman la reserva
   • Cancel (Reservation Cancellation) — Asientos que cancelan la reserva. Completa también estos campos: el ledger valida Hold, Commit y Cancel como un grupo atómico y rechaza la ruta cuando falta el mapeo de Cancel.

   Los campos de asiento disponibles varían según el Operation Type:

   • Source — Hold y Cancel muestran los campos de débito y crédito. Commit muestra solo débito.
   • Destination — Solo aparece la fase Commit, con crédito únicamente. Hold y Cancel no están disponibles.
   • Bidirectional — Todas las fases muestran los campos de débito y crédito.

   Reversal

   Asientos que registran la reversa de una transacción completada. Define los códigos de cuenta de débito y crédito y las descripciones para los asientos de reversa.

   El escenario Reversal solo está disponible para Rutas de Operación Bidirectional.

   Overdraft

   Asientos que aplican cuando un débito excede los fondos disponibles de la cuenta y recurre a una línea de sobregiro. Define los códigos de cuenta de débito y crédito y las descripciones para el uso del sobregiro y su posterior reembolso.

   Overdraft está disponible para las Rutas de Operación Source, Destination y Bidirectional. Cuando activas Overdraft, el asistente también activa el escenario Direct, porque el uso del sobregiro se liquida mediante un asiento directo.

   Block

   Asientos que registran el bloqueo y desbloqueo de fondos en una cuenta. Configura dos secciones independientes, Block y Unblock. Cada sección es de todo o nada: déjala vacía para usar los asientos por defecto, o completa el código de cuenta y la descripción de cada lado visible.

   Block está disponible para todos los Operation Types. Las rutas Source muestran solo asientos de débito, las rutas Destination muestran solo asientos de crédito y las rutas Bidirectional muestran ambos.

4. (Opcional) Haz clic de nuevo en Add Operation Route para añadir más Rutas de Operación a esta Ruta Contable.

   Debes añadir al menos una Ruta de Operación de origen y una de destino, o al menos una ruta bidireccional. El asistente no continuará sin una configuración de ruta válida.

5. Haz clic en Next para avanzar al Paso 3.

​

Paso 3: Revisión

---

1. Revisa la configuración completa:

   • Título y descripción de la Ruta de Transacción
   • Cada Ruta de Operación con su tipo, reglas de validación y asientos contables
   • Accounting Scenarios con asientos de débito y crédito por tipo de transacción
2. Para ajustar algo, haz clic en Previous para volver atrás.

3. Haz clic en Create Transaction Route para crear la Ruta Contable.

​

Guía de campos

---

​

Información básica

Campo	Qué introducir	Ejemplo
Route Title	Nombre obligatorio de la ruta. Mantenlo breve y específico al flujo de negocio.	Pix Transfer Route
Description	Explicación opcional de lo que la ruta valida o registra.	Handles Pix transfers between customer accounts.

​

Ruta de Operación

Campo	Qué introducir	Ejemplo
Title	Nombre obligatorio de esta tarjeta de Ruta de Operación. Debe completarse para avanzar; no hay campo de descripción separado.	Checking account validation for Pix
Type	Lado contable al que aplica esta Ruta de Operación: Source, Destination o Bidirectional. No puede cambiarse tras la creación.	Bidirectional
Validation Type	Regla opcional de validación de cuentas. Usa Account Type para clases de cuenta o @Alias para una cuenta específica. Una Ruta de Operación puede omitir esta regla.	Account Type
Account Type or Alias	Tipos de Cuenta o alias aceptados por esta Ruta de Operación.	customer
Accounting Scenarios	Escenarios de transacción que esta ruta debe registrar: Direct, Two-Step, Reversal, Overdraft o Block.	Direct Transaction
Account Code	Código contable usado en el asiento de débito o crédito del escenario seleccionado.	1.1.1.001
Entry Description	Descripción a nivel de asiento mostrada en la configuración del escenario.	Customer checking - outbound

​

Ejemplo rápido

---

Transferencia Pix con escenarios Direct y Two-Step

Transaction Route

Campo	Valor
Title	Pix Transfer Route
Description	Handles Pix instant transfers between checking accounts

Ruta de Operación 1 — Bidirectional

Campo	Valor
Title	Checking account validation for Pix
Operation Type	Bidirectional
Validation Type	Account Type
Account Types	checking

Escenario Direct Transaction

Lado	Account Code	Descripción
Debit	1.1.1.001	Customer checking — outbound
Credit	1.1.1.002	Customer checking — inbound

Two-Step Transaction — Hold

Lado	Account Code	Descripción
Debit	1.1.1.001	Customer checking — reserve
Credit	2.1.1.001	Pending settlement — hold

Two-Step Transaction — Commit

Lado	Account Code	Descripción
Debit	2.1.1.001	Pending settlement — release
Credit	1.1.1.002	Customer checking — settled

​

Qué hacer a continuación

---

Tras crear la ruta, crea una transacción que coincida con los mismos Tipos de Cuenta, alias y escenario en Crear una Transacción.

Create Transaction Route

Crea la ruta a nivel de transacción mediante la API.

Create Operation Route

Crea reglas de enrutamiento a nivel de operación mediante la API.