Skip to main content
Los Fee Packages son la unidad base del Fees Engine. Cada paquete define un conjunto de Reglas de tarifas y las condiciones bajo las cuales se aplican a las Transacciones.
Habilita el Fees Engine en la configuración de Midaz Module antes de usar esta página.

​
Qué contiene un Paquete de Tarifas

Un Paquete de Tarifas te permite:
  • Definir reglas de cálculo de tarifas — tarifas planas, tarifas basadas en porcentaje o cálculos combinados.
  • Establecer rangos de importes — aplicar tarifas solo a transacciones dentro de un rango mín/máx.
  • Vincular a Rutas de Transacción — apuntar a flujos de transacción específicos.
  • Eximir tarifas para cuentas específicas — excluir cuentas de origen seleccionadas.
  • Priorizar la aplicación de tarifas — controlar el orden en que el Fees Engine aplica varias tarifas.
Los Paquetes de Tarifas se combinan con Rutas Contables y Segmentos para un control granular.

​
Acceder a la página Fee Packages

En la barra lateral de Midaz Module, expande Fees Engine. Selecciona Fee Packages. La página lista todos los paquetes configurados.
Si no tienes ningún Paquete de Tarifas, la lista está vacía y muestra una indicación para crear tu primer paquete.

​
Acciones disponibles

Desde la página Fee Packages, puedes:

Crear un Paquete de Tarifas

Define nuevas reglas de cálculo de tarifas para transacciones

Editar un Paquete de Tarifas

Actualiza configuraciones y reglas de tarifas

Eliminar un Paquete de Tarifas

Elimina un paquete de tarifas de tu configuración
Selecciona un paquete de la lista para abrir su vista de detalles. Allí puedes revisar la configuración del paquete — tipo, alcance y reglas — antes de editarlo. Para previsualizar las tarifas que un período genera entre los paquetes, usa los Billing Runs.

​
Entender la estructura de un Paquete de Tarifas

Cuando creas o editas un paquete de tarifas en Midaz Module, trabajas con estos campos:

​
Información básica

  • Fee Group Label (requerido) - Un nombre descriptivo para el paquete de tarifas
  • Description (opcional) - Explicación del propósito del paquete y cuándo aplica
  • Transaction Route (opcional) - Vincula a una Ruta de Transacción específica
  • Segment (opcional) - Asocia con un Segmento específico
  • Ledger (requerido) - El Ledger al que aplica este paquete

​
Rango de importe

  • Minimum Amount (requerido) - Importe de transacción más bajo para aplicar la tarifa
  • Maximum Amount (requerido) - Importe de transacción más alto para aplicar la tarifa
  • Waived Accounts (opcional) - Lista de alias de cuentas exentos de estas tarifas

​
Reglas de tarifas

Cada paquete de tarifas puede contener varias Reglas de tarifas con:
  • Fee Label - Nombre que identifica esta tarifa
  • Application Rule - Cómo el Fees Engine calcula la tarifa:
    • flatFee - Importe fijo independiente del valor de la transacción
    • percentual - Porcentaje del importe de la transacción
    • maxBetweenTypes - El valor más alto entre el cálculo plano y el porcentaje
  • Calculation Type - flat o percentage
  • Calculation Value - El importe o porcentaje de la tarifa
  • Reference Amount - Base para el cálculo del porcentaje:
    • originalAmount - Calcular sobre el valor original de la transacción
    • afterFeesAmount - Calcular después de que el Fees Engine aplica otras tarifas
  • Priority - Orden de aplicación de la tarifa (los números más bajos se aplican primero)
  • Is Deductible From - Si el Fees Engine deduce esta tarifa de la transacción
  • Credit Account - Cuenta que recibe el importe de la tarifa

​
Casos de uso comunes

Aplica una tarifa fija a todas las transacciones dentro de un rango de importes:
  • Application Rule: flatFee
  • Calculation: flat con valor 2.50
  • Ejemplo: Tarifa de 2.50encadatransaccioˊnentre2.50 en cada transacción entre 10 y $1000
Cobra un porcentaje del importe de la transacción:
  • Application Rule: percentual
  • Calculation: percentage con valor 1.5
  • Ejemplo: Tarifa del 1.5% sobre transferencias, donde una transferencia de 100=100 = 1.50 de tarifa
Crea múltiples paquetes con diferentes rangos de importe:
  • Paquete 1: 0−0-100 → 2% de tarifa
  • Paquete 2: 100−100-1000 → 1.5% de tarifa
  • Paquete 3: $1000+ → 1% de tarifa
  • Tarifas más bajas para transacciones de mayor valor
Aplica el valor más alto entre plano y porcentaje:
  • Application Rule: maxBetweenTypes
  • Calculations: flat: 1.00 y percentage: 2.0
  • Ejemplo: En transacción de 30:max(30: max(1.00, 0.60)=0.60) = 1.00 de tarifa
  • Ejemplo: En transacción de 100:max(100: max(1.00, 2.00)=2.00) = 2.00 de tarifa
Exime cuentas específicas de las tarifas:
  • Crea el paquete con reglas de tarifa estándar
  • Añade los alias de cuentas premium a la lista Waived Accounts
  • Estas cuentas transaccionan sin las tarifas configuradas

​
Buenas prácticas

1

Planifica tu estructura de tarifas

Diseña tus paquetes de tarifas antes de implementarlos. Considera los tipos de transacción, rangos de importe y segmentos de cliente que requieran tratamientos de tarifa diferentes.
2

Usa etiquetas descriptivas

Elige etiquetas y descripciones claras para el fee group que expliquen cuándo y por qué aplican las tarifas. Esto ayuda en auditoría y comunicación con clientes.
3

Define rangos de importe adecuados

Define cuidadosamente los importes mínimo y máximo para evitar vacíos o solapamientos en tu estructura de tarifas.
4

Prueba los cálculos de tarifas

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

Gestiona la prioridad cuidadosamente

Cuando uses varias tarifas en un paquete, establece prioridades para que el Fees Engine aplique las tarifas en el orden correcto.
6

Documenta las cuentas exentas

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

​
Flujo de cálculo de tarifas

Cuando el 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 importe (la transacción debe caer dentro del mín/máx)
  3. Verifica si la cuenta está en la lista de Waived Accounts
  4. Aplica las Reglas de tarifas en orden de Prioridad
  5. Calcula cada tarifa según la Application Rule y el Reference Amount
  6. Acredita los importes de las tarifas en 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.