- ¿Qué cuentas pueden actuar en el lado de origen?
- ¿Qué cuentas pueden actuar en el lado de destino?
- ¿Qué asientos de débito y crédito registra la ruta cuando se ejecuta la transacción?
Pix transfer puede exigir una cuenta customer en el lado de origen y una cuenta merchant en el lado de destino. Luego, la ruta define asientos directos de débito y crédito entre ellas. Cuando habilitas la validación de rutas, una transacción Pix que hace referencia a la ruta valida las cuentas y aplica las reglas configuradas.
Las Rutas contables ofrecen validación de rutas opcional. Midaz la aplica solo cuando habilitas la configuración de Ledger accounting.validateRoutes (el valor predeterminado es false). Cuando está habilitada, las transacciones deben hacer referencia a rutas válidas y las operaciones deben coincidir con las reglas configuradas. Las rutas son más fáciles de modelar cuando ya sabes qué cuentas representan a los clientes, la tesorería, las comisiones, la liquidación, los ingresos y los gastos.
Cómo encajan las piezas
Elegir el tipo de operación
Usa Source cuando la regla se aplique solo al lado de envío
Usa Source cuando la regla se aplique solo al lado de envío
Usa Source para cuentas donde se origina el valor.Ejemplo: una cuenta de cliente puede enviar fondos en un flujo de pago.
Usa Destination cuando la regla se aplique solo al lado de recepción
Usa Destination cuando la regla se aplique solo al lado de recepción
Usa Destination para cuentas donde llega el valor.Ejemplo: una cuenta de comerciante puede recibir fondos en un flujo de pago.
Usa Bidirectional cuando la misma regla se aplique a ambos lados
Usa Bidirectional cuando la misma regla se aplique a ambos lados
Usa Bidirectional cuando la misma clase de cuenta pueda enviar y recibir.Ejemplo: las cuentas corrientes pueden transferir valor a otras cuentas corrientes.
Una ruta debe incluir una ruta de operación Source y una Destination, o al menos una ruta de operación Bidirectional.
Elegir la regla de validación
Una ruta de operación puede incluir opcionalmente una regla de cuenta (Account Types registrados o un
@Alias). Midaz aplica una regla presente cuando habilitas la validación de rutas. Usa la validación por Account Type para flujos escalables. Usa la validación por alias para cuentas operativas fijas, como cuentas de tesorería, comisión, liquidación o suspensión.
Patrones comunes de rutas
De cliente a comerciante
Usa rutas Source y Destination separadas cuando cada lado tenga un rol distinto.Transferencia entre pares
Usa una ruta Bidirectional cuando el mismo tipo de cuenta pueda ser tanto origen como destino.Cobro de comisiones
Usa una ruta Destination con validación por alias cuando las comisiones deban llegar siempre a una cuenta operativa fija.Escenarios contables
Páginas disponibles
Configurar la contabilidad en la Console
Una guía paso a paso, centrada en la Console, para construir tu modelo contable, desde el plan de cuentas hasta un pago Pix funcional. No requiere llamadas a la API.
Gestionar Rutas contables
Configura rutas contables con reglas de operación y escenarios contables en un asistente unificado.