Tariff
1. Overview
The Tariff module in Sumo Ledger monitors the execution of tariff calculations across all configured tariff definitions. Tariffs are programmable fee, charge, or calculation engines that run during transaction processing — for example, calculating processing fees, interest amounts, credit scores, or routing decisions.
The Tariff module provides a dashboard view of tariff execution volume, success rates, and failure rates, helping administrators ensure that all fee and calculation engines are running correctly.
Navigation: Tariff (main sidebar menu)
URL: https://las.ledger.raralabs.dev/tariff
2. Tariff Overview Page
2.1 Tariff Volume Trend
A bar chart showing tariff execution volume over time. The x-axis shows dates and the y-axis shows the count of tariff executions. A Date Range filter (e.g., 2026-06-13 to 2026-07-13) controls the time window.
2.2 Tariff Summary Table
Below the chart, a table summarizes tariff activity for the Last 30 Days:
| Column | Description |
|---|---|
| Tariff Name | The name of the tariff definition (e.g., process_fee_calculator, payday_disburse_route, overdue_check). Clicking navigates to the detail view for that tariff. |
| Total Requests | The total number of times this tariff was executed in the last 30 days. |
| Success | The number of successful executions. |
| Failed | The number of failed executions. |
2.3 Common Tariff Types
Tariff definitions reflect the various calculations and logic configured in your system. Typical examples include:
| Tariff Name | Purpose |
|---|---|
process_fee_calculator | Calculates processing fees for transactions. |
scrip_fee_calculator | Calculates fees related to securities/scrip transactions. |
payday_disburse_route | Determines the disbursement route for payday loans. |
payday_decision | Makes approval/rejection decisions for payday loans. |
payday_intent_score | Calculates intent scores for loan applications. |
payday_hard_reject | Applies hard rejection rules to loan applications. |
payday_eligible_amount | Calculates the eligible loan amount for a customer. |
payday_capacity_score | Calculates repayment capacity scores. |
overdue_check | Checks whether an account or loan is overdue. |
reversal_amount | Calculates the amount for transaction reversals. |
unique_id_generator | Generates unique identifiers for records. |
verify_margin_call | Verifies margin call requirements. |
valuation_tariff | Performs asset valuation calculations. |
3. Tariff Detail View
Clicking on a tariff name opens its execution detail view, showing individual execution records with timestamps, input parameters, results, and any error messages.
4. How Tariffs Work in Practice
Execution Flow
- A transaction reaches a process stage that references a tariff.
- The system invokes the tariff engine with the transaction's parameters.
- The tariff calculates the result (e.g., a fee amount, a score, a routing decision).
- The result is returned to the process stage, which uses it in subsequent steps (e.g., posting the fee, making an approval decision).
- The execution is logged in the Tariff module.
Relationship to Configuration
Tariff definitions are created and maintained in Configurations > Tariff. The main menu Tariff module is the monitoring dashboard — it shows how tariffs are performing, not how they are configured.
5. Best Practices
- Monitor for failures daily. A tariff failure typically means a transaction could not be fully processed. Investigate failures promptly.
- Check tariffs with zero executions. If a tariff shows zero requests over 30 days, verify whether it is still being referenced by active processes.
- Use the volume trend to spot anomalies. Sudden spikes may indicate batch processing; sudden drops may indicate a process change that bypasses the tariff.
- Test tariff changes thoroughly. After modifying a tariff definition in Configurations, monitor this dashboard to confirm the changes are producing expected results.
- Correlate tariff failures with Connect failures. Some tariffs depend on external API connections. If a tariff fails, check the Connect module for related connection issues.