FedEx 標誌
Developer Portal
Open Ship API
概覽

此 API 讓您能靈活地建立貨件,並在不時收到資料時為貨件輸入資料,而無須只能在貨件備妥可供處理時一次過填寫所有託運資料。貨件於五日期內維持可供填寫資料的狀態,且在該期間內接受新增、刪除或修改包裹。於第五日結束時,貨件則必須獲確認,否則會被刪除。開放式託運的同步模式最多可接受 40 件包裹/貨件,非同步模式最多可接受 300 件包裹/貨件,而國際商品則可接受 999 件包裹/貨件。

版本
v1
最後更新日期
2020 年 7 月 27 日

此 API 讓您能靈活地建立貨件,並在不時收到資料時為貨件輸入資料,而無須只能在貨件備妥可供處理時一次過填寫所有託運資料。貨件於五日期內維持可供填寫資料的狀態,且在該期間內接受新增、刪除或修改包裹。於第五日結束時,貨件則必須獲確認,否則會被刪除。開放式託運的同步模式最多可接受 40 件包裹/貨件,非同步模式最多可接受 300 件包裹/貨件,而國際商品則可接受 999 件包裹/貨件。


主要功能

貨運棧板圖示

隨時讓您新增包裹

建立主要 Open Ship 貨件後,您可以在最多五天內任何時候為開放式貨件新增貨件。

電郵圖示

透過電郵寄發退件標籤

您可以將 FedEx Express®、FedEx Ground、FedEx Ground® Economy 及 FedEx Freight® 包裹的回件標籤透過電郵寄送予客戶。電郵載有連結,讓客戶可以檢視及列印標籤,電郵內更附有 QR 碼,客戶可在指定 FedEx 服務站掃瞄該 QR 碼,由 FedEx 為客戶列印標籤。

此部分涵蓋本 API 及其終端點所有相關技術更新的日誌。所有更改按照日期分類。所述日期顯示有關更改上載至正式版本的日期。 

如需進一步了解這些功能,我們建議您瀏覽此 API 的 API 文件頁面

-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

2025年1月13日更改日誌:

  • 簡化商品託運:這項全新託運功能讓顧客只須在託運請求中提供商品說明,而非完整的商品詳情,便可在歐盟國家/地區託運自由流通的貨品。
  • 推出全新醫療保健識別碼服務「貨品分銷實務」。

2024年7月15日更改日誌:

  • 推出全新服務:FedEx International Deferred Freight (FDF)。這項新的全球空運託運服務針對國際空運貨件提供符合成本效益的解決方案,運費經濟實惠,且提供更寬裕的遞送/運送時間。此服務僅適用於指定國家/地區之間的路線。
  • 除了熱敏打印機現有的203 DPI解像度外,亦新增了300 DPI標籤解像度支援。無須更改標籤格式,即可使用新的300 DPI解像度標籤。
  • 危險物品(DG)陸運特別服務允許寄件人以陸運方式在歐洲主要巿場境內託運危險物品。引入新的standaloneBatteryDetails元素,作為packageSpecialServices物件下危險物品陸運措施的一部分。根據歐洲境內的危險物品陸運措施,引入以下新的包裹層級特別服務選項:
    • 單獨鋰電池貨件
    • 全面受監管危險物品陸運
    • 陸運限量貨件
    • 基因改造(微)生物
    • B 類生物物質
    • 除外數量
    • 放射性物質

2023 年 10 月 16 日更改日誌:

新的 FedEx Express 國內服務正式引入歐盟地區。單獨貨件將使用下列服務類型處理:

  • FedEx® First
  • FedEx® 優先速遞特快服務
  • FedEx® 優先速遞服務
  • FedEx® 優先速遞特快大貨服務
  • FedEx® 優先速遞大貨服務

2023 年 7 月 17 日更改日誌:

貨件目的地為美國的 FedEx Express 及 FedEx Ground 服務,已移除貨到付款 (C.O.D) 及電子貨到付款 (E.C.O.D) 選項。生效日期為 2023 年 7 月 31 日。

下列服務的貨到付款及電子貨到付款服務不受影響:

  • 加拿大境內貨件
  • FedEx Ground 從美國寄至加拿大的貨件
  • 其他支援貨到付款及電子貨到付款服務的地區

2022 年 5 月 22 日更改日誌:

labelStockType 項目中的熱感應標籤,以計算數值形式新增了兩個新的標籤庫類型:

  • STOCK_4X85_TRAILING_DOC_TAB
  • STOCK_4X105_TRAILING_DOC_TAB

2022 年 4 月 22 日更改日誌:

已新增新元素 cargoAircraftOnly
cargoAircraftOnly 元素值設定為布林格式的 True 值時即表示危險品的貨件運輸模式為貨機。此元素的預設值為 False。
備註:貨機載運貨件的空運提單會加上 DGD-CAO 識別符

2022 年 2 月 19 日更改日誌:

  • 全新項目 soldTo 已新增至要求中:
    soldTo 項目將表示負責購買從寄件人手上運送至收件人處之商品的一方。Sold to 方並不一定是收件人或登記進口商。當部分海關條例是否適用乃取決於買家,而非收件人的時候,Sold to 方便具有相關性。
  • 寄件人/聯絡人物件中,現在只需提供 personNamecompanyName 其中之一即可,無需同時提供兩者。若 personName 和 CompanyName 皆為空白或未在要求中提供,便會傳回錯誤。