---
title: "How to troubleshoot and resolve fuel surcharge calculation issues in Qargo?"
description: ""
url: https://help.qargo.com/us/articles/628311-how-to-troubleshoot-and-resolve-fuel-surcharge-calculation-issues-in-qargo
locale: us
updated: 2026-04-02
---

# How to troubleshoot and resolve fuel surcharge calculation issues in Qargo?

## How to troubleshoot and resolve fuel surcharge calculation issues in Qargo {#h_6ecc0a4ca5}

Fuel surcharge calculations in Qargo can sometimes produce unexpected outcomes, such as a surcharge of €0, incorrect surcharge amounts, or calculation errors. This article gives an overview of common issues, their causes, and actionable steps to resolve them.

### Overview of fuel surcharge calculations in Qargo {#h_8d66a88990}

Qargo calculates fuel surcharges 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 helps to identify and resolve issues effectively.

### Common issues and their causes {#h_a3e2e5dd5c}

#### 1\. Fuel surcharge calculates as €0 {#h_e06452b7fe}

-   **Cause:** If the surcharge is configured as an indexation applied to the transport charge, it calculates as €0 when the transport charge is €0. This can happen if the route's stops are not configured in the relevant rate table for the selected service/route (e.g., a specific stop not set up under Pickup, 1st stop & Deliver).

#### 2\. Surcharge added despite "valid from" date being later than pickup date {#h_cfea020e52}

-   **Cause:** If the surcharge setting "Always add to order" is enabled, Qargo creates the surcharge line whether or not the index has a rate for that date. In addition, 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 {#h_a3d3a093a4}

-   **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 is never met when a load has only one resource.

#### 4\. Calculation error for orders dated before surcharge start date {#h_fa40163dcb}

-   **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 {#h_bad8b31bf9}

#### 1\. Resolving €0 surcharge calculations {#h_f3bf6297f5}

-   Verify that the transport charge is calculated by making sure the route is covered in the rate table.

#### 2\. Fixing surcharge added despite "valid from" date {#h_e165cbb581}

-   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.
-   Make sure the index has a defined rate for the relevant date if a non-zero amount is expected.

#### 3\. Correcting surcharge shown but not calculated {#h_90a706cd08}

-   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 load/resource data (e.g., reassign the resource if needed).

#### 4\. Addressing calculation errors for orders before surcharge start date {#h_b4c8ee4c9d}

-   Add a 0% entry to the diesel (fuel) surcharge index with a "valid from" date earlier than the affected orders.
-   Steps: - Open the 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 {#h_0b313465e5}

-   Regularly review and update rate card configurations to make sure they align with 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 {#h_1442d7a8cf}

-   For detailed instructions on navigating Qargo's interface, refer to the system documentation or contact support.
-   If issues persist, contact Qargo's technical support team for further assistance.


## Related articles

- [Rates - Price index (fuel surcharge)](https://help.qargo.com/us/articles/133795-rates-price-index-fuel-surcharge.md)
- [FAQ - Why is an order not receiving a price in Qargo, and how can this be resolved?](https://help.qargo.com/us/articles/397043-faq-why-is-an-order-not-receiving-a-price-in-qargo-and-how-can-this-be-resolved.md)
- [Rate card: general surcharges](https://help.qargo.com/us/articles/133796-rate-card-general-surcharges.md)
- [Rate card FAQ – FAQ rate cards](https://help.qargo.com/us/articles/445955-rate-card-faq-faq-rate-cards.md)
- [Rates - Rate card customers](https://help.qargo.com/us/articles/133865-rates-rate-card-customers.md)
