Skip to main content
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 tarifas de tu configuración
Selecciona un paquete de la lista para abrir su vista de detalles. Ahí puedes revisar la configuración del paquete (tipo, alcance y reglas) 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 tarifas en el Módulo Midaz, trabajas con estos campos:

​
Información básica

  • Fee Group Label (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

​
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 tarifas puede contener varias reglas de comisión con:
  • Fee Label - Nombre que identifica esta comisión
  • Application Rule - Cómo calcula Fees Engine la comisión:
    • flatFee - Monto fijo sin importar el valor de la transacción
    • percentual - Porcentaje del monto de la transacción
    • maxBetweenTypes - 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)
  • Is Deductible From - Si Fees Engine deduce esta comisión de la transacción
  • Credit Account - 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:
  • Application Rule: flatFee
  • Calculation: flat con valor 2.50
  • Example: comisión de 2.50encadatransaccioˊnentre2.50 en cada transacción entre 10 y $1000
Cobra un porcentaje del monto de la transacción:
  • Application Rule: percentual
  • Calculation: percentage con valor 1.5
  • Example: comisión del 1.5% en transferencias, donde una transferencia de 100=comisioˊnde100 = comisión de 1.50
Crea varios paquetes con distintos rangos de montos:
  • Paquete 1: 0−0-100 → comisión del 2%
  • Paquete 2: 100−100-1000 → comisión del 1.5%
  • Paquete 3: $1000+ → 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:
  • Application Rule: maxBetweenTypes
  • Calculations: flat: 1.00 y percentage: 2.0
  • Example: en una transacción de 30:max(30: max(1.00, 0.60)=comisioˊnde0.60) = comisión de 1.00
  • Example: en una transacción de 100:max(100: max(1.00, 2.00)=comisioˊnde2.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 tarifas 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. Identifica los paquetes de tarifas aplicables según la ruta de transacción y el segmento
  2. Filtra los paquetes por rango de montos (la transacción debe estar dentro del mínimo/máximo)
  3. Verifica si la cuenta está en la lista de 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 tarifas para que se aplique a las transacciones. Para pausar un paquete, deshabilítalo. Un paquete deshabilitado permanece en tu configuración.