Introduction

Qargo uses PTV for route and toll cost calculation. The logic is slightly different for toll cost calculation on an order versus on a trip.

A default Order Routing Profile can be configured in Transport Services and the Vehicle Category. When creating an order, sequential logic determines the correct vehicle type for routing and toll calculations.

Rate card charges can also be configured to exclude specific toll systems — allowing carriers whose base rates already include certain tolls (e.g. Belgian road tolls) to avoid double-charging without manual order adjustments.

Terminology

Term	Definition
PTV	A routing and toll cost calculation engine used to determine distances, travel times, and toll charges based on vehicle type and route.
Routing Profile	A set of rules in Qargo that define how routes and tolls are calculated for a given vehicle type. Can be configured at the organisation, transport service, or vehicle category level.
Vehicle Category	Classification of vehicles in Qargo (e.g., Van, Rigid, Semi-Truck) that determines the applicable routing profile and toll calculations.
Order	Represents a customer shipment request. Routing and toll costs at the order level are determined by the configured routing profile, before the trip is created.
Trip	Operational execution of an order, where resources such as drivers, tractors, trucks, vans, and trailers are assigned. Toll calculations at this level are based on the actual resource vehicle type.
Organisation Settings	A global configuration in Qargo that defines the default routing profile to be used when no specific profile is set in Transport Services or Vehicle Categories.
Transport Services	A configuration area in Qargo where routing profiles can be defined per transport service, influencing toll and routing calculations at the order level.
Resource	Operational unit used in trips, including driver, tractor, truck, van, and trailer. The resource type determines the vehicle profile applied to the trip.
GVW (Gross Vehicle Weight)	The total weight of a vehicle, including its maximum payload, used to classify vehicles into categories (e.g., Van up to 3.5t, Rigid 7.5–12t, Semi-Truck up to 40t).
Axle Configuration	Details about the number and arrangement of axles on a vehicle or trailer. In some regions, toll costs depend on axle configuration in addition to vehicle category.
Subcontractor Resource	External resources (e.g., subcontracted drivers or vehicles) assigned to trips. If limited information is available, toll calculation falls back on organisation-level routing profiles.
Fallback Profile	The routing profile applied when no specific vehicle or service-based routing profile is configured. Defaults to the Organisation Settings profile.
Toll system	A named toll operator or scheme returned by PTV routing (e.g., Viapass, Autoroutes de France, Liefkenshoektunnel, Eurovignet).
Per toll system metric	A calculation metric on a rate card charge that evaluates toll cost filtered by toll system name, rather than returning a combined total across all systems.
Charge template	A reusable rate card charge configuration that can be applied across multiple rate cards.
Rate card	A pricing configuration in Qargo that defines how charges are calculated for a customer or transport service.

Configuring Routing Profiles

1.) Validate routing in ORGANISATION SETTINGS

Navigate to CONFIGURATION > Organisation settings > Route planning & optimisation
From the 'Routing' panel, validate the default vehicle profile set
Update to the appropriate profile if required
SAVE the profile

📚 This is used in both Orders and Trips as a fallback (if required).

2.) (Optional) Set default routing in TRANSPORT SERVICES

Navigate to RATES > Order Input
From the left-hand menu, select Transport Services
Select the Transport Service to update
Navigate to the 'Cost & Toll Calculation' section
Select the appropriate Routing Profile from the dropdown
Save the profile

You can set a routing profile for each Transport Service offered. Profiles can be unique to each service.

3.) (Optional) Set default routing in VEHICLE CATEGORIES

Navigate to RATES > Order Input
From the left-hand menu, select Vehicle Categories
Select the Vehicle Category to update
Navigate to the 'Vehicle Type' section
Select the appropriate Routing Profile from the dropdown
Save the profile

📚 Configured routing profiles for transport service & vehicles apply to ORDERS ONLY (routing and tolls). If no optional profiles are set, the default will be the Routing profile from the organisation settings.

Qargo vehicle profile and the equivalent PTV category

Routing Profile Category	PTV Routing Category	Description
Car	EUR_CAR	up to 1.77t GVW
Van	EUR_VAN	up to 3.5t GVW
Rigid	EUR_TRUCK_7_49T	3.5t - 7.5t GVW
Rigid	EUR_TRUCK_11.99T	7.5t - 12t GVW
Semi-Truck	EUR_TRAILER_TRUCK	up to 40t GVW

Toll cost on orders

Qargo uses logic based on the configurations to check for the vehicle type when creating an order.

In the order, under General Info, the Route details will display the default vehicle profile
This is based on the configured routing profile set up
Toll calculations will be based on the vehicle profile included here

If time windows are enforced, the planned execution time will influence whether day or night tariffs are applied, ensuring accuracy based on the order's schedule.

Order logic workflow to set vehicle profile

‼️ Routing profiles need to be set in the transport service or vehicle category BEFORE the order is built. Updates to these will not update the vehicle profile on the order.

Toll cost on trips

Once a Resource is assigned to a Trip, the vehicle type associated with the resource is used to generate the routing and the toll.

📚 Vehicle type is set when adding a new resource and can include Tractor, Truck, Van and Trailer.

Qargo vehicle profile and the equivalent PTV category

Routing Profile Category	PTV Routing Category	Description
Van	EUR_VAN	up to 3.5t GVW
Rigid (Truck 3.5 - 7.5t)	EUR_TRUCK_7_49T	3.5t - 7.5t GVW
Semi-Truck (Tractor &/or Trailer)	EUR_TRAILER_TRUCK	up to 40t GVW

📚 This does not impact the routing associated to the order, which will still show the default used (if any) when the order was originally created.

Use case 1: Own resources

Own resources, including driver, vehicle and trailer. Vehicle profile defaults to Semi-Truck based on the vehicle & trailer resources.

Use case 2: Subcontractor Resource (Driver)

Assigning a subcontractor resource (driver) with own internal trailer. Vehicle profile defaults to Semi-Truck based on the trailer resource assigned — assumption that a Semi is required to haul the trailer.

Use case 3: Subcontractor trip — no trailer

Assigning subcontractor only, with no additional resources. Vehicle profile defaults to the 'Organisation Settings' routing profile as actual vehicle resources are unknown.

Trip workflow logic is based on resource type. Where multiple resources are assigned (e.g., Truck & Trailer), it will take the highest-weight resource to calculate route and toll.

Trip workflow Logic is based on resource type. Where multiple resources assigned (ie: Truck & Trailer) it will take the highest weight resource to calculate route and toll.

Resource type	Qargo Vehicle profile	Subcontractor Resource
Tractor	Semi-Truck (up to 40t GVW)	As per Qargo vehicle profile
Trailer	Semi-Truck (up to 40t GVW)	As per Qargo vehicle profile
Truck	Rigid (3.5t - 7.5t GVW)	As per Qargo vehicle profile
Van	Van (up to 3.5t GVW)	As per Qargo vehicle profile
Driver only	Vehicle profile selected on organisation settings	As per Qargo organisation settings
Generic Subco	Vehicle profile selected on organisation settings	As per Qargo organisation settings

Examples:

A trailer and a tractor → Semi-Truck (up to 40t GVW)
A Rigid truck (3.5t - 7.5t GVW) + trailer → Semi-Truck (up to 40t GVW)
A driver (org settings profile) + tractor → Semi-Truck (up to 40t GVW)

To change the vehicle profile used in the trip, you will need to change the resource.

📚Users can change the time to recalculate if another vehicle profile is selected on organisation settings. This will update the order to reflect the change.

In some regions tolls can also be calculated based on the AXLE CONFIGURATION specified in the resource profile.
- Typically applies to Trailers, but could also be applied to Tankers if used.

🧰 Complete the axle configuration in the resource profile to help with accurate toll calculations.

📚 Where toll rates vary depending on time of day, use enforced time windows in the order to ensure the correct rate is used in the calculation.

By setting "Start" and/or "Arrival" times and enabling the "Enforce Window" option, Qargo ensures toll tariffs align with expected execution times. This is especially critical for locations like the Liefkenshoektunnel, where rates vary between day and night hours.

Excluding toll systems from rate card charges

Rate card charges can be configured to exclude specific toll systems from the toll cost calculation using the Per toll system metric. This is useful when a carrier's base rate already includes certain tolls (e.g., Belgian road tolls via Viapass), avoiding double-charging without manual adjustment on every order.

📚 The Per toll system metric lets users filter which toll systems are included in a charge.

Use cases

A carrier includes Belgian road tolls in the base transport rate → exclude Viapass and charge only for other systems (e.g., Autoroutes de France)
A carrier holds a separate tunnel contract → exclude Liefkenshoektunnel from the standard Qargo toll charge
A carrier manages vignette costs separately → exclude Eurovignet from the Qargo toll calculation
An intermodal operator needs system-level exclusion because different subcontractors use different routes through different toll systems

Configure a Per Toll System Exclusion on a Rate Card

NAVIGATE to RATES → Rate card customers
OPEN the relevant rate card and locate the toll cost charge, or ADD a new charge
SET the calculation metric to Route / Total toll cost / Per toll system
SET a condition row:
- Metric: Per toll system
- Operator: Not in (to exclude) - or In to set an 'allow' list for specific systems
- Value: type the name of the toll system (e.g., Viapass) - a list of known systems available will display
ADD additional condition rows for each further toll system to exclude - each condition is evaluated independently
SAVE the rate card - the exclusion applies automatically to all future orders and trips on this rate card

Configure a Per Toll System Exclusion on a Charge Template

NAVIGATE to RATES → Charge templates
OPEN the relevant charge template or CREATE a new one
FOLLOW steps 3–5 from the rate card configuration above
SAVE the template and apply it to the relevant rate cards to propagate the exclusion

Stacking multiple exclusions

Multiple toll systems can be excluded by adding several condition rows on the same charge, each with the Not in operator. Each condition filters independently — all matching systems are removed from the toll cost total before the charge is calculated.

Alternatively, add separate charge calculations within the same rate card if different exclusion rules are needed for different scenarios.

Troubleshooting

Issue	Likely cause	Resolution
The Per toll system metric does not appear in the calculation metric list	Toll routing is not active or the rate card charge is on an older version	Verify that PTV routing is enabled for the transport service; refresh the rate card editor
The toll system name does not appear in the autocomplete list	The system is not in Qargo's current toll system list (~204 systems sourced from PTV production data)	Type the system name exactly as it appears in PTV; contact support if the system is absent and expected
The toll charge still shows the full combined toll cost	The Per toll system metric is set but no condition row has been added	Confirm that a Per toll system condition row with the correct operator and value has been saved on the charge
Eurotunnel costs cannot be excluded via this feature	Eurotunnel is globally excluded from Qargo's toll calculation by default	No action required — Eurotunnel costs are never included in Qargo's toll charge
A new toll system does not appear in autocomplete	The autocomplete list is updated periodically from PTV production data	Contact support to request a list refresh to include the new system