Thuộc tính
Trường | Ghi chú |
---|---|
id STRING | Định danh duy nhất cho đối tượng. Id cho đối tượng đánh giá sẽ luôn được tiền tố bằng ship . |
currency HASH | Hash cung cấp thông tin về loại tiền tệ cơ sở được gửi trong yêu cầu và được cung cấp cho phản hồi. |
currency.id STRING | Định danh duy nhất cho đối tượng tiền tệ. |
currency.base STRING | Loại tiền tệ cơ sở như đã gửi trong yêu cầu đánh giá, được đại diện bởi một mã ISO ba chữ cái. Tất cả các khoản tiền trong đối tượng đánh giá được liệt kê bằng loại tiền tệ cơ sở. |
currency.date TIMESTAMP | Ngày mà tiền tệ rate được lấy, theo định dạng ISO 8601 YYYY-MM-DDTHH:mm:ss.sssZ . |
currency.rates HASH | Hash chứa các loại tiền tệ và tỷ giá hối đoái cần thiết để chuyển đổi từ loại tiền tệ cơ sở. |
errors HASH | Hash chứa chi tiết về bất kỳ lỗi nào trong yêu cầu. |
errors.type STRING | Nguồn gốc của lỗi. Các giá trị có thể bao gồm fedex_api ups_api dhl_api usps_api internal_error zonos_configuration . |
errors.message STRING | Lý do mô tả cho lỗi từ nhà vận chuyển tương ứng. |
errors.details HASH | Hash chứa chi tiết về cấp dịch vụ đã trả về lỗi. |
errors.details.id STRING | Định danh duy nhất cho cấp dịch vụ. |
errors.details.service_level STRING | Cấp dịch vụ với nhà vận chuyển, ví dụ: standard . |
errors.details.display_name STRING | Tên hiển thị cho cấp dịch vụ. |
quotes LIST | Danh sách các báo giá vận chuyển theo cấp dịch vụ. |
quotes.id STRING | Định danh duy nhất cho đối tượng. Id cho đối tượng báo giá sẽ luôn được tiền tố bằng rtqt . |
quotes.amount_subtotal DECIMAL | Tổng chi phí vận chuyển được tính toán cho cấp dịch vụ. |
quotes.weight HASH | Hash cung cấp thông tin về trọng lượng được sử dụng cho chi phí vận chuyển đã báo giá. |
quotes.weight.billable DECIMAL | Trọng lượng tính phí của gói hàng được sử dụng cho báo giá vận chuyển. |
quotes.weight.unit STRING | Đơn vị đo lường cho trọng lượng. Các giá trị có thể là pound , ounce , kilogram , và null . Khi null , pound sẽ được sử dụng. |
quotes.mode HASH | Hash chứa thông tin chi tiết về cấp dịch vụ. |
quotes.mode.service_level STRING | Cấp dịch vụ với nhà vận chuyển, ví dụ: standard . Cá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_ground . Xem tài liệu nhà vận chuyển để biết danh sách đầy đủ các cấp dịch vụ có sẵn theo nhà vận chuyển. |
quotes.mode.display_name STRING | Tên hiển thị cho cấp dịch vụ. |
quotes.mode.delivery_date_estimate TIMESTAMP | Ngày ước lượng giao hàng cho cấp độ dịch vụ, trong định dạng ISO 8601 YYYY-MM-DDTHH:mm:ss.sssZ . Sẽ được trả về nếu có sẵn từ API của nhà vận chuyển. |
quotes.mode.transit_business_days INTEGER | Số ngày vận chuyển ước lượng cho cấp độ dịch vụ chỉ tính các ngày làm việc làm ngày vận chuyển. Sẽ được trả về nếu có sẵn từ API của nhà vận chuyển. |
quotes.mode.transit_days INTEGER | Số ngày vận chuyển ước lượng cho cấp độ dịch vụ. Sẽ được trả về nếu có sẵn từ API của nhà vận chuyển. |
quotes.mode.rates HASH | Hash chứa thông tin chi tiết về phân tích cấp độ vận chuyển rate. |
quotes.mode.rates.amount DECIMAL | Số tiền của mục cụ thể rate. |
quotes.mode.rates.note STRING | Chi tiết bổ sung về mục rate đại diện số tiền. |
quotes.mode.rates.type STRING | Loại mục rate. Các giá trị có thể bao gồm retail_shipping fuel_surcharge carrier_fee negotiated_discount . |
quotes.packages LIST | Một danh sách chi tiết về các gói hàng đang được vận chuyển. |
quotes.packages.id STRING | Bộ nhận dạng duy nhất cho đối tượng gói hàng. |
quotes.packages.weight HASH | Hash chứa chi tiết về trọng lượng cho gói hàng. |
quotes.packages.weight.billable DEMICAL | Trọng lượng có thể tính của gói hàng. |
quotes.packages.weight.dimensional DECIMAL | Trọng lượng kích thước của gói hàng. |
quotes.packages.weight.factor INTEGER | Hệ số trọng lượng quốc tế được sử dụng để tính toán trọng lượng kích thước cho gói hàng. |
quotes.packages.weight.weight_unit STRING | 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 , pound sẽ được sử dụng. |
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",
"display_name": "FedEx Express Saver",
"service_level": "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,
"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"
}
}
],
"weight": {
"billable": 32.0,
"unit": "pound"
}
}
]
}
Đối tượng Đánh giá
Khám phá các khả năng và chức năng của đối tượng Đánh giá.
Đối tượng Đánh giá sẽ cung cấp báo giá vận chuyển theo cấp độ dịch vụ với sự phân tích các khoản phụ phí, phí và các khoản giảm giá rate đã thương lượng tạo nên báo giá.