Introduction
What is the Chargeable Weight Conditions feature?
This feature allows you to add conditions to individual conversion factor lines within a chargeable weight conversion. Each line can use a different conversion factor based on goods-level properties such as height, weight, volume, loading meters, pallet spaces, packaging type, or commodity type.
Why would I use it?
When your transport pricing depends on cargo characteristics — for example, pallets below a certain height use actual weight while taller pallets use a loading meter conversion — you need different conversion factors for different goods on the same shipment. Without conditions, only a single conversion factor could be applied per chargeable weight conversion, making accurate mixed-cargo pricing impossible.
How does it work?
You configure multiple conversion factor lines within a single chargeable weight conversion. Each line can have its own condition based on goods metrics. When the system calculates the chargeable weight, it evaluates each good individually against the conditions and applies the first matching conversion factor per input specification.
Terminology
Term | Definition |
Chargeable weight conversion | A configuration in Qargo that defines how goods metrics (e.g. weight, volume, loading meters) are converted into a single chargeable weight value used for pricing. |
Conversion factor | A multiplier applied to an input metric (e.g. loading meters × 875 = chargeable weight in kg). Multiple conversion factor lines can exist within one chargeable weight conversion. |
Condition | A rule attached to a conversion factor line that determines when that factor should be applied, based on a goods-level metric (e.g. "apply this factor when ordered height > 1.6 m"). |
Input specification | The metric used as the input for the conversion (e.g. loading meters, volume). Conversion factor lines are grouped by input specification, and the first matching condition within each group is used. |
How to configure Chargeable Weight Conditions
Step 1: Navigate to the Chargeable Weight Conversion settings
NAVIGATE to RATES > Chargeable weight conversions in your Qargo environment.
SELECT the chargeable weight conversion you want to edit, or create a new one.
Step 2: Add multiple conversion factor lines
ADD a new conversion factor line by clicking 'Add item' within the conversion.
SELECT the input specification (e.g. loading meters, volume, weight) for the line.
ENTER the conversion factor value (e.g. 875 for loading meters to kg).
REPEAT to add additional conversion factor lines as needed — for example, one line for standard pallets and another for oversized pallets.
📚 You can have multiple conversion factor lines with the same input specification. The order of these lines matters: the system uses the first matching condition per input specification.
Step 3: Add conditions to conversion factor lines
CLICK on a conversion factor line to expand its settings.
ADD a condition by selecting a goods-level metric from the available options.
CONFIGURE the condition operator and value. For example:
Ordered unit height > 1.6 m
Ordered total weight < 500 kg
Packaging type = "Euro pallet"
SAVE the chargeable weight conversion.
The available condition metrics include:
Dimensions: ordered/actual unit height, width, length, width or length (max)
Weight & volume: ordered/actual total weight, total volume
Loading metrics: ordered/actual total loading meters, total pallet spaces
Quantity: ordered/actual quantity
Types: packaging type, commodity type
Step 4: Verify the order of conversion factor lines
REVIEW the order of your conversion factor lines. For lines sharing the same input specification, the first line whose condition matches will be used.
REORDER lines if needed to ensure the correct priority. More specific conditions should typically appear before more general ones.
A line without any condition acts as a fallback and will match any good that did not match a previous condition.
‼️ The order of conversion factor lines determines evaluation priority. Place your most specific conditions first.
Example: Height-based chargeable weight for mixed cargo
A transport company charges differently based on pallet height:
Pallets under 1.6 m: use actual weight as the chargeable weight
Pallets 1.6 m and above: use a loading meter conversion (e.g. 875 kg per loading meter)
Configuration:
Create a chargeable weight conversion with two conversion factor lines:
Line 1 — Input: weight, Factor: 1, Condition: ordered unit height < 1.6 m
Line 2 — Input: loading meters, Factor: 875, Condition: ordered unit height >= 1.6 m
When an order contains 3 pallets with different heights:
Pallet A (1.0 m high, 450 kg): matches Line 1 → chargeable weight = 450 kg
Pallet B (1.7 m high, 500 kg): matches Line 2 → chargeable weight = loading meters × 875
Pallet C (2.5 m high, 700 kg): matches Line 2 → chargeable weight = loading meters × 875
The system sums up the individual chargeable weights to determine the total for pricing.
Limitations
Price table visualisation: Conversion factor lines that have conditions are not displayed in the price table visualisation to avoid confusion. A future update will introduce named conversions for better identification.
Goods-level conditions only: Conditions are limited to goods-level metrics. Shipment-level or trip-level conditions (e.g. route country) are not available on chargeable weight conversion factor lines.
Evaluation scope: Conditions are evaluated per individual good, not across the shipment as a whole.
Troubleshooting
My chargeable weight is not being calculated correctly for mixed cargo.
Verify that your conversion factor lines are in the correct order. The first matching condition per input specification is applied.
Check that conditions use the correct metric (ordered vs. actual) to match how your goods data is entered.
I don't see conditions reflected in the price table.
This is expected. Conversion factor lines with conditions are intentionally hidden from the price table visualisation to prevent confusion. The calculation still works correctly in the background.
I want to apply conditions based on route or country.
Chargeable weight conditions currently support goods-level metrics only. For country-based pricing differences, consider duplicating the price calculation and applying country-based conditions at the calculation level instead.