Thuộc tính
Các cặp khóa/giá trị JSON trong thân yêu cầu
POST | https://api.zonos.com/v1/shipment_rating
HEADER zonos-version: 2020-03-04
Header trên là một đầu vào bắt buộc để yêu cầu đánh giá này hoàn thành thành công.
| Trường | Ghi chú |
|---|---|
currency BẮT BUỘC | Chuỗi tiền tệ cơ bản, được biểu diễn bằng mã ISO ba chữ cái. |
items_amount BẮT BUỘC | Một số thập phân với số lượng mặt hàng. |
packages BẮT BUỘC | Một danh sách số lượng và kích thước của các gói hàng đang được vận chuyển. hash |
packages.id BẮT BUỘC | Mã xác định duy nhất cho gói hàng của thương nhân hoặc người xuất khẩu. |
packages.dimensions BẮT BUỘC | Kích thước cho gói hàng. hash |
packages.dimensions.height BẮT BUỘC | Một số thập phân cho chiều cao của hộp vận chuyển. |
packages.dimensions.length BẮT BUỘC | Một số thập phân cho chiều dài của hộp vận chuyển. |
packages.dimensions.unit BẮT BUỘC | Đơn vị đo lường cho kích thước hộp vận chuyển. Các giá trị có thể là inch centimeter millimeter null. Khi null, sẽ sử dụng inch. |
packages.dimensions.width BẮT BUỘC | Một số thập phân chứa chiều rộng của hộp vận chuyển. |
packages.insured_amount TÙY CHỌN | Một số thập phân với số tiền bảo hiểm. |
packages.type TÙY CHỌN | Một chuỗi để chỉ định loại hộp vận chuyển cụ thể để sử dụng cho việc tính toán vận chuyển. Các giá trị có thể bao gồm FEDEX_BOX |
packages.weight BẮT BUỘC | Một số thập phân chứa trọng lượng của gói hàng. |
packages.weight_unit BẮT BUỘC | Một chuỗi với đơn vị đo lường cho trọng lượng. Các giá trị có thể là pound ounce kilogram null. Khi null, sẽ sử dụng pound. |
pickup_date BẮT BUỘC | Ngày yêu cầu lấy hàng cho gói hàng, theo định dạng ISO 8601 YYYY-MM-DDTHH:mm:ss.sssZ. Giả định sử dụng múi giờ UTC khi không có thông tin múi giờ được truyền. |
service_level TÙY CHỌN | Cấp độ dịch vụ với hãng vận chuyển, ví dụ tiêu chuẩn. hashCác ví dụ phổ biến bao gồm: ups_express, ups_express_saver, ups_expedited, ups_economy, ups_standard, ups_mail_innovations_economy, ups_mail_innovations_priority, dhl_express, dhl_ecommerce_parcel_direct, fedex_priority, fedex_economy, usps_first_class_mail_international, usps_priority_mail_international, landmark_parcel, apc_parcel, point2point_standard, point2point_direct, point2point_packet, và fedex_international_groundXem tài liệu của hãng vận chuyển để xem danh sách đầy đủ các cấp độ dịch vụ có sẵn theo từng hãng vận chuyển. |
ship_from BẮT BUỘC | Địa chỉ xuất phát. hash |
ship_from.city | Một chuỗi cho thành phố, thị trấn, quận, ngoại ô hoặc làng của địa chỉ xuất phát. |
ship_from.country BẮT BUỘC | Chuỗi quốc gia xuất phát, được biểu diễn bằng mã ISO hai chữ cái. |
ship_from.postal_code BẮT BUỘC | Một chuỗi cho mã bưu điện của địa chỉ xuất phát. |
ship_from.state_code BẮT BUỘC | Một chuỗi cho địa chỉ xuất phát khi có sẵn. Chỉ bắt buộc ở Canada và Brazil. |
ship_to BẮT BUỘC | Địa chỉ đích. hash |
ship_to.city BẮT BUỘC | Một chuỗi cho thành phố, thị trấn, quận, ngoại ô hoặc làng của khách hàng. |
ship_to.country BẮT BUỘC | Một chuỗi cho quốc gia đích, được biểu diễn bằng mã ISO hai chữ cái. |
ship_to.postal_code BẮT BUỘC | Một chuỗi cho mã bưu điện đích. Tùy chọn tùy thuộc vào quốc gia nhập khẩu. |
ship_to.state_code BẮT BUỘC | Một chuỗi cho mã bang đích khi có sẵn. Chỉ bắt buộc ở Canada và Brazil. |
ship_to.type BẮT BUỘC | Loại địa chỉ đích. Các giá trị có thể có bao gồm residential commercial. |
Yêu cầu ví dụ
1
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
{
"currency": "USD",
"items_amount": 168.99,
"packages": [
{
"id": "1",
"dimensions": {
"height": 19.0,
"length": 15.0,
"unit": "inch",
"width": 15.0
},
"insured_amount": 33.22,
"type": null,
"weight": 32.0,
"weight_unit": "pound"
}
],
"pickup_date": "2020-07-06T18:47:04.629+0000",
"service_level": null,
"ship_from": {
"city": "St George",
"country": "US",
"postal_code": "84770",
"state_code": "UT"
},
"ship_to": {
"city": "Campinas",
"country": "BR",
"postal_code": "75828-000",
"state_code": "SP",
"type": "residential"
}
}
Ví dụ phản hồi
1
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
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
{
"id": "ship_5p67angIDnS91CyfpW55YZ",
"currency": {
"id": "curr_1Rp9lhXSRXvEWVs97k2PHE",
"base": "USD",
"date": "2020-02-04T18:47:04.629+0000",
"rates": []
},
"errors": [
{
"details": {
"id": "rtqt_7cz80Ny8dToSqoWlHTJJnP",
"service_level": "FEDEX_EXPRESS_SAVER",
"display_name": "FedEx Express Saver"
},
"message": "[868] Service is not allowed. ",
"type": "fedex_api"
}
],
"quotes": [
{
"id": "rtqt_4BUyxLEUeoU6zDdprCRoUV",
"amount_subtotal": 943.18,
"mode": {
"delivery_date_estimate": null,
"display_name": "UPS Expedited ",
"rates": [
{
"amount": 848.31,
"note": "UPS api: standard rate",
"type": "retail_shipping"
},
{
"amount": 64.4,
"note": "UPS api: fuel surcharge",
"type": "fuel_surcharge"
},
{
"amount": 40.0,
"note": "UPS api: extended area",
"type": "carrier_fee"
},
{
"amount": -9.53,
"note": "UPS negotiated discount",
"type": "negotiated_discount"
}
],
"service_level": "UPS_WORLDWIDE_EXPEDITED",
"transit_business_days": null,
"transit_days": null
},
"packages": [
{
"id": "1",
"weight": {
"billable": 32.0,
"dimensional": 30.7554,
"factor": 139,
"weight_unit": "pound"
}
}
],
"weight": {
"billable": 32.0,
"unit": "pound"
}
},
{
"id": "rtqt_1jyuPdiE5uIBcYzhO54DAb",
"amount_subtotal": 1058.86,
"weight": {
"billable": 32.0,
"unit": "pound"
},
"mode": {
"delivery_date_estimate": null,
"display_name": "UPS Saver ",
"rates": [
{
"amount": 957.26,
"note": "UPS api: standard rate",
"type": "retail_shipping"
},
{
"amount": 72.3,
"note": "UPS api: fuel surcharge",
"type": "fuel_surcharge"
},
{
"amount": 40.0,
"note": "UPS api: extended area",
"type": "carrier_fee"
},
{
"amount": -10.7,
"note": "UPS negotiated discount",
"type": "negotiated_discount"
}
],
"service_level": "UPS_SAVER",
"transit_business_days": null,
"transit_days": null
},
"packages": [
{
"id": "1",
"weight": {
"billable": 32.0,
"dimensional": 30.7554,
"factor": 139,
"weight_unit": "pound"
}
}
]
}
]
}
Yêu cầu đánh giá vận chuyển
Khám phá các cặp khóa/giá trị trong yêu cầu đánh giá vận chuyển.
Yêu cầu tỷ lệ vận chuyển quốc tế cho nhiều nhà cung cấp vận chuyển được cấu hình trong cài đặt của cửa hàng bạn trong Zonos.