Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt

Use this file to discover all available pages before exploring further.

Los Paquetes de Tarifas son los bloques de construcción del Fees Engine. Cada paquete define un conjunto de Reglas de tarifas y las condiciones bajo las cuales se aplican a las Transacciones.
El plugin Fees Engine debe estar habilitado en la configuración de Midaz Module para que esta página esté disponible.

​
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 se aplican 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 y selecciona Fee Packages. La página lista todos los paquetes configurados.
Si no tienes ningún Paquete de Tarifas, la lista aparecerá vacía con 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

​
Entender la estructura de un Paquete de Tarifas

Al crear o editar un paquete de tarifas en Midaz Module, trabajarás con:

​
Información básica

  • Fee Group Label (requerido) - Un nombre descriptivo para el paquete de tarifas
  • Description (requerido) - 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 específica
  • Application Rule - Cómo se 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 aplicar otras tarifas
  • Priority - Orden de aplicación de la tarifa (los números más bajos se aplican primero)
  • Is Deductible From - Si esta tarifa se deduce 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 incurrir en 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 verificar los cálculos antes de habilitar los paquetes en producción.
5

Gestiona la prioridad cuidadosamente

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

Documenta las cuentas exentas

Mantén registro de por qué ciertas cuentas están exentas de tarifas para fines de auditoría y cumplimiento.

​
Flujo de cálculo de tarifas

Cuando se procesa una transacción, Fees Engine:
  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 de origen 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
Los paquetes de tarifas deben estar habilitados para aplicarse a las transacciones. Puedes deshabilitar paquetes temporalmente sin eliminarlos.