DOCS
首頁API 參考資料 Rating REST API Rating 物件

Rating 物件

探索 Rating 物件的功能和特性。

Rating 物件會根據服務級別提供運費報價，並詳細說明組成報價的附加費、費用和談判費率折扣。

屬性 

欄位↕說明↕
id STRING物件的唯一識別碼。Rating 物件的 id 一律以 ship 開頭。
currency HASHHash 提供請求中發送的基礎貨幣資訊以及為回應提供的資訊。
currency.id STRING貨幣物件的唯一識別碼。
currency.base STRING運費查詢請求中發送的基礎貨幣，以三字母 ISO 代碼表示。Rating 物件中的所有金額都以基礎貨幣列出。
currency.date TIMESTAMP提取貨幣匯率的日期，採用 ISO 8601 格式 YYYY-MM-DDTHH:mm:ss.sssZ。
currency.rates HASHHash 包含從基礎貨幣轉換所需的貨幣和匯率。
errors HASHHash 包含請求中任何錯誤的詳細資訊。
errors.type STRING錯誤的來源。可能的值包括 fedex_api ups_api dhl_api usps_api internal_error zonos_configuration。
errors.message STRING來自相應運輸商的錯誤的說明性原因。
errors.details HASHHash 包含返回錯誤的服務級別的詳細資訊。
errors.details.id STRING服務級別的唯一識別碼。
errors.details.service_level STRING運輸商的服務級別，例如 standard。
errors.details.display_name STRING服務級別的顯示名稱。
quotes LIST按服務級別列出的運費報價清單。
quotes.id STRING物件的唯一識別碼。Quotes 物件的 id 一律以 rtqt 開頭。
quotes.amount_subtotal DECIMAL該服務級別的運費總額。
quotes.weight HASHHash 提供用於報價運費的重量資訊。
quotes.weight.billable DECIMAL用於運費報價的套件計費重量。
quotes.weight.unit STRING重量的測量單位。可能的值為 pound、ounce、kilogram 和 null。當為 null 時，將使用 pound。
quotes.mode HASHHash 包含服務級別的詳細資訊。
quotes.mode.service_level STRING運輸商的 service_level，例如 standard。常見範例包括：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 和 fedex_international_ground。請參閱運輸商文件以取得每個運輸商可用服務級別的完整清單。
quotes.mode.display_name STRING服務級別的顯示名稱。
quotes.mode.delivery_date_estimate TIMESTAMP服務級別的預計交付日期，採用 ISO 8601 格式 YYYY-MM-DDTHH:mm:ss.sssZ。如果運輸商 API 提供此資訊，將予以返回。
quotes.mode.transit_business_days INTEGER服務級別的預計運輸天數，僅計算運輸日期為工作日的天數。如果運輸商 API 提供此資訊，將予以返回。
quotes.mode.transit_days INTEGER服務級別的預計運輸天數。如果運輸商 API 提供此資訊，將予以返回。
quotes.mode.rates HASHHash 包含運費金額細項的詳細資訊。
quotes.mode.rates.amount DECIMAL特定費率項目的金額。
quotes.mode.rates.note STRING關於費率項目金額代表內容的其他詳細資訊。
quotes.mode.rates.type STRING費率項目的類型。可能的值包括 retail_shipping fuel_surcharge carrier_fee negotiated_discount。
quotes.packages LIST包含有關正在寄送的套件詳細資訊的清單。
quotes.packages.id STRING套件物件的唯一識別碼。
quotes.packages.weight HASHHash 包含套件重量的詳細資訊。
quotes.packages.weight.billable DEMICAL套件的計費重量。
quotes.packages.weight.dimensional DECIMAL套件的體積重量。
quotes.packages.weight.factor INTEGER用於計算套件體積重量的國際重量係數。
quotes.packages.weight.weight_unit STRING包含重量測量單位的字串。可能的值為 pound ounce kilogram null。當為 null 時，將使用 pound。
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}

這個頁面有幫助嗎？

獲取支持·法律文件·© 2026 Zonos
在此頁面：
  • Rating 物件
  • 屬性