Fee Engine

​

¿Por qué usar Fee Engine?

El plugin Fee Engine te ayuda a gestionar fácilmente la lógica compleja de tarifas. Ya sea que estés aplicando una tarifa fija, distribuyendo tarifas proporcionalmente o simulando transacciones por adelantado, este plugin está diseñado para flexibilidad y escala. Esto es lo que desbloquea:

• Configuración flexible de tarifas mediante paquetes de tarifas, adaptados a grupos de cuentas o ledgers específicos.
• Múltiples métodos de cálculo: tarifas fijas, tasas porcentuales y lógica de “máximo entre tipos”.
• Distribución proporcional de tarifas para flujos de marketplace y operaciones con múltiples cuentas.
• Herramientas de simulación para previsualizar cálculos antes de ejecutar transacciones.
• Rangos personalizables sin tarifas y configuraciones basadas en cuentas.
• Aplicación basada en prioridad para controlar el orden en que se aplican múltiples tarifas.

​

¿Qué son las tarifas?

Las tarifas son valores monetarios cobrados a cambio de servicios, productos o acceso. Su propósito depende de la industria, pero la necesidad de claridad y consistencia es universal. A continuación se presentan solo algunos ejemplos:

​

Finanzas

En el sector financiero, las tarifas se aplican para cubrir costos operativos y garantizar el cumplimiento legal.

• Tarifa de mantenimiento de cuenta: Cubre el costo de mantener y gestionar cuentas bancarias.
• Tarifa de transferencia: Cubre el costo de realizar transferencias, como TEDs o transferencias internacionales.

​

Logística y transporte

En el sector logístico, las tarifas están relacionadas con el uso de servicios de transporte y almacenamiento.

• Tarifa de manipulación: Cubre el costo de mover mercancías en almacenes o durante el transporte.
• Tarifa de descarga: Cubre el costo de descargar mercancías en puertos o terminales.

​

Farmacéutico y salud

En el sector farmacéutico, las tarifas tienen como objetivo garantizar la calidad y regulación de los servicios.

• Tarifa de registro de medicamentos: Cubre el costo de aprobación y registro de medicamentos con autoridades reguladoras.
• Tarifa de análisis de laboratorio: Cubre los costos de análisis y control de calidad de productos farmacéuticos.

​

Agrícola

En el sector agrícola, las tarifas están vinculadas a procesos de comercialización y regulatorios.

• Tarifa de inspección sanitaria: Cubre los costos de inspeccionar y certificar productos agrícolas y ganaderos.
• Tarifa de exportación agrícola: Cubre los costos administrativos y regulatorios para exportar productos agrícolas.

​

Paquetes de Tarifas

Un Fee Package es una estructura configurable que define cómo se calculan y aplican las tarifas en operaciones bancarias. Los paquetes pueden personalizarse por grupo de cuentas o caso de uso, haciéndolos ideales para organizaciones que requieren tratamiento diferenciado entre segmentos de clientes o tipos de productos. Parámetros clave:

• Plan de Cuentas – Qué cuentas están involucradas y cómo están configuradas.
• Segmento – El grupo de cuentas afectadas por la lógica de tarifas.
• Ledger – Donde se rastrean las transacciones y se aplican las reglas de tarifas.

​

Validaciones de paquetes

Para garantizar la integridad, se aplican algunas reglas al configurar un Fee Package:

• Priority debe ser único. No puedes asignar la misma prioridad a más de una tarifa.
• Las tarifas de Priority 1 deben usar siempre OriginalAmount como referenceAmount.
• Los campos organizationId, ledgerId y creditAccount deben existir en Midaz antes de crear un paquete. Puedes verificarlos usando el endpoint Obtener una Cuenta desde Alias.

​

Enrutamiento de tarifas

Cada tarifa calculada se enruta a la creditAccount apropiada según lo definido en la configuración de reglas, garantizando que los valores fluyan correctamente a través de tu estructura contable.

​

Eliminación suave para un registro seguro

No se pierde ningún dato. Cuando se elimina un recurso:

• Se marca con una marca de tiempo deletedAt.
• Se excluye de las consultas estándar, pero aún se almacena para auditoría y precisión histórica.

Esto garantiza la trazabilidad completa si es necesario.

​

Integraciones

Puedes usar Fee Engine por sí solo o junto con otros componentes en tu stack. Se integra perfectamente con plugins de Lerian o tu propia implementación para aplicar tarifas basadas en tu lógica de negocio única. Los casos de uso populares incluyen:

• Motores de intercambio.
• Plataformas de préstamos.
• Sistemas de pago de facturas.
• Smart contracts.
• Pix (plataforma de pagos instantáneos de Brasil).