This document describes the products you can search with Routes, Schedules and Rates API
Product Names
Please use the below product names and the corresponding default Special Handling Codes (SHC) products in your search to perform search for different categories of products:
| Product Name | Description | Default SHC |
|---|---|---|
| PHARM | Pharmaceutical product | PIL |
| FRESH | Perishable product | PER |
| GCR | General Cargo product | GCR |
| HUM/LHO | Human Remains | HUM |
| VAL/VUN | Valuables | VAL |
| AVI | Live Animals | AVI |
You need to include the "specialHandlingCodes" field in the "shipment" field of your request body. Within the "specialHandlingCodes" field, the default SHC of the product must be included. Furthermore, for pharmaceuticals or perishable products you need to specify the temperature requirements SHCs if temperature control is required for booking.
Listed below are the accepted SHCs for temperature requirements:
- FRO (for temperatures ranging from -10°C to -20°C)
- COL (for temperatures ranging from +2°C to +8°C)
- ERT (for temperatures ranging from +2°C to +25°C)
- CRT (for temperatures ranging from +15°C to +25°C)
SHC, HS Codes and SCR Codes Explained
Special Handling Codes (SHC), Harmonized System Codes (HS Codes), and Special Commodity Rate Codes (SCR Codes) are essential metadata in an air cargo booking because they:
- Instruct the airline on how to handle the goods safely and legally,
- Ensure regulatory compliance and accurate customs classification, and
- Enable correct rating and service level application.
| SHC | Determines how the cargo is stored, loaded, and prioritized |
| HS Code | Ensures legal transport and facilitates customs pre-clearance |
| SCR Code | Defines the rate category and contract applicability |
Providing this information in your search request is crucial to maximize your chances of obtaining results and accurate rating for your shipment.
Note:
For detailed SHCs, EuropeanHS, GlobalHS and SCRs lists, our technical team will be happy to share them once a NDA and Direct Agreement are in place. Please reach out after signing.
Example
Find below an example of a "shipment" object that includes SHC, HS Codes and SCR Codes.
"shipment": {
"product": "GCR",
"pieces": 1,
"weight": 100,
"chargeableWeight": 166.67,
"volume": 1,
"dimensions": [
{
"length": 100,
"width": 100,
"height": 100,
"pieces": 1,
"weight": 1,
"stackable": true,
"tiltable": false,
"toploadable": false,
"weightType": "TOTAL",
"loadType": "TOTAL"
}
],
"specialHandlingCodes": [
"SPX",
"PER"
],
"dangerousGoods": [],
"scrs": [
"0336"
],
"globalHS": [
"3"
],
"europeanHS": [
"30020000090"
]
}
