Uso de Fee Engine

​

Uso típico

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

​

Paso 1 - Crear sus paquetes de tarifas

Comience configurando paquetes de tarifas que definen cómo se aplican las tarifas. Para hacerlo, use el endpoint Crear un Package. Estos paquetes pueden personalizarse para diferentes grupos de cuentas o segmentos de clientes, con parámetros clave como:

• Plan de Cuentas – Especifica qué cuentas se ven afectadas.
• ID del Segmento – Identifica el grupo de clientes o negocio relevante.
• ID del Ledger – Vincula la estructura de tarifas a un Ledger específico.
• Rangos Min/Max – Umbrales opcionales que controlan la aplicación de tarifas.

Esta flexibilidad asegura que las tarifas se apliquen exactamente como se necesita para cada escenario único.

Gestión de Paquetes

Los siguientes endpoints también están disponibles para que gestione los paquetes:

• Listar Paquetes - Liste todos los paquetes creados.
• Recuperar un Paquete - Recupere información de un paquete específico.
• Actualizar un Paquete - Actualice la información de un paquete específico.
• Eliminar un Paquete - Eliminación suave de un paquete.

​

(opcional) Paso 2 - Crear una simulación

Si desea verificar las tarifas antes de crear la Transacción real, puede usar el endpoint Simular comisión por Transacción. Le ayuda a validar los cargos esperados antes del procesamiento.

​

Paso 3 - Crear una Transacción

Una vez que sus paquetes de tarifas estén en su lugar, cree una Transacción.

​

Paso 4 - El Fee Engine entra en acción

El sistema envía automáticamente una llamada al endpoint Calcular tarifas para un Package para evaluar y aplicar las reglas de tarifas. El Fee Engine verifica los paquetes de tarifas coincidentes basándose en lo siguiente:

• Plan de Cuentas
• Segment ID
• Ledger ID
• Condiciones de valor Min/Max

Solo los paquetes que cumplan con los criterios serán considerados para aplicar tarifas.

​

Paso 5 - Escenarios sin tarifas

El sistema verifica si la Transacción califica para una exención de tarifas:

• Exento: Si la Transacción califica para el estado libre de tarifas, el sistema devuelve un mensaje y no se aplican tarifas. La Transacción procede sin cambios.
• No exento: Si no hay exención, el sistema avanza con el cálculo y aplicación de las tarifas.

​

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

Cuando se aplican tarifas, el sistema:

• Calcula los montos de tarifas aplicables.
• Los aplica según las reglas en su paquete de tarifas.
• Devuelve los detalles de la Transacción y el ID del paquete de tarifas en el objeto de metadatos.

Las tarifas se enrutan a la creditAccount designada.

​

Paso 7 - Actualizaciones del Ledger

El componente Transactions toma el control, procesando débitos y créditos en el Ledger relevante. Cada movimiento—tarifas incluidas—se registra para trazabilidad y reportes.

​

Paso 8 - Revisar la Transacción

Finalmente, el usuario puede:

• Ver la Transacción.
• Inspeccionar todos los movimientos de tarifas.
• Verificar qué tarifas se aplicaron y cómo impactaron cada cuenta.