Units of measure
eCargo can represent different units of measure.
There are different ways of specifying the units of measure, depending on whether the unit is displayed in a user interface or API. The names for some of these units of measure have changed over time, and some units have been deprecated because they are either no longer relevant or duplicate another unit.
The different units of measure in the tables below are used in:
- Invoicing: The invoicing / manual charge pages.
- Premium: eCargo Premium.
- Legacy APIs: Legacy APIs, manual charges, rates import CSV, and the admin pages.
- New APIs: New APIs and consignment import CSV.
Using these tables
The documentation for the API you’re using will tell you whether you need the new API unit of measure or the legacy API unit of measure. You can then map from the codes you see in Premium or other APIs that you use to the correct codes for your API.
Preferred units of measure
Where possible, use the units of measure in this table:
Invoicing | Premium | Legacy APIs | New APIs | Display name |
---|---|---|---|---|
Aus GPA pallets | Aus | Aus GPA | aus-gpa-pallet | Aus GPA pallets |
Bags | Bags | Bags | bag | Bag |
Bales | Bales | Bales | bale | Bale |
Bins | Bins | Bins | bins | Bins |
Boxes | Boxes | Boxes | box | Box |
Bundle | Bundle | BUN | bundle | Bundle |
Cartons | Cartons | Cartons | carton | Carton |
Cases | Cases | Cases | case | Case |
Chep plts | Chep | Chep plts | chep-pallet | Chep |
cm³ Cubic centimetre | cm³ | CCM | cm3 | cm³ |
Per Consignment | Per | Consignment | consignment | Per consignment |
Cntnrs | Cntnrs | Cntnrs | container | Container |
Crates | Crates | Crates | crates | Crates |
Days | Days | 10 | day | Day |
Displays | Displays | dsp | display | Display |
dm³ Cubic decimetre | dm³ | CDM | dm3 | dm³ |
Dble-Stk | Dble-Stk | DST | double-stack | Double stack |
Each | Each | Each | each | Each |
Export plt | Export | Export plt | export-pallet | Export pallet |
XLge Plts | XLge | XLge Plts | extra-large-pallet | Extra large pallet |
FoodCaps | FoodCaps | FoodCaps | foodcap | Foodcap |
Gram | Gram | G | g | Gram |
Half-Lifts | Half-Lifts | Half-Lifts | half-lift | Half lift |
High-Pallet | High-Pallet | PF-HR | high-pallet | High pallet |
hours | hours | hours | hour | Hour |
JAS | JAS | JAS | jas | JAS |
Kilogram | Kilogram | KG | kg | Kilogram |
Lge Plts | Lge | Lge Plts | large-pallet | Large pallet |
Lifts | Lifts | Lifts | lift | Lift |
Load | Load | Load | load | Load |
Lng Pcks 3.6m | Lng | Lng Pcks 3.6m | long-pack | Long pack |
Loscam plts | Loscam | Loscam plts | loscam-pallet | Loscam |
Low-Pallet | Low-Pallet | PF-LR | low-pallet | Low pallet |
Metre | Metre | M | m | Metre |
m² Square metre | m² | M2 | m2 | m² |
m³ Cubic metre | m³ | M3 | m3 | m³ |
MaxLength | MaxLength | Max Length | max-length | Max length |
Med Plts | Med | Med Plts | medium-pallet | Medium pallet |
NZ-Export pallets | NZ-Export | NZ Export | nz-export-pallet | NZ Export pallets |
Packs | Packs | Packs | pack | Pack |
Packer Pallets | Packer | Packers | packer-pallet | Packer pallet |
Pkts | Pkts | Pkts | packet | Packet |
Pallets | Pallets | Plts | pallet | Pallet |
Panel | Panel | PAN | panel | Panel |
Pieces | Pieces | Pieces | piece | Piece |
Polybins | Polybins | Polybins | polybin | Polybin |
Reels | Reels | Reels | reel | Reel |
Roll | Roll | ROL | roll | Roll |
Sheet | Sheet | ZSH | sheet | Sheet |
Shrt Pcks 2.4m | Shrt | Shrt Pcks 2.4m | short-pack | Short pack |
Skid | Skid | Skid | skid | Skid |
Sml Plts | Sml | Sml Plts | small-pallet | Small pallet |
Ties | Ties | Ties | tie | Tie |
Tonnes | Tonnes | Tonnes | tonne | Tonne |
Truck | Truck | Truck | truck | Truck |
TnT | TnT | T&T | truck-and-trailer-load | Truck and trailer load |
Units | Units | Units | unit | Unit |
Deprecated units of measure
These units of measure are still supported by eCargo, but should be avoided if possible:
Invoicing | Premium | Legacy APIs | New APIs | Display name |
---|---|---|---|---|
Box | Box | KI | box-do-not-use | Box |
BB Container | BB | BB | break-bulk-container-do-not-use | Break bulk container |
Case | Case | CSE | case-do-not-use | Case |
Each | Each | ZEA | each-do-not-use | Each |
Each | Each | EA | each-do-not-use-2 | Each |
FEU | FEU | FEU | feu-do-not-use | FEU |
FHC Container | FHC | FHC | fhc-do-not-use | FHC |
Hectolitre | Hectolitre | HL | hl-do-not-use | Hectolitre |
Kilograms | Kilograms | KGS | kg-do-not-use | Kilogram |
m3 | m3 | Volume(m3) | m3-do-not-use | m³ |
Pack | Pack | PAK | pack-do-not-use | Pack |
Pack - 2 decimals | Pack | PCK | pack-do-not-use-2 | Pack |
Pallet | Pallet | PAL | pallet-do-not-use | Pallet |
Pallet New Zealand Std | Pallet | PLZ | pallet-do-not-use-2 | Pallet |
Plts | Plts | pallets | pallet-do-not-use-3 | Pallet |
Piece | Piece | PC | piece-do-not-use | Piece |
TEU Twenty foot container | TEU | TEU | teu-do-not-use | TEU |
Tonne (1000 kg) | Tonne | TO | tonne-do-not-use | Tonne |