Usa la Calculadora en Midaz Module para estimar cálculos de tarifas antes de procesar Transacciones reales. El estimador es de solo lectura — no crea una Transacción ni toca ningún saldo del Ledger.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.
Antes de empezar
- El plugin Fees Engine debe estar habilitado en la configuración de Midaz Module.
- Necesitas al menos un Paquete de Tarifas guardado.
- Necesitas los alias de las Cuentas de origen y destino contra los que quieres probar.
Ejecutar una estimación
Completa la transacción estimada. Consulta la Guía de campos más abajo para cada entrada.
Guía de campos
| Campo | Qué introducir | Ejemplo |
|---|---|---|
| Transaction Amount | Valor total a estimar para las tarifas. | 100.00 |
| Currency | Código del Activo para la transacción estimada. | BRL |
| Fee Package | Paquete de Tarifas a probar. | Standard Transfer Fee |
| From Account | Alias de cuenta que sería debitada. | @customer_123 |
| To Account | Alias de cuenta que sería acreditada. | @merchant_456 |
| Description | Descripción opcional para la estimación. | Pix transfer test |
La Calculadora es una herramienta de solo lectura. No afecta al Ledger ni crea ninguna transacción. Puedes ejecutar tantas estimaciones como necesites de forma segura.
Entender los resultados
Tras ejecutar una estimación, verás un desglose detallado de cómo se calculan las tarifas:
Resumen
- Total Fee - El importe combinado de todas las tarifas que se cobrarían
- Net Amount - El importe que recibiría el destino tras las tarifas deducibles
Desglose de tarifas
Para cada Regla de tarifas aplicada, verás:| Campo | Descripción |
|---|---|
| Fee Label | Nombre que identifica la tarifa |
| Priority | Orden en que se aplicó la tarifa |
| Calculation Type | flat o percentage |
| Reference Amount | El importe base usado para el cálculo |
| Calculated Amount | El valor real de la tarifa |
| Credit Account | Cuenta que recibiría la tarifa |
| Is Deductible | Si la tarifa se deduce de la transacción |
Ejemplos de estimación
Estimación de tarifa plana simple
Estimación de tarifa plana simple
Escenario: Probar una tarifa plana de $2.00 sobre una transferencia de $100Entrada:
- Fee Package:
Standard Transfer Fee - Asset:
USD - Amount:
100.00 - Source:
@customer/checking - Destination:
@merchant/revenue
- Total Fee: $2.00
- Net Amount: $98.00 (si es deducible) o $100.00 (si no es deducible)
Estimación de tarifa por porcentaje
Estimación de tarifa por porcentaje
Escenario: Probar una tarifa del 1.5% sobre una transferencia de $500Entrada:
- Fee Package:
Percentage Transaction Fee - Asset:
USD - Amount:
500.00 - Source:
@customer/savings - Destination:
@vendor/payments
- Total Fee: $7.50 (1.5% de $500)
- Cálculo: 500 × 0.015 = 7.50
Estimación de tarifa combinada
Estimación de tarifa combinada
Escenario: Probar la tarifa max(flat, percentage) en distintos importesPrueba 1 - Transacción pequeña ($30):
- Flat: $1.00
- Percentage: 2% = $0.60
- Resultado: $1.00 (la plana es mayor)
- Flat: $1.00
- Percentage: 2% = $4.00
- Resultado: $4.00 (el porcentaje es mayor)
Estimación con varias tarifas
Estimación con varias tarifas
Escenario: Paquete con dos tarifas aplicadas en orden de PrioridadFee A (Priority 1): 1% sobre el importe original
Fee B (Priority 2): 0.5% sobre el importe después de tarifasEntrada: Transacción de $1000Resultado esperado:
- Fee A: $10.00 (1% de $1000)
- Fee B: $4.95 (0.5% de $990)
- Total Fee: $14.95
Casos de uso para la estimación de tarifas
Validar nuevos Paquetes de Tarifas
Antes de habilitar un nuevo paquete de tarifas, ejecuta estimaciones con varios importes de transacción para asegurar que las tarifas se calculen correctamente en todo el rango.Probar casos límite
Estima transacciones en los límites de importe mínimo y máximo para verificar el comportamiento de las tarifas en los extremos de tus rangos configurados.Comparar estructuras de tarifas
Ejecuta la misma transacción a través de distintos paquetes de tarifas para comparar resultados y elegir la mejor estructura para tu caso de uso.Documentar tarifas esperadas
Usa los resultados de simulación para crear documentación para tu equipo financiero o clientes sobre los importes de tarifas esperados.Depurar problemas con tarifas
Si las transacciones muestran tarifas inesperadas, usa el estimador para reproducir el escenario y entender el desglose del cálculo.Buenas prácticas
- Prueba todos los rangos de importe - No pruebes solo un importe; estima transacciones en el mínimo, el máximo y varios puntos intermedios.
- Verifica el orden de Prioridad - Cuando los paquetes tienen varias tarifas, confirma que se apliquen en el orden esperado.
- Comprueba las Waived Accounts - Prueba con cuentas que deberían estar exentas para confirmar que se excluyen de las tarifas.
- Documenta tus pruebas - Lleva un registro de los resultados de la estimación para fines de auditoría y cumplimiento.
- Comparte con stakeholders - Usa los desgloses de la estimación para alinear con los equipos financieros sobre los resultados de tarifas esperados antes de pasar a producción.
Qué hacer a continuación
Tras validar el resultado de la tarifa, ajusta el Paquete de Tarifas si es necesario en Editar un Paquete de Tarifas, o crea una Transacción real en Crear una Transacción.