Size and Weight
Accuracy is Key
Strive to be as accurate as possible when shipping! This will affect the availability of your chosen service. If the carrier has the ability to quote, The more accurate your information is, the better the rate quote you will receive from the Carriers.
Additionally, if the shipping information is incorrect, It may lead to the failure of the buy order, if the fluke buy order is successful, most carriers will follow up with a charge to make up the difference. This may result in your package being held until the extra delivery cost is paid by you or the recipient.
Note:The European logistics company's size and weight decimals will be rounding to the nearest integer by the logistics center. For US logistics companies,FedEx employs rounding down logic.UPS is rounded up by the logistics company itself: for weight, it is rounded up, and for size, it is rounding to the nearest integer.
The Basics
Weight
Weight inside of a shipment's packages
object is required.
Property | Description |
---|---|
unit | enumerated string, required KG , LB |
value | decimal, required Weight in the unit specified. |
Different carriers have different requirements for the weight field.
- FedEx
For weight and currency value/amount, only two explicit decimal places are allowed. At present, the logistics center defaults to packing YOUR_PACKAGING, and the maximum weight of a single package can reach 150lbs/68KG. - UPS
Package weight up to 70 kilograms or 150 pounds. do not support decimals. - Evri
Package weight up to 15 kilograms or 33 pounds. only two explicit decimal places are allowed. - Whitsl
For weight, only three explicit decimal places are allowed. Different logistics service limits are different. See service description for details - DPD_UK
Package weight up to 30 kilograms or 66 pounds. only three explicit decimal places are allowed. - DPD_DE
Package weight up to 31.5 kilograms or 69 pounds. only three explicit decimal places are allowed. - GLS
Package weight up to 40 kilograms or 88 pounds. There is no requirement for the number of decimal places in the document. - GEL
Package weight up to 1000 kilograms or 2205 pounds. only three explicit decimal places are allowed. - AMAZON
Package weight up to 50 pounds.
Dimensions
Optionally, you can specify the dimensions of each package in the shipment.
Property | Description |
---|---|
unit | enumerated string, required CM , IN |
length | decimal, required Length in the unit specified. |
width | decimal, required Width in the unit specified. |
height | decimal, required Height in the unit specified. |
Add the objects directly into the shipment
object. Use this same format to get shipping rates as well.
Different carriers have different requirements for the dimensions field.
FedEx
length, width and height – do not support decimals.- Ground : The maximum size limit for a package is 108' in length, or 165 total inches in length plus girth (L+2W+2H).
- U.S. Express Shipping : The maximum size limit for a package is 119' in length, or 165 total inches in length plus girth (L+2W+2H).
Note: Package measurements:Although not required for FedEx Express and FedEx Ground shipments, entering package measurements helps FedEx provide the most accurate rate quote possible.You are required to enter skid measurements for FedEx Express Freight shipments.
Length: The longest side of your package.
Width: The next longest side of your package.
Height: The shortest side of your package.
UPS
length, width and height – do not support decimals. The maximum size limit for a package is 108' in length, or 165 total inches in length plus girth (L+2W+2H).Evri
no information.Whitsl
length, width and height – do not support decimals. Different logistics service limits are different. See service description for detailsDPD_UK
no information.DPD_DE
length, width and height - only two explicit decimal places are allowed. length up to 175cm, width and height meets the maximum circumference limit of 300cm.GLS
no information.GEL
length, width and height - only two explicit decimal places are allowed. length up to 610cm, width up to 200cm, height up to 225cm.AMAZON
length, width and height —length up to 59inches, width and height up to 33inches, girth exceeding 130 inches. Length is defined as the longest side of the parcel, and girth is defined as G=L+2(W+H).
Example
POST /v1/shipment
This example shows how to ship a package with a shipping weight of 10.8425 kilograms, and box dimensions of 50.56 x 50.23 x 50.58 inches.
POST /v1/shipment HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
"serviceType": "__YOUR_SERVICE_TYPE__",
"carrierId": "__YOUR_CARRIER_ID__",
"shipper": {
"address": {
...
},
"contact": {
...
}
},
"recipient": {
"address": {
...
},
"contact": {
...
}
},
"itemLines": [
{
"itemTransactionId": "itemTransactionId",
"itemCode": "itemCode",
"weight": {
"units": "kg",
"value": 10.8425
},
"customerReference": {
"ref1": "ref1"
},
"dimensions": {
"length": 50.56,
"units": "in",
"width": 50.23,
"height": 50.58
}
}
],
"labelSpecification": {
...
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48