To calculate your shipment cost correctly, it’s important to understand the difference between net rate, all-in rate, and total:
Net rate (netRate in API response) → The base rate for your shipment excluding any surcharges.
All-in rate (allInRate in API response) → The rate including all surcharges (fuel, security, etc.).
Total (total in API response) → The final amount, based on your weights and surcharge types.
Example
Component | Type | Rate | Basis | Example Weight | Total |
Net rate | – | 6.08 | per chargeable kg | 100 kg | 608 |
Fuel surcharge | CHARGEABLE_WEIGHT | 0.07 | per chargeable kg | 100 kg | 7 |
Security surcharge | GROSS_WEIGHT | 0.08 | per gross kg | 100 kg | 8 |
All-in rate | – | 6.23 | per chargeable kg | 100 kg | 623 |
Calculation details
To calculate the total cost:
Total = (Net rate × Chargeable weight) + (Fuel surcharge × Chargeable weight) + (Security surcharge × Gross weight)
Example:
(6.08 × 100) + (0.07 × 100) + (0.08 × 100) = 608 + 7 + 8 = 623
This matches the all-in rate (6.23 × 100 = 623).
Understanding surcharge basis types
Each surcharge has a type that determines how it’s applied:
Type | Calculation Basis | Example |
CHARGEABLE_WEIGHT | Multiply by chargeable weight | Fuel surcharge |
GROSS_WEIGHT | Multiply by gross weight | Security surcharge |
PIECES | Multiply by total number of pieces | Handling fee |
SHIPMENT | Apply once per shipment | Booking fee |
Always check the surcharge’s type to know which weight or count to use in your calculation.
Example data
{"name": "Spot","currency": "EUR","netRate": 6.08,"allInRate": 6.23,"total": 623,