How to Troubleshoot and Resolve Fuel Surcharge Calculation Issues in Qargo
Fuel surcharge calculations in Qargo can sometimes result in unexpected outcomes, such as a surcharge of €0, incorrect surcharge amounts, or calculation errors. This article provides an overview of common issues, their causes, and actionable steps to resolve them.
Overview of Fuel Surcharge Calculations in Qargo
Fuel surcharges in Qargo are calculated based on rate card configurations, indexation settings, and applicable dates. Misconfigurations or mismatches in these settings can lead to calculation errors or unexpected results. Understanding the underlying principles of surcharge calculation can help you identify and resolve issues effectively.
Common Issues and Their Causes
1. Fuel Surcharge Calculates as €0
Cause: If the surcharge is configured as an indexation applied to the transport charge, it will calculate as €0 when the transport charge is €0. This can happen if the route’s stops are not configured in the relevant price table for the selected service/route (e.g., a specific stop not set up under Collect, 1st stop & Deliver).
2. Surcharge Added Despite "Valid From" Date Being Later Than Pickup Date
Cause: If the surcharge setting "Always add to order" is enabled, Qargo will create the surcharge line regardless of whether the index has a rate for that date. Additionally, fallback logic may use the most recent earlier index value if no index value exists for the relevant date.
3. Surcharge Shown but Not Calculated
Cause: This occurs when the rate card condition is too restrictive. For example, if the condition requires the resource to be both Resource A AND Resource B, it will never be met when a trip has only one resource.
4. Calculation Error for Orders Dated Before Surcharge Start Date
Cause: Qargo attempts to calculate the surcharge for every order. If there is no valid surcharge index entry for the order’s date, the system cannot find a valid calculation and shows an error.
Troubleshooting Steps
1. Resolving €0 Surcharge Calculations
Verify that the transport charge is calculated by ensuring the route is covered in the price table.
2. Fixing Surcharge Added Despite "Valid From" Date
Check whether "Always add to order" is enabled for the surcharge and disable it if necessary.
Verify the date the indexation uses (e.g., requested first pickup date) and confirm the order’s date.
Ensure the index has a defined rate for the relevant date if a non-zero amount is expected.
3. Correcting Surcharge Shown but Not Calculated
Edit the rate card condition for the fuel surcharge.
Change the logical condition from AND to OR between the applicable resources (e.g., "Resource A OR Resource B").
Save the rate card and refresh the trip/resource data (e.g., reassign the resource if needed).
4. Addressing Calculation Errors for Orders Before Surcharge Start Date
Add a 0% entry to your diesel (fuel) surcharge index with a "valid from" date earlier than the affected orders.
Steps: - Open your diesel/fuel surcharge index (rate card component). - Add a new row with percentage = 0%. - Set "valid from" to a date before the earliest affected orders. - Save and recalculate prices on the impacted orders.
Best Practices for Configuring Fuel Surcharges
Regularly review and update your rate card configurations to ensure they align with your operational needs.
Use logical conditions (e.g., OR instead of AND) to avoid overly restrictive configurations.
Maintain a comprehensive surcharge index with valid entries for all relevant dates to prevent calculation errors.
Test changes in a controlled environment before applying them to live orders.
FAQs and Additional Resources
For detailed instructions on navigating Qargo’s interface, refer to the system documentation or contact support.
If issues persist, consult Qargo’s technical support team for further assistance.