Usando Fees Engine

Ya sea que estés aplicando tarifas en producción o simulándolas con anticipación, Fees Engine ofrece control y flexibilidad total. Esta guía te lleva a través del ciclo de vida completo, desde la creación de paquetes hasta la revisión de resultados de tarifas.

​

Uso típico

Así es como funciona el proceso, desde la configuración de tarifas hasta ver los resultados.

​

Paso 1 - Crear tus paquetes de tarifas

Comienza configurando paquetes de tarifas que definen cómo se aplican las tarifas. Para hacerlo, usa el endpoint Create a Package. Cada paquete contiene un conjunto de reglas de tarifas y criterios de coincidencia. Puedes adaptar paquetes a diferentes segmentos o Ledgers usando:

• transactionRoute – Identifica la naturaleza de la transacción.
• segmentId – Agrupa clientes o tipos de productos.
• ledgerId – Define qué Ledger registra la transacción.
• Minimum y maximum amount – Umbrales opcionales para la aplicación de tarifas.
• routeFrom / routeTo – Define cómo se mueve cada tarifa a través de los flujos contables.

Esta flexibilidad te permite aplicar tarifas distintas por escenario, desde configuraciones basadas en cuentas hasta basadas en valor. Gestión de Paquetes Los siguientes endpoints también están disponibles para que gestiones los paquetes:

• List Packages - Lista todos los paquetes creados.
• Retrieve a Package - Recupera información de un paquete específico.
• Update a Package - Actualiza la información de un paquete específico.
• Delete a Package - Eliminación suave de un paquete.

​

(opcional) Paso 2 - Ejecutar una simulación

Si quieres previsualizar cómo se comportaría un paquete de tarifas antes de confirmar una transacción real, usa el endpoint Simular comisión por Transacción. Esta simulación ayuda a validar:

• Qué reglas de tarifas se activarán.
• Cómo se comportará el paquete con los valores dados.
• Si se aplican exenciones.

​

Paso 3 - Crear una transacción

Una vez que los paquetes estén configurados, activa la transacción real usando el endpoint create a transaction. Incluye el transactionRoute, segmentId y ledgerId apropiados para que el motor pueda evaluar el paquete coincidente.

​

Paso 4 - El Fees Engine entra en acción

Fees Engine envía automáticamente una llamada al endpoint Calculate Fees for a Package y evalúa si un paquete aplica basándose en:

• transactionRoute
• segmentId
• ledgerId
• Minimum y maximum amount
• waivedAccounts (para exenciones de tarifas)

​

Paso 5 - Verificar exenciones

El sistema verifica:

• Si el monto de la transacción está fuera del rango permitido.
• Si la cuenta de origen está exenta.

Si se cumple cualquiera de estas condiciones, no se aplican tarifas y la transacción procede normalmente.

​

Paso 6 - Cálculo y aplicación de tarifas

Si se aplica un paquete, Fees Engine:

• Calcula valores de tarifas basándose en la applicationRule seleccionada.
• Aplica tarifas proporcionalmente entre cuentas si es necesario.
• Usa isDeductibleFrom para definir si la tarifa se agrega o se deduce.
• Enruta tarifas a la creditAccount correcta usando el routeFrom y routeTo configurados.
• Devuelve el resultado completo de la transacción junto con el packageAppliedID en los metadatos.

​

Paso 7 - Actualizaciones del Ledger

Una vez que las tarifas se calculan, el componente Transactions toma el control. Procesa:

• Débitos de cuentas de origen
• Créditos a destinos de tarifas
• Desglose de tarifas por ruta y cuenta

Cada movimiento se almacena en el Ledger para trazabilidad y auditabilidad completas.

​

Paso 8 - Revisar y confirmar

Después de la ejecución, puedes:

• Inspeccionar la transacción final y los montos por cuenta.
• Confirmar el paquete de tarifas que se aplicó.
• Verificar todos los movimientos de tarifas a través de metadatos y registros del Ledger.

​

¿Por qué simular una transacción?

Las simulaciones te permiten previsualizar cómo se comporta un paquete de tarifas específico, sin ejecutar una transacción real ni escribir en el Ledger. Usa simulaciones cuando:

• Quieras probar un paquete específico.
• Estés depurando reglas de tarifas o umbrales.
• Quieras validar exenciones, rangos de valores o divisiones proporcionales.
• Necesites una vista previa antes de crear una transacción real.
• Estés construyendo una interfaz y quieras mostrar tarifas estimadas.

Fees Engine proporciona el endpoint Simular comisión por Transacción para este propósito. Solo tienes que pasar un packageId y el endpoint devuelve lo que sucedería si se aplicara ese paquete exacto.

​

¿Qué obtienes con una simulación?

• Una simulación completa de las reglas de tarifas.
• Qué cuentas serían cargadas.
• Cómo se dividiría la tarifa.
• Sin impacto en el Ledger.

​

Errores comunes

Fees Engine valida cada solicitud para asegurar consistencia y lógica correcta de tarifas. A continuación se muestran los problemas más frecuentes que puedes encontrar al crear paquetes o procesar transacciones.