DOCS
Trang chủTài liệu tham khảo API API Định giá REST Đối tượng Rating

Đối tượng Rating

Khám phá các khả năng và chức năng của đối tượng Rating.

Đối tượng Rating sẽ cung cấp báo giá vận chuyển theo mức dịch vụ với một bảng chi tiết các khoản phụ phí, lệ phí và chiết khấu tỷ giá thương lượng tạo nên báo giá.

Các thuộc tính 

Trường↕Ghi chú↕
id STRINGMã định danh duy nhất cho đối tượng. Mã cho đối tượng rating sẽ luôn được tiền tố với ship.
currency HASHHash cung cấp thông tin về tiền tệ cơ sở được gửi trong yêu cầu và cung cấp cho phản hồi.
currency.id STRINGMã định danh duy nhất cho đối tượng tiền tệ.
currency.base STRINGTiền tệ cơ sở như được gửi trong yêu cầu rating, được biểu thị bằng mã ISO ba chữ cái. Tất cả các số tiền trong đối tượng rating được liệt kê bằng tiền tệ cơ sở.
currency.date TIMESTAMPNgày mà tỷ giá tiền tệ được lấy, theo định dạng ISO 8601 YYYY-MM-DDTHH:mm:ss.sssZ.
currency.rates HASHHash chứa các tiền tệ và tỷ giá hối đoái cần thiết để chuyển đổi từ tiền tệ cơ sở.
errors HASHHash chứa các chi tiết về bất kỳ lỗi nào trong yêu cầu.
errors.type STRINGNguồ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 STRINGLý do mô tả cho lỗi từ nhà cung cấp dịch vụ tương ứng.
errors.details HASHHash chứa chi tiết về mức dịch vụ trả về lỗi.
errors.details.id STRINGMã định danh duy nhất cho mức dịch vụ.
errors.details.service_level STRINGMức dịch vụ với nhà cung cấp, ví dụ: standard.
errors.details.display_name STRINGTên hiển thị cho mức dịch vụ.
quotes LISTDanh sách báo giá vận chuyển theo mức dịch vụ.
quotes.id STRINGMã định danh duy nhất cho đối tượng. Mã cho đối tượng quotes sẽ luôn được tiền tố với rtqt.
quotes.amount_subtotal DECIMALTổng chi phí vận chuyển được tính toán cho mức dịch vụ.
quotes.weight HASHHash cung cấp thông tin về trọng lượng được sử dụng cho báo giá vận chuyển.
quotes.weight.billable DECIMALTrọng lượng có thể tính toán được 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 HASHHash chứa thông tin chi tiết về mức dịch vụ.
quotes.mode.service_level STRINGservice_level với nhà cung cấp, 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à cung cấp dịch vụ để xem danh sách đầy đủ các mức dịch vụ có sẵn theo nhà cung cấp dịch vụ.
quotes.mode.display_name STRINGTên hiển thị cho mức dịch vụ.
quotes.mode.delivery_date_estimate TIMESTAMPNgày giao hàng ước tính cho mức dịch vụ, theo định dạng ISO 8601 YYYY-MM-DDTHH:mm:ss.sssZ. Điều này sẽ được trả về nếu có sẵn từ API nhà cung cấp dịch vụ.
quotes.mode.transit_business_days INTEGERSố ngày vận chuyển ước tính cho mức dịch vụ chỉ tính các ngày làm việc làm ngày vận chuyển. Điều này sẽ được trả về nếu có sẵn từ API nhà cung cấp dịch vụ.
quotes.mode.transit_days INTEGERSố ngày vận chuyển ước tính cho mức dịch vụ. Điều này sẽ được trả về nếu có sẵn từ API nhà cung cấp dịch vụ.
quotes.mode.rates HASHHash chứa thông tin chi tiết về phân tích chi tiết số tiền tỷ giá vận chuyển.
quotes.mode.rates.amount DECIMALSố tiền của mục tỷ giá cụ thể.
quotes.mode.rates.note STRINGChi tiết bổ sung về những gì mục tỷ giá đại diện.
quotes.mode.rates.type STRINGLoại của mục tỷ giá. Các giá trị có thể bao gồm retail_shipping fuel_surcharge carrier_fee negotiated_discount.
quotes.packages LISTDanh sách các chi tiết về các gói hàng được vận chuyển.
quotes.packages.id STRINGMã định danh duy nhất cho đối tượng packages.
quotes.packages.weight HASHHash chứa chi tiết về trọng lượng cho gói hàng.
quotes.packages.weight.billable DEMICALTrọng lượng có thể tính toán được của gói hàng.
quotes.packages.weight.dimensional DECIMALTrọng lượng kích thước của gói hàng.
quotes.packages.weight.factor INTEGERTrọng lượng quốc tế được tính toán để tính toán trọng lượng kích thước cho gói hàng.
quotes.packages.weight.weight_unit STRINGMột chuỗi có đơ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.
1{
2 "id": "ship_5p67angIDnS91CyfpW55YZ",
3 "currency": {
4 "id": "curr_1Rp9lhXSRXvEWVs97k2PHE",
5 "base": "USD",
6 "date": "2020-02-04T18:47:04.629+0000",
7 "rates": []
8 },
9 "errors": [
10 {
11 "details": {
12 "id": "rtqt_7cz80Ny8dToSqoWlHTJJnP",
13 "display_name": "FedEx Express Saver",
14 "service_level": "FEDEX_EXPRESS_SAVER",
15 "message": "[868] Service is not allowed. ",
16 "type": "fedex_api"
17 }
18 }
19 ],
20 "quotes": [
21 {
22 "id": "rtqt_4BUyxLEUeoU6zDdprCRoUV",
23 "amount_subtotal": 943.18,
24 "mode": {
25 "delivery_date_estimate": null,
26 "display_name": "UPS Expedited ",
27 "rates": [
28 {
29 "amount": 848.31,
30 "note": "UPS api: standard rate",
31 "type": "retail_shipping"
32 },
33 {
34 "amount": 64.4,
35 "note": "UPS api: fuel surcharge",
36 "type": "fuel_surcharge"
37 },
38 {
39 "amount": 40,
40 "note": "UPS api: extended area",
41 "type": "carrier_fee"
42 },
43 {
44 "amount": -9.53,
45 "note": "UPS negotiated discount",
46 "type": "negotiated_discount"
47 }
48 ],
49 "service_level": "UPS_WORLDWIDE_EXPEDITED",
50 "transit_business_days": null,
51 "transit_days": null
52 },
53 "packages": [
54 {
55 "id": "1",
56 "weight": {
57 "billable": 32,
58 "dimensional": 30.7554,
59 "factor": 139,
60 "weight_unit": "pound"
61 }
62 }
63 ],
64 "weight": {
65 "billable": 32,
66 "unit": "pound"
67 }
68 },
69 {
70 "id": "rtqt_1jyuPdiE5uIBcYzhO54DAb",
71 "amount_subtotal": 1058.86,
72 "mode": {
73 "delivery_date_estimate": null,
74 "display_name": "UPS Saver ",
75 "rates": [
76 {
77 "amount": 957.26,
78 "note": "UPS api: standard rate",
79 "type": "retail_shipping"
80 },
81 {
82 "amount": 72.3,
83 "note": "UPS api: fuel surcharge",
84 "type": "fuel_surcharge"
85 },
86 {
87 "amount": 40,
88 "note": "UPS api: extended area",
89 "type": "carrier_fee"
90 },
91 {
92 "amount": -10.7,
93 "note": "UPS negotiated discount",
94 "type": "negotiated_discount"
95 }
96 ],
97 "service_level": "UPS_SAVER",
98 "transit_business_days": null,
99 "transit_days": null
100 },
101 "packages": [
102 {
103 "id": "1",
104 "weight": {
105 "billable": 32,
106 "dimensional": 30.7554,
107 "factor": 139,
108 "weight_unit": "pound"
109 }
110 }
111 ],
112 "weight": {
113 "billable": 32,
114 "unit": "pound"
115 }
116 }
117 ]
118}

Trang này có hữu ích không?

Nhận hỗ trợ·Tài liệu pháp lý·© 2026 Zonos
Trên trang này:
  • Đối tượng Rating
  • Các thuộc tính