Saltar al contenido principal
Los Fee Packages son la unidad base del Fees Engine. Cada paquete define un conjunto de reglas de comisión y las condiciones bajo las cuales se aplican a las Transacciones.
Habilita el Fees Engine en la configuración del módulo de Midaz antes de usar esta página.

​
Qué contiene un Fee Package

Un Fee Package permite:
  • Definir reglas de cálculo de comisiones: comisiones fijas, comisiones porcentuales o cálculos combinados.
  • Establecer rangos de montos: aplicar comisiones solo a transacciones dentro de un rango mínimo/máximo.
  • Vincular a rutas de transacción: dirigir la comisión a flujos de transacción específicos.
  • Eximir de comisiones a cuentas específicas: exceptuar cuentas de origen seleccionadas.
  • Priorizar la aplicación de comisiones: controlar el orden en que Fees Engine aplica varias comisiones.
Los Fee Packages se combinan con Rutas Contables y Segmentos para un control granular.

​
Acceder a la página de Fee Packages

En la barra lateral del Módulo Midaz, expande Fees Engine. Selecciona Fee Packages. La página lista todos los paquetes configurados.
Si no tienes Fee Packages, la lista aparece vacía y muestra una indicación para crear tu primer paquete.

​
Acciones disponibles

Desde la página de Fee Packages, puedes:

Crear un Fee Package

Define nuevas reglas de cálculo de comisiones para las transacciones

Editar un Fee Package

Actualiza las configuraciones y reglas de comisión

Eliminar un Fee Package

Elimina un paquete de comisiones de tu configuración
Selecciona un paquete de la lista para abrir su vista de detalles. Ahí puedes revisar la configuración del paquete (alcance, rango de montos y reglas de comisión) antes de editarlo. Para previsualizar las comisiones que un período genera en todos los paquetes, usa Billing Runs.

​
Cómo entender la estructura de un Fee Package

Cuando creas o editas un paquete de comisiones en el Módulo Midaz, trabajas con estos campos:

​
Información básica

  • Fee Package Name (obligatorio) - Un nombre descriptivo para el paquete
  • Description (opcional) - Explicación del propósito del paquete y cuándo se aplica
  • Transaction Route (opcional) - Vínculo a una ruta de transacción específica
  • Segment (opcional) - Asociación con un segmento específico
  • Ledger (obligatorio) - El ledger al que se aplica este paquete
  • Metadata selector (opcional) - Pares de metadatos que una transacción debe llevar para que se aplique el paquete. Los defines solo al crear el paquete

​
Rango de montos

  • Minimum Amount (obligatorio) - Monto de transacción más bajo para la aplicación de la comisión
  • Maximum Amount (obligatorio) - Monto de transacción más alto para la aplicación de la comisión
  • Waived Accounts (opcional) - Lista de alias de cuenta exentos de estas comisiones

​
Reglas de comisión

Cada paquete de comisiones puede contener varias reglas de comisión con:
  • El campo de nombre de la comisión (placeholder Display Name) - Nombre que identifica esta comisión
  • La tarjeta de tipo de comisión - Cómo calcula Fees Engine la comisión:
    • Flat Fee - Monto fijo sin importar el valor de la transacción
    • Percentage Fee - Porcentaje del monto de la transacción
    • Max between types - El valor más alto entre los cálculos fijo y porcentual
  • Calculation Type - flat o percentage
  • Calculation Value - El monto o porcentaje de la comisión
  • Reference Amount - Base para el cálculo porcentual:
    • originalAmount - Calcular sobre el valor original de la transacción
    • afterFeesAmount - Calcular después de que Fees Engine aplique otras comisiones
  • Priority - Orden de aplicación de la comisión (los números más bajos se aplican primero)
  • Deductible from transaction? - Si Fees Engine deduce esta comisión de la transacción
  • Deferrable - Si la parte de esta comisión que el pagador no puede cubrir puede convertirse en una deuda de comisión
  • Credit Account ID - Cuenta que recibe el monto de la comisión

​
Casos de uso comunes

Aplica una comisión fija a todas las transacciones dentro de un rango de montos:
  • Tipo de comisión: Flat Fee
  • Calculation: flat con valor 2.50
  • Example: comisión de $2.50 en cada transacción entre $10 y $1000
Cobra un porcentaje del monto de la transacción:
  • Tipo de comisión: Percentage Fee
  • Calculation: percentage con valor 1.5
  • Example: comisión del 1.5% en transferencias, donde una transferencia de $100 = comisión de $1.50
Crea varios paquetes con distintos rangos de montos:
  • Paquete 1: $0-$100 → comisión del 2%
  • Paquete 2: $100.01-$1000 → comisión del 1.5%
  • Paquete 3: $1000.01+ → comisión del 1%
  • Comisiones más bajas para transacciones de mayor valor
Aplica el que sea más alto entre el fijo y el porcentual:
  • Tipo de comisión: Max between types
  • Calculations: flat: 1.00 y percentage: 2.0
  • Example: en una transacción de $30: max($1.00, $0.60) = comisión de $1.00
  • Example: en una transacción de $100: max($1.00, $2.00) = comisión de $2.00
Exime cuentas específicas de comisiones:
  • Crea el paquete con reglas de comisión estándar
  • Agrega los alias de cuentas premium a la lista Waived Accounts
  • Estas cuentas transaccionan sin las comisiones configuradas

​
Mejores prácticas

1

Planifica tu estructura de comisiones

Diseña tus paquetes de comisiones antes de la implementación. Considera los tipos de transacción, los rangos de montos y los segmentos de clientes que requieren un tratamiento de comisión diferente.
2

Usa etiquetas descriptivas

Elige etiquetas de grupo de comisión y descripciones claras que expliquen cuándo y por qué se aplican las comisiones. Esto ayuda con la auditoría y la comunicación con el cliente.
3

Establece rangos de montos adecuados

Define los montos mínimo y máximo con cuidado para evitar vacíos o superposiciones en tu estructura de comisiones.
4

Prueba los cálculos de comisión

Usa la función Fee Estimation para previsualizar los cálculos de comisión antes de habilitar los paquetes en producción.
5

Gestiona la prioridad con cuidado

Cuando uses varias comisiones en un paquete, establece las prioridades para que las comisiones se apliquen en el orden correcto.
6

Documenta las cuentas exentas

Registra por qué eximes de comisiones a ciertas cuentas. Esto respalda la auditoría y el cumplimiento.

​
Flujo de cálculo de comisiones

Cuando Fees Engine procesa una transacción:
  1. Encuentra los paquetes habilitados que coinciden con la ruta de transacción, el segmento, el selector de metadatos y el rango de montos
  2. Conserva la coincidencia más específica, así que se aplica como máximo un paquete
  3. Omite las cuentas exentas
  4. Aplica las reglas de comisión en orden de prioridad
  5. Calcula cada comisión según la regla de aplicación y el monto de referencia
  6. Acredita los montos de comisión a las cuentas designadas
Habilita un paquete de comisiones para que se aplique a las transacciones. Para pausar un paquete, deshabilítalo. Un paquete deshabilitado permanece en tu configuración.