Ship API
簡介
如要使用 FedEx 應用程式開發介面 (API),請務必先了解 FedEx® 服務的各種面向。本文件為您整理好 FedEx 託運業務知識,協助您了解各種託運選項、規定與指南。這些資源針對您所有與託運領域相關的問題提供解答,並提供您使用 FedEx 應用程式開發介面 (API) 寄送貨件。
託運應用程式開發介面 (API) 詳細資料
託運應用程式開發介面 (API) 可讓您將 FedEx 託運功能整合到應用程式中。運用託運應用程式開發介面 (API),您就能處理國內、國際及退貨貨件的包裹託運請求,並將這些請求提交給 FedEx。
每項貨件請求都包含貨件及包裹的詳細資訊。
FedEx 託運服務可分類為:
- 國內託運
- 國際託運
託運應用程式開發介面 (API) 的運作方式
以下是此應用程式開發介面 (API) 提供的功能:
建立貨件
請利用本端點建立含有所有託運必需資訊的 FedEx 貨件。
與此請求關聯的輸入資訊如下:
- 帳號 – FedEx 託運帳號。
- 取件類型 – 指出貨件是否為自行投遞至 FedEx 服務站或由 FedEx 取件。也會指出該貨件是否為定期預約取件,或是首次預約取件。此為 FedEx Express、FedEx Ground 及 FedEx Ground® Economy (先前稱為 FedEx SmartPost®) 的必要資訊。
- 服務類型 – 用於託運包裹的服務類型。
- 包裹類型 – 包裹使用的包裝方式。
- 寄件人資訊
- 收件人資料
- 託運付款類型 (寄件人/收件人/第三方/帳戶等)
- 付款人資訊 – 如果提供的付款類型為 SENDER (寄件人),此資訊元素就非必需。
- 個別包裹重量
- 標籤規格 – 標籤使用的影像類型、印表機格式及標籤紙詳細資訊。您也可以指定客戶特定的詳細資訊,例如文件索引標籤內容、法規標籤,以及標籤上的遮蔽資料。
此請求成功獲得回應後,將會取得追蹤號碼和標籤資訊,對於貨件追蹤非常實用。
注意:為避免在標籤及 FedEx 系統中輸入錯誤資料,請勿在您的「建立貨件」請求中輸入非 ASCII 字元。
驗證貨件
此端點可讓您在提交最終貨件請求之前,驗證貨件詳細資料的正確性。此功能也可讓收到使用者客戶託運訂單的企業,在向 FedEx 提交建立貨件請求和列印標籤之前,驗證部分貨件資訊。若出於任何原因必須編輯或變更資訊,則在使用者仍可確認變更時均可完成這些動作。此端點可協助您在實際提交之前,找出並更正貨件中的錯誤。
注意:此請求不會驗證街道地址詳細資料。
與此請求關聯的輸入資訊如下:
- 帳號 – FedEx 託運帳號。
- 取件類型 – 指出貨件是否為自行投遞至 FedEx 服務站或由 FedEx 取件。也會指出該貨件是否為定期預約取件,或是首次預約取件。此為 FedEx Express、FedEx Ground 及 FedEx Ground® Economy 的必要資訊。
- 服務類型 – 用於託運包裹的服務類型。
- 包裹類型 – 包裹使用的包裝方式。
- 寄件人資訊
- 收件人資料
- 託運付款類型 (寄件人/收件人/第三方/帳戶等)
- 付款人資訊 – 如果提供的付款類型為 SENDER (寄件人),此資訊元素就非必需。
- 個別包裹重量
- 標籤規格 – 標籤使用的影像類型、印表機格式及標籤紙詳細資訊。您也可以指定客戶特定的詳細資訊,例如文件索引標籤內容、法規標籤,以及標籤上的遮蔽資料。
此請求的成功回應為「200 OK」與交易識別碼。在貨件資料無效或不正確的情況下,輸出會在回應中傳回錯誤、警告、注意事項及警示,以便更正相關項目並藉由修正問題方式重新驗證貨件。
以下是有關此端點的幾項要點:
- 此為貨件層級驗證,因此僅支援驗證單一貨件。
- 貨件驗證支援所有 Express 和 Ground 國內和國際貨件以及所有適用的特殊服務。
- 貨件驗證支援 FedEx Ground® Economy,但不支援貨運 LTL 貨件。
擷取非同步貨件
使用此端點可透過工作 ID 擷取非同步處理的貨件。
與此請求關聯的輸入資訊如下:
- jobId (工作 ID)
- accountNumber (帳號)
此請求成功獲得回應後,系統會針對各別 jobId 傳回所有標籤及貨件報告詳細資訊。如果傳回的輸出資料有誤,請修正問題來重新提交貨件。
取消託運
運用此請求可取消已經建立並交付給 FedEx 的貨件/包裹。
與此請求關聯的輸入資訊如下:
- 追蹤號碼。
- 帳號 – FedEx 託運帳號。
注意:如果要取消的貨件為電子郵件退回貨件,請將 emailReturnShipment 指定為「true」。
此請求的輸出資料會傳回指示及一則訊息,指出貨件是否已經取消。
重要事項:
- 如有控制參數 (deletioncontrol) 值,您就能指定貨件中僅有一件或是所有包裹必須刪除。
- 取消 FedEx Express 國際多包裹貨件時,如果您輸入主追蹤號碼,所有與該貨件關聯的包裹都會遭到刪除。如果您嘗試刪除貨件中的一件包裹,標籤序號就會不正確,且若您無法說明貨件中的所有包裹,就可能會在海關遭遇清關問題。
- 取消 FedEx International Ground 多包裹貨件時,如果您輸入任何與主貨件關聯的追蹤號碼,所有與貨件關聯的包裹都會遭到刪除。
- 取消 FedEx Ground 美國多包裹貨件時,您可以輸入單筆追蹤號碼來刪除貨件中的一件包裹。由於 FedEx Ground 美國多包裹貨件與序號 (1 of 2、2 of 2) 並未建立關聯,您不需要刪除整批貨件。
- 取消 FedEx Ground 貨到收款 (C.O.D.) 多包裹貨件時,輸入貨件中的任何追蹤號碼都會刪除整批貨件。如要取消 FedEx Ground® 貨到收款 (C.O.D.) 多包裹貨件,您必須逐一刪除個別包裹。
錯誤條件與提示:
如果您無法刪除包裹或貨件,就會收到錯誤條件。這項錯誤條件會指出以下情況:
- 取消 FedEx Express 貨件時,包裹已經交付給 FedEx。
- 您輸入的帳號無效。
- 帳號雖然有效,卻與追蹤號碼沒有關聯。
- 您輸入追蹤號碼無效。此條件僅適用於 FedEx Ground 貨件。FedEx Express 可接受任何位數正確的號碼。
建立標籤
FedEx 會為客戶建立與提供退貨運送標籤,並收取退貨的物品。客戶必須在 FedEx 司機抵達時,備妥要取件的包裹。請利用此選項建立 FedEx Express 及 FedEx Ground 貨件的標籤請求。
與此請求關聯的必要輸入資訊及部分關鍵資訊如下:
- 帳號 – FedEx 託運帳號。
- 取件詳細資訊 – 預約取件的詳細資訊。
- 服務類型 – 用於託運包裹的服務類型。
- 包裹類型 – 包裹使用的包裝方式。
- 寄件人資訊
- 收件人資料
- 託運付款類型 (寄件人/收件人/第三方/帳戶等)
- 特殊服務 – 針對貨件要求的可選特殊服務。
- 標籤規格 – 標籤使用的影像類型、印表機格式及標籤紙詳細資訊。您也可以指定客戶特定的詳細資訊,例如文件索引標籤內容、法規標籤,以及標籤上的遮蔽資料。
成功建立標籤請求後,此請求的輸出資料會傳回確認號碼、適用的 FedEx Express 服務和派車日期。
取消標籤
使用此選項可取消 FedEx 回件標籤;如果 FedEx Express 和 FedEx Ground 貨件尚未經運務員取件,此選項也可取消關聯貨件的取件。
如要取消標籤,請提供以下資訊元素:
- 帳號 – FedEx 託運帳號。
- 服務類型
- 確認號碼
- 派送日期
- 地點
此請求的輸出資料會傳回一項指標,也就是取消的標籤值 (True 或 False) 加上一則 FedEx 標籤取消請求成功的訊息。
美國快遞託運
您可以在美國境內使用各種 FedEx 遞送服務託運,從緊急的當日配送到較不緊急的遞送選項都可選擇。
美國快遞託運相關的服務有:
下一個工作天送達
FedEx First Overnight®
FedEx 為多數區域提供下一個工作天不晚於上午 8:00、上午 8:30、上午 9:00 或上午 9:30,以及延伸服務區域不晚於上午 10:00、上午 11:00 或下午 2:00 的上午優先送達服務。多數區域也提供週六取件與遞送服務,但需加收額外費用。[Service ENUM : FIRST_OVERNIGHT]
FedEx Priority Overnight®
FedEx 為多數美國地址提供下一個工作天不晚於上午 10:30,以及不晚於中午或下午 5:00 送達的服務。週六也提供不晚於中午、下午 1:30 或 5:00 送達的服務。此選項也為往來阿拉斯加與夏威夷的特定貨件提供 2 個工作天內送達的服務。[Service ENUM : FEDEX_PRIORITY_OVERNIGHT]
FedEx Standard Overnight®
FedEx 為多數美國地址提供下一個工作天不晚於下午 3:00 送達的服務 (住宅地址不晚於下午 5:00 或晚上 8:00)。[Service ENUM : STANDARD_OVERNIGHT]
2 到 3 個工作天送達
FedEx 2Day® A.M.
FedEx 為多數美國地址提供第二個工作天不晚於上午 10:30 及鄉村區域不晚於中午送達的服務。多數區域週一至週五皆提供服務,週六也提供取件服務,但需加收附加費用。[Service ENUM : FEDEX_2_DAY_AM]
FedEx 2Day®
FedEx 為多數區域提供第二個工作天不晚於下午 5:00 送達的服務 (住宅地址不晚於晚上 8:00)。多數區域週一至週五皆提供服務,週六也提供取件與遞送服務,但需加收附加費用。此選項也為送往阿拉斯加與夏威夷的特定貨件提供 3 個工作天內送達的服務。[Service ENUM : FEDEX_2_DAY]
FedEx Express Saver®
FedEx 為多數區域提供第三個工作天不晚於下午 5:00 送達的服務 (住宅地址不晚於晚上 8:00)。FedEx Express Saver 並不為電子郵件退貨貨件提供服務。[Service ENUM : FEDEX_EXPRESS_SAVER]
陸運商務遞送
FedEx Ground®
FedEx 根據目的地距離,提供 1–5 個工作天的指定日期送達服務 (往返阿拉斯加及夏威夷 3–7 個工作天送達)。此選項也提供工作天結束前送達服務。FedEx Ground Multiweight® 費率可協助您為重達 200 磅或以上的多包裹貨件節省運費。[Service ENUM : FEDEX_GROUND]
陸運住宅遞送
FedEx Home Delivery®
根據目的地距離,提供 1–7 個工作天指定日期送達的服務 (往返阿拉斯加及夏威夷 3–7 個工作天送達)。包裹重量及尺寸的上限分別為 150 磅、長 108 吋,或長度加周長合計 (長度 + 2 倍寬度 + 2 倍高度) 165 吋。貨件可在美國境內 50 州往來運送,但送往阿拉斯加及夏威夷可能運輸時間會更長。週一到週五,所有美國地址皆適用於當天結束送達服務,週六為幾乎全數地址適用,週日則為大部分地址適用。[Service ENUM : GROUND_HOME_DELIVERY]
FedEx Date Certain Home Delivery
FedEx 可為特定日期受理收件資訊 (收件人電話號碼為交易必需資訊) 並安排包裹遞送。[Service ENUM : DATE_CERTAIN]
FedEx Evening Home Delivery
與「特定日期送達」一樣,FedEx 也可受理客戶資訊 (收件人電話號碼為交易必要資訊) 並安排夜間送達包裹。[Service ENUM : EVENING]
FedEx Appointment Home Delivery
此選項為指定時間服務。舉例來說,如果您希望包裹於週二 1:30 送達,FedEx 會致電收件人確認該日期與時間。收件人電話號碼為交易必需資料。[Service ENUM : APPOINTMENT]
附註:
- FedEx Home Delivery 便利遞送選項的請求以貨件層級為依據,需收附加費用。
- 若要接收「便利遞送選項」(CDO) 通知連結,您需要在請求中指定可接收簡訊的正確手機號碼。
FedEx Ground® Economy (先前稱為 FedEx SmartPost®)
FedEx 提供將低重量包裹遞送至住宅地址、郵政信箱、APO、FPO 和 DPO 目的地的服務。根據目的地距離,送達時間通常為 2–7 個工作天 (相鄰的 48 州以外的運送時間更長)。FedEx 將包裹送至美國郵政服務機構,即完成遞送。此為僅供合約對象的服務,且包裹重量上限為 70 磅。[Service ENUM : SMART_POST]
如需更多資訊,請參閱 FedEx Ground® Economy 章節。
國際託運
FedEx 可為任何往來地點提供國際託運服務,也就是說,您可以為任何 FedEx 有提供服務的國家/地區建立往來託運交易。FedEx 可供您以整合託運解決方案的方式,為您的國際業務進行 FedEx 服務。
以下為根據遞送速度分組的國際託運服務:
最快速遞送 (1、2 或 3 個工作天送達)
FedEx 國際特早快遞服務®
FedEx 為全球 20 個主要地點內的特定郵遞區號提供 1、2 或 3 個工作天的包裹遞送服務。加拿大可提供 1 個工作天內不晚於上午 10:00 送達的服務,墨西哥提供 1 個工作天內不晚於上午 11:00 送達的服務 (非文件類貨件則為 2 個工作天),美國多數區域的特定郵遞區號則提供不晚於上午 8:00、8:30、9:00 或 9:30 送達的服務。[Service ENUM : INTERNATIONAL_FIRST]
FedEx 國際優先快遞服務®
FedEx 為超過 220 個國家和地區都有提供通常在 1、2 或 3 個工作天送達包裹的服務。加拿大及墨西哥各大城市提供通常在 1 個工作天內的最快速送達服務,歐洲及亞洲各大城市則提供通常在 2 個工作天內不晚於中午送達的服務。美國境內多數地點則可在上午 10:30 或中午前送達包裹。[Service ENUM : INTERNATIONAL_PRIORITY]
FedEx 國際優先快遞特快服務 (2A)
此為新推出的國際中午前送達承諾,提供海關清關、「戶對戶」(DTD) 遞送服務。送達時間通常為 1 到 3 個工作天,並且適用「FedEx 保證準時,否則退費」(MBG) 條款。
若要請求此服務,請在 ServiceType 值中傳送 FEDEX_INTERNATIONAL_PRIORITY_EXPRESS。
以下為與本服務相關的優勢:
- 快速可靠的遞送
- 貨件通常可於 1 至 3 個工作天內送達
- 向數十座城市提供 2 個工作天內不晚於中午送達的貨件遞送標準
- 從歐洲、中東、亞洲、墨西哥、南美洲各大城市寄往多數美國城市的貨件適用隔夜遞送服務
- 包裹重量上限為 68 公斤或 150 磅
- 提高對遞送承諾的掌控度
- 收件者具有管理入境大量到貨的彈性
- 國際快遞包裹服務的送達時間選項大幅增加
標籤識別:
選擇 FedEx國際優先快遞服務 Express 時,標籤會標示「IP EXP」。
FedEx 國際優先快遞服務® (2P)
此為新推出的國際當天結束前送達承諾,提供海關清關、「戶對戶」(DTD) 遞送服務。送達時間通常為 1 到 3 個工作天,並且適用「FedEx 保證準時,否則退費」(MBG) 條款。
如要請求此服務,請在 ServiceType 值中傳送 FEDEX_INTERNATIONAL_PRIORITY。
以下為與本服務相關的優勢:
- 可靠的遞送
- 提高對遞送承諾的掌控度
- 收件者具有管理入境大量到貨的彈性
- 國際快遞包裹服務的送達時間選項大幅增加
- 向美國多數重要商業中心提供隔天不晚於下午 5:00 送達服務,適用於多個歐洲市場寄件的 EuroOne 貨件
- 向美國及其他地點提供小包裹貨件延後同捆取件時間服務
- 提升歐洲寄送至美國貨物的價值地位
標籤識別:
選擇 FedEx國際優先快遞服務時,標籤會標示「IP EOD」。
單一費率國際託運
FedEx® 10 公斤快遞箱和 FedEx® 25 公斤快遞箱
簡易又經濟的國際託運方式。根據目的地採用單一費率,在託運重量不超過 22 磅時使用 FedEx 10 公斤快遞箱,不超過 56 磅時使用 FedEx 25 公斤快遞箱,透過 FedEx國際優先快遞服務,向超過 220 個國家和地區提供通常在 1、2 或 3 個工作天送達的服務。[Service ENUM : FEDEX_10KG_BOX and FEDEX_25KG_BOX]
2 到 5 個工作天送達
FedEx 國際經濟快遞服務®
FedEx 為超過 215 個國家和地區提供具成本效益的包裹遞送 (通常 2–5 個工作天可送達),並為加拿大、墨西哥及波多黎各提供可在 2-3 個工作天送達的遞送服務。[Service ENUM : INTERNATIONAL_ECONOMY]
FedEx International Connect PlusTM
新推出的 FedEx International Connect PlusTM 是一項合約型服務,提供價格較低的多種不同運費選項,且與 FedEx 國際優先快遞服務® 服務類似。此選項也提供完整的包裹掌控權,具備快速且便利的遞送優勢。[Service ENUM : FEDEX_INTERNATIONAL_CONNECT_PLUS]
詳細特色:
- 適用於電子商務的國際、指定日期、當天結束遞送
- 一般需 2-5 個工作天完成遞送
- 僅在指定市場以合約方式提供
- 無退費保證。
若要請求此服務,請在 serviceType 元素中指定服務列舉值。
注意:如需本服務詳細資訊,請聯絡 FedEx 支援代表。
5 到 10 個工作天送達
FedEx International Deferred Freight (FDF)
FedEx International Deferred Freight (FDF) 是全球空運託運服務,適用於透過經濟實惠的費率,以延長的遞送/運輸時間託運國際空運貨件。FDF 也可用於「機場到機場」(ATA)、「戶對機場」、「機場對戶」,以及「戶對戶」遞送服務。
[Service ENUM: FEDEX_INTERNATIONAL_DEFERRED_FREIGHT]
附註:
- 目前這項服務僅於特定國家/地區間路線提供。
- 不允許運送危險物品 (DG) 和受限制的商品。例如:乾冰、鋰離子電池。請聯絡 FedEx 顧客支援瞭解詳情。
- 不允許運送美國國內貨件和非美國國內貨件。
地區經濟快遞服務
FedEx® Regional Economy
FedEx® Regional Economy 為歐洲地區內的指定日期、已清關、戶對戶經濟快遞服務,適用於緊急性較低且每個包裹重量上限為 68 公斤的貨件。
如要請求此服務,請在 ServiceType 值中傳送 FEDEX_REGIONAL_ECONOMY。
以下為與本服務相關的優勢:
- 向歐洲目的地提供通常 1 到 4 個工作天送達的服務。
- 共計 22 個歐洲國家/地區可設為寄件地和目的地。(奧地利、比利時、捷克共和國、丹麥、愛沙尼亞、芬蘭、法國、德國、匈牙利、冰島、義大利、拉脫維亞、立陶宛、盧森堡、荷蘭、挪威、波蘭、斯洛維尼亞、西班牙、瑞典、瑞士、英國)。
- 提供戶對戶服務及指定日期遞送承諾。
適用於 FedEx® Regional Economy 服務的業務規則如下:
- 服務日為週一至週五,週六為一般工作天的地區也提供遞送服務。
- 適用於燃料附加費,採計不同 4000 材積係數 (適用於 FedEx 新客戶),不適用 MBG,不使用 FedEx 品牌包裝,也不提供手寫/紙本空運提單 (AWB)。
標籤識別
選取 FedEx® Regional Economy 服務時,標籤上會標示「RGNL ECONOMY」。
FedEx® Regional Economy Freight
FedEx® Regional Economy Freight 為歐洲地區內的指定日期、已清關、戶對戶經濟快遞服務,適用於緊急性較低且每個包裹重量超過 68 公斤的貨件。
如要請求此服務,請將 ServiceType 值以 FEDEX_REGIONAL_ECONOMY_FREIGHT。
以下為與本服務相關的優勢:
- 向歐洲目的地提供一般 2 到 5 個工作天、指定時間送達的服務,適用於每個包裹重量在 68 公斤以上的貨件。
- 共計 22 個歐洲國家/地區可設為寄件地和目的地。(奧地利、比利時、捷克共和國、丹麥、愛沙尼亞、芬蘭、法國、德國、匈牙利、冰島、義大利、拉脫維亞、立陶宛、盧森堡、荷蘭、挪威、波蘭、斯洛維尼亞、西班牙、瑞典、瑞士、英國)。
- 服務日為週一至週五,在週六為一般工作天的國家/地區也提供遞送服務。
- 根據地點提供在當天結束前送達的遞送承諾。
可使用以下特殊服務 (視目的地而定):
- FedEx 國際清關代理人
- 由服務站保管
適用於 FedEx® Regional Economy Freight 服務的業務規則如下:
- 服務日為週一至週五,週六為一般工作天的地區也提供遞送服務。
- FedEx 國際星期六遞送的服務視地區提供。
- 適用於燃料附加費,採計不同 4000 材積係數 (適用於 FedEx 新客戶),不適用 MBG,不使用 FedEx 品牌包裝,也不提供手寫/紙本空運提單 (AWB)。
標籤識別:
選取 FedEx® Regional Economy Freight 服務時,標籤上會標示「RGNL ECON FRT」。
歐盟 (EU) 規則
歐盟進口貨件增值稅 (VAT)
以下規則適用於歐盟進口貨件。
- 無論先前的價值例外狀況為何,所有進口至歐盟的貨物均適用增值稅。
- 150 歐元或以下的託運貨件增值稅可在銷售時使用新的進口一站式服務機制 (IOSS) 收取,或由海關申報人 (例如 FedEx) 向終端客戶收取。
- 這些增值稅規則不適用於在歐盟成員國境內進行銷售的歐盟企業。
進口一站式服務機制 (IOSS)
進口一站式服務機制 (IOSS) 是電子化入口網站,企業可用於履行進口物品遠距銷售的電子商務加值稅義務。IOSS 可讓供應商將進口物品銷售給歐盟 (EU) 境內的買家,以收取、申報及支付要向稅務主管機關繳交的加值稅。
注意:您可以在歐盟委員會網站和國稅局網站上取得歐盟的增值稅費率相關資訊。
IOSS 涵蓋符合以下條件的遠距銷售物品:
- 在銷售時由歐盟境外派送或運輸
- 以價值未超過 150 歐元 (低價值物品) 的託運貨件派送或運輸,即使訂單包含多件物品仍適用
- 以價值未超過 150 歐元 (低價值物品) 的託運貨件派送或運輸,即使訂單包含多件物品仍適用
在貨件中使用 IOSS 號碼的方式
若要使用 IOSS 處理歐盟進口貨件,
- 請在進口一站式服務機制 (IOSS) 註冊進口一站式服務機制 (IOSS) 系統,並取得 IOSS 號碼。
- 於託運請求交易期間,在貨件請求元素「寄件人\TIN\號碼」欄位中指定唯一的 IOSS 號碼
加拿大陸運服務
FedEx International Ground®
FedEx 向加拿大提供經濟型的指定日期陸運包裹遞送服務,通常會在 2–7 個工作天送達。包裹會在工作天結束前送達。FedEx Ground Multiweight 費率可協助您為重達 150 磅或以上的多包裹貨件節省運費。服務中已包含報關 (需收費用),因此我們會為您完成清關。 [Service ENUM : FEDEX_GROUND]
國際託運與包裝選項
除了標準 FedEx Express 包裝,您也可以選擇 FedEx 10 公斤快遞箱或 FedEx 25 公斤快遞箱。FedEx 10 公斤快遞箱限重 22 磅,FedEx 25 公斤快遞箱則限重 55 磅。上述包裝選項適用於 FedEx 國際優先快遞服務®,可為超過 220 個國家和地區提供。
- 文件類貨件
- 商品類貨件
文件託運
非應課稅的貨件內容,又稱為文件類貨件。不過,有些國家會對文件類貨件課徵 $1 的海關申報值。
如需更多資訊,請參閱最低海關申報值國家
注意:寄送 FedEx Express 國際多件包裹貨件 (MPS) 時,如有包裹為文件類,則貨件中所有包裹都必須為文件類。相同規定也適用於商品類貨件。商品類和文件類包裹不可混合在同一批多件包裹貨件 (MPS) 中託運。
商品託運
應課關稅貨件內容,又稱為商品類貨件。託運商品時,貨件中的完整商品清單必須檢附於每件包裹的託運請求中,以便正確計算商品價值。
注意:寄送 FedEx Express 國際多包裹貨件 (MPS) 時,如有包裹為商品類貨件,則貨件中所有包裹都必須包含商品。商品類與文件類貨件不可混合在多包裹貨件中。
物品自由流通
物品自由流通是指在特定區域或地區內,物品和產品可以無限制地流通,不受關稅、配額或其他貿易限制。這代表物品可以在該地區內自由運輸、購買和銷售,不受任何阻礙。
歐盟地區內的自由流通:從非歐盟國家/地區進入歐盟關稅領域的物品,稱為非商品物品。這些物品必須先經放行自由流通,才可以在歐盟境內銷售。為此,應替物品報關,並繳納關稅和/或增值稅。一旦符合這些條件,非商品物品就會變成商品物品。這些物品將獲得與在歐盟境內生產、收穫或開採的物品相同的地位,且可以在歐盟境內自由運輸。
簡化商品託運
簡化商品託運讓您僅需要提供商品說明,而不需要在託運請求中提供完整的商品詳細資料,即可託運在歐洲國家/地區自由流通的物品。
注意:若要檢查您的寄件地/目的地組合是否符合簡化商品託運的資格,請使用 Global Trade API 中的「檢索法規詳細資料」端點。
商品說明
貨件說明不精確或含糊,是海關延遲的常見原因。商品說明必須能夠回答以下問題:
- 內容是什麼?
- 總共有幾件?
- 物品成分是什麼?
- 物品的用途是什麼?
- 製造國家/地區為何?
根據要運送的商品和文件而定,您可能必須提供更多資訊。危險物品或危險材料的商品說明有非常嚴格的規定和限制。如果您託運的商品歸類為上述其中一種類別,請務必透徹了解商品類別的托運限制。
注意:在歐洲國家/地區自由流通的物品,只需要在託運請求中提供商品說明。不需要提供完整的商品詳細資料,如製造地、重量、海關申報值或海關文件等。如果請求中說明其他商品詳細資料,則會上傳這些詳細資料,但在建立貨件時不會考慮。然而,如果客戶表示物品為「NOT_IN_FREE_CIRCULATION」,則需要提供完整的商品詳細資料,並且將對商品詳細資料進行完整驗證。
識別受限制商品
進出口商品都必須經過識別,確認是否為託運目的地或商品託運往來地點的限制商品。如果託運受限制商品,運送會立即停止,且商品會保存在倉庫中。以下資訊元素可協助您識別商品是否受限:
- 商品限制 – 此元素指出商品是否受到限制。商品的國際商品統一代碼結合其關聯價值,可用於判斷商品為受限或可託運。回應元素有:derivedHarmonizedCode (衍生國際商品統一代碼)、commodityIndex (商品索引)、source (來源)、categories (類別) 和 type (類型),這些資訊會指出商品類型及限制。
- 法規參考資料 – 此元素會指出貨件是否需要提供其他參考資料。回應時會顯示 waivers (棄權聲明)、message (訊息)、code (代碼)、text (文字) 等關聯資訊元素。
- 法規建議 – 此元素會提供商品相關的任何額外資訊或釐清資訊。回應元素建議會列出所有指定建議,也會顯示以下輸出資訊:code、text、parameter (參數) 和 localizedText (本地化文字)。
商品分類
所有進出口商品都必須根據國際商品統一分類 (HTS) 代碼經過正確分類,以便符合美國及外國政府的海關規定。請使用 HTS 來判斷商品的代碼。HTS 為一般類別指定六位數的代碼。使用 HTS 的國家可透過超過六位數的代碼來詳細定義商品,但所有定義都必須對應六位數的 HTS 系統。美國採用 10 位數的 HTS 代碼來定義商品。如需連結至美國管理進出口 HTS 代碼的機關,請前往 fedex.com 的 FedEx 國際資源中心。
商品出口許可證
出口許可證是政府向特定出口商提供的特定授權,可用於出口特定產品。出口許可證會以個案方式授予單次交易或特定期間內的出口。出口商必須申請出口許可證。許可證號碼為一個英文字母加上六個數字。每個許可證核發時都會提供到期日期。需要取得美國國務院許可證的商品,僅可透過 FedEx Express 使用 FedEx 國際管制出口商品 (FICE) 服務託運。
國際貨件內容說明如果精確且清晰易讀,海關延遲的風險就會降低。以下為提供貨品詳細說明時的幾則指南。
文件類或商品類
- 首先,請判斷您託運的貨件屬於文件類還是商品類。不同國家對文件的分類也不同,因此,您必須了解要運往的特定國家如何定義文件。
- 一般而言,文件指的是不具商業價值的商品。這類商品的特性通常會以輸入、謄寫或列印方式,在紙本或其他材質上說明,且無須檢附商業發票。如果商品具有商業價值,或屬於商業交易,則會經認定為「非文件」。所有商品類貨件均須檢附商業發票。
- 如需研究商品類別,請到 fedex.com/gtm 使用線上的 FedEx Global Trade Manager。您會在此工具中找到各國特定的資訊,以便判斷商品在您的目的地需認定為文件或非文件類。
海關清關
每個國家都有特定的國際託運法律與規範。判斷文件與海關清關要求時,您有許多資源可利用。FedEx 會提供商業發票,這是所有國際貨件都必須提供的文件。
除了 FedEx 國際空運提單和 FedEx International MailService 空運提單 (例如商業發票) 之外,如果貨件還需要其他文件,就可能需要更長的運輸時間。
空運提單
空運提單是針對相關條款與條件所述的服務而使用於 FedEx 系統中的託運文件、標籤、電子報關之類的物件。請務必使用原始文件 (影本不予受理)。
管制商品
跨國託運下列商品時,請確認您所選擇的 FedEx® 服務接受將這些商品遞送至目的地國家/地區及城市:
- 微量的危險物品
注意:如要託運微量的危險物品,請使用特殊服務選項 SMALL_QUANTITY_EXCEPTION。
- 微量放射性包裹
FedEx 國際管制出口商品 (FICE)
FICE 為出口管制貨品的美國及波多黎各客戶以精確且合規的方式處理海關清關程序。FICE 可減少處理時間、清關延遲和例外處理手續費。
簡化歐盟境內商品託運
客戶必須確認商品是否處於自由流通狀態。如果商品為「非自由流通」,則需要在應用程式開發介面 (API) 請求中說明完整的商品資訊。所有從北愛爾蘭 (NI) 運往歐盟,以及從歐盟運往北愛爾蘭 (NI) 的貨件,都不屬於歐盟境內貨件,並且不適用歐盟境內貨件的商品放寬規則。然而,所有從愛爾蘭共和國 (RI) 運往歐盟,以及從歐盟運往愛爾蘭共和國 (RI) 的貨件,都屬於歐盟境內貨件,並且適用歐盟境內貨件的商品放寬規則。
國際武器貿易條例 (ITAR)
ITAR 是一系列的美國政府法規,用於管制美國軍品管制清單 (USML) 中的國防相關物品的全球流通。FedEx 允許透過 FedEx國際優先快遞服務 (IP)、FedEx International Premium (IP1) 和 FedEx International Airport-to-Airport (ATA) 服務託運 ITAR 貨品。
國家/地區特定的清關與託運規定
下列為部分國家/地區的特定清關要求。相關要求可能因國家/地區不同而異。如需詳細資訊,請造訪 fedex.com 或聯絡 FedEx 業務專員。
英國/愛爾蘭及歐洲的海關與託運規定:
以下是與英國/愛爾蘭及歐洲相關的託運規定。
寄件地與目的地 | 清關與寄件規定 |
往返於北愛爾蘭 (NI) 與英國本土之間 |
不需要清關 (國內貨件)。 |
英國至北愛爾蘭 (NI) |
需要清關 (報關文件)。 |
歐盟至歐盟 |
物品自由流通。適用簡化商品託運。 |
愛爾蘭共和國 (RI) 至歐盟 |
物品自由流通。適用簡化商品託運。 |
歐盟至愛爾蘭共和國 (RI) |
物品自由流通。適用簡化商品託運。 |
北愛爾蘭 (NI) 至愛爾蘭共和國 (RI) |
物品自由流通。 |
北愛爾蘭 (NI) 至歐盟 |
不需要清關。不適用簡化商品託運。 |
歐盟至北愛爾蘭 (NI) |
不需要清關。 不適用簡化商品託運。 |
北愛爾蘭 (NI) 至世界其他地區以及世界其他地區至北愛爾蘭 (NI) |
需要清關。 |
英國至歐盟或歐盟至英國 |
需要清關。 |
託運服務可用於從其他國家/地區託運至北愛爾蘭 |
|
英國國際優先分送快遞服務 (IPD) 規定
- 此規定適用於自英國寄件至歐盟的客戶。
- 北愛爾蘭與愛爾蘭共和國 (歐盟 (EU) 的一部分) 保持開放的邊境。因此,託運至歐盟的 IPD 貨件 (SPOC) 可 包含託運至北愛爾蘭的包裹。
澳洲海關清關
- 一般清關要求
- 正式報關要求
- 違禁物品
- 清關訣竅
- 保稅轉運
- 進口關稅與 GST
中國海關清關
- 申報類別
- 違禁物品
- 必要文件
- 清關訣竅
- 進口關稅和稅金
- 自由貿易區與加工出口區
- 保稅轉運
中國出口海關清關
- 必要文件
- 順利清關秘訣
香港海關清關
- 申報類別
- 違禁物品
- 必要文件
- 清關訣竅
- 保稅轉運
- 進口關稅和稅金
印度出口海關清關
- 一般清關文件
- 運務員清關
- 正式清關
印尼海關清關
- 申報類別
- 違禁物品
- 清關訣竅
日本海關清關
- 申報類別
- 清關要求
- 違禁物品
- 必要文件
- 清關訣竅
- 保稅轉運
- 自由貿易區
- 進口關稅和稅金
馬來西亞海關清關
- 申報類別
- 自由商業區 (FCZ) 申報費用
- 違禁物品
- 必要文件
- 進口關稅和稅金
紐西蘭海關清關
- 申報類別
- 商品特定要求
- 違禁物品
- 進口商要求
- 保稅轉運
- 進口關稅和稅金
菲律賓海關清關
- 申報類別
- 違禁物品
- 必要文件
- 附加費
- 進口關稅和稅金
新加坡海關清關
- 申報類型
- 違禁物品
- 必要文件
- 進口關稅和稅金
- 關稅和稅金付款選項
- 自由貿易區 (FTZ)
- 監管機關與進口商資源
南韓海關清關
- 申報類別與必要文件
- 違禁物品
- 保稅轉運
- 進口關稅和稅金
台灣海關清關
- 申報類別
- 違禁物品
- 必要文件
- 進口關稅和稅金
- 經濟與自由貿易區 (FTZ) 資訊
- 倉庫規格
泰國海關清關
- 申報類別
- 違禁物品
- 食品與藥物管理局商品
- 必要文件
- 進口關稅和稅金
- 附加費與其他費用
- 自由貿易區 (FTZ)
越南海關清關
- 申報類別
- 違禁物品
- 必要文件
- 商品特定要求
- 倉庫與海關費用
- 進口關稅和稅金
託運與海關文件
為了避免包裹遭扣押或延遲,並確保包裹順利送達,正確提交文件對於國內和國際託運都是重要的一環。以下為幾種不同託運與海關文件類型:
原產地證明 (COO)
COO 是用於確認產品製造國家/地區的國際文件。有些國家會禁止從特定國家進口,多數國家會限制進口貨品的數量,還有些國家/地區則會為特定國家/地區製造的貨品提供優惠待遇。[ServiceENUM : CERTIFICATE_OF_ORIGIN]
商業發票 (CI)
此為賣方/出口商提供的文件,內容說明託運交易之相關當事方及欲運輸的物品。此為海關使用的主要文件,應盡量以物品進口國家/地區的官方語言製作。商業發票應包含貨件全部品項之詳細陳述,包括:適當的物品描述 (內容物是什麼?物品成分為何?物品的用途為何?)、數量、製造國家/地區、價格或成本、使用幣別、各商品的國際商品統一分類號碼及遞送條款。有些國家/地區要求簽署印有寄件人信頭的發票正本。出口商應一律在發票上簽名並填上日期,證明文件所提供之詳細資料屬實,且正確反映商業發票涵蓋的內容。[Service ENUM : COMMERCIAL_INVOICE]
如需更多資訊,請造訪 Global Trade Manager。
海關包裹文件
此文件可讓您新增與包裹內容相關的任何其他詳細資料。[Service ENUM : CUSTOM_PACKAGE_DOCUMENT]
海關貨件文件
您可以在此文件中新增與貨件相關的其他詳細資料。[Service ENUM : CUSTOM_SHIPMENT_DOCUMENT]
客戶指定標籤
此文件可讓您在包裹上新增自訂標籤。[Service ENUM : CUSTOMER_SPECIFIED_LABELS]
危險物品寄件人申報單
此為寄件人的危險物品申報單,內含物品性質與數量,且申報單必須簽名。[Service ENUM : DANGEROUS_GOODS_SHIPPERS_DECLARATION]
出口申報單
電子出口資訊 (EEI) 先前稱為寄件人出口申報單 (SED),美國人口普查局要求提供此文件以取得統計資料,工業安全局 (BIS) 要求提供此文件以協助行使出口管制。任何單一 B 類之貨品總價值超過美金$ 2,500 元或商品需要出口授權時,須檢附 SED/EEI。出口商或其代理人得以電子形式填妥此資訊。針對商業管制清單 (CCL) 或美國軍品管制清單 (USML) 上所列之商品,須強制透過自動化出口系統 (AES) 以電子形式檢附此資訊。[Service ENUM : EXPORT_DECLARATION]
一般代理合約
代理協議或委任書 (POA) 是由進口商向清關代理人提供的法定授權,可讓代理人代表進口商的公司向加拿大稅務局 (CRA) 處理貨件的放行與/或報帳。如果身為加拿大居民的進口商希望 Federal Express 持續擔任自身在加拿大的清關代理人,則在貨件進入加拿大之前,就必須依據說明表填寫並繳回上述表單。此表單為限定的代理協議,且僅適用於 Federal Express 貨件。此表單採用填寫格式,方便於本網站的文件資料庫區塊中使用。[Service ENUM : GENERAL_AGENCY_AGREEMENT]
標籤
此為具備郵政貨件文件上傳條件的貨件採用電子貿易文件(ETD) 特殊服務所產生的貨件標籤。此貨件標籤也可連同其他書面文件一起上傳。[Service ENUM : LABEL]
淨費率表
此為特定帳戶的費率表,可反映扣除適用折扣後的運費。您可針對各種可用服務,在 FedEx 網站下載此類文件,並產生適用區域與重量的費率表。此類報告可供下載存放,以便您在需要時查看。此處提供的費率報價僅供參考且不具法律約束力,亦不可視為協議或協議的部分內容。淨費率係依適用運輸折扣計算,不含附加費、輔助/其他費用、關稅與貨物稅,或特別處理費。[Service ENUM : NET_RATE_SHEET]
OP900
此為 FedEx Ground 危險材料申報表。[Service ENUM : OP_900]
待處理貨件電子郵件通知
用於接收待處理貨件電子郵件通知的文件。[Service ENUM: PENDING_SHIPMENT_EMAIL_NOTIFICATION]
形式發票
形式發票會在完成銷售前核發。收到供應商的形式發票後,購買人會向供應商傳送採購單或開立信用狀。賣方需根據合約的運送日期,準備好託運物品。[Service ENUM: PRO_FORMA_INVOICE]
回件指示
此為退貨標籤。[Service ENUM: RETURN_INSTRUCTIONS]
VICS 提單
VICS 提單由 VICS (北美跨產業商業標準協會) 所成立,主要使用於一般貨品零售產業的貨件。[Service ENUM: VICS_BILL_OF_LADING]
USMCA 商業發票和原產地證明
USMCA/T-MEC/CUSMA 商業發票 - 原產地證明是一種商業發票,結合了必要的原產地證明資料元素,其中的聲明有利於運送放行,以及透過該文件要求為合格物品取得美國墨西哥加拿大協議的優惠關稅待遇。申請優惠關稅待遇資格的物品必須原產並出口自美國、墨西哥或加拿大。[Service ENUM: USMCA_COMMERCIAL_INVOICE_CERTIFICATION_OF_ORIGIN]
USMCA 原產地證明
根據美國墨西哥加拿大協議,USMCA/T-MEC/CUSMA 原產地證明可用於要求優惠關稅待遇。證明中包含一系列資料元素,包括必須由為物品申請資格的出口商、生產者或進口商認證的聲明。進口物品必須原產並出口自美國、墨西哥或加拿大。此表單可用於涵蓋單一貨件,或使用長達十二個月的有效期限。[Service ENUM: USMCA_CERTIFICATION_OF_ORIGIN]
其他
以下章節說明幾種歸類為其他文件的常用文件。此類文件並非託運貨件時須強制上傳的文件,但可能必須在個別貨件進行海關清關提出。根據貨件類型、寄件地、目的地和其他因素,文件可能不同。[Service ENUM: OTHER]
包裝清單
一份空運提單中如果有多件包裹,或者貨件重量超過 100 公斤,則需要檢附包裝清單。請注意,根據託運商品而定,這項要求在各別市場可能也有不同。此清單必須正確並清晰說明貨品、數量與重量。
- FCC 740 聲明為進口可能造成有害干擾的無線射頻裝置時須提出的文件
影片影帶申報
託運具有無線射頻裝置的電器時,如果該裝置可能造成有害干擾,就必須檢附聯邦通信委員會 (FCC) 740 表單。此表包含裝置型號/類型名稱、國際商品統一分類關稅代碼、製造商名稱與地址、收件人姓名與地址,以及進口商名稱與地址等詳細資訊。
視訊影片申報單:此為託運視訊/影片時提交的申報文件,用於聲明不含猥褻或不道德內容,也不含任何提倡或主張反叛美國的內容。文件包含視訊/影片長度、視訊/影片拍攝期間以及簡短內容概要等詳細資訊。
棄權聲明:以上資訊隨時可能變更。注意:「其他」文件僅需在有國家、產品和其他海關文件所需時上傳。如要檢視多數其他常用文件清單,請按一下出口文件
其他海關與法規解決方案
加拿大海關與法規解決方案
解決方案團隊僅會針對 FedEx Express 國際貨件,為加拿大業務人員與客戶提供法規資訊與支援。
FedEx Express 進口海關債券
FedEx Express 指定 FedEx Trade Networks (FTN) 擔任貨件進口美國時的清關代理人,另經指定的狀況除外。Express 進口絕大多數貨件時,FTN 都會在報關過程擔任登記進口商 (IOR) 角色,不過如另經指定,此角色也可由客戶擔任。
非珠寶物品的申報價值 (DV) 例外
客戶託運的非珠寶物品如果價值超過 FedEx 服務指南指定的 5 萬美元上限,FedEx 會為符合資格的客戶提供永久授權 (亦稱為高申報價值 [HDV] 例外請求)。
FedEx 國際託運協助 (FISA)
FISA 為免費服務,服務對象為初次接觸國際託運或經驗不足的中小型企業和個人。
全球貿易協定和貿易法規
任何規模的企業都能因全球貿易而受益。美國自由貿易協定 (FTA) 能夠促進全球貿易、向美國出口商開啟外國市場,並且確保夥伴國家遵守共同規則與標準。FTA 創造了穩定且透明的貿易環境,讓美國各大公司更容易出口產品及服務到全世界。
一次性申報價值 (DV) 例外
寄件人如需要單次將美國國內或出口的國際 Express 貨件標準 DV 限制提高到最高的 250 萬美元,可申請提高託運貨品 DV,亦稱為國內棄權聲明請求。
寄件人指示信 (SLI)
SLI 包含美國客戶的國際貨件資訊。
附註:
- 貨件運往加拿大時,託運服務中已包含報關,因此我們會為您完成清關,但需收費用。並非所有電器託運解決方案都適用含報關的服務。
- International Ground 包裹配送服務可讓 FedEx Ground 以同一批 International Ground 貨件的形式集中託運,僅在一次入關中以一筆報關費用完成清關與處理。
國內託運
這項服務可供客戶在國內託運。並非所有服務都適用於所有區域。許多歐洲國家和墨西哥境內的國內託運都需要使用個別國家的特定帳戶。
FedEx 國內服務
以下資訊針對國內託運使用的服務提供總覽。並非所有服務都適用於所有區域。
FedEx 經濟快遞服務®
FedEx 經濟快遞服務® 為公司行號提供 3 個工作天內不晚於下午 5:00 及住宅地址不晚於晚上 7:00 送達的服務。[Service ENUM : FEDEX_ECONOMY]
FedEx First Overnight®
FedEx First Overnight® 為多數區域提供下一個工作天不晚於上午 8:00、8:30、9:00 或 9:30,以及延伸服務區域不晚於上午 10:00、上午 11:00 或下午 2:00 送達的服務。[Service ENUM : FIRST_OVERNIGHT]
FedEx Priority Overnight®
FedEx Priority Overnight® 為多數美國地址提供下一個工作天不晚於上午 10:30,以及不晚於中午、下午 5:00 送達的服務。週六也提供不晚於中午、下午 1:30 或 5:00 送達的服務。
服務日為週一至週五,週六也為多數區域提供取件與遞送服務,但需加收額外費用。[Service ENUM : FEDEX_PRIORITY_OVERNIGHT]
FedEx Standard Overnight®
FedEx Standard Overnight® 為多數地址提供下一個工作天不晚於下午 3:00,以及住宅地址不晚於下午 5:00 和晚上 8:00 送達的服務。服務日為週一至週五,週六也提供取件服務,但需加收額外費用。[Service ENUM : STANDARD_OVERNIGHT]
FedEx Ground
週一至週五送達 (上午 8:00 至工作天結束),時間視目的地距離而定。
指定日期遞送服務僅適用於美國及加拿大境內。[Service ENUM : FEDEX_GROUND]
FedEx Home Delivery®
透過 FedEx Ground 採用 FedEx Home Delivery 進行住宅區遞送需 1−7 個工作天,視目的地距離而定。[Service ENUM : GROUND_HOME_DELIVERY]
FedEx Express Saver®
FedEx Express Saver® 提供第三個工作天不晚於下午 5:00 及住宅地址不晚於晚上 8:00 送達的服務。
服務日為週一至週五,週六也為多數區域提供取件與遞送服務,但需加收額外費用。[Service ENUM : FEDEX_EXPRESS_SAVER]
FedEx SameDay® 城市
FedEx SameDay® City 為指定城市及郵遞區號提供數小時內跨城市送達的服務。週一至週五可提供取件與遞送服務。託運包裹時,使用 SAME_DAY_CITY 元素即可指定這項服務類型。使用 FedEx SameDay City 服務需要簽訂合約。請聯絡 FedEx 業務專員了解 SameDay City 的更多資訊。[Service ENUM : SAME_DAY_CITY]
注意:手寫空運提單並不適用 SameDay City 服務。此服務僅適用於墨西哥境內特定城市,與美國國內 FedEx SameDay Service 不同。
FedEx 統一費率®
FedEx 統一費率® 為單一費率託運選項,您不需要為 50 磅以下的貨件秤重或丈量尺寸,且申報價值為 $100 (含燃料、住家配送和遞送區域附加費用)。您可以選擇最符合運送物品尺寸的盒子或管子,並將包裹裝滿,只要貨件不超過 50 磅即可。此服務的付款選項包括寄件人、收件人及特定第三方。FedEx Express® 提供 2 到 3 個工作天內送達的服務,在部分區域也提供週六遞送。在 62,000 個便利服務站則提供免費路線取件或投遞服務。[Service ENUM : FEDEX_ONE_RATE]
歐洲國內服務
FedEx® First
FedEx® First 為公司行號或住宅地址提供下一個工作天不晚於上午 9:00、9:30 或 10:00 送達的包裹配送服務。[Service ENUM : FIRST_FIRST]
FedEx® 優先快遞服務
FedEx® 優先快遞服務為公司行號和住宅地址提供下一個工作天不晚於中午送達的包裹配送服務。[Service ENUM : FEDEX_PRIORITY_EXPRESS]
FedEx® Priority
FedEx® Priority 為公司行號或住宅地址提供當天結束送達的包裹配送服務。[Service ENUM : FEDEX_PRIORITY]
FedEx® Priority Express Freight
FedEx® Priority Express Freight 為公司行號或住宅地址提供下一個工作天不晚於中午送達的服務。[Service ENUM : FEDEX_PRIORITY_EXPRESS_FREIGHT]
FedEx® 優先快遞大貨服務
FedEx® 優先快遞大貨服務為公司行號和住宅地址提供當天結束送達的服務。[Service ENUM : FEDEX_PRIORITY_FREIGHT]
FedEx® 經濟快遞服務
FedEx® 經濟快遞服務提供當天結束送達的服務,適用於上限 68 公斤的包裹,可於 2 到 3 個工作天內送達。[Service ENUM : FEDEX_ECONOMY_SELECT]
如需國內託運服務區域的更多資訊,請參閱歐洲國內服務產品組合。
FedEx Ground® Economy (先前稱為 FedEx SmartPost®)
FedEx Ground® Economy 和 FedEx Ground® Economy Returns 都需要簽訂服務合約。若要註冊 FedEx Ground® Economy 出口託運或 FedEx Ground® Economy Returns,請聯絡您的 FedEx 業務專員。
FedEx Ground® Economy 可協助您透過美國郵政署 (USPS),將大量輕量且時間不急迫的企業對消費者 (B2C) 包裹集中託運,並遞送至以住宅為最終目的地的地址。本服務週一至週六向美國境內所有住家地址皆提供遞送,包括郵政信箱、軍用 APO 和 FPO 目的地。
FedEx Ground® Economy 也提供 FedEx Ground® Economy Returns 服務、美國出口貨件遞送及貨件電子郵件通知、自訂標籤,以及預約寄件託運。
FedEx Ground® Economy 服務詳細資料
FedEx Ground® Economy 服務包含以下特點:
- FedEx Ground® Economy 僅適用於美國相鄰 48 州寄出的貨件。阿拉斯加、夏威夷、波多黎各和美國屬地不屬於上述寄件地點。
- FedEx Ground® Economy 服務可遞送至美國全 50 州及屬地,包括郵政信箱和軍用地點 (陸軍郵局 – APO、艦隊郵局 – FPO、外交郵局 – DPO),以及波多黎各。
- FedEx Ground® Economy 僅為顧客包裹提供服務。原因是 FedEx Ground® 委託美國郵政署 (USPS) 將包裹遞送至以住宅為最終目的地的地址,這些包裹必須接受 USPS 限制的規範。
- 預訂寄件託運服務適用於 FedEx Ground® Economy 貨件。
- USPS 可提供週六遞送。此服務無需 FedEx 附加費用。
- FedEx Ground® Economy 貨件標籤包含一個 12 位數 FedEx 主貨件追蹤號碼搭配 34 位數 FedEx 條碼字串、一個帶有條碼字串的美國郵政署 (USPS) 追蹤號碼,以及一個選用的顧客參考編號條碼。包裹僅可透過 FedEx 追蹤號碼或 USPS 追蹤號碼進行追蹤。
- 可受理的付款類型為帳單寄件人和帳單收件人。
- FedEx Ground® Economy Returns 為所有寄件人提供美國境內一天 100 件以上包裹的回件服務。簽訂合約後,寄件人為自己的出口託運使用任何服務的同時,仍可使用 FedEx Ground® Economy Returns。列印及電子郵件回件標籤選項均適用。
- FedEx Ground® Economy 無法為寄件地不是美國相鄰各州的包裹提供取件服務。
注意:系統會為 FedEx Ground® Economy 出口貨件和 FedEx Ground® Economy Returns 提供不同的帳號。如果客戶簽訂的合約是退貨服務合約,他們需要使用國家號碼相關的帳戶。
標準郵件、裝訂印刷品和媒體須採用以下尺寸限制:
- 尺寸:長度與周長合計 (長度 + 2 倍寬度 + 2 倍高度) 不得超過 84 吋。
- 任何一邊的尺寸都不得超過 60 吋。
- 最小尺寸為長 6 吋 x 寬 4 吋 x 高 1 吋。
指定包裹須採用以下限制:
- 尺寸:長度與周長合計不得超過 130 吋。
- 任何一邊的尺寸不得超過 60 吋。
- 最小尺寸為長 6 吋 X 寬 4 吋 X 高 1 吋。
- 登記為裝訂印刷品或媒體的包裹如果重量不到一磅,就會無條件進位整為一磅。
FedEx Ground® Economy 標籤詳細資料
- FedEx Ground® Economy(FGE) 貨件標籤包含一個 12 位數 FedEx 主貨件追蹤號碼搭配 34 位數 FedEx 條碼字串、一個帶有條碼字串的美國郵政署 (USPS) 追蹤號碼,以及一個選用的顧客參考編號條碼。以下為此更新的優點:
- FedEx 追蹤號碼可讓您搜尋追蹤詳細資料,進而處理您的包裹追蹤查詢。
- 這能夠讓您更輕鬆地識別 FedEx 貨件。
- 當您輸入 FGE 貨件的顧客參考編號時,標籤會包含最多 24 個字元的顧客參考編號條碼,其他 FedEx 系統仍會持續採用 40 個字元。
- 如果您發布或建立自訂通知,建議您使用 FedEx 追蹤號碼將查詢轉介至 fedex.com。
下圖可讓您深入瞭解更新的 FedEx Ground Economy 標籤內容。

FedEx Ground® Economy 服務選項
根據包裹重量和尺寸提供的其他 FedEx Ground® Economy 服務選項:
服務選項 | 最小重量 |
最大重量 |
尺寸 |
指定輕量包裹 |
0.01 磅 |
< 1 磅 |
長度加上周長合計不得超過 84 吋 最小尺寸:6 吋 (長) x 4 吋 (寬) x 1 吋 (高) |
裝訂印刷品 |
0.01 磅 |
15 磅 |
長度加上周長合計不得超過 84 吋 最小尺寸:6 吋 (長) x 4 吋 (寬) x 1 吋 (高) |
媒體 |
0.01 磅 |
70 磅 |
長度加上周長合計不得超過 84 吋 最小尺寸:6 吋 (長) x 4 吋 (寬) x 1 吋 (高) |
包裹選取 |
1 磅 |
70 磅 |
長度加上周長合計不得超過 130 吋 最小尺寸:6 吋 (長) x 4 吋 (寬) x 1 吋 (高) |
FedEx Ground® Economy Returns |
0.01 磅 |
70 磅 |
長度加上周長合計不得超過 130 吋 最小尺寸:6 吋 (長) x 4 吋 (寬) x 1 吋 (高) |
例外狀況
以下項目不適用於 FedEx Ground® Economy:
- 貨到付款
- 保證準時,否則退錢
- 申報值
- 簽收證明
- 夜間遞送或指定送達
- 危險材料服務
特殊服務
酒精貨件
FedEx 酒精託運規定適用於葡萄酒、烈酒和啤酒。各飲料類型適用於不同規定時,會分項列出。葡萄酒是唯一可為顧客直送的酒精類型,視選擇的託運服務而定。酒精可能屬於 Express 危險物品 (DG) 的範圍,視各液體容量酒精的百分比而定。
誰有託運資格?
- 個人無法透過 FedEx 託運酒精。
- 持有許可證 (持照者) 且已註冊 FedEx 酒精託運方案的企業可向指定州別的個人或其他州或國家/地區的持照者託運酒精。
- 有些州對於向消費者運送酒類設有嚴格規定,有些州則禁止此類運送。
國際法規
- 各國法律均對國際酒精運送設有規範。客戶務必遵守寄件地及目的地國家的法律與法規。
- FedEx 不受理含酒精的國際陸運貨件。
監控與介入 (MI) 及醫療保健識別碼 (HCID)
監控與介入 (MI) 及醫療保健識別碼 (HCID) 特殊服務選項協助主動監控重要醫療保健貨件、減輕風險,並提供介入支援,保護醫療保健貨件。HCID 特殊服務會識別有時效的醫療保健貨件,並提升其在 FedEx 網路中的優先順序。整合 MI 可提供對 HCID 貨件的密切監控,讓您即時追蹤您的包裹。
附註:
- 這屬於附加服務,您必須聯絡您的 FedEx 顧客代表,才能為您的帳戶啟用此服務。
- 帳戶必須啟用醫療保健功能,才能為貨件選取 MI 和 HCID 服務。
- 若選取「重要航太」或「重要汽車」等非醫療保健服務選項,則必須為每個個別選項啟用 EAN。
- 醫療保健選項僅適用於高級快遞服務。您必須先選擇 M&I 特殊服務選項,才能託運這些醫療保健選項。
- 這些特殊服務也適用特定附加費。
若要瞭解有關可用 MI 與 HCID 服務選項的資訊,請參閱 MI 與 HCID 選項表格。託運標籤上會列印您選擇的 MI 和 HCID 代碼。
附註:
- 雖然貨件可以包含多個醫療保健識別碼,但標籤上只會顯示一組 HCID。如果一個貨件包含多個識別碼,標籤會顯示 HCID 選項清單最上方的識別碼。
- 溫控識別碼 (HCT - TEMPERATURE_CONTROLLED) 需要選擇一個溫度範圍識別碼。每個貨件只能選擇一個溫度。如果建立的貨件包含多個與溫度相關的 HCID,將會導致錯誤。
陸運危險物品
陸運危險物品 (DG) 是包裹層級的特殊服務選項,可讓寄件人在歐洲境內根據 ADR 法規,透過陸運來託運危險物品包裹。此選項將會在重要歐洲市場中提供陸運危險物品 (DG) 的服務,透過 FedEx 地區經濟快遞服務、FedEx 地區經濟快遞大貨服務和 FedEx Express 國內等,在國內託運乾冰、鋰電池、數量限制的危險物品等。
其中包括下方的特殊服務,以便讓陸運危險物品 (DG) 具備處理貨件的額外功能:
- 獨立鋰電池貨件
- 陸運全面管制的危險物品 (DG)
- 陸運數量限制貨件
- 基因改造 (微) 生物
- 生物物質 B 類
- 例外數量
- 放射性物質
附註:
- 必須在 specialServiceTypes 下具體列舉 STANDALONE_BATTERY,才可獲得在元素 standaloneBatteryDetails 下選取電池詳細資料的選項。這項特殊服務類型僅適用於歐洲境內的區域。
- 對於全面管制的危險物品 (FDG) 和限制數量的危險物品 (LDG) 貨件,您需要在貨件要求中的 dangerousGoodsDetail 物件下將法規 指定為 ADR,才可成功處理。
危險物品
含有危險物品的貨件必須根據目前的國際航空運輸協會 (IATA) 空運規定和 FedEx Express 條款與條件採用 FedEx Express 方式託運。無論路線,無論貨件的實體運輸方式最終是採空運、陸上運輸或兩者皆採用,皆須遵守此規定。為求安心,請使用 FedEx® DG Ready 解決方案來產生您的危險物品申報單。[Service ENUM : DANGEROUS_GOODS]
<p">1.3 類爆裂物</p">
FedEx Express 不受理運送 1.3 類爆裂物。所有 FedEx Express® 服務皆禁止運送 1.3 類爆裂物。
乾冰
您可託運含有乾冰的包裹,唯須於運送交易時提供乾冰貨件的資料規格。乾冰是被視為危險物品的材料。[Service ENUM : DRY_ICE]
附註:
- 乾冰國內與國際貨件適用於包裹層級特殊服務。
- 國際多包裹貨件 (MPS) 如果含有乾冰,則在貨件及包裹上皆須據以申報,以便列印空運提單標籤上的合規性聲明。範例:乾冰,UN1845 1x2.00 公斤。
- 乾冰特殊服務不適用於文件類貨件。
- FedEx 包裝不適用。
放射性物質
在美國境內,如未經預先安排,高速公路管制數量或易裂類別 III 放射性物質不予受理。
限貨機運送
限貨機運送服務適用於包含客機上不允許之危險物品數量的包裹,客戶將能夠表明貨件是否適用於貨機運送。貨機運送貨件的空運提單 (AWB) 中會新增 DGD-CAO 識別碼。限貨機運送標籤 (DGD-CAO) 可提醒航空公司地勤作業人員不要將危險物品裝載於客機上,因為這樣做可能會對飛機及其乘客的安全造成危害。貨機運送服務的幾個危險物品範例,包括鋰電池、磁化材料、使用電池的設備、乾冰 (固態二氧化碳)。
鋰電池
由於鋰電池和單電池在某些情況下容易受損,可能引發火災,所以被歸類為危險物品。因此,國際航空運輸協會 (IATA) 和國際民航組織 (ICAO) 制訂了託運鋰電池和單電池應遵循的規範:
託運鋰離子電池/單電池的步驟如下:
步驟 1. 確定您要託運的電池類型
步驟 2. 確定準備鋰電池貨件的正確方式
步驟 3. 填妥書面文件
步驟 4. 完成包裝
如需詳細指引及逐步指示,請查看此處。
對於鋰含量較少或瓦時數較低的包裹,適用的法規規範較為寬鬆,為更有效識別和管制貨件,您需要釐清並申報貨件的技術規格。如需更多託運這些電池和單電池的資訊,請按一下此處。
按一下此處即可參閱 FedEx 提供的工作輔助資料,進而快速判斷您要託運的鋰電池貨件類型。
在無需危險物品 (DG) 託運人申報的簡化條件下,共有四種鋰電池貨件可以空運:
- 與設備包裝在一起的鋰離子電池 UN 3481,第 II 節,PI 966
- 裝入設備的鋰離子電池 UN 3481,第 II 節,PI 967
- 與設備包裝在一起的鋰金屬電池 UN 3091,第 II 節,PI 969
- 裝入設備的鋰金屬電池 UN 3091,第 II 節,PI 970
若屬於這四種類型,需要透過「packageSpecialServices」的「batteryDetails」物件陣列元素提出簡化的鋰電池申報,同時必須作為特殊服務類型「電池」。此類鋰電池貨件可以透過 FedEx 託運標籤的「ELB」處理代碼加以識別。ICAO/IATA 要求 (尤其是標籤和包裝的要求) 將持續適用。若屬於其他 LB 託運類型,通常需要完整的危險物品 (DG) 申報 (寄件人申報),請參閱如何託運危險物品。
若要建立和驗證貨件要求,並建立貨件標籤,您必須選取「LITHIUM_ION / LITHIUM_METAL ENUM」做為 batteryDetails 中 batteryMaterialType 的輸入內容。batteryMaterialType 表示電池或單電池的材料成分。
注意:以上資訊僅適用於上述四個 ELB 章節,不適用於須提供寄件人申報的鋰電池貨件 (DGD)。
鋰電池服務適用於下表所述的 FedEx Express 服務:
FedEx 國內服務 | FedEx International Services |
---|---|
FedEx First Overnight® |
FedEx International First Overnight |
FedEx Priority Overnight® |
國際優先快遞服務 (IP) |
FedEx Standard Overnight® |
FedEx International Priority® |
FedEx 2Day® |
FedEx® Regional Economy |
FedEx Express Saver® |
FedEx® 地區經濟快遞大貨服務 |
FedEx 1 Day® Freight (Express) |
FedEx International Priority® Express |
FedEx 2 Day® Freight (Express) |
FedEx International Priority Overnight |
FedEx 3 Day® Freight (Express) |
FedEx International Economy® |
FedEx® First |
FedEx 國際電商逸 (FICP) |
FedEx® Priority Express |
International Priority® Freight Service |
FedEx® Priority |
FedEx International Economy® Freight Service |
FedEx® Priority Express Freight |
FedEx Europe First® |
FedEx® Priority Freight |
FedEx First Overnight® Freight |
FedEx® 經濟快遞服務 |
FedEx 2Day® AM |
|
FedEx International Priority DirectDistribution Freight (IDF) |
|
FedEx 國際優先分送快遞服務 (IPD) |
|
FedEx 國際經濟分送快遞服務 (IED) |
|
FedEx Transborder Distribution Canada (TD CA) – Express |
|
FedEx Transborder Distribution Mexico (TD MX) – Express |
特殊處理費
含有危險物品的貨件需收取特殊處理費。根據所需特殊處理類別及類型而定,包括物品在運送期間是否必須可觸及,需再收取附加費。
簽收選項
寄件人可選擇適用於 FedEx Express® 或 FedEx Ground® 貨件的 FedEx® 簽收選項。
簽名選項 | 服務說明 |
---|---|
須直接簽名 | 在收件人地址的任何一人皆可簽收放行。若無人在收件地址時,FedEx 將會重新遞送。 |
須間接簽名 | 此選項適用於住宅遞送。 FedEx 可接受由以下列三種方式之一取得簽名:
|
須成人簽名 | FedEx 會在遞送地址處向任一位在目的地國家已達法定成年人年齡的人取得簽名。 |
不須簽名 | 若是無人簽收,FedEx 可直接留下包裹。 |
簽收選項詳細資訊
- 將貨件交付 FedEx 後,您就無法變更簽收選項。
- 「須直接簽名」服務不適用於「由服務站保管」貨件。
- 「須成人簽名」服務適用於「由服務站保管」貨件。
- 多包裹貨件中的所有包裹都必須採用相同 FedEx 簽收選項。
- 所有申報價值達美金$ 500 或加幣$ 500 以上的物件須經簽收。「須直接簽名」服務為預設服務,且不加收費用。如果您託運多包裹貨件,且其中一或多件包裹的申報價值達美金/加幣$ 500 以上,請以最低價值優先的服務處理包裹,以免支付多筆遞送費用。
FedEx Priority Alert 選項
FedEx Priority Alert™
這項服務承諾主動監控以及 24 小時連線,因此在託運過程的每個階段,您都能掌握貨件的動向。FedEx 提供專屬支援,代表在安全性至上的時候,您可以獲得所需的安全性。[Service ENUM : PRIORITY_ALERT]
FedEx Priority Alert Plus™
這項服務提供更高層級的保證 – 主動防範。在意外發生延遲的時候,如果您託運的是必須控制溫度的關鍵貨件 (通常為醫療相關),我們會提供必要的應變措施,例如補充乾冰、重新調整凝膠包裝,以及送入冷藏儲存環境。FedEx 明白,及時送達關鍵貨件能夠拯救性命。FedEx 再加碼保證,您的緊急包裹從出發那一刻起就會接受緊密監控,直至安全送達。
粉紅色代表優先性:Priority Alert 包裹周圍會貼上亮粉紅色膠帶,以便在裝貨與卸貨時表示優先狀態。
FedEx Priority Alert™ 和 FedEx Priority Alert Plus™ 是必須簽訂合約並且另行計費的專業級服務,結合了全天候 24 小時支援、進階貨件監控、主動通知,以及關鍵及緊急性貨件的自訂包裹找回服務。貨件可接受優先登機與優先清關處理。為了加強可見性,所有 FedEx Priority Alert™ 資訊都會列印在 FedEx ASTRA 標籤上。FedEx Priority Alert™ 服務會針對個別包裹收取附加費用。[Service ENUM : PRIORITY_ALERT_PLUS]
FedEx Priority Alert Plus™ 包括所有 FedEx Priority Alert™ 的服務特色,在將需要控制時間與溫度的貨件託運至金融、航太、電子製造和醫療產業時,提供最高層級的進階監控,此外還提供以下選項:
- 乾冰補充
- 凝膠包裝更換
- 冷藏環境
與 FedEx Priority Alert™ 相同,這項特別服務需收取附加費用。
FedEx Priority Alert 服務
使用下列貨件服務時,您可以再按照需求選擇 FedEx Priority Alert 和 Priority Alert Plus 服務:
- FedEx First Overnight®
- FedEx Priority Overnight®
- FedEx 國際優先快遞服務®
- FedEx 國際特早快遞服務®
- FedEx Europe First®
- FedEx® First
- FedEx® 優先快遞服務
- FedEx® Priority
- FedEx® Priority Express Freight
- FedEx® 優先快遞大貨服務
- FedEx® 經濟快遞服務
貨件特殊服務包括:
- 星期六遞送
- 平日遞送
- 由服務站保管
包裏特殊服務包括:
- 危險物品
- 乾冰
- 簽收服務選項
星期六遞送服務
FedEx Express® 貨件可提供星期六取件貨星期六遞送服務,需收附加費用。所有一般定點及待命取件和遞送均需收費。多數美國城市和指定國際地點可提供星期六包裹遞送或取件服務。
星期六託運及遞送服務
下列 FedEx Express 美國服務類型可提供星期六遞送服務:
- FedEx Priority Overnight®
- FedEx 2Day®
- FedEx 2Day® A.M.
下列 FedEx Express 美國服務類型可提供星期六取件服務:
- FedEx Priority Overnight®
- FedEx Standard Overnight®
- FedEx 2Day®
- FedEx Express Saver®
下列 FedEx Express 美國服務類型可提供星期六由服務站保管服務:
- FedEx Priority Overnight®
- FedEx 2Day®
Ground 貨到收款 (C.O.D.)
附註:此服務僅適用於加拿大境內 FedEx Ground® 貨件。
FedEx Ground® 貨到收款 (C.O.D.) 可讓寄件人指定 FedEx Ground 司機在包裹送達時向收件人索取的金額。如果 FedEx Ground 司機收取保證基金或公司及/或個人支票,款項會經由美國郵件直接寄送給寄件人。如收取現金,FedEx Ground 會在下一個工作天根據收取的金額向寄件人開立支票。FedEx 開立的支票會透過美國郵政服務寄給寄件人。寄件人必須指定要讓 FedEx Ground 收取的付款類型。FedEx Ground 貨到收款 (C.O.D.) 不適用於 FedEx Home Delivery® 服務。
注意:FedEx 提供 FedEx Ground® 電子貨到收款 (E.C.O.D.) 選項。如果您的合約指定此選項,FedEx 會在收款後的 24 到 48 小時內將款項以電子方式存入您的銀行帳戶。由於 E.C.O.D. 為合約服務,您必須聯絡 FedEx 業務專員註冊此選項。在託運請求中建立 E.C.O.D. 貨件無須再另行登錄。
Ground 電子貨到收款 (E.C.O.D.)
附註:此服務僅適用於加拿大境內 FedEx Ground® 貨件。
使用 FedEx Ground 電子貨到收款 (E.C.O.D.) 服務選項,可在貨件送達後 24 到 48 小時內收到款項。寄件人須經電子金融轉帳方式收款。請聯絡 FedEx 業務專員了解 E.C.O.D. 的更多資訊。
E.C.O.D. 不適用於 FedEx Home Delivery 服務。您在託運時可以選用貨到收款 (C.O.D.) 或 E.C.O.D.,但無法同時使用這兩種服務。
適用 FedEx Ground E.C.O.D. 的服務選項:
- FedEx Priority Alert 選項
- 預付或僅限第三方計費
- 申報價值
- 酒精託運
- FedEx Home Delivery 便利遞送選項
- 遮蔽資料
FedEx® 國際指定清關代理人
FedEx 國際指定清關代理人® 可讓您指定 FedEx (或我們指定的代理人) 以外的特定清關代理人。
FedEx 國際指定清關代理人服務詳細資訊
使用下列服務託運至指定國家時,可使用 FedEx 國際指定清關代理人服務:
- FedEx 國際優先快遞服務®
- FedEx 國際經濟快遞服務®
- FedEx International Ground® 託運至加拿大
加拿大出口貨件的出口報單
針對下列情況,必須向加拿大邊境服務局 (CBSA) 提交出口報單以通報從加拿大出口的情況。
- 所有包含非限制物品的加拿大出口貨件,如有商用物品價值達 $2,000 加幣或以上,且物品目的地為美國、波多黎各或美屬維京群島以外之國家/地區,就必須提交此出口報單。
- 所有加拿大出口貨件當中包含管制、限制或受到監管之物品者,無論其價值,均必須提交此出口報單。
承運人必須在物品起運離開加拿大之前,先行向出口商索取報告證明編號。出口商必須先送出出口報單,再向承運人提供報告證明編號。
電子出口資訊
電子出口資訊 (EEI) 等同於電子版的商業部 (Census Bureau) 7525-V 寄件人出口申報單 (SED),但美國政府已不再受理後者。電子出口資訊 (EEI) 中包含國際貨件交易的所有相關出口資料,可提供出口統計與掌握用途。
商品如登載於商業管制清單 (CCL),則電子出口資訊 (EEI) 為必要資料,須由出口商或代理人以電子方式透過自動化出口系統 (AES) 提交。
由於美國政府對電子出口資訊 (EEI) 程序做了變更,因此若要透過 AESDirect 申報電子出口資訊 (EEI),請造訪自動化出口系統 (AES) 網站 (www.aesdirect.gov)。這個由政府支援的網站可協助您滿足申報要求,並為您的包裹提供適當的寄件人身分識別資訊。FedEx 會將此資訊套用於您的貨件,但不會再為您申報此資訊。
注意:您也可以使用 Global Trade API 中的「File EEI」(申報 EEI) 端點,向美國海關申報您的電子出口資訊 (EEI)。
如需電子出口資訊 (EEI) 申報的詳細資訊,請造訪下方頁面
- FedEx 國際託運頁面
- FedEx Global Trade Manager
- 美國人口普查局
何時要申報電子出口資訊 (EEI)?
當分類於任何附表 B 所列號碼下之物品的總價值超過 2,500 美元或所列商品需要出口許可證時,須檢附電子出口資訊 (EEI)。
- 如有任何單一商品明細項目價值超過 2,500 美元,則必須進行電子出口資訊 (EEI) 申報。
- 如有任何單一商品的價值低於或等於 2,500 美元,則不必進行電子出口資訊 (EEI) 申報,並取得國際貿易法規 (FTR) 豁免。
如果貨件從美國、美屬維京群島或波多黎各寄至中國、俄羅斯、委內瑞拉和香港,無論貨件價值為何,您都必須提供以下資訊:
- 登錄於電子出口資訊 (EEI) 的內部交易號碼 (ITN)
- 每件物品的出口管制分類號碼 (ECCN) 或 EAR99 分類號碼,或
- 適用的登錄豁免文件
如果貨件符合以下條件,可豁免登錄。
- 符合許可證例外 GOV 資格
- 符合出口管理條例和國際貿易法規 (FTR) 的例外條件,或
- 僅包含分類為 EAR99 的物品
所有往來於美國與波多黎各之間,以及從美國或波多黎各運送至美國和維京群島的的所有貨件,在下列情況下均須進行電子出口資訊 (EEI) 申報:
- 屬於相同附表 B 所列商品號碼之商品的託運價值超過 2,500 美元,並於當天從相同出口商運送至相同收件人。
注意:從美國運送至加拿大的貨件可豁免這項規定 - 貨件包含需要出口許可證的商品,無論其價值如何。
- 商品受到國際武器貿易條例 (ITAR) 的規範,無論其價值如何。
- 無論價值為何,貨件即將運送至古巴、伊朗、北韓、蘇丹或敘利亞。
- 貨件包含鑽石原石,無論其價值如何 (HTS 7102.10、7102.21 與 7102.31)。
附註:
- 運送至其他美國屬地 (美屬薩摩亞、北馬里亞納群島邦、關島、豪蘭群島及威克島) 或從美屬維京群島運送至美國或波多黎各的貨件不需要電子出口資訊 (EEI)。
- 從美國出口貨件至其他目的地時,如果任何指定日期的集中托運貨件中有一或多個商品 (附表 B 所列號碼) 總價值超過 2,500 美元,您都必須申報電子出口資訊 (EEI)。
從美國運送至加拿大的貨件
除非適用下列任一項,否則從美國運送至加拿大的貨件不需要電子出口資訊 (EEI):
- 商品受到國際武器貿易條例 (ITAR) 的規範。
- 貨件需要出口許可證。
- 託運的商品為鑽石原石。
如需電子出口資訊 (EEI) 的詳細資訊,請前往 FedEx Global Trade Manager。
在您填寫電子出口資訊 (EEI) 前,請識別下列資訊。
- USPPI 雇主身分識別號碼 (EIN) 和識別碼 — 如果寄件人為公司,您將需要美國主要利益方的雇主身分識別號碼 (EIN) (統一編號)。如果寄件人為個人,您將需要該人員的社會安全號碼。
- 必須填寫有關交易各方之關係的資訊。此資訊會指出寄件人和收件人是否為同一公司的子公司或部門,或者互不相關。
- 運輸參考號碼 — 要求您提供自己的 FedEx 國際空運提單號碼。
- 最終收件人 — 只有當最終收件人不同於您在 FedEx 國際空運提單上輸入的收件人時,才需要識別您要託運之商品的使用者。
- 最終目的地國家/地區 — 指出貨件的最終使用國家/地區。
- D/F/ 或 M (自動化出口系統 [AES] 中的國內或國外) — 指出商品是在美國 (D=國內) 境內製造或在美國 (F=國外) 境外製造。
- 附表 B 所列號碼 (自動化出口系統 [AES] 中的商品分類號碼) — 輸入正確的附表 B 或國際商品統一分類代碼和單位。若要尋找此資訊,請前往 FedEx Global Trade Manager 網站 (網址為:fedex.com/gtm)或致電美國人口普查局 (電話為:1.800.549.0595)。
- 價值 — 如果商品尚未售出,請輸入其售價或成本。
- 許可證號碼/免許可證代號/授權 (自動化出口系統 [AES] 中的許可證號碼/引文) — 輸入您的出口許可證號碼或免許可證代號。若要判斷您是否需要提供此資訊,請致電位於加州紐波特比奇的美國商務部 (電話為:1.202.482.4811 或 1.714.660.0144),或前往工業與安全局網站。
電子出口資訊 (EEI) 代碼詳細資料
電子出口資訊 (EEI) 貨件需要您在透過 AESDirect (請前往 www.aesdirect.gov 使用此應用程式) 申報電子出口資訊 (EEI) 貨件資料時收到的豁免號碼或 ITN 號碼 (內部交易號碼)。託運應用程式開發介面 (API) 中提供可用於提交您的內部交易號碼 (ITN) 或電子出口資訊 (EEI) 豁免號碼的元素。
注意:您也可以在 Ship API 請求中,使用透過 Global Trade API 的「Retrieve ITN」(檢索 ITN) 端點獲得的內部交易號碼 (ITN)。
元素 | 說明 |
Sender/Tins/TinType |
身為寄件人,您必須將稅籍識別資訊更新至 FedEx 以用於電子出口資訊 (EEI) 貨件。指定雇主身分識別號碼 (EIN)。
|
Sender/Tins/Number |
透過 TinType 的對應識別號碼指定納稅人身分識別/號碼。 |
CustomsClearanceDetail/ExportDetail/ ExportComplianceStatement |
若為需要電子出口資訊 (EEI) 的貨件,請輸入當您申報貨件或國際貿易法規 (FTR) 豁免號碼時,從自動化出口系統 (AES) 收到的內部交易號碼 (ITN)。 |
注意:您在託運要求中提交的內部交易號碼 (ITN) 或國際貿易法規 (FTR) 豁免號碼會列印在國際託運標籤上。
商業目的地管制
符合 ITAR 免許可證或取得 ITAR 許可證的貨件如從美國、波多黎各、維京群島和所有其他美國領地出境,運送至所有其他國際目的地,您必須在熱感應或雷射託運標籤上列印美國國務院商業目的地管制聲明 (DCS),且貨件必須隨附任何佐證出口文件。託運應用程式開發介面 (API) 提供三種託運服務元素,以便您在託運標籤上使用合適的目的地管制聲明 (DCS)。
商業目的地管制服務詳細資訊
美國國務院貨件有兩種類型:
- 豁免:所有 FedEx 國際服務均適用美國國務院豁免聲明,但託運至加拿大的 FedEx International Ground® 貨件除外。
- 可獲許可證:取得許可證的美國國務院貨件僅可使用 FedEx 國際優先快遞服務® 服務。
注意:從美國、波多黎各或美屬維京群島託運至關島、美屬薩摩亞或北馬利安納群島的貨件不受此規定所限。
遞送入戶費用
在要求之下,FedEx 可將貨件運送至鄰近載貨區域以外的位置。如果 FedEx 運務員按照此要求遞送貨件,則除了其他適用費用之外,FedEx 還會酌收遞送入戶費用。
預約寄件
使用預約寄件託運時,可預約距離實際託運日期最多十 (10) 天的 FedEx Express 貨件。標籤會在貨件經過處理後列印,但貨件會先暫留保管,直到指定日期當天才會將包裹交付給運務員。
預約寄件適用於所有 FedEx Express 託運服務。FedEx Express 標籤會標示指定託運日期。
藥局遞送
藥局遞送可讓您將藥局指定為所需的貨件遞送地點,直接繞過裝卸平台和收件區。
藥局遞送讓客戶得以判斷藥局遞送特殊服務類型是否適用於美國國內快遞小型貨件的託運目的地。
附註:
- 這項服務同時適用於出境及回件貨件 (紙本及電子郵件回件)。
- 不包括快遞標籤。
- 使用藥局快遞時,美國國內範圍僅包括 50 州 (含阿拉斯加和夏威夷),不包括波多黎各或任何美國領地 (例如維京群島、美屬薩摩亞、關島等)。
- 藥局快遞可用的包裝類型與並非使用藥局快遞的「類似」貨件可用的包裝相同。
FedEx 第三方收件人
此為中性的遞送服務選項,可讓製造商繞過進口商配銷中心,直接託運至最終收件人,無需向製造商透露進口商的成本及條款。客戶如果不願意將貨件的進口海關申報值透露給收件人,可選擇此加價服務。透過這項服務遞送至收件人的貨件不含商業發票。收件人不會取得任何海關資訊。
服務優勢
- 改善端對端運輸時間 – 物品直送最終客戶。
- 免除額外的目的地處理及倉儲費用。
- 海關關稅和稅金以進口交易為依據,而非販售給最終客戶的後續銷售價值。
運輸時間*
FedEx 第三方收件人服務的送達時間與您選用的特定 FedEx® 服務所指定時間相同。我們以「保證準時,否則退錢」的承諾,作為運輸時間的擔保。**
服務選項
您可以搭配 FedEx國際優先快遞服務® 或 FedEx國際優先快遞® 大貨服務來選用 FedEx 第三方受件人服務,請在貨件請求中將貨件層級特殊服務類型指定為 specialServiceTypes=THIRD_PARTY_CONSIGNEE。
服務限制
- 遞送時必須分別指定進口商和收件人。
- 危險物品、易腐壞物品和 brokerselect 選項不適用。
- 無法託運國內及歐洲境內貨件。
* 運輸時間和遞送承諾可能會因寄件地和目的地而有所不同。請聯絡 FedEx 顧客服務部瞭解詳情。
* * 如需「FedEx 保證準時,否則退費」的詳情,請到 fedex.com 查看「我們的服務」。如需詳細資訊,請聯絡 FedEx 業務代表或前往 FedEx/TPC。
貨到付款 (C.O.D.)
FedEx® 貨到付款 (C.O.D.) 選項可讓您指定 FedEx Express 運務員在包裹送達時向收件人收取的金額。無需另外註冊。您的收件人可使用個人支票、匯票、本票、公司支票、銀行本票、保付支票、現金或任何選項付款。FedEx 會在下一個工作天經由 FedEx Standard Overnight® 將款項退還給您 (可行情況下,否則採用 FedEx 2Day®)。貨到付款貨件需加收附加費用。
由 FedEx 服務站保管
若客戶想要於指定的 FedEx 服務站領取包裹,可以使用 FedEx Express 的「由 FedEx 服務站保管 (HAL)」服務。例如,客戶偏好在 FedEx 服務站或 FedEx Express 櫃台據點領取葡萄酒貨件時,經過核准的葡萄酒寄件人可能就會使用 FedEx Express 的由 FedEx 服務站®保管 (HAL) 服務。
如果您的交易指定由服務站保管,您必須指定所需 FedEx 服務站的地點識別碼,以便獲得由服務站保管服務。由服務站保管服務也可指定 FedEx OnSite 據點。請使用自行投遞地點定位器選擇 FedEx 取件地點 (指定的 FedEx 服務站® 列印與託運中心、FedEx 服務站® 託運中心或 FedEx 全球服務中心®),如需協助,請聯絡 FedEx 客戶整合顧問。
如果您加入此選項,FedEx Express 標籤會顯示「由服務站保管」,表示包裹不會由 FedEx 運務員遞送。
FedEx OnSite
FedEx OnSite 服務在第三方聯盟據點提供 FedEx Express 和陸運取件及投遞服務,藉此擴大 FedEx 零售據點服務網。客戶可在將近 2,500 個配置 FedEx 人員的據點和將近 11,000 個 FedEx 零售聯盟據點使用 FedEx 服務;80% 的美國人口都在 FedEx OnSite 據點的 5 英里範圍內。
FedEx OnSite 可讓 FedEx 客戶選擇 FedEx Onsite 據點,在非 FedEx 經營的據點取得便利的包裹自行投遞和取件服務,享有延長的營業時間和安全的包裹存放。
FedEx One Rate®
FedEx 統一費率是單一費率託運,50 磅以下的貨件不需要秤重或丈量尺寸。您可以選擇最符合運送物品尺寸的盒子或管子,並將包裹裝滿,只要貨件不超過 50 磅。這為您的 FedEx Express 包裹提供簡單又可預測的單一費率託運選項。FedEx 統一費率是根據六種 FedEx Express Service 選項的託運組合,結合七種 FedEx 專有的 (白色) 包裝類型。
FedEx 統一費率包裝
可使用統一費率定價選項的 FedEx 包裝類型如下:
- FEDEX_ENVELOPE
- FEDEX_SMALL_BOX
- FEDEX_MEDIUM_BOX
- FEDEX_LARGE_BOX
- FEDEX_EXTRA_LARGE_BOX
- FEDEX_PAK
- FEDEX_TUBE
您自己的包裝不適用於統一費率定價選項。
如需深入瞭解包裝服務,請參閱包裝類型。
如何指定統一費率定價
若要指定 FedEx 統一費率訂價選項,請執行以下步驟:
- 指定 \"FEDEX_ONE_RATE\" 貨件特殊服務。
- 指定其中一種包裝類型。
- 指定美國寄件地和美國目的地。 請注意:夏威夷境內的貨件不允許採用統一費率定價。
- 請在下列類型中指定一種 FedEx Express 服務類型:
- FIRST_OVERNIGHT
- PRIORITY_OVERNIGHT
- STANDARD_OVERNIGHT
- FEDEX_2_DAY
- FEDEX_2_DAY_AM
- EXPRESS_SAVER
請注意:FedEx 顧客可透過在要求中指定 \"FEDEX_ONE_RATE\" 做為服務選項類型,在單一費率要求中請求統一費率和重量型 (非統一費率) 費率。
FedEx 託運標籤
FedEx 應用程式開發介面 (API) 支援各式各樣的標籤。FedEx 應用程式開發介面 (API) 支援三種標籤選項,包括熱感應、普通紙張和自訂標籤。您可以使用託運應用程式開發介面 (API) 和 Open Ship 應用程式開發介面 (API) 端點製作各式各樣的標籤。
FedEx 提供 2 種支援託運服務的標籤格式:
- 熱感應標籤
- 雷射標籤
熱感應標籤
FedEx 應用程式開發介面 (API) 可讓您透過各種熱感應標籤印表機為所有託運類型列印託運標籤,例如 FedEx Express®、FedEx Ground® 和 FedEx International Ground® 都適用。
FedEx 應用程式開發介面 (API) 支援以下熱感應標籤尺寸:
- 4 吋 x 6 吋 – 不含可設定的文件索引標籤
- 4 吋 x 6.75 吋 – 含或不含文件索引標籤
- 4 吋 x 8 吋 – 有空間納入您選擇的圖形或文字檔案
- 4 吋 x 8.5 吋 – 含可配置的文件索引標籤 (專用於輪胎識別標籤)
- 4 吋 x 9 吋 – 有空間納入圖形、文字及文件索引標籤
- 4 吋 x 10.5 吋 – 含可配置的文件索引標籤 (專用於輪胎識別標籤)
標籤紙類型 4 吋 x 8.5 吋和 4 吋 x 10.5 吋包含使用相同條碼的額外文件索引標籤。一組條碼會顯示在主標籤上,另一組則會顯示在文件索引標籤上。此標籤紙類型值對於輪胎包裹而言相當實用,因為一張標籤可貼在輪胎胎紋上,另一張的文件索引標籤則可搭配條碼複本及操作指示貼附於輪胎胎壁上。使用這類標籤紙類型可減少輪胎重新貼標的情形,而增加的多面掃描有助於復原。如需更多標籤紙相關資訊,請參閱標籤紙類型。
注意:文件索引標籤是一種可撕下的黏貼式標籤,用於標示其他託運資訊。您在使用熱感應印表機列印託運標籤時,可根據標籤紙選擇此選項。
熱感應標籤組成元素
熱感應託運標籤包含以下三種基本元素:
- 人類可讀的內容:標籤中的此部分包含 FedEx 託運應用程式開發介面 (API) 中的託運資訊。
- 按照預設,陸運的人類可讀條碼會經過加密。
- 二維 (2D) 條碼:維度化的英數條碼,使用美國國家標準協會 (ANSI) MH10.8.3 標準儲存 FedEx Express 和 FedEx Ground 貨件的資料。2D 條碼是經由可攜式資料檔案 (PDF) 417 條碼協定所建立。
- FedEx 專用條碼:
- ASTRA (進階分件追蹤路徑輔助) 適用於完全開始採用 FDX 1D 條碼前的 FedEx Express 貨件;「96」條碼適用於 FedEx Ground 和 FedEx Home Delivery®;FedEx Ground 也允許使用 SSCC-18「00」條碼。
- FedEx 1D (FDX1D) 條碼適用於 FedEx Express 貨件,是透過 ANSI/AIM BC4-1995 (統一符號規格 CODE-128C) 所建立。
產生熱感應標籤的關鍵資訊
以下為產生熱感應標籤所需的關鍵資訊:
- LabelFormatType:在託運回覆應用程式開發介面 (API) 中收到正確標籤影像所需的資訊:
有效的值:
- COMMON2D:收到標籤時的標籤格式類型。
- LABEL_DATA_ONLY:如果建立自訂標籤時,用於取得條碼資料的值。
- ImageType:根據所用印表機形成熱感應標籤所需資訊;可提供要傳回的資料流類型或點陣圖。
有效的值:
- EPL2 – Eltron (標籤紙類型)
- ZPLII – Zebra (標籤紙類型)
注意:貨件所需的所有標籤都會在單次緩衝中產生與傳回。
支援的熱感應印表機
使用 FedEx 應用程式開發介面 (API) 時,建議搭配以下熱感應印表機:
- Unimark
- Eltron
- Orion (EPL2)
- Eclipse (EPL2)
- Zebra
- LP2443 (EPL2)
- LP2844 (EPL2)
- Gk420 (ZPL)
- LP2348 Plus (EPL2/ZPL)
- Z4M Plus (ZPL 或 EPL)
- ZP500/ZP505 (EPL2/ZPL)
- Z4M/Z4M+ (EPL2/ZPL)
- ZM400 (EPL2/ZPL)
- ZT410 (EPL2/ZPL)
- Other ZT4xx 系列印表機 (EPL2/ZPL)
注意:上述印表機皆與 ASCII Eltron 程式語言 (EPL2) 頁面模式相容。進行熱感應列印時,您可以直接寫入連接至系統序列埠的印表機,也可以使用透過 LPT、序列埠或 USB 連線的原生安裝 Windows 印表機。FedEx 提供的印表機採用的韌體版本可能因地區而不同。
各項服務需列印的熱感應標籤數量
下表列出個別特殊服務所需標籤類型的數量。僅需呼叫 FedEx 常用標籤伺服器 (CLS) 一次,即可產生所有所需標籤;CLS 會傳回單次緩衝,貨到收款 (C.O.D.) 回件標籤除外。
各項美國服務列印標籤
服務類型 | 熱感應標籤 (FedEx CLS 會在回應中傳回適當數量的標籤) |
---|---|
FedEx Express 美國 |
1 張託運標籤 |
FedEx Ground 美國/FedEx Home Delivery |
1 張託運標籤 |
各項美國國際出口服務列印標籤
服務類型 | 熱感應標籤 (FedEx CLS 會在回應中傳回適當數量的標籤) |
---|---|
FedEx Express 美國國際出口 |
1 張託運標籤 2 張收件人標籤 |
FedEx Express 美國國際出口指定清關代理人選項 |
1 張託運標籤 2 張收件人標籤 |
FedEx Ground 美國國際出口 |
1 張託運標籤 |
FedEx Ground 美國國際出口貨到收款 (C.O.D.) |
1 張託運標籤 2 張貨到收款 (C.O.D.) 回件標籤 |
各項加拿大境內服務列印標籤
服務類型 | 熱感應標籤 (FedEx CLS 會在回應中傳回適當數量的標籤) |
---|---|
FedEx Express 加拿大境內 |
非 DG (危險物品)/乾冰託運: 1 張託運標籤 |
FedEx Ground 加拿大境內 |
1 張託運標籤 |
FedEx Ground 加拿大境內貨到收款 (C.O.D.) |
1 張託運標籤 2 張貨到收款 (C.O.D.) 回件標籤 |
各項加拿大國際出口服務列印標籤
服務類型 | 熱感應標籤 (FedEx CLS 會在回應中傳回適當數量的標籤) |
FedEx Express 加拿大國際出口 |
非危險物品 (DG)/乾冰託運: 1 張託運標籤 2 張收件人標籤 |
FedEx Express 加拿大國際指定出口清關代理人 |
非危險物品 (DG)/乾冰託運: 1 張託運標籤 2 張收件人標籤 |
FedEx Ground 加拿大 (CA) 國際出口 |
1 張託運標籤 |
各項菲律賓與泰國入境貨件列印標籤
服務類型 | 熱感應標籤 (FedEx CLS 會在回應中傳回適當數量的標籤) |
菲律賓入境貨件 |
2 張印有帳號的託運標籤 1 張不含帳號的收件人標籤 3 張商業發票副本 |
泰國入境商品類貨件 |
3 張印有帳號的託運標籤 1 張不含帳號的收件人標籤 |
泰國入境文件類貨件 |
2 張印有帳號的託運標籤 1 張不含帳號的收件人標籤 |
文件索引標籤
如果您使用熱感應印表機列印託運標籤,可以在選擇標籤紙時加入文件索引標籤。這是一種可撕下的黏貼式標籤,含有其他託運資訊。您可以在託運資料中設定這些託運資訊,或者根據您的特定託運需求列印這些可設定資料。
雷射標籤
FedEx 應用程式開發介面 (API) 支援使用雷射印表機列印標籤。這類標籤通常列印在美國信函或 A4 紙張上,對折後正好可放入標準 FedEx 標籤袋。以雷射印表機列印的標籤會產生為 PDF 格式,且不需重新調整大小。如需更多標籤紙相關資訊,請參閱 標籤紙類型。
先決條件
以下規定適用於 PDF 標籤:
- 處理標籤時需要使用 Adobe Reader 6.0 或以上版本。
- 印表機驅動程式組態的印表機縮放功能必須設為「無」。
- 不需要使用 HTML 包裝函式,即可在瀏覽器中顯示普通紙張的 PDF 標籤。
- Acrobat 建議使用以下瀏覽器檢視 PDF 文件:
- Microsoft Internet Explorer 10 或以上版本
- Firefox 1.0 或以上版本
- Mozilla 1.7 或以上版本
PDF 標籤選項免除了指定影像方向參數 (寬度與高度) 或螢幕解析度的需求,可直接在瀏覽器上正確顯示標籤。
雷射標籤組成元素
雷射託運標籤包含以下三種基本元素:
- 人類可讀的內容 – 標籤中的此部分包含 FedEx 託運應用程式開發介面 (API) 中的託運資訊。
- 按照預設,陸運的人類可讀條碼會經過加密。
- 二維 (2D) 條碼 – 維度化的英數條碼,使用美國國家標準協會 (ANSI) MH10.8.3 標準儲存 FedEx Express 和 FedEx Ground 貨件的資料。2D 條碼是經由可攜式資料檔案 (PDF) 417 格式所建立。
- FedEx 專用條碼:
- ASTRA (進階分件追蹤路徑輔助) 適用於完全開始採用 FDX 1D 條碼前的 FedEx Express 貨件;「96」條碼適用於 FedEx Ground 和 FedEx Home Delivery 貨件;適用情況下,FedEx Ground 也允許使用 SSCC-18「00」條碼。
- FedEx 1D (FDX1D) 條碼適用於 FedEx Express 貨件,是透過 ANSI/AIM BC4-1995 (統一符號規格 CODE-128C) 所建立。
產生雷射標籤的關鍵資訊
以下為產生雷射標籤所需的 FedEx 應用程式開發介面 (API) 資訊元素:
- LabelSpecification/LabelFormatType:在託運回覆應用程式開發介面 (API) 中收到正確標籤影像所需的資訊:
有效的值為:
- COMMON2D – 收到標籤時的標籤格式類型。
- LABEL_DATA_ONLY – 如果建立自訂標籤時,此值用於取得條碼資料。
- LabelSpecification/ImageType:表示標籤格式時所必需。系統會傳回資料流格式或點陣圖:
有效的值為:
- PDF – 普通紙張
- PNG – 普通紙張
- LabelSpecification/LabelStockType:所有標籤類型皆必需,可指定標籤紙頂端或尾端是否有文件索引標籤,或者不含文件索引標籤。使用 PDF 或 PNG 的 ImageType 時,以下的值會顯示雷射格式標籤:
- PAPER_4X6
- PAPER_4X8
- PAPER_4X9
- PAPER_4X675
- PAPER_7X47
- PAPER_85X11_BOTTOM_HALF_LABEL
- PAPER_85X11_TOP_HALF_LABEL
- PAPER_LETTER
以下的值會顯示普通紙張格式的託運標籤:
注意:如果您請求的是普通紙張標籤,傳回的資料則為 Base64 編碼的標籤影像,此檔案必須先經過 Base64 解碼才能顯示標籤檔案。
支援的雷射印表機
多數雷射印表機都能支援這種標籤類型,不過,標籤如果以噴墨印表機列印,則無法受理。
注意:如果您使用彩色雷射印表機,色彩定義必須設為黑色,即使印表機僅安裝黑色墨水匣也一樣
各項服務需列印的雷射標籤數量
下表列出個別特殊服務所需標籤類型的數量。僅需呼叫 FedEx 常用標籤伺服器 (CLS) 一次,即可產生所有所需標籤;CLS 會傳回單次緩衝,貨到收款 (C.O.D.) 回件標籤除外。
各項美國服務列印標籤
服務類型 | 雷射標籤 – PDF 格式 |
---|---|
FedEx Ground/FedEx Home Delivery 美國 |
1 張託運標籤 |
各項美國國際出口服務列印標籤
服務類型 | 雷射標籤 – PDF 格式 |
---|---|
FedEx Express 美國國際出口 |
回覆時會傳回 1 張託運標籤;至少需列印 3 張標籤 – 1 張包裹標籤和 2 張文件袋標籤。 |
FedEx Express 美國國際指定出口清關代理人 |
回覆時會傳回 1 張託運標籤;至少需列印 3 張標籤 – 1 張包裹標籤和 2 張文件袋標籤。 |
FedEx Ground 美國國際出口 |
1 張託運標籤 |
FedEx Ground 美國國際出口貨到收款 (C.O.D.) |
1 張託運標籤 2 張貨到收款 (C.O.D.) 回件標籤 |
各項墨西哥境內服務列印標籤
服務類型 | 雷射標籤 – PDF 格式 |
---|---|
FedEx Express 墨西哥境內 |
FedEx Express 墨西哥境內 非 DG (危險物品)/乾冰託運: 1 張託運標籤 |
各項加拿大境內服務列印標籤
服務類型 | 雷射標籤 – PDF 格式 |
---|---|
FedEx Express 加拿大境內 |
FedEx Express 加拿大境內 非 DG (危險物品)/乾冰託運: 1 張託運標籤 |
FedEx Ground 加拿大境內 |
1 張託運標籤 |
FedEx Ground 加拿大境內貨到收款 (C.O.D.) |
1 張託運標籤 2 張貨到收款 (C.O.D.) 回件標籤 |
各項加拿大國際出口服務列印標籤
服務類型 | 雷射標籤 – PDF 格式 |
---|---|
FedEx Express 加拿大國際出口 |
FedEx Express 加拿大國際出口 非危險物品 (DG)/乾冰託運: 1 張託運標籤 2 張收件人標籤 |
FedEx Express 加拿大國際指定出口清關代理人 |
FedEx Express 加拿大國際指定出口清關代理人 非危險物品 (DG)/乾冰託運: 1 張託運標籤 2 張收件人標籤 |
FedEx Ground 加拿大 (CA) 國際出口 |
1 張託運標籤 |
各項菲律賓與泰國入境貨件列印標籤
服務類型 | 熱感應標籤 (FedEx CLS 會在回應中傳回適當數量的標籤) |
---|---|
菲律賓入境貨件 |
2 張印有帳號的託運標籤 1 張不含帳號的收件人標籤 3 張商業發票副本 |
泰國入境商品類貨件 |
3 張印有帳號的託運標籤 1 張不含帳號的收件人標籤 |
泰國入境文件類貨件 |
2 張印有帳號的託運標籤 1 張不含帳號的收件人標籤 |
自訂標籤
FedEx 允許自訂 FedEx 產生的標籤。您可以在熱感應標籤的自訂部份加上業務相關文字,並選擇要使用在 FedEx 文件上的條碼 (符號) 類型。
為了支援託運應用程式,FedEx 託運應用程式開發介面 (API) 提供兩種自訂託運標籤的選項:
- 將 PNG 紙張 7 吋 x 475 吋圖形置放在標籤紙中。舉例來說,您可於 8-1/2 吋 x 11 吋表格上建立包裝清單。作為此表格的一部分,您也可以放置 7 吋 x 475 吋 PNG 紙張圖像,而非自行建立自訂標籤。
- 將圖形或文字檔案加到 4 吋 x 8 吋或 4 吋 x 9 吋的熱感應標籤。這種標籤尺寸提供 2 吋的空間來容納圖形或文字。
注意:標籤上的人類可讀內容和標籤一般部分中的條碼無法更改。
自訂驗證標籤
您可以在包裹和貨件上都建立非託運用的自訂標籤,指定所需自訂資訊、資訊的構成方式,以及自訂標籤上的置放位置。自訂標籤必須使用熱感應標籤格式。
自訂熱感應標籤
FedEx 應用程式開發介面 (API) 提供兩種可自訂圖形或文字檔案的熱感應標籤格式,以免您還需要建立自訂標籤。這些標籤支援所有 FedEx 託運服務,格式包括:
- 4 吋 x 8 吋熱感應標籤,不含文件索引標籤
- 4 吋 x 9 吋熱感應標籤,含文件索引標籤
這些標籤類型都提供兩吋的可自訂區塊。此功能適用於設為 203 DPI 或 300 DPI 的熱感應印表機列印的熱感應標籤。
自訂標籤規則
使用標籤格式的規則如下:
- 只有託運標籤可供自訂。舉例來說,如果您列印含有標誌的 4 吋 x 8 吋 Express 託運標籤,次要的收件人標籤將不會顯示此標誌。
- 自訂圖形或文字的高度不得超過 2 吋,寬度不得超過 4-1/2 吋。
- FedEx 不會提供任何修正,圖形和/或文字列印內容會與您提交給託運服務的內容相同。
- 如果您未提供列印圖形和/或文字的所需資料 (例如 X 和 Y 座標),系統就會傳回不含自訂資料的有效託運標籤。如果您想要重新建立含有圖形及/或文字的新標籤,就必須取消前述標籤代表的貨件。
- 如果使用 203 DPI (每釐米 8 點) 印表機的解析度,在放置 X 和 Y 座標時,插入點座標的數據即為含有底部文件索引標籤的 4.00 吋 x 6.75 吋熱感應標籤上緣與左側交叉的位置。如果是採用上方文件索引標籤的 4.00 吋 x 6.75 吋熱感應標籤,請將插入點座標 Y 的值增加 164 點。如果是不含文件索引標籤的 4.00 吋 x 6.00 吋標籤,請將插入點座標 Y 的值增加 8 點。熱感應標籤元素屬性會以 203 DPI (每釐米 8 點) 印表機的解析度為準。
- 如果使用 300 DPI (每釐米 12 點) 印表機的解析度,在放置 X 和 Y 座標時,插入點座標的數據即為含有底部文件索引標籤的 4.00 吋 x 6.75 吋熱感應標籤上緣與左側交叉的位置。如果是採用上方文件索引標籤的 4.00 吋 x 6.75 吋熱感應標籤,請將插入點座標 Y 的值增加 246 點。如果是不含文件索引標籤的 4.00 吋 x 6.00 吋標籤,請將插入點座標 Y 的值增加 12 點。熱感應標籤元素屬性會以 300 DPI (每釐米 12 點) 印表機的解析度為準。
附註:- 如果是 FXD1D 條碼,用於 203 DPI 印表機的 X 尺寸 (符號中最窄橫條的寬度) 是 15 mil (3 點),用於 300 DPI 印表機的 X 尺寸是 13.3 mil (4 點)。
- 如果是 2D PDF-417 條碼,用於 203 DPI 印表機的 X 尺寸是 10 mil (2 點)。用於 300 DPI 印表機時,如需最接近相等的 X 尺寸,則必須使用 9.99 mil (3 點)。
- 標籤上方的「寄件人/其他」區塊和收件人資訊下方的「寄件人參考資料」區塊中使用非常小的字體,標籤開發者需要檢查 ZPL 程式開發指南,交叉參照字體集特性,以便為其他各種列印頭解析度選取表現相近的字體集。
- 字元插入點為字串中第一個字元上緣切線的左上角。
- 印表機的限制要求起始位置為前端的左上角象限,因此,資料有可能會從標籤的自訂區段開始往下寫入至 FedEx 的標籤部分 (實際的熱感應標籤資料)。如果發生這種情況,您的標誌或文字會遭到 FedEx 標籤資訊的內容覆蓋。您必須修正此位置設定,才能使用託運標籤。
- 如要將文件索引標籤資訊加到 4 吋 x 9 吋標籤,請務必按照您設定標準 4 吋 x 6 吋文件索引標籤熱感應標籤時所使用的相同程序來設定。
注意:由於標籤將會採用黑白列印,請務必只加入單位元色彩的影像。
自訂標籤圖形登錄元素
應用程式開發介面 (API) 會向 FedEx Express 和 FedEx Ground 標籤提供 PNG (可攜式網路圖形) 影像。PNG 標籤圖形是應用程式開發介面 (API) 所支援的熱感應或普通紙張標籤複本。此標籤選項可讓您將 PNG 標籤圖形置放在標籤紙上,以免您還需要建立自訂標籤。
使用在託運文件中內嵌的 4 吋 x 6 吋 PNG 圖形時,請注意以下要求:
- 標籤紙
- 印表機
- 尺寸比例
標籤紙
4 吋 x 6 吋 PNG 標籤僅可使用於黏貼式標籤紙。如果 4 吋 x 6 吋 PNG 標籤未採用黏貼式標籤紙,包括列印在普通紙張上的任何標籤,FedEx Ground 和 FedEx Express 標籤認證團隊將會拒絕受理。
印表機
列印標籤時建議使用雷射印表機。請勿使用噴墨印表機,因為這種印表機在建立掃描式條碼時並不穩定。您必須將色彩定義設為黑色,即使印表機僅安裝黑色墨水匣也一樣,否則無法使用彩色印表機列印 4 吋 x 6 吋 PNG 標籤。此設定有助於在 FedEx 轉運中心完成正確的條碼定義,以便進行掃描。
尺寸比例
系統在您的託運交易中傳回的影像為 200 個每英寸點數 (DPI),尺寸為 4 吋 (寬) x 6 吋 (高) 或 800 x 1200 像素。這種標籤採用直式方向,專為列印在 4 吋 x 6 吋標籤區域上而設計。列印後,標籤的測量尺寸應為 4 吋 x 6 吋。
如要製作所需 DPI 的標籤和條碼,必須在列印前先縮放 (或調整) 影像的尺寸比例。縮放影像的方式,視您用於檢視與列印標籤的應用程式而定。如要以英吋為單位將 PNG 影像縮放為 4 吋 x 6 吋標籤,請確實選用 4 吋寬度和 6 吋長度。
標籤審核檢查清單
所有條碼
驗證要求:
- 淨空區:條碼上下務必一律各留至少 0.1 吋的空白空間。
- 淨空區:條碼左右務必一律各留至少 0.2 吋的空白空間。
- 驗證所有條碼都符合最低高度要求。
列印品質
造成標籤遭拒的常見問題有:
- 分裂條紋
- 列印色彩淡化/白色無效部分
- 連續白色無效部分 (滾筒問題)
- 汙點 (熱感應傳輸)
- 剝落 (雷射),表示有碳粉混合問題
- 列印皺褶 (熱感應傳輸)
- 直接熱感應標籤的列印對比必須至少為 90%
Ground 標籤的人類可讀詳細資訊
在 FedEx Ground 標籤加上人類可讀資料時,請注意下列驗證要求:
- 資料必須與條碼相符
- FedEx Ground 標誌:FedEx Identity 網站 fedex.com 提供下載標誌。
- FedEx Home Delivery 標誌:標籤的託運地址中必須有一個小於 1 吋的方塊,其中有標示大寫的「H」。這個「H」必須至少為 0.25 吋x 0.70 吋。
- 服務說明
- 寄件人資料
- 收件人資料
- 郵遞區號和路線
- 託運日期
- 實際重量
- 客戶自動化裝置資訊 (郵戳、應用程式/系統、版本)
- 尺寸
- 其他參考資訊
- 追蹤號碼和表單 ID (追蹤號碼必須為 14 位數)
- 機場機坪 ID
- 郵遞區號
Express 標籤的人類可讀詳細資訊
如要通過認證,標籤上務必列印下列元素:
- FedEx Express 標誌:FedEx Identity 網站 fedex.com 提供下載標誌。
- 服務說明
- 如為國際託運,需含包裝類型
- 當週遞送日 (例如 MON 表示週一)
- 遞送日期
- 郵戳號碼
- 託運日期
- 件數格式、主標籤用詞、所有多包裹貨件 (MPS) 上的顧客參考號碼 (CRN) 標籤用詞
- 機場機坪 ID
- 郵遞區號和路線
- 通用路徑與分類輔助 (URSA) 的路徑前綴與後綴字元
- 處理代碼
- 服務區域承諾
- 收件人和寄件人電話號碼
- 重量
- 適用情況下,需含尺寸
- 如為酒精貨件,需含參考欄位
- 追蹤號碼和表單 ID (追蹤號碼必須為 14 位數)
- 在 ASTRA 標籤上,12 位數的追蹤號碼在 32 個字元的條碼中,位於第 17 到第 28 位。在新的 FDX 1D 條碼中,追蹤號碼則位於第 21 到第 34 位。FedEx Express 追蹤號碼仍會持續採用 12 位數。前兩位數為零。
FedEx Ground 美國託運
FedEx Ground® 美國是選擇陸運遞送服務時,適用於美國商業地址的經濟型遞送服務。FedEx Home Delivery® 則適用於美國住宅地址的遞送。這兩種服務在美國全部 50 州都可使用,且根據目的地距離而定,可提供指定日期遞送。
FedEx Home Delivery
向美國境內住宅地址託運包裹時,請使用 FedEx Home Delivery 服務。如果住宅遞送的貨件未滿 150 磅,FedEx Ground 會指定由 FedEx Home Delivery 服務承運。
住宅地址的客戶可在週一到週五當天結束前收到包裹,而週六幾乎所有地址和週日多數地址都仍可收件。
FedEx Ground、FedEx International Ground 和 FedEx Home Delivery 貨件會在運輸報價中加上精確的預估送達日期/時間。[Service ENUM : GROUND_HOME_DELIVERY]
FedEx Ground 美國服務選項
可用的幾種主要託運服務選項如下:
- 預約寄件託運
- 危險材料 FedEx Ground 美國
- 由 FedEx 服務站保管
- FedEx Home Delivery 服務詳細資訊
- 替代回件地址
- 簽收選項
- 託運請求的貨件通知
- 變動處理費用
FedEx International Ground 託運
FedEx International Ground 是一種直送託運方式,可供您將單件或多件小型包裹貨件在美國和加拿大之間往來直送,沒有包裹最低數量要求。
FedEx International Ground 為全加拿大境內提供指定日期遞送:
- 配送時間:2–7 個工作天。
- 服務日:週一至週五,工作天結束前。
- 遞送區域:加拿大。
- 包裹尺寸及重量:上限為 150 磅、長 108 吋,以及長度加周長合計 (長度 + 2 倍寬度 + 2 倍高度) 165 吋。包裹重量如達 100–150 磅,請按照特定指南標示為重型包裹。如需詳細資訊,請前往 http://www.fedex.com/us/services/intl/ground.html。
- 例外:FedEx Ground® 無法遞送至郵政信箱。
- 不得含有危險材料 (運往加拿大的特定含乾冰貨件或分類為其他管制材料 – 國內 [ORM-D/數量限定] 者除外)。
- 貨件運往加拿大時,託運服務中已包含報關,因此我們會為您完成清關,但需收費用。並非所有電器託運解決方案都適用含報關的服務。
- 所有貨件都需要商業發票 (CI)。
FedEx International Ground 服務詳細資訊
以下服務選項適用於 FedEx International Ground 託運:
- 替代回件地址
- 商業目的地管制
- 簽收選項
- 預約寄件託運
- 遮蔽帳號 (FedEx International Ground)
- 託運請求的貨件通知
- 變動處理費用
International Ground 包裹配送服務
International Ground 包裹配送服務可讓 FedEx Ground 以同一批 International Ground 貨件的形式集中託運,僅在一次入關中以一筆報關費用完成清關與處理。服務適用於採用 FedEx Ground 遞送網絡在美國和加拿大之間往來運送。本服務以可指定清關代理人的專屬服務形式提供。含清關代理人服務的選項並不適用。
清關要求
所有出口文件都必須放入國際文件袋,並檢附於 FedEx International Ground 包裹,或多包裹貨件 (MPS) 中的第一件包裹。每個貨件都必須包含:
- 1 份簽名影本和 4 份原始文件 (加拿大);1 份簽名影本和 2 份原始文件 (波多黎各)。
- 清關代理人資訊 (包括適用情況下需加入的非居民進口商 (NRI) 指定對象) 必須載明於商業發票。
- 商業發票也必須包含收件人的聯絡詳細資訊,包括電話號碼。
- 除非商業發票上另有指定,否則收件人會自動成為登記進口商 (IOR)。
美國與加拿大之間的報關與帳單選項
以下一系列功能可改善您在美國與加拿大兩地的託運體驗,使 FedEx International Ground 包裹跨境託運變得更容易。
含報關的服務
透過預設即含報關的新服務選項,FedEx International Ground 託運為您提供在包裹運送途中即可進行的一站式聯絡及法定清關程序啟動窗口。
指定清關代理人選項
如果您想要指定自己的清關代理人,我們也提供相關選項。
彈性帳單解決方案
您現在可以選擇將關稅、稅金和附加費計入寄件人、收件人或第三方帳單中。
多包裹貨件 (MPS)
多包裹貨件 (MPS) 包含兩個或以上託運到相同收件人地址的包裹。貨件請求中的第一個包裹為主要包裹。
若要建立多包裹貨件:
- 請加入貨件層級資訊,例如 serviceType、packagingType、totalWeight、totalPackageCount 和 requestedPackageLineItems 等主要包裹詳細資料。[注意:主要包裹的 sequenceNumber 必須等於 1。]
- 針對每個包裹的列印標籤,請在所有後續包裹的 masterTrackingId 元素中包含主要追蹤詳細資料。
以下是適用於此應用程式開發介面 (API) 的多包裹貨件處理選項:
一次列印一張包裹標籤
此處理選項可讓您處理多包裹貨件 (MPS),並逐一取得標籤。在需要按照順序處理包裹並為每個包裹產生標籤時,此即為最佳方式。
如果需要為貨件採用此功能,請在貨件請求中提供 oneLabelAtATime as true 元素,並附上所有所需 MPS 元素。
第一個請求的輸出應該會產生標籤和追蹤編號,這就是主追蹤號碼。請在 masterTrackingId 元素中提供這個主追蹤號碼以處理後續託運請求,並針對已定義的包裹總數 (groupPackageCount) 產生含有追蹤號碼 (子追蹤號碼) 的標籤。
附註:
- 此處理選項允許的最大包裹數量為 200。
- 如果 sequenceNumber 等於 groupPackageCount,系統就會產生最終貨件文件/報告。
一次列印所有包裹標籤
此處理選項可讓您處理多包裹貨件 (MPS),並一次取得所有標籤。視貨件中的包裹或包裹層級商品數量而定,選擇此選項後,您的貨件可能會經同步或非同步方式處理。
同步貨件處理
同步處理是其中一種最佳處理方式;如果貨件包含 40 件或以下包裹 (groupPackagecount<=40),且商品在限制範圍之內,而 oneLabelAtATime 設為 false,內部就會採用此方法。
40 件或以下的包裹請求會經過同步處理,並且立即產生標籤和其他貨件文件/報告。如果寄件人時間緊迫,且標籤必須立即列印,此即為最佳處理程序。
注意:40 個包裹的上限為指示參考,但並非固定的上限。這項上限也須視貨件中包裹及商品的組成而定。如需更多資訊,請聯絡 FedEx 支援團隊。
範例:在提交後會經過同步處理的前提下,您的貨件請求包含 10 個包裹,因此系統的回應會建立 10 個標籤,而且會依請求提供標籤 URL 或編碼標籤。
以下高層級工作流程說明同步貨件處理的過程:
- 使用端點建立貨件建立含有 1-40 件包裹的貨件。
- 請求成功後,系統應會產生標籤,且依照請求,輸出的回應會包含標籤 URL 或經過編碼的標籤。
- 如果貨件包含錯誤,回應會提供錯誤詳細資訊。
- 修正錯誤後,重新建立並提交貨件,以便取得成功回應。
注意:
- 在此方法中,如果需要為現有貨件新增更多包裹,最多只能新增 40 個。
- 在同步處理請求中,processingOptionType 元素的預設值為 SYNCHRONOUS_ONLY,而且即使您未提供上述元素,或在請求中傳遞的值為 SYNCHRONOUS_ONLY 或 ALLOW_ASYNCHRONOUS 其中之一,貨件仍會經過同步處理。
非同步貨件處理
貨件包裹超過 40 件時 (totalPackageCount>40),請使用非同步處理選項。如果您的包裹量大,且想要定期提交大量貨件,這會是相當便利的方式。這種大量提交貨件的方式,會在您提交資料後立即採用各種高價的 FedEx 資源和運作。透過此處理選項,FedEx 會經由內部確認這些大量貨件經過處理,您則會定期取得標籤資料。
以非同步方式處理交易時,系統針對此請求提供的回覆只會確認該請求已成功排入序列,但貨件本身可能尚未成功經過處理,且也會傳回 jobId,以便稍後取得結果。
注意:這項程序需要時間讓貨件能成功的被處理,您才能取得結果。
若要擷取非同步貨件結果,請使用端點擷取非同步託運,並在請求中提供 jobId 和 accountNumber 詳細資料。系統會針對該請求傳回含有標籤詳細資料的貨件結果資料,或是貨件錯誤詳細資料。
範例:您的貨件包含 45 個包裹,在提交後會以非同步貨件方式處理。系統會在回應中傳回 jobId。接著,您就能使用端點 Retrieve Async Ship 來擷取貨件結果,進而取得標籤資料。
以下高層級工作流程會說明非同步託運處理的過程:
- 使用端點建立貨件建立含有超過 40 件包裹的貨件。
- 提供所有必需貨件詳細資訊,並且將元素 processingOptionType 指定為 ALLOW_ASYNCHRONOUS,元素 labelResponseOptions 則指定為 LABEL。
- 提交成功後,系統會提供 jobId。
- 使用 jobId 和 accountNumber,透過擷取非同步託運端點來取得輸出結果。
- 如輸出成功,系統會提供結果資料和標籤詳細資訊。
- 如果結果有錯誤,回應會提供錯誤詳細資訊。
- 修正錯誤後,重新建立並提交貨件,以便取得成功回應。
附註:
- 在此方法中,單一請求所允許的包裹總數為 300 到 999 個商品之間。
- 在此方法中,請求一經提交,將無法在原始請求中新增、修改或刪除該包裹。
- 如果非同步貨件回應中有錯誤,您無法在相同貨件請求中重新確認或修正資料,而是必須在修改或修正錯誤後,提交新的貨件請求
回件託運
只要是可提供現有 FedEx Express 服務的地區,國內和國際託運都適用回件服務。您可以透過追蹤號碼將出貨貨件與回件貨件建立關聯或「連結」。使用 FedEx 自動化服務處理國際回件包裹時,基於海關清關目的,您必須在處理包裹過程中為出貨貨件和回件貨件提供回件原因。請將包裹指定為回件,並加入回件類型。請從以下表單選取正確的回件原因。
出貨 加入回件標籤的原因為何? |
回件 回件的原因為何?
|
何時適用? |
---|---|---|
代付回件標籤 | 退貨 | 如果您要為客戶在貨件中加上回件標籤,但通常並不期望獲得回件時,請選取這兩種原因。 |
展覽/商貿展 | 展覽/商貿展回件 | 如果您託運的物品用於展覽、商貿展或活動時,請選取這兩種原因。 |
租借項目 | 出借物歸還 | 如果您託運的物品僅供收件人暫時使用,且將原封不動歸還給您時,請選取這兩種原因。 |
修理/加工用途 | 修理/加工回件 | 如果您託運的物品將會經過修理或加工,之後再退還給您,請選取這兩種原因。修理或加工過程可能包含修改、合併或某種形式的處理等手法。 |
物品試用 | 測試品回件 | 如果您託運的物品為測試品,且之後會退還給您,請選取這兩種原因。 |
置換 | 寄出物為故障品 | 如果您想要先託運更換物品,然後再收回故障品,請選擇這兩種原因。 |
臨時出口 – 其他 | 回件 – 其他 | 如果列出的其他原因均不適用,請選取這兩種原因。做出上述選擇時,您可以說明回件的確切原因。 |
後續修理/加工回件 | N/A | 如果物品收件人之前寄送物品給您做修復時,並非透過 FedEx 託運,請選取這項原因。 |
回件貨件產生後,您透過可用的追蹤應用程式即可追蹤貨件,進而增加託運可見度的期程。
FedEx® 回件解決方案提供兩種處理回件標籤的方式:FedEx 回件標籤和 FedEx 回件標記。
- FedEx 回件標籤解決方案可讓您產生印刷回件或電子郵件回件標籤,或使用預先列印的標籤 (計費郵票和陸運包裹回件方案)。
- FedEx 印刷回件標籤 – 建立並列印回件標籤,然後將標籤加入運送給客戶的原始貨件,或另行寄件。您的客戶之後可根據需求將此標籤貼上包裹,投遞到最近的 FedEx 投遞服務站。
- FedEx 電子郵件回件標籤 – 透過電子郵件將透過密碼保護的 fedex.com URL 傳送給客戶,客戶存取後可直接從自己的電腦列印回件標籤。客戶收到包含標籤連結的電子郵件後,可列印標籤,將標籤貼上包裹,投遞到最近的 FedEx 投遞服務站。
- 列印後的回件標籤並不會過期,隨時使用於運送皆有效。然而,如果標籤列印後已超過 255 天,客戶將無法追蹤貨件,即使標籤依然可使用亦然。
- FedEx 回件標記解決方案 (FedEx Express® 標記和 FedEx Ground® 發貨標籤) 會在包裹取件時提供由 FedEx 產生的回件標籤。由您安排 FedEx 向客戶建立並提供回件託運標籤,並且收取要回件的物品,客戶僅需在 FedEx Express® 運務員抵達收件時備妥包裹即可。託運標籤及客戶收據皆會在現場列印。
- 您可以預約 FedEx Express 取件時間,時間可為週一至週五當天或下一個工作天。FedEx 會在服務中嘗試取件一次。
- 您也可以利用回件指示詳細資訊,列印回件指示後隨附在出口貨件中。
下節會說明如何建立與刪除 FedEx Express 回件標記請求,以及如何將 FedEx Express 或 FedEx Ground 回件標籤加入託運請求中。
全球回件
FedEx 全球回件服務方案將現有的回件產品組合擴大,在所有地區 (亞太地區;歐洲、中東與非洲地區;拉丁美洲與加勒比地區;美國與加拿大) 開發了全球回件解決方案,並在這些地區內提供國內回件服務。此方案將可加速回件文件處理,不僅提供出入境解決方案,也帶來完整的套裝產品組合選項。此外,方案也在適用情況下,支援將回件退回寄件地、新地點或國內回件。
此方案可供商家為國際與非美國的國內回件貨件託運請求電子郵件回件標籤和貿易文件,並提供給回件寄件人取得。還有許多新推出的加強型服務也適用於美國國內電子郵件回件標籤貨件,包括但不限於:回件指示、商家通知、商家文件,以及延長到期時間 (2 年)。
FedEx 回件標記
FedEx 會為客戶建立與提供退貨運送標籤,並收取退貨的物品。客戶必須在 FedEx 司機抵達時,備妥要取件的包裹。請使用託運應用程式開發介面 (API) 建立與刪除 FedEx Express 和 FedEx Ground 貨件的回件標記。
建立 FedEx Express 貨件的回件標記之前,您可以使用回件標記端點中的快遞標記服務供應狀態確認有效的取件時間。
回件標記服務詳細資訊
使用 FedEx Ground 服務時,我們最多會嘗試取件三次;使用 FedEx Express 時,則最多一次,之後就會取消回件標記。
以下服務詳細資訊適用於回件標記:
- 遞送範圍
- 適用於全美國 50 州的 FedEx 遞送
- FedEx Express 和 FedEx Ground 回件標記標籤不適用於國際貨件。
- 商業與住宅地址皆可使用此服務。
- 國內回件亦適用。
- 例外狀況
- 不提供往來加拿大和波多黎各的跨境服務。
- 使用 FedEx Ground 美國運送的危險材料
- 乾冰貨件和危險物品無法託運。
- 其他資訊
- 其他服務選項包括住宅取件。
- 最高申報值為美金$ 25,000。
如需 FedEx 所供應服務的詳細資訊,請參閱電子版 FedEx 服務指南。
回件標記規定
以下詳細資訊適用於回件標記:
- 在單件包裹請求中,您可以申請一次回件標記。
- 在多件的回件標記請求中,您最多可以申請 99 件的標記。
- 無需檢附陸運貨運清單。
- FedEx® 快遞標籤貨件可經由回件關聯元素與出口貨件建立關聯。
- FedEx Ground® 發貨標籤貨件可經由下列元素與出口貨件建立關聯:
- 客戶參考類型設為 RMA_ASSOCIATION,且
- 客戶參考值設為 RMA 號碼
FedEx 列印回件標籤
FedEx 列印回件標籤非常適合使用於零售產品、法律文件、藥品和保固/修復服務。請使用「建立貨件」端點列印回件標籤,並加入要運送給客戶的原始貨件,或分開寄送。如要使用列印回件標籤,您的客戶只需備妥託運包裹,並貼上回件標籤即可。接著客戶可以藉由預約取件、利用一般預約取件,或造訪 FedEx 投遞服務站的方式,向 FedEx 交付 FedEx Express® 美國或國際包裹,或者 FedEx International Ground® 包裹。
此外,您也可以在託運交易中加入退貨授權 (RMA) 參考編號。RMA 號碼會以條碼形式列印在標籤上,並以人類可讀形式新增至回件標籤的 RMA_Association 參考編號。此號碼亦可列印在 FedEx 發票上,且可用於追蹤回件包裹。FedEx Express 和 FedEx Ground 回件標籤可交換使用,不受原始託運服務限制。舉例來說,您可以使用 FedEx Express 服務寄送原始貨件,但在包裝文件中加入 FedEx Ground 回件標籤。
FedEx 列印回件標籤服務詳細資訊
下列服務詳細資訊適用於 FedEx Express 和 FedEx Ground 回件標籤:
- 在全美國 50 州範圍內,列印的回件標籤適用於 FedEx First Overnight®、FedEx Priority Overnight®、FedEx Standard Overnight®、FedEx 2Day®、FedEx 2Day®A.M.、FedEx Ground®、FedEx Home Delivery®。
- 如運送至國際目的地,列印的回件標籤適用於 FedEx 國際特早快遞服務®、FedEx 國際優先快遞服務® 和 FedEx International Ground®。
- 其他服務選項還包括星期六遞送服務、乾冰貨件和由服務站保管。
- 危險物品和危險材料無法託運。
- 最高申報值如下
- FedEx First Overnight、FedEx Priority Overnight、FedEx Standard Overnight 和 FedEx 2Day 為美金$ 1,000。
- FedEx Ground 和 FedEx Home Delivery 為美金$ 100。
如需 FedEx 所提供服務的詳細資訊,請參閱電子版 FedEx 服務指南。
替代回件地址
託運應用程式開發介面 (API) 提供替代回件地址選項,以便您覆寫寄件人地址,並在託運標籤上列印不同地址。舉例來說,如果您寄送的包裹無法遞送,您可以透過此選項標示回件處理設施的地址,以便讓 FedEx 將包裹退回該地址,藉此替代託運設施地址。
貨件流程
FedEx 會按部就班逐一經不同地點轉運貨件。我們遵照的託運工作流程如下:
準備/建立貨件
建立貨件是託運流程的第一步。在託運產品之前,寄件人必須選擇所需產品,並向製造商下訂單。FedEx 會提供託運日期,指出產品可於何時取件,並提供訂單的商業發票。發票中的貨件詳細資訊包含託運日期、詳細寄件地和目的地地址,以及包裹尺寸。
如有任何特殊要求,例如託運危險物品或乾冰,FedEx 就會根據相關目的提供特殊服務。
路線
路線資訊有助於建立與計算實地營運的規劃路線。該資訊可協助開發路線,將往來數家客戶的所有遞送與取件地點都涵蓋進來,並找出最有效率的路線。
查詢
追蹤作業可協助您根據運送位置 (即上一個、目前以及下一個位置) 監控貨件物品所在。隨著包裹往目的地運送過程,您會收到即時的位置資訊。
您可以使用此貨件特殊服務的通知事件類型選項,設定並自訂要收到的貨件查詢事件通知。
使用通知事件類型可讓 FedEx 自動通知您和/或客戶及/或第三方。系統會透過電子郵件傳送此類通知,其中含有重大貨件事件 (如清關延遲、遞送嘗試、放行及預先通知)。
您可以針對下列事件接收電子郵件通知:
- 正在建立貨件
- 預估送達日期
- 貨件已遞交
- 任何例外事件
- 貨件送達
如需傳送電子郵件通知給收件人,您必須於貨件請求指定收件人電子郵件,並使用任意或所有的通知類型。此通知支援 FedEx Express、FedEx Ground 及 FedEx Ground® Economy。FedEx 也會為預估送達日期提供新的電子郵件通知,於遞送當日發送電子郵件。與此請求關聯的關鍵輸入資訊如下:
- 寄件人姓名
- 電子郵件
- 通知事件
請按一下這裡,以取得通知事件類型的更多資訊。
此請求的成功結果將會針對指定事件啟動通知提示,並傳送至指定的電子郵件地址。
費率
在要求費率報價時,務必具體說明貨件的詳細資訊,包括日期、詳細寄件地和目的地地址,以及貨件尺寸。如有提供這些精確的詳細資訊,您的物品將可收到正確的報價。如果您有任何特殊要求,例如運送危險物品,請務必具體說明。
標籤
標籤可用於說明與指出包裹內容。視使用的運輸業者而定,託運標籤可能不同。
託運標籤一般包含下列資訊:
商務規則
FedEx Express 美國
- 所有 FedEx 服務都要求取件時提供政府核發的相片身份證件。
- FedEx SameDay® City 服務僅適用於墨西哥境內特定城市。
- FedEx Express Saver® 服務適用於美國全部州別,阿拉斯加和夏威夷除外。
- FedEx 2Day®A.M. 服務適用於全美 50 州 (夏威夷僅供出境託運)。
- FedEx Express 美國服務適用於託運至美國 50 州。運輸時間視包裹目的地及所選服務而定。
- FedEx Ground® Economy 服務的包裹託運重量上限為 70 磅。
- FedEx 為 FedEx Express 貨件提供自訂包裝服務。您可以選擇使用 FedEx® 信封、FedEx® 快遞袋、FedEx® 快遞箱或 FedEx® 快遞筒運送。您也可以使用自己的包裝來運送。
- 商業及住宅地址貨件都可以透過 FedEx Express 美國服務來託運。您必須在託運交易中指明住宅包裹。
- 為交易費用設定帳單時,您有數個選項可選。這些帳單選項包括計入寄件者的 FedEx 帳戶、計入收件人的 FedEx 帳戶、FedEx Ground® 貨到付款,以及計入第三方的 FedEx 帳戶。
- FedEx Express 美國包裹的尺寸上限為重量 150 磅、長度 119 吋,或長度與週長合計 (長度 + 2 倍寬度 + 2 倍高度) 165 吋。
FedEx Ground 美國託運
下列規則適用於 FedEx Ground 美國託運:
- 貨件的寄件地及遞送目的地可為美國 50 州。美國相鄰各州可在 1 到 7 個工作天內送達,阿拉斯加和夏威夷的往來貨件則在 3 到 7 個工作天內送達。
- FedEx Home Delivery 在週一到週五向所有美國地址提供當天結束前送達服務,週六為幾乎全數居住地址適用,週日則為大部分地址適用。
- FedEx Ground 不會遞送至郵政信箱。不提供危險材料遞送,ORM-D 及數量限定者除外。
- FedEx Ground® 服務適用於全美 50 州內的所有商業地址 (阿拉斯加和夏威夷特定偏遠位置僅提供入境運送服務)。
- FedEx Home Delivery® 服務適用於所有美國住宅地址。透過本服務,最多可託運 150 件包裹。
- FedEx Ground 可受理最重達 150 磅的包裹。包裹尺寸的上限為長 108 吋,或長度加周長合計 (長度 + 2 倍寬度 + 2 倍高度) 165 吋。
- HazMat 貨件可受理,但設有限制:危險材料不得往來託運阿拉斯加和夏威夷。
- 如果包裹必須遞送至商業地址,請將服務類型指定為 FedEx Ground。如果包裹必須遞送至住宅地址,則請指定 FedEx Home Delivery。
- 託運 FedEx Ground 美國包裹時,您必須輸入美國五十州內的有效商業或公司託運地址。
- 向美國境內住宅地址託運包裹時,請使用 FedEx Home Delivery 服務。如果住宅遞送的貨件未滿 150 磅,FedEx Ground 會指定由 FedEx Home Delivery 服務承運。
- FedEx Ground 貨件的寄件人和收件人地址必須包含美國城市與州。
- 請勿在遞送地址中輸入 USPS 郵政信箱號碼。
注意:您必須啟用寄件人帳號,才能使用陸運到府功能。帳號啟用後,客戶就能為低於 150 磅的住宅地址遞送貨件指定 Ground 服務類型,不必指定 Ground 住宅遞送。
國際託運
- 海關清關包含在貨件服務中。
- 包裹的重量和尺寸上限分別為重 150 磅,長 108 吋,長與周長合計 (長度 + 2 倍寬度 + 2 倍高度) 130 吋,上述限制適用於 FedEx 國際優先快遞服務、FedEx 國際經濟快遞服務及 FedEx 國際特早快遞服務®
- FedEx International First 服務提供在 1 到 2 個工作天內從 60 個國家/地區進口並遞送至特定美國郵遞區號的服務。
- 下列服務選項適用於 FedEx Express 國際託運:替代回件地址、商業目的地管制、危險物品、FedEx Express 國際星期六服務、乾冰貨件、簽收選項、FedEx InSight、FedEx 國際清關代理人指定®、遮蔽帳號 (FedEx International Ground)、遮蔽資料、在託運請求中提供貨件通知,以及變動處理費用。
- 可選用 FedEx 10 公斤快遞箱或 FedEx 25 公斤快遞箱包裝選項。FedEx 10 公斤快遞箱限重 22 磅,FedEx 25 公斤快遞箱限重 55 磅。上述包裝選項適用於 FedEx 國際優先快遞服務®,可為超過 220 個國家和地區提供。
- 寄送 FedEx Express 國際多包裹貨件 (MPS) 時,如有包裹為文件類,則貨件中所有包裹都必須為文件類。此規定也適用於商品類貨件,所有包裹都必須為商品類。商品類和文件類包裹不可混合在同一批多包裹貨件 (MPS) 中。
國內託運
- 使用 FedEx SameDay City 服務需要簽訂合約
- 手寫空運提單並不適用 SameDay City 服務,此服務僅適用於墨西哥境內特定城市,與美國國內 FedEx SameDay Service 不同。
- 託運危險材料前,您必須先獲得認證。
- FedEx Ground 服務不受理超過 150 磅的包裹、超過 70 磅的 HazMat 包裹、超過 66 磅的 ORM-D/數量限制包裹、長度超過 108 吋或長度與周長合計 (長度 + 2 倍寬度 + 2 倍高度) 超過 165 吋的包裹,以及搭配 HazMat 或 ORM-D/數量限制貨件使用特殊補助由服務站保管的包裹。
- 以下為貨到收款 (C.O.D.) 付款選項無效:旅行支票、信用卡、櫃台支票、第三方背書的支票,或向 FedEx 開立應付支票。
標籤建立
- FedEx 應用程式開發介面 (API) 可讓您透過各種熱感應標籤印表機為所有託運類型列印託運標籤,例如 FedEx Express®、FedEx Ground® 和 FedEx International Ground® 都適用。
- 貨件所需的所有熱感應標籤都會在單次緩衝中產生與傳回。
- 如需重新列印標籤,可將原始熱感應標籤緩衝傳送至印表機。不過,您僅可在原始標籤於包裹取件之前已損毀或遺失,或需做為記錄用影本時,才可重新列印標籤。複製要貼在包裹上的標籤會造成重製標籤問題,某些情況下也會造成您的託運服務遭到暫停。
- 以雷射印表機列印的標籤會產生為 PDF 格式,且不需重新調整大小。
- 處理標籤時需要使用 Adobe Reader 6.0 或以上版本。印表機驅動程式組態的印表機縮放功能必須設為「無」。
- 不需要使用 HTML 包裝函式,即可在瀏覽器中顯示普通紙張的 PDF 標籤。
- 雷射標籤如果以噴墨印表機列印,則無法受理。如果您使用彩色雷射印表機,色彩定義必須設為黑色,即使印表機僅安裝黑色墨水匣也一樣
- FedEx 會為每個託運請求傳回一張雷射標籤,但貨到收款 (C.O.D.) 標籤除外。
- 如果您需要列印多張標籤 (舉例來說,國際貨件需要在海關清關文件中檢附額外的託運標籤副本),務必請求額外副本。
- 如果未指定語言,所有墨西哥境內託運的貨件都會以西班牙文提供法律條款與條件。
- 如需重新列印雷射標籤,可將原始 PDF 傳送至印表機。僅需呼叫 FedEx 常用標籤伺服器 (CLS) 一次,即可產生所有所需標籤;CLS 會傳回單次緩衝,貨到收款 (C.O.D.)回件標籤除外。
- 標籤上的人類可讀內容和標籤一般部分中的條碼無法更改。
- 託運應用程式開發介面 (API) 會向 FedEx Express 和 FedEx Ground 標籤提供 PNG (可攜式網路圖形) 影像。
- 4 吋 x 6 吋 PNG 自訂標籤僅可使用於黏貼式標籤紙。
- 請勿使用噴墨印表機,因為這種印表機在建立掃描式條碼時並不穩定。
JSON 應用程式開發介面 (API) 集合
Ship API (1.0.0)
Create Shipment
This endpoint helps you to create shipment requests thereby validating all the shipping input information and either generates the labels (if the responses is synchronous) or a job ID if transaction is processed using asynchronous method.
Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS) mechanism.
header Parameters
x-customer-transaction-id | string Example: 624deea6-b709-470c-8c39-4b5511281492 This element allows you to assign a unique identifier to your transaction. This element is also returned in the reply and helps you match the request to the reply. |
content-type required | string Example: application/json This is used to indicate the media type of the resource. The media type is a string sent along with the file indicating format of the file. |
x-locale | string Example: en_US This indicates the combination of language code and country code. Click here to see Locales |
authorization required | string Example: Bearer XXX This indicates the authorization token for the input request. |
Request Body schema: application/json
- Full_Schema_Ship
- MinimumSamplePayload-ShipShipment
- MinimumSamplePayload-DomesticShipmentMPS
- SamplePayload-InternationalShipmentMPS
- FDGSamplePayload-ShipShipment-intraEurope
- One_Rate_Shipment
- US_Domestic_SingleShot_Multi_Piece_Shipment
- US_Domestic_Print_Return_Label_Shipment
- US_Domestic_Email_Return_Label_Shipment
- International_SingleShot_Multi_Piece_Shipment
- Express_OneLabelATATime_Master_Shipment
- Express_OneLabelATATime_Child_Shipment
- Ground_OneLabelATATime_Master_Shipment
- Ground_OneLabelATATime_Child_Shipment
- Asynchronous_Multipiece_Shipment
- Alcohol_Shipment
- US_Domestic_Hold_At_Location_Adult_Signature_Option_Shipment
- Electronic_Trade_Documents_Requested_Document_Copies
- Ground_HomeDelivery_Shipment_Appointment
- International_Shipment
- Intra_India_Cash_on_Delivery_and_Delivery_on_Invoice_Acceptance
- Intra_Mexico_Express_Saver_Shipment
- Intra_UAE_Standard_Overnight_Shipment
- Priority_Alert_Freight_Shipment
- SmartPost_Shipment_Return
- SmartPost_Shipment
- US_Express_Freight
- US_Express_Shipment
- US_Ground_Shipment
- International_Print_Return_Shipment
- International_Dry_Ice_Shipment
- Third_Party_Consigneee_Shipment
- Intra_UK_Shipment
- Domestic_Express_Customer_Reference
- MinimumSamplePayload-Intra-EU
- International_Express_Email_notifications
mergeLabelDocOption | string Enum: "NONE" "LABELS_AND_DOCS" "LABELS_ONLY" It specifies the content of the merged pdf URL in the response. The merged pdf URL is generated only if the labelResponseOption is indicated as URL_ONLY.
This is optional field and will default to LABELS_AND_DOCS. Note: If the value is 'LABELS_ONLY', then the returned merged pdf label will not be in the Base64 encoded format. |
requestedShipment required | object (RequestedShipment) The descriptive data of the requested shipment. |
labelResponseOptions required | string (LABELRESPONSEOPTIONS) Enum: "URL_ONLY" "LABEL" LabelResponseOptions specifies the label generation format. |
accountNumber required | object (ShipperAccountNumber) The account number associated with the shipment. |
shipAction | string (OpenShipmentAction) Enum: "CONFIRM" "TRANSFER" Indicate shipment action for the Shipment.
|
processingOptionType | string (AsynchronousProcessingOptionType_1) Enum: "SYNCHRONOUS_ONLY" "ALLOW_ASYNCHRONOUS" Indicate the processing option for submitting a Single shot MPS shipment. The value indicates if the MPS to be processed synchronously or asynchronously.
Example:ALLOW_ASYNCHRONUS |
oneLabelAtATime | boolean This flag is used to specify if the shipment is singleshot mps or one Label at a time, piece by piece shipment. Default is false. If true, one label at a time is processed. |
Responses
Success
Bad Request
Unauthorized
Forbidden
Not Found
Failure
Service Unavailable
Sandbox Server
Production Server
Request samples
- Payload
- C#
- JAVA
- JAVASCRIPT
- PHP
- PYTHON
- RUST
- SWIFT
- "mergeLabelDocOption": "LABELS_AND_DOCS",
- "requestedShipment": {
- "shipDatestamp": "2019-10-14",
- "totalDeclaredValue": {
- "amount": 12.45,
- "currency": "USD"
- "shipper": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneExtension": "91",
- "phoneNumber": "XXXX567890",
- "companyName": "Fedex"
- "tins": [
- {
- "number": "XXX567",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2024-06-13",
- "expirationDate": "2024-06-13"
- "soldTo": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneExtension": "91",
- "phoneNumber": "1234567890",
- "companyName": "Fedex"
- "tins": [
- {
- "number": "123567",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2000-01-23T04:56:07.000+00:00",
- "expirationDate": "2000-01-23T04:56:07.000+00:00"
- "accountNumber": {
- "value": "Your account number"
- "recipients": [
- {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneExtension": "000",
- "phoneNumber": "XXXX345671",
- "companyName": "FedEx"
- "tins": [
- {
- "number": "123567",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2000-01-23T04:56:07.000+00:00",
- "expirationDate": "2000-01-23T04:56:07.000+00:00"
- "deliveryInstructions": "Delivery Instructions"
- "recipientLocationNumber": "1234567",
- "pickupType": "USE_SCHEDULED_PICKUP",
- "serviceType": "PRIORITY_OVERNIGHT",
- "packagingType": "YOUR_PACKAGING",
- "totalWeight": 20.6,
- "origin": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "38127",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "person name",
- "emailAddress": "email address",
- "phoneNumber": "phone number",
- "phoneExtension": "phone extension",
- "companyName": "company name",
- "faxNumber": "fax number"
- "shippingChargesPayment": {
- "paymentType": "SENDER",
- "payor": {
- "responsibleParty": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneNumber": "XXXX567890",
- "phoneExtension": "phone extension",
- "companyName": "Fedex",
- "faxNumber": "fax number"
- "accountNumber": {
- "value": "Your account number"
- "shipmentSpecialServices": {
- "specialServiceTypes": [
- "THIRD_PARTY_CONSIGNEE",
- "PROTECTION_FROM_FREEZING"
- "etdDetail": {
- "attributes": [
- "POST_SHIPMENT_UPLOAD_REQUESTED"
- "attachedDocuments": [
- {
- "documentType": "PRO_FORMA_INVOICE",
- "documentReference": "DocumentReference",
- "description": "PRO FORMA INVOICE",
- "documentId": "090927d680038c61"
- "requestedDocumentTypes": [
- "VICS_BILL_OF_LADING",
- "GENERAL_AGENCY_AGREEMENT"
- "returnShipmentDetail": {
- "returnEmailDetail": {
- "merchantPhoneNumber": "19012635656",
- "allowedSpecialService": [
- "SATURDAY_DELIVERY"
- "rma": {
- "reason": "Wrong Size or Color"
- "returnAssociationDetail": {
- "shipDatestamp": "2019-10-01",
- "trackingNumber": "123456789"
- "returnType": "PRINT_RETURN_LABEL"
- "deliveryOnInvoiceAcceptanceDetail": {
- "recipient": {
- "address": {
- "streetLines": [
- "23, RUE JOSEPH-DE MA",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneExtension": "000",
- "phoneNumber": "1234567890",
- "companyName": "Fedex"
- "tins": [
- {
- "number": "123567",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2000-01-23T04:56:07.000+00:00",
- "expirationDate": "2000-01-23T04:56:07.000+00:00"
- "deliveryInstructions": "Delivery Instructions"
- "internationalTrafficInArmsRegulationsDetail": {
- "licenseOrExemptionNumber": "9871234"
- "pendingShipmentDetail": {
- "pendingShipmentType": "EMAIL",
- "processingOptions": {
- "options": [
- "ALLOW_MODIFICATIONS"
- "recommendedDocumentSpecification": {
- "types": [
- "ANTIQUE_STATEMENT_EUROPEAN_UNION",
- "ANTIQUE_STATEMENT_UNITED_STATES"
- "emailLabelDetail": {
- "recipients": [
- {
- "emailAddress": "nnnnneena@fedex.com",
- "optionsRequested": {
- "options": [
- "PRODUCE_PAPERLESS_SHIPPING_FORMAT",
- "SUPPRESS_ACCESS_EMAILS"
- "role": "SHIPMENT_COMPLETOR",
- "locale": "en_US"
- "message": "your optional message"
- "attachedDocuments": [
- {
- "documentType": "PRO_FORMA_INVOICE",
- "documentReference": "DocumentReference",
- "description": "PRO FORMA INVOICE",
- "documentId": "090927d680038c61"
- "expirationTimeStamp": "2020-01-01"
- "holdAtLocationDetail": {
- "locationId": "YBZA",
- "locationContactAndAddress": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "38127",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "person name",
- "emailAddress": "email address",
- "phoneNumber": "phone number",
- "phoneExtension": "phone extension",
- "companyName": "company name",
- "faxNumber": "fax number"
- "locationType": "FEDEX_ONSITE"
- "shipmentCODDetail": {
- "addTransportationChargesDetail": {
- "rateType": "ACCOUNT",
- "rateLevelType": "BUNDLED_RATE",
- "chargeLevelType": "CURRENT_PACKAGE",
- "chargeType": "COD_SURCHARGE"
- "codRecipient": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneExtension": "000",
- "phoneNumber": "XXXX345671",
- "companyName": "Fedex"
- "accountNumber": {
- "value": "Your account number"
- "tins": [
- {
- "number": "123567",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2000-01-23T04:56:07.000+00:00",
- "expirationDate": "2000-01-23T04:56:07.000+00:00"
- "remitToName": "remitToName",
- "codCollectionType": "CASH",
- "financialInstitutionContactAndAddress": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "38127",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "person name",
- "emailAddress": "email address",
- "phoneNumber": "phone number",
- "phoneExtension": "phone extension",
- "companyName": "company name",
- "faxNumber": "fax number"
- "codCollectionAmount": {
- "amount": 12.45,
- "currency": "USD"
- "returnReferenceIndicatorType": "INVOICE",
- "shipmentCodAmount": {
- "amount": 12.45,
- "currency": "USD"
- "shipmentDryIceDetail": {
- "totalWeight": {
- "units": "LB",
- "value": 10
- "packageCount": 12
- "internationalControlledExportDetail": {
- "licenseOrPermitExpirationDate": "2019-12-03",
- "licenseOrPermitNumber": "11",
- "entryNumber": "125",
- "foreignTradeZoneCode": "US",
- "type": "WAREHOUSE_WITHDRAWAL"
- "homeDeliveryPremiumDetail": {
- "phoneNumber": {
- "areaCode": "901",
- "localNumber": "3575012",
- "extension": "200",
- "personalIdentificationNumber": "98712345"
- "deliveryDate": "2019-06-26",
- "homedeliveryPremiumType": "APPOINTMENT"
- "emailNotificationDetail": {
- "aggregationType": "PER_PACKAGE",
- "emailNotificationRecipients": [
- {
- "name": "Joe Smith",
- "emailNotificationRecipientType": "SHIPPER",
- "emailAddress": "jsmith3@aol.com",
- "notificationFormatType": "TEXT",
- "notificationType": "EMAIL",
- "locale": "en_US",
- "notificationEventType": [
- "ON_PICKUP_DRIVER_ARRIVED",
- "ON_SHIPMENT"
- "personalMessage": "your personal message here"
- "expressFreightDetail": {
- "bookingConfirmationNumber": "123456789812",
- "shippersLoadAndCount": 123,
- "packingListEnclosed": true
- "variableHandlingChargeDetail": {
- "rateType": "PREFERRED_CURRENCY",
- "percentValue": 12.45,
- "rateLevelType": "INDIVIDUAL_PACKAGE_RATE",
- "fixedValue": {
- "amount": 24.45,
- "currency": "USD"
- "rateElementBasis": "NET_CHARGE_EXCLUDING_TAXES"
- "customsClearanceDetail": {
- "regulatoryControls": [
- "NOT_IN_FREE_CIRCULATION",
- "USMCA"
- "brokers": [
- {
- "broker": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneNumber": "1234567890",
- "phoneExtension": 91,
- "companyName": "Fedex",
- "faxNumber": 1234567
- "accountNumber": {
- "value": "Your account number"
- "tins": [
- {
- "number": "number",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2000-01-23T04:56:07.000+00:00",
- "expirationDate": "2000-01-23T04:56:07.000+00:00"
- "deliveryInstructions": "deliveryInstructions"
- "type": "IMPORT"
- "commercialInvoice": {
- "originatorName": "originator Name",
- "comments": [
- "optional comments for the commercial invoice"
- "customerReferences": [
- {
- "customerReferenceType": "DEPARTMENT_NUMBER",
- "value": "3686"
- "taxesOrMiscellaneousCharge": {
- "amount": 12.45,
- "currency": "USD"
- "taxesOrMiscellaneousChargeType": "COMMISSIONS",
- "freightCharge": {
- "amount": 12.45,
- "currency": "USD"
- "packingCosts": {
- "amount": 12.45,
- "currency": "USD"
- "handlingCosts": {
- "amount": 12.45,
- "currency": "USD"
- "declarationStatement": "declarationStatement",
- "termsOfSale": "FCA",
- "specialInstructions": "specialInstructions\"",
- "shipmentPurpose": "REPAIR_AND_RETURN",
- "emailNotificationDetail": {
- "emailAddress": "neena@fedex.com",
- "type": "EMAILED",
- "recipientType": "SHIPPER"
- "freightOnValue": "OWN_RISK",
- "dutiesPayment": {
- "payor": {
- "responsibleParty": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "38127",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneNumber": "1234567890",
- "phoneExtension": "phone extension",
- "companyName": "Fedex",
- "faxNumber": "fax number"
- "accountNumber": {
- "value": "Your account number"
- "tins": [
- {
- "number": "number",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2024-06-13",
- "expirationDate": "2024-06-13"
- {
- "number": "number",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2024-06-13",
- "expirationDate": "2024-06-13"
- "billingDetails": {
- "billingCode": "billingCode",
- "billingType": "billingType",
- "aliasId": "aliasId",
- "accountNickname": "accountNickname",
- "accountNumber": "Your account number",
- "accountNumberCountryCode": "US"
- "paymentType": "SENDER"
- "commodities": [
- {
- "unitPrice": {
- "amount": 12.45,
- "currency": "USD"
- "additionalMeasures": [
- {
- "quantity": 12.45,
- "units": "KG"
- "numberOfPieces": 12,
- "quantity": 125,
- "quantityUnits": "Ea",
- "customsValue": {
- "amount": "1556.25",
- "currency": "USD"
- "countryOfManufacture": "US",
- "cIMarksAndNumbers": "87123",
- "harmonizedCode": "0613",
- "description": "description",
- "name": "non-threaded rivets",
- "weight": {
- "units": "KG",
- "value": 68
- "exportLicenseNumber": "26456",
- "exportLicenseExpirationDate": "2025-03-15T15:47:31Z",
- "partNumber": "167",
- "purpose": "BUSINESS",
- "usmcaDetail": {
- "originCriterion": "A"
- "isDocumentOnly": false,
- "recipientCustomsId": {
- "type": "PASSPORT",
- "value": "123"
- "customsOption": {
- "description": "Description",
- "type": "COURTESY_RETURN_LABEL"
- "importerOfRecord": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneExtension": "000",
- "phoneNumber": "XXXX345671",
- "companyName": "Fedex"
- "accountNumber": {
- "value": "Your account number"
- "tins": [
- {
- "number": "123567",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2000-01-23T04:56:07.000+00:00",
- "expirationDate": "2000-01-23T04:56:07.000+00:00"
- "generatedDocumentLocale": "en_US",
- "exportDetail": {
- "destinationControlDetail": {
- "endUser": "dest country user",
- "statementTypes": "DEPARTMENT_OF_COMMERCE",
- "destinationCountries": [
- "USA",
- "India"
- "b13AFilingOption": "NOT_REQUIRED",
- "exportComplianceStatement": "12345678901234567",
- "permitNumber": "12345"
- "totalCustomsValue": {
- "amount": 12.45,
- "currency": "USD"
- "partiesToTransactionAreRelated": true,
- "declarationStatementDetail": {
- "usmcaLowValueStatementDetail": {
- "countryOfOriginLowValueDocumentRequested": true,
- "customsRole": "EXPORTER"
- "insuranceCharge": {
- "amount": 12.45,
- "currency": "USD"
- "smartPostInfoDetail": {
- "ancillaryEndorsement": "RETURN_SERVICE",
- "hubId": "5015",
- "indicia": "PRESORTED_STANDARD",
- "specialServices": "USPS_DELIVERY_CONFIRMATION"
- "blockInsightVisibility": true,
- "labelSpecification": {
- "labelFormatType": "COMMON2D",
- "labelOrder": "SHIPPING_LABEL_FIRST",
- "customerSpecifiedDetail": {
- "maskedData": [
- "PACKAGE_SEQUENCE_AND_COUNT",
- "TOTAL_WEIGHT"
- "regulatoryLabels": [
- {
- "generationOptions": "CONTENT_ON_SHIPPING_LABEL_ONLY",
- "type": "ALCOHOL_SHIPMENT_LABEL"
- "additionalLabels": [
- {
- "type": "MANIFEST",
- "count": 1
- "docTabContent": {
- "docTabContentType": "BARCODED",
- "zone001": {
- "docTabZoneSpecifications": [
- {
- "zoneNumber": 0,
- "header": "string",
- "dataField": "string",
- "literalValue": "string",
- "justification": "RIGHT"
- "barcoded": {
- "symbology": "UCC128",
- "specification": {
- "zoneNumber": 0,
- "header": "string",
- "dataField": "string",
- "literalValue": "string",
- "justification": "RIGHT"
- "printedLabelOrigin": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "38127",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "person name",
- "emailAddress": "email address",
- "phoneNumber": "phone number",
- "phoneExtension": "phone extension",
- "companyName": "company name",
- "faxNumber": "fax number"
- "labelStockType": "PAPER_7X475",
- "labelRotation": "UPSIDE_DOWN",
- "imageType": "PDF",
- "labelPrintingOrientation": "TOP_EDGE_OF_TEXT_FIRST",
- "returnedDispositionDetail": "RETURNED",
- "resolution": 300
- "shippingDocumentSpecification": {
- "generalAgencyAgreementDetail": {
- "documentFormat": {
- "provideInstructions": true,
- "optionsRequested": {
- "options": [
- "SUPPRESS_ADDITIONAL_LANGUAGES",
- "SHIPPING_LABEL_LAST"
- "stockType": "PAPER_LETTER",
- "dispositions": [
- {
- "eMailDetail": {
- "eMailRecipients": [
- {
- "emailAddress": "email@fedex.com",
- "recipientType": "THIRD_PARTY"
- "locale": "en_US",
- "grouping": "NONE"
- "dispositionType": "CONFIRMED"
- "locale": "en_US",
- "docType": "PDF"
- "returnInstructionsDetail": {
- "customText": "This is additional text printed on Return instr",
- "documentFormat": {
- "provideInstructions": true,
- "optionsRequested": {
- "options": [
- "SUPPRESS_ADDITIONAL_LANGUAGES",
- "SHIPPING_LABEL_LAST"
- "stockType": "PAPER_LETTER",
- "dispositions": [
- {
- "eMailDetail": {
- "eMailRecipients": [
- {
- "emailAddress": "email@fedex.com",
- "recipientType": "THIRD_PARTY"
- "locale": "en_US",
- "grouping": "NONE"
- "dispositionType": "CONFIRMED"
- "locale": "en_US\"",
- "docType": "PNG"
- "op900Detail": {
- "customerImageUsages": [
- {
- "id": "IMAGE_5",
- "type": "SIGNATURE",
- "providedImageType": "SIGNATURE"
- "signatureName": "Signature Name",
- "documentFormat": {
- "provideInstructions": true,
- "optionsRequested": {
- "options": [
- "SUPPRESS_ADDITIONAL_LANGUAGES",
- "SHIPPING_LABEL_LAST"
- "stockType": "PAPER_LETTER",
- "dispositions": [
- {
- "eMailDetail": {
- "eMailRecipients": [
- {
- "emailAddress": "email@fedex.com",
- "recipientType": "THIRD_PARTY"
- "locale": "en_US",
- "grouping": "NONE"
- "dispositionType": "CONFIRMED"
- "locale": "en_US",
- "docType": "PDF"
- "usmcaCertificationOfOriginDetail": {
- "customerImageUsages": [
- {
- "id": "IMAGE_5",
- "type": "SIGNATURE",
- "providedImageType": "SIGNATURE"
- "documentFormat": {
- "provideInstructions": true,
- "optionsRequested": {
- "options": [
- "SUPPRESS_ADDITIONAL_LANGUAGES",
- "SHIPPING_LABEL_LAST"
- "stockType": "PAPER_LETTER",
- "dispositions": [
- {
- "eMailDetail": {
- "eMailRecipients": [
- {
- "emailAddress": "email@fedex.com",
- "recipientType": "THIRD_PARTY"
- "locale": "en_US",
- "grouping": "NONE"
- "dispositionType": "CONFIRMED"
- "locale": "en_US",
- "docType": "PDF"
- "certifierSpecification": "EXPORTER",
- "importerSpecification": "UNKNOWN",
- "producerSpecification": "SAME_AS_EXPORTER",
- "producer": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneExtension": "000",
- "phoneNumber": "XXXX345671",
- "companyName": "Fedex"
- "accountNumber": {
- "value": "Your account number"
- "tins": [
- {
- "number": "123567",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2000-01-23T04:56:07.000+00:00",
- "expirationDate": "2000-01-23T04:56:07.000+00:00"
- "blanketPeriod": {
- "begins": "22-01-2020",
- "ends": "2-01-2020"
- "certifierJobTitle": "Manager"
- "usmcaCommercialInvoiceCertificationOfOriginDetail": {
- "customerImageUsages": [
- {
- "id": "IMAGE_5",
- "type": "SIGNATURE",
- "providedImageType": "SIGNATURE"
- "documentFormat": {
- "provideInstructions": true,
- "optionsRequested": {
- "options": [
- "SUPPRESS_ADDITIONAL_LANGUAGES",
- "SHIPPING_LABEL_LAST"
- "stockType": "PAPER_LETTER",
- "dispositions": [
- {
- "eMailDetail": {
- "eMailRecipients": [
- {
- "emailAddress": "email@fedex.com",
- "recipientType": "THIRD_PARTY"
- "locale": "en_US",
- "grouping": "NONE"
- "dispositionType": "CONFIRMED"
- "locale": "en_US",
- "docType": "PDF"
- "certifierSpecification": "EXPORTER",
- "importerSpecification": "UNKNOWN",
- "producerSpecification": "SAME_AS_EXPORTER",
- "producer": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneExtension": "000",
- "phoneNumber": "XXXX345671",
- "companyName": "Fedex"
- "accountNumber": {
- "value": "Your account number"
- "tins": [
- {
- "number": "123567",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2000-01-23T04:56:07.000+00:00",
- "expirationDate": "2000-01-23T04:56:07.000+00:00"
- "certifierJobTitle": "Manager"
- "shippingDocumentTypes": [
- "RETURN_INSTRUCTIONS"
- "certificateOfOrigin": {
- "customerImageUsages": [
- {
- "id": "IMAGE_5",
- "type": "SIGNATURE",
- "providedImageType": "SIGNATURE"
- "documentFormat": {
- "provideInstructions": true,
- "optionsRequested": {
- "options": [
- "SUPPRESS_ADDITIONAL_LANGUAGES",
- "SHIPPING_LABEL_LAST"
- "stockType": "PAPER_LETTER",
- "dispositions": [
- {
- "eMailDetail": {
- "eMailRecipients": [
- {
- "emailAddress": "email@fedex.com",
- "recipientType": "THIRD_PARTY"
- "locale": "en_US",
- "grouping": "NONE"
- "dispositionType": "CONFIRMED"
- "locale": "en_US",
- "docType": "PDF"
- "commercialInvoiceDetail": {
- "customerImageUsages": [
- {
- "id": "IMAGE_5",
- "type": "SIGNATURE",
- "providedImageType": "SIGNATURE"
- "documentFormat": {
- "provideInstructions": true,
- "optionsRequested": {
- "options": [
- "SUPPRESS_ADDITIONAL_LANGUAGES",
- "SHIPPING_LABEL_LAST"
- "stockType": "PAPER_LETTER",
- "dispositions": [
- {
- "eMailDetail": {
- "eMailRecipients": [
- {
- "emailAddress": "email@fedex.com",
- "recipientType": "THIRD_PARTY"
- "locale": "en_US",
- "grouping": "NONE"
- "dispositionType": "CONFIRMED"
- "locale": "en_US",
- "docType": "PDF"
- "rateRequestType": [
- "LIST",
- "PREFERRED"
- "preferredCurrency": "USD",
- "totalPackageCount": 25,
- "masterTrackingId": {
- "formId": "0201",
- "trackingIdType": "EXPRESS",
- "uspsApplicationId": "92",
- "trackingNumber": "49092000070120032835"
- "requestedPackageLineItems": [
- {
- "sequenceNumber": "1",
- "subPackagingType": "BUCKET",
- "customerReferences": [
- {
- "customerReferenceType": "INVOICE_NUMBER",
- "value": "3686"
- "declaredValue": {
- "amount": 12.45,
- "currency": "USD"
- "weight": {
- "units": "KG",
- "value": 68
- "dimensions": {
- "length": 100,
- "width": 50,
- "height": 30,
- "units": "CM"
- "groupPackageCount": 2,
- "itemDescriptionForClearance": "description",
- "contentRecord": [
- {
- "itemNumber": "2876",
- "receivedQuantity": 256,
- "description": "Description",
- "partNumber": "456"
- "itemDescription": "item description for the package",
- "variableHandlingChargeDetail": {
- "rateType": "PREFERRED_CURRENCY",
- "percentValue": 12.45,
- "rateLevelType": "INDIVIDUAL_PACKAGE_RATE",
- "fixedValue": {
- "amount": 24.45,
- "currency": "USD"
- "rateElementBasis": "NET_CHARGE_EXCLUDING_TAXES"
- "packageSpecialServices": {
- "specialServiceTypes": [
- "ALCOHOL",
- "NON_STANDARD_CONTAINER",
- "DANGEROUS_GOODS",
- "SIGNATURE_OPTION",
- "PRIORITY_ALERT"
- "signatureOptionType": "ADULT",
- "priorityAlertDetail": {
- "enhancementTypes": [
- "PRIORITY_ALERT_PLUS"
- "content": [
- "string"
- "signatureOptionDetail": {
- "signatureReleaseNumber": "23456"
- "alcoholDetail": {
- "alcoholRecipientType": "LICENSEE",
- "shipperAgreementType": "Retailer"
- "dangerousGoodsDetail": {
- "cargoAircraftOnly": false,
- "regulation": "ADR",
- "accessibility": "INACCESSIBLE",
- "options": [
- "LIMITED_QUANTITIES_COMMODITIES",
- "ORM_D"
- "packageCODDetail": {
- "codCollectionAmount": {
- "amount": 12.45,
- "currency": "USD"
- "pieceCountVerificationBoxCount": 0,
- "batteryDetails": [
- {
- "batteryPackingType": "CONTAINED_IN_EQUIPMENT",
- "batteryRegulatoryType": "IATA_SECTION_II",
- "batteryMaterialType": "LITHIUM_METAL"
- "dryIceWeight": {
- "units": "KG",
- "value": 68
- "standaloneBatteryDetails": [
- {
- "batteryMaterialType": "LITHIUM_METAL"
- "labelResponseOptions": "URL_ONLY",
- "accountNumber": {
- "value": "Your account number"
- "shipAction": "CONFIRM",
- "processingOptionType": "ALLOW_ASYNCHRONOUS",
- "oneLabelAtATime": true
Response samples
- 200
- 400
- 401
- 403
- 404
- 500
- 503
- "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
- "customerTransactionId": "AnyCo_order123456789",
- "output": {
- "transactionShipments": [
- {
- "serviceType": "STANDARD_OVERNIGHT",
- "shipDatestamp": "2010-03-04",
- "serviceCategory": "EXPRESS",
- "shipmentDocuments": [
- {
- "contentKey": "content key",
- "copiesToPrint": 10,
- "contentType": "COMMERCIAL_INVOICE",
- "trackingNumber": "794953535000",
- "docType": "PDF",
- "alerts": [
- {
- "code": "SHIPMENT.VALIDATION.SUCCESS",
- "alertType": "NOTE",
- "message": "Shipment validated successfully. No errors found."
- "encodedLabel": "encoded label",
- "pieceResponses": [
- {
- "netChargeAmount": 21.45,
- "packageDocuments": [
- {
- "contentKey": "content key",
- "copiesToPrint": 10,
- "contentType": "COMMERCIAL_INVOICE",
- "trackingNumber": "794953535000",
- "docType": "PDF",
- "alerts": [
- {
- "code": "SHIPMENT.VALIDATION.SUCCESS",
- "alertType": "NOTE",
- "message": "Shipment validated successfully. No errors found."
- "encodedLabel": "encoded label",
- "acceptanceTrackingNumber": "794953535000",
- "serviceCategory": "EXPRESS",
- "listCustomerTotalCharge": "listCustomerTotalCharge",
- "deliveryTimestamp": "2012-09-23",
- "trackingIdType": "FEDEX",
- "additionalChargesDiscount": 621.45,
- "listRateAmount": 1.45,
- "baseRateAmount": 321.45,
- "packageSequenceNumber": 215,
- "netDiscountAmount": 121.45,
- "codCollectionAmount": 231.45,
- "masterTrackingNumber": "794953535000",
- "acceptanceType": "acceptanceType",
- "trackingNumber": "794953535000",
- "customerReferences": [
- {
- "customerReferenceType": "DEPARTMENT_NUMBER",
- "value": "3686"
- "serviceName": "FedEx 2 Day Freight",
- "alerts": [
- {
- "code": "RECIPIENTCONTACT.PHONENUMBER.INVALID",
- "message": "Recipient’s phone number format is not matching with recipient's country code; hence, recipient will not receive Convenient Delivery Options. Moving forward, please provide valid mobile phone number."
- "completedShipmentDetail": {
- "completedPackageDetails": [
- {
- "sequenceNumber": 256,
- "operationalDetail": {
- "astraHandlingText": "astraHandlingText",
- "barcodes": {
- "binaryBarcodes": [
- {
- "type": "COMMON-2D",
- "value": "string"
- "stringBarcodes": [
- {
- "type": "ADDRESS",
- "value": "1010062512241535917900794953544894"
- "operationalInstructions": [
- {
- "number": 17,
- "content": "content"
- "signatureOption": "DIRECT",
- "trackingIds": [
- {
- "formId": "0201",
- "trackingIdType": "EXPRESS",
- "uspsApplicationId": "92",
- "trackingNumber": "49092000070120032835"
- "groupNumber": 567,
- "oversizeClass": "OVERSIZE_1, OVERSIZE_2, OVERSIZE_3",
- "packageRating": {
- "effectiveNetDiscount": 0,
- "actualRateType": "PAYOR_ACCOUNT_PACKAGE",
- "packageRateDetails": [
- {
- "ratedWeightMethod": "DIM",
- "totalFreightDiscounts": 44.55,
- "totalTaxes": 3.45,
- "minimumChargeType": "CUSTOMER",
- "baseCharge": 45.67,
- "totalRebates": 4.56,
- "rateType": "PAYOR_RETAIL_PACKAGE",
- "billingWeight": {
- "units": "KG",
- "value": 68
- "netFreight": 4.89,
- "surcharges": [
- {
- "amount": "56.22",
- "surchargeType": "APPOINTMENT_DELIVERY",
- "level": "PACKAGE, or SHIPMENT",
- "description": "description"
- "totalSurcharges": 22.56,
- "netFedExCharge": 12.56,
- "netCharge": 121.56,
- "currency": "USD"
- "dryIceWeight": {
- "units": "KG",
- "value": 68
- "hazardousPackageDetail": {
- "regulation": "IATA",
- "accessibility": "ACCESSIBLE",
- "labelType": "II_YELLOW",
- "containers": [
- {
- "QValue": 2,
- "hazardousCommodities": [
- {
- "quantity": {
- "quantityType": "GROSS",
- "amount": 24.56,
- "units": "Kg"
- "options": {
- "labelTextOption": "STANDARD",
- "customerSuppliedLabelText": "Customer Supplied Label Text"
- "description": {
- "sequenceNumber": 876,
- "packingInstructions": "packingInstructions",
- "subsidiaryClasses": [
- "Subsidiary Classes"
- "labelText": "labelText",
- "tunnelRestrictionCode": "UN2919",
- "specialProvisions": "specialProvisions",
- "properShippingNameAndDescription": "properShippingNameAndDescription",
- "technicalName": "technicalName",
- "symbols": "symbols",
- "authorization": "authorization",
- "attributes": [
- "attributes"
- "id": "1234",
- "packingGroup": "packingGroup",
- "properShippingName": "properShippingName",
- "hazardClass": "hazardClass"
- "netExplosiveDetail": {
- "amount": 10,
- "units": "units",
- "type": "NET_EXPLOSIVE_WEIGHT"
- "massPoints": 2
- "cargoAircraftOnly": true,
- "referenceId": "123456",
- "radioactiveTransportIndex": 2.45
- "operationalDetail": {
- "originServiceArea": "A1",
- "serviceCode": "010",
- "airportId": "DFW",
- "postalCode": "38010",
- "scac": "scac",
- "deliveryDay": "TUE",
- "originLocationId": "678",
- "countryCode": "US",
- "astraDescription": "SMART POST",
- "originLocationNumber": 243,
- "deliveryDate": "2001-04-05",
- "deliveryEligibilities": [
- "deliveryEligibilities"
- "ineligibleForMoneyBackGuarantee": true,
- "maximumTransitTime": "SEVEN_DAYS",
- "destinationLocationStateOrProvinceCode": "GA",
- "astraPlannedServiceLevel": "TUE - 15 OCT 10:30A",
- "destinationLocationId": "DALA",
- "transitTime": "TWO_DAYS",
- "stateOrProvinceCode": "GA",
- "destinationLocationNumber": 876,
- "packagingCode": "03",
- "commitDate": "2019-10-15",
- "publishedDeliveryTime": "10:30A",
- "ursaSuffixCode": "Ga",
- "ursaPrefixCode": "XH",
- "destinationServiceArea": "A1",
- "commitDay": "TUE",
- "customTransitTime": "ONE_DAY"
- "carrierCode": "FDXE",
- "completedHoldAtLocationDetail": {
- "holdingLocationType": "FEDEX_STAFFED",
- "holdingLocation": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "38127",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John",
- "emailAddress": "string",
- "phoneNumber": "string",
- "phoneExtension": "string",
- "companyName": "string"
- "completedEtdDetail": {
- "folderId": "0b0493e580dc1a1b",
- "type": "COMMERCIAL_INVOICE",
- "uploadDocumentReferenceDetails": [
- {
- "documentType": "PRO_FORMA_INVOICE",
- "documentReference": "DocumentReference",
- "description": "PRO FORMA INVOICE",
- "documentId": "090927d680038c61"
- "packagingDescription": "Customer Packaging",
- "masterTrackingId": {
- "formId": "0201",
- "trackingIdType": "EXPRESS",
- "uspsApplicationId": "92",
- "trackingNumber": "49092000070120032835"
- "serviceDescription": {
- "serviceType": "FEDEX_1_DAY_FREIGHT",
- "code": "80",
- "names": [
- {
- "type": "long",
- "encoding": "UTF-8",
- "value": "F-2"
- "operatingOrgCodes": [
- "FXE"
- "astraDescription": "2 DAY FRT",
- "description": "description",
- "serviceId": "EP1000000027",
- "serviceCategory": "freight"
- "usDomestic": true,
- "hazardousShipmentDetail": {
- "hazardousSummaryDetail": {
- "smallQuantityExceptionPackageCount": 10
- "adrLicense": {
- "licenseOrPermitDetail": {
- "number": "12345",
- "effectiveDate": "2019-08-09",
- "expirationDate": "2019-04-09"
- "dryIceDetail": {
- "totalWeight": {
- "units": "KG",
- "value": 68
- "packageCount": 10,
- "processingOptions": {
- "options": [
- "options"
- "shipmentRating": {
- "actualRateType": "PAYOR_LIST_SHIPMENT",
- "shipmentRateDetails": [
- {
- "rateZone": "US001O",
- "ratedWeightMethod": "ACTUAL",
- "totalDutiesTaxesAndFees": 24.56,
- "pricingCode": "LTL_FREIGHT",
- "totalFreightDiscounts": 1.56,
- "totalTaxes": 3.45,
- "totalDutiesAndTaxes": 6.78,
- "totalAncillaryFeesAndTaxes": 5.67,
- "taxes": [
- {
- "amount": 10,
- "level": "level",
- "description": "description",
- "type": "type"
- "totalRebates": 1.98,
- "fuelSurchargePercent": 4.56,
- "currencyExchangeRate": {
- "rate": 25.6,
- "fromCurrency": "Rupee",
- "intoCurrency": "USD"
- "totalNetFreight": 9.56,
- "totalNetFedExCharge": 88.56,
- "shipmentLegRateDetails": [
- {
- "rateZone": "rateZone",
- "pricingCode": "pricingCode",
- "taxes": [
- {
- "amount": 10,
- "level": "level",
- "description": "description",
- "type": "type"
- "totalDimWeight": {
- "units": "KG",
- "value": 68
- "totalRebates": 2,
- "fuelSurchargePercent": 6,
- "currencyExchangeRate": {
- "rate": 25.6,
- "fromCurrency": "Rupee",
- "intoCurrency": "USD"
- "dimDivisor": 6,
- "rateType": "PAYOR_RETAIL_PACKAGE",
- "legDestinationLocationId": "legDestinationLocationId",
- "dimDivisorType": "dimDivisorType",
- "totalBaseCharge": 6,
- "ratedWeightMethod": "ratedWeightMethod",
- "totalFreightDiscounts": 9,
- "totalTaxes": 12.6,
- "minimumChargeType": "minimumChargeType",
- "totalDutiesAndTaxes": 17.78,
- "totalNetFreight": 6,
- "totalNetFedExCharge": 3.2,
- "surcharges": [
- {
- "amount": "56.22",
- "surchargeType": "APPOINTMENT_DELIVERY",
- "level": "PACKAGE, or SHIPMENT",
- "description": "description"
- "totalSurcharges": 5,
- "totalBillingWeight": {
- "units": "KG",
- "value": 68
- "freightDiscounts": [
- {
- "amount": 8.9,
- "rateDiscountType": "COUPON",
- "percent": 28.9,
- "description": "description"
- "rateScale": "6702",
- "totalNetCharge": 253,
- "totalNetChargeWithDutiesAndTaxes": 25.67,
- "currency": "USD"
- "dimDivisor": 0,
- "rateType": "RATED_ACCOUNT_SHIPMENT",
- "surcharges": [
- {
- "amount": "56.22",
- "surchargeType": "APPOINTMENT_DELIVERY",
- "level": "PACKAGE, or SHIPMENT",
- "description": "description"
- "totalSurcharges": 9.88,
- "totalBillingWeight": {
- "units": "KG",
- "value": 68
- "freightDiscounts": [
- {
- "amount": 8.9,
- "rateDiscountType": "COUPON",
- "percent": 28.9,
- "description": "description"
- "rateScale": "00000",
- "totalNetCharge": 3.78,
- "totalBaseCharge": 234.56,
- "totalNetChargeWithDutiesAndTaxes": 222.56,
- "currency": "USD"
- "documentRequirements": {
- "requiredDocuments": [
- "COMMERCIAL_OR_PRO_FORMA_INVOICE",
- "AIR_WAYBILL"
- "prohibitedDocuments": [
- "CERTIFICATE_OF_ORIGIN"
- "generationDetails": [
- {
- "type": "COMMERCIAL_INVOICE",
- "minimumCopiesRequired": 3,
- "letterhead": "OPTIONAL",
- "electronicSignature": "OPTIONAL"
- "exportComplianceStatement": "12345678901234567",
- "accessDetail": {
- "accessorDetails": [
- {
- "password": "password",
- "role": "role",
- "emailLabelUrl": "emailLabelUrl",
- "userId": "userId"
- "shipmentAdvisoryDetails": {
- "regulatoryAdvisory": {
- "prohibitions": [
- {
- "derivedHarmonizedCode": "01",
- "advisory": {
- "code": "code",
- "text": "Text",
- "parameters": [
- {
- "id": "message ID",
- "value": "Message value"
- "localizedText": "localizedText"
- "commodityIndex": 12,
- "source": "source",
- "categories": [
- "categories"
- "type": "type",
- "waiver": {
- "advisories": [
- {
- "code": "code",
- "text": "Text",
- "parameters": [
- {
- "id": "message ID",
- "value": "Message value"
- "localizedText": "localizedText"
- "description": "description",
- "id": "id"
- "status": "status"
- "masterTrackingNumber": "794953535000"
- "alerts": [
- {
- "code": "SHIPMENT.VALIDATION.SUCCESS",
- "alertType": "NOTE",
- "message": "Shipment validated successfully. No errors found."
- "jobId": "abc123456"
Cancel Shipment
Use this endpoint to cancel FedEx Express and Ground shipments that have not already been tendered to FedEx. This request will cancel all packages within the shipment.
Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS) mechanism.
header Parameters
x-customer-transaction-id | string Example: 624deea6-b709-470c-8c39-4b5511281492 This element allows you to assign a unique identifier to your transaction. This element is also returned in the reply and helps you match the request to the reply. |
content-type required | string Example: application/json This is used to indicate the media type of the resource. The media type is a string sent along with the file indicating format of the file. |
x-locale | string Example: en_US This indicates the combination of language code and country code. Click here to see Locales |
authorization required | string Example: Bearer XXX This indicates the authorization token for the input request. |
Request Body schema: application/json
- Full_Schema_Cancel_Shipment
- Cancel_Shipment
accountNumber required | object The account number (account value) associated with the shipment. |
emailShipment | boolean A boolean flag passed by Clients to indicate that whether a shipment is a EMAIL shipment(Pending Shipment) or not. Once a shipment is confirmed, it can no longer be cancelled by having this flag as True. |
senderCountryCode | string The two-letter sender Country code(Ex: US, CA, GB..etc). |
deletionControl | string Value: "DELETE_ALL_PACKAGES" Specifies which packages in a shipment to be canceledDELETE_ALL_PACKAGES which will cancel all tracking numbers associated to the shipment. |
trackingNumber required | string This is an unique number assigned by FedEx to the packages for tracking. |
Responses
Success
Bad Request
Unauthorized
Forbidden
Not Found
Failure
Service Unavailable
Sandbox Server
Production Server
Request samples
- Payload
- C#
- JAVA
- JAVASCRIPT
- PHP
- PYTHON
- RUST
- SWIFT
- "accountNumber": {
- "value": "Your account number"
- "emailShipment": "false",
- "senderCountryCode": "US",
- "deletionControl": "DELETE_ALL_PACKAGES",
- "trackingNumber": "794953555571"
Response samples
- 200
- 400
- 401
- 403
- 404
- 500
- 503
- "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
- "customerTransactionId": "AnyCo_order123456789",
- "output": {
- "cancelledShipment": true,
- "cancelledHistory": true,
- "successMessage": "Success",
- "alerts": [
- {
- "code": "SHIPMENT.VALIDATION.SUCCESS",
- "alertType": "NOTE",
- "message": "Shipment validated successfully. No errors found."
Retrieve Async Ship
This endpoint helps you to process confirmed shipments asynchronously (above 40 packages) and produce results based on job id.
Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS) mechanism.
header Parameters
x-customer-transaction-id | string Example: 0e671149-016f-1000-941f-ef4dbabadd2e This transaction Id helps the customers to track the transaction with APIF. |
content-type required | string Example: application/json This is used to indicate the media type of the resource. The media type is a string sent along with the file indicating format of the file. |
x-locale | string Example: en_US This indicates the combination of language code and country code. Click here to see Locales |
authorization required | string Example: Bearer XXX This indicates the authorization token for the input request. |
Request Body schema: application/json
- FullSchema-getConfirmedShipmentAsyncResults
- MinimumSamplePayload-getConfirmedShipmentAsyncResults
accountNumber required | object (PartyAccountNumber) This is FedEx Account number details. |
jobId required | string Indicates the job under which the deferred shipment artifacts must be identified in the subsequent retrieval request. |
Responses
Success
Bad Request
Unauthorized
Forbidden
Not Found
Failure
Service Unavailable
Sandbox Server
Production Server
Request samples
- Payload
- C#
- JAVA
- JAVASCRIPT
- PHP
- PYTHON
- RUST
- SWIFT
- "accountNumber": {
- "value": "Your account number"
- "jobId": "89sxxxxx233ae24ff31xxxxx"
Response samples
- 200
- 400
- 401
- 403
- 404
- 500
- 503
- "transactionId": "624xxxxx-b709-470c-8c39-4b55112xxxxx",
- "customerTransactionId": "AnyCo_order123456789",
- "output": {
- "transactionShipments": [
- {
- "serviceType": "STANDARD_OVERNIGHT",
- "shipDatestamp": "2010-03-04",
- "serviceCategory": "EXPRESS",
- "shipmentDocuments": [
- {
- "contentKey": "content key",
- "copiesToPrint": 10,
- "contentType": "COMMERCIAL_INVOICE",
- "trackingNumber": "794953535000",
- "docType": "PDF",
- "alerts": [
- {
- "code": "SHIPMENT.VALIDATION.SUCCESS",
- "alertType": "NOTE",
- "message": "Shipment validated successfully. No errors found."
- "encodedLabel": "encoded label",
- "pieceResponses": [
- {
- "netChargeAmount": 21.45,
- "packageDocuments": [
- {
- "contentKey": "content key",
- "copiesToPrint": 10,
- "contentType": "COMMERCIAL_INVOICE",
- "trackingNumber": "794953535000",
- "docType": "PDF",
- "alerts": [
- {
- "code": "SHIPMENT.VALIDATION.SUCCESS",
- "alertType": "NOTE",
- "message": "Shipment validated successfully. No errors found."
- "encodedLabel": "encoded label",
- "acceptanceTrackingNumber": "794953535000",
- "serviceCategory": "EXPRESS",
- "listCustomerTotalCharge": "listCustomerTotalCharge",
- "deliveryTimestamp": "2012-09-23",
- "trackingIdType": "FEDEX",
- "additionalChargesDiscount": 621.45,
- "listRateAmount": 1.45,
- "baseRateAmount": 321.45,
- "packageSequenceNumber": 215,
- "netDiscountAmount": 121.45,
- "codCollectionAmount": 231.45,
- "masterTrackingNumber": "794953535000",
- "acceptanceType": "acceptanceType",
- "trackingNumber": "794953535000",
- "customerReferences": [
- {
- "customerReferenceType": "DEPARTMENT_NUMBER",
- "value": "3686"
- "serviceName": "FedEx 2 Day Freight",
- "alerts": [
- {
- "code": "RECIPIENTCONTACT.PHONENUMBER.INVALID",
- "message": "Recipient’s phone number format is not matching with recipient's country code; hence, recipient will not receive Convenient Delivery Options. Moving forward, please provide valid mobile phone number."
- "completedShipmentDetail": {
- "completedPackageDetails": [
- {
- "sequenceNumber": 256,
- "operationalDetail": {
- "astraHandlingText": "astraHandlingText",
- "barcodes": {
- "binaryBarcodes": [
- {
- "type": "COMMON-2D",
- "value": "string"
- "stringBarcodes": [
- {
- "type": "ADDRESS",
- "value": "1010062512241535917900794953544894"
- "operationalInstructions": [
- {
- "number": 17,
- "content": "content"
- "signatureOption": "DIRECT",
- "trackingIds": [
- {
- "formId": "0201",
- "trackingIdType": "EXPRESS",
- "uspsApplicationId": "92",
- "trackingNumber": "49092000070120032835"
- "groupNumber": 567,
- "oversizeClass": "OVERSIZE_1, OVERSIZE_2, OVERSIZE_3",
- "packageRating": {
- "effectiveNetDiscount": 0,
- "actualRateType": "PAYOR_ACCOUNT_PACKAGE",
- "packageRateDetails": [
- {
- "ratedWeightMethod": "DIM",
- "totalFreightDiscounts": 44.55,
- "totalTaxes": 3.45,
- "minimumChargeType": "CUSTOMER",
- "baseCharge": 45.67,
- "totalRebates": 4.56,
- "rateType": "PAYOR_RETAIL_PACKAGE",
- "billingWeight": {
- "units": "KG",
- "value": 68
- "netFreight": 4.89,
- "surcharges": [
- {
- "amount": "56.22",
- "surchargeType": "APPOINTMENT_DELIVERY",
- "level": "PACKAGE, or SHIPMENT",
- "description": "description"
- "totalSurcharges": 22.56,
- "netFedExCharge": 12.56,
- "netCharge": 121.56,
- "currency": "USD"
- "dryIceWeight": {
- "units": "KG",
- "value": 68
- "hazardousPackageDetail": {
- "regulation": "IATA",
- "accessibility": "ACCESSIBLE",
- "labelType": "II_YELLOW",
- "containers": [
- {
- "QValue": 2,
- "hazardousCommodities": [
- {
- "quantity": {
- "quantityType": "GROSS",
- "amount": 24.56,
- "units": "Kg"
- "options": {
- "labelTextOption": "STANDARD",
- "customerSuppliedLabelText": "Customer Supplied Label Text"
- "description": {
- "sequenceNumber": 876,
- "packingInstructions": "packingInstructions",
- "subsidiaryClasses": [
- "Subsidiary Classes"
- "labelText": "labelText",
- "tunnelRestrictionCode": "UN2919",
- "specialProvisions": "specialProvisions",
- "properShippingNameAndDescription": "properShippingNameAndDescription",
- "technicalName": "technicalName",
- "symbols": "symbols",
- "authorization": "authorization",
- "attributes": [
- "attributes"
- "id": "1234",
- "packingGroup": "packingGroup",
- "properShippingName": "properShippingName",
- "hazardClass": "hazardClass"
- "netExplosiveDetail": {
- "amount": 10,
- "units": "units",
- "type": "NET_EXPLOSIVE_WEIGHT"
- "massPoints": 2
- "cargoAircraftOnly": true,
- "referenceId": "123456",
- "radioactiveTransportIndex": 2.45
- "operationalDetail": {
- "originServiceArea": "A1",
- "serviceCode": "010",
- "airportId": "DFW",
- "postalCode": "38010",
- "scac": "scac",
- "deliveryDay": "TUE",
- "originLocationId": "678",
- "countryCode": "US",
- "astraDescription": "SMART POST",
- "originLocationNumber": 243,
- "deliveryDate": "2001-04-05",
- "deliveryEligibilities": [
- "deliveryEligibilities"
- "ineligibleForMoneyBackGuarantee": true,
- "maximumTransitTime": "SEVEN_DAYS",
- "destinationLocationStateOrProvinceCode": "GA",
- "astraPlannedServiceLevel": "TUE - 15 OCT 10:30A",
- "destinationLocationId": "DALA",
- "transitTime": "TWO_DAYS",
- "stateOrProvinceCode": "GA",
- "destinationLocationNumber": 876,
- "packagingCode": "03",
- "commitDate": "2019-10-15",
- "publishedDeliveryTime": "10:30A",
- "ursaSuffixCode": "Ga",
- "ursaPrefixCode": "XH",
- "destinationServiceArea": "A1",
- "commitDay": "TUE",
- "customTransitTime": "ONE_DAY"
- "carrierCode": "FDXE",
- "completedHoldAtLocationDetail": {
- "holdingLocationType": "FEDEX_STAFFED",
- "holdingLocation": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "38127",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John",
- "emailAddress": "string",
- "phoneNumber": "string",
- "phoneExtension": "string",
- "companyName": "string"
- "completedEtdDetail": {
- "folderId": "0b0493e580dc1a1b",
- "type": "COMMERCIAL_INVOICE",
- "uploadDocumentReferenceDetails": [
- {
- "documentType": "PRO_FORMA_INVOICE",
- "documentReference": "DocumentReference",
- "description": "PRO FORMA INVOICE",
- "documentId": "090927d680038c61"
- "packagingDescription": "Customer Packaging",
- "masterTrackingId": {
- "formId": "0201",
- "trackingIdType": "EXPRESS",
- "uspsApplicationId": "92",
- "trackingNumber": "49092000070120032835"
- "serviceDescription": {
- "serviceType": "FEDEX_1_DAY_FREIGHT",
- "code": "80",
- "names": [
- {
- "type": "long",
- "encoding": "UTF-8",
- "value": "F-2"
- "operatingOrgCodes": [
- "FXE"
- "astraDescription": "2 DAY FRT",
- "description": "description",
- "serviceId": "EP1000000027",
- "serviceCategory": "freight"
- "usDomestic": true,
- "hazardousShipmentDetail": {
- "hazardousSummaryDetail": {
- "smallQuantityExceptionPackageCount": 10
- "adrLicense": {
- "licenseOrPermitDetail": {
- "number": "12345",
- "effectiveDate": "2019-08-09",
- "expirationDate": "2019-04-09"
- "dryIceDetail": {
- "totalWeight": {
- "units": "KG",
- "value": 68
- "packageCount": 10,
- "processingOptions": {
- "options": [
- "options"
- "shipmentRating": {
- "actualRateType": "PAYOR_LIST_SHIPMENT",
- "shipmentRateDetails": [
- {
- "rateZone": "US001O",
- "ratedWeightMethod": "ACTUAL",
- "totalDutiesTaxesAndFees": 24.56,
- "pricingCode": "LTL_FREIGHT",
- "totalFreightDiscounts": 1.56,
- "totalTaxes": 3.45,
- "totalDutiesAndTaxes": 6.78,
- "totalAncillaryFeesAndTaxes": 5.67,
- "taxes": [
- {
- "amount": 10,
- "level": "level",
- "description": "description",
- "type": "type"
- "totalRebates": 1.98,
- "fuelSurchargePercent": 4.56,
- "currencyExchangeRate": {
- "rate": 25.6,
- "fromCurrency": "Rupee",
- "intoCurrency": "USD"
- "totalNetFreight": 9.56,
- "totalNetFedExCharge": 88.56,
- "shipmentLegRateDetails": [
- {
- "rateZone": "rateZone",
- "pricingCode": "pricingCode",
- "taxes": [
- {
- "amount": 10,
- "level": "level",
- "description": "description",
- "type": "type"
- "totalDimWeight": {
- "units": "KG",
- "value": 68
- "totalRebates": 2,
- "fuelSurchargePercent": 6,
- "currencyExchangeRate": {
- "rate": 25.6,
- "fromCurrency": "Rupee",
- "intoCurrency": "USD"
- "dimDivisor": 6,
- "rateType": "PAYOR_RETAIL_PACKAGE",
- "legDestinationLocationId": "legDestinationLocationId",
- "dimDivisorType": "dimDivisorType",
- "totalBaseCharge": 6,
- "ratedWeightMethod": "ratedWeightMethod",
- "totalFreightDiscounts": 9,
- "totalTaxes": 12.6,
- "minimumChargeType": "minimumChargeType",
- "totalDutiesAndTaxes": 17.78,
- "totalNetFreight": 6,
- "totalNetFedExCharge": 3.2,
- "surcharges": [
- {
- "amount": "56.22",
- "surchargeType": "APPOINTMENT_DELIVERY",
- "level": "PACKAGE, or SHIPMENT",
- "description": "description"
- "totalSurcharges": 5,
- "totalBillingWeight": {
- "units": "KG",
- "value": 68
- "freightDiscounts": [
- {
- "amount": 8.9,
- "rateDiscountType": "COUPON",
- "percent": 28.9,
- "description": "description"
- "rateScale": "6702",
- "totalNetCharge": 253,
- "totalNetChargeWithDutiesAndTaxes": 25.67,
- "currency": "USD"
- "dimDivisor": 0,
- "rateType": "RATED_ACCOUNT_SHIPMENT",
- "surcharges": [
- {
- "amount": "56.22",
- "surchargeType": "APPOINTMENT_DELIVERY",
- "level": "PACKAGE, or SHIPMENT",
- "description": "description"
- "totalSurcharges": 9.88,
- "totalBillingWeight": {
- "units": "KG",
- "value": 68
- "freightDiscounts": [
- {
- "amount": 8.9,
- "rateDiscountType": "COUPON",
- "percent": 28.9,
- "description": "description"
- "rateScale": "00000",
- "totalNetCharge": 3.78,
- "totalBaseCharge": 234.56,
- "totalNetChargeWithDutiesAndTaxes": 222.56,
- "currency": "USD"
- "documentRequirements": {
- "requiredDocuments": [
- "COMMERCIAL_OR_PRO_FORMA_INVOICE",
- "AIR_WAYBILL"
- "prohibitedDocuments": [
- "CERTIFICATE_OF_ORIGIN"
- "generationDetails": [
- {
- "type": "COMMERCIAL_INVOICE",
- "minimumCopiesRequired": 3,
- "letterhead": "OPTIONAL",
- "electronicSignature": "OPTIONAL"
- "exportComplianceStatement": "12345678901234567",
- "accessDetail": {
- "accessorDetails": [
- {
- "password": "password",
- "role": "role",
- "emailLabelUrl": "emailLabelUrl",
- "userId": "userId"
- "shipmentAdvisoryDetails": {
- "regulatoryAdvisory": {
- "prohibitions": [
- {
- "derivedHarmonizedCode": "01",
- "advisory": {
- "code": "code",
- "text": "Text",
- "parameters": [
- {
- "id": "message ID",
- "value": "Message value"
- "localizedText": "localizedText"
- "commodityIndex": 12,
- "source": "source",
- "categories": [
- "categories"
- "type": "type",
- "waiver": {
- "advisories": [
- {
- "code": "code",
- "text": "Text",
- "parameters": [
- {
- "id": "message ID",
- "value": "Message value"
- "localizedText": "localizedText"
- "description": "description",
- "id": "id"
- "status": "status"
- "masterTrackingNumber": "794953535000"
- "alerts": [
- {
- "code": "SHIPMENT.VALIDATION.SUCCESS",
- "alertType": "NOTE",
- "message": "Shipment validated successfully. No errors found."
Validate Shipment
Use this endpoint to verify the accuracy of a shipment request prior to actually submitting shipment request. This allow businesses that receive shipping orders from end-user/customers to verify the shipment information prior to submitting a create shipment request to FedEx and printing a label. If for any reason the information needs to be edited or changed, it can be done while the end-user is still available to confirm the changes.
Note:
- This is shipment level validation hence supports validation for single piece shipment only.
- Shipment validation is supported for all Express and Ground - Domestic as well as international shipments with all applicable special services.
- Shipment validation is supported for SmartPost and not for Freight LTL shipments.
Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS) mechanism.
header Parameters
x-customer-transaction-id | string Example: 624deea6-b709-470c-8c39-4b5511281492 This element allows you to assign a unique identifier to your transaction. This element is also returned in the reply and helps you match the request to the reply. |
content-type required | string Example: application/json This is used to indicate the media type of the resource. The media type is a string sent along with the file indicating format of the file. |
x-locale | string Example: en_US This indicates the combination of language code and country code. Click here to see Locales |
authorization required | string Example: Bearer XXX This indicates the authorization token for the input request. |
Request Body schema: application/json
- FullSchema-VerifyShipment
- Minimum-Sample-Domestic
- Minimum-Sample-International
requestedShipment required | object (RequestedShipmentVerify) This is the detailed shipment request data to be validated before being submitted to FedEx. |
accountNumber | object (ShipperAccountNumber) The account number associated with the shipment. |
Responses
Success
Bad Request
Unauthorized
Forbidden
Not Found
Failure
Sandbox Server
Production Server
Request samples
- Payload
- C#
- JAVA
- JAVASCRIPT
- PHP
- PYTHON
- RUST
- SWIFT
- "requestedShipment": {
- "shipDatestamp": "2019-10-14",
- "pickupType": "USE_SCHEDULED_PICKUP",
- "serviceType": "PRIORITY_OVERNIGHT",
- "packagingType": "YOUR_PACKAGING",
- "totalWeight": 20,
- "shipper": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneExtension": "91",
- "phoneNumber": "1234567890",
- "companyName": "Fedex"
- "tins": [
- {
- "number": "123567",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2000-01-23T04:56:07.000+00:00",
- "expirationDate": "2000-01-23T04:56:07.000+00:00"
- "recipients": [
- {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneExtension": "000",
- "phoneNumber": "XXXX345671",
- "companyName": "FedEx"
- "tins": [
- {
- "number": "123567",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2000-01-23T04:56:07.000+00:00",
- "expirationDate": "2000-01-23T04:56:07.000+00:00"
- "deliveryInstructions": "Delivery Instructions"
- "origin": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "38127",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "person name",
- "emailAddress": "email address",
- "phoneNumber": "phone number",
- "phoneExtension": "phone extension",
- "companyName": "company name",
- "faxNumber": "fax number"
- "shippingChargesPayment": {
- "paymentType": "SENDER",
- "payor": {
- "responsibleParty": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneNumber": "XXXX567890",
- "phoneExtension": "phone extension",
- "companyName": "Fedex",
- "faxNumber": "fax number"
- "accountNumber": {
- "value": "Your account number"
- "shipmentSpecialServices": {
- "specialServiceTypes": [
- "THIRD_PARTY_CONSIGNEE"
- "etdDetail": {
- "attributes": [
- "POST_SHIPMENT_UPLOAD_REQUESTED"
- "attachedDocuments": [
- {
- "documentType": "PRO_FORMA_INVOICE",
- "documentReference": "DocumentReference",
- "description": "PRO FORMA INVOICE",
- "documentId": "090927d680038c61"
- "requestedDocumentTypes": [
- "VICS_BILL_OF_LADING",
- "GENERAL_AGENCY_AGREEMENT"
- "returnShipmentDetail": {
- "returnEmailDetail": {
- "merchantPhoneNumber": "19012635656",
- "allowedSpecialService": [
- "SATURDAY_DELIVERY"
- "rma": {
- "reason": "Wrong Size or Color"
- "returnAssociationDetail": {
- "shipDatestamp": "2019-10-01",
- "trackingNumber": "123456789"
- "returnType": "PRINT_RETURN_LABEL"
- "deliveryOnInvoiceAcceptanceDetail": {
- "recipient": {
- "address": {
- "streetLines": [
- "23, RUE JOSEPH-DE MA",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneExtension": "000",
- "phoneNumber": "1234567890",
- "companyName": "Fedex"
- "tins": [
- {
- "number": "123567",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2000-01-23T04:56:07.000+00:00",
- "expirationDate": "2000-01-23T04:56:07.000+00:00"
- "deliveryInstructions": "Delivery Instructions"
- "internationalTrafficInArmsRegulationsDetail": {
- "licenseOrExemptionNumber": "9871234"
- "pendingShipmentDetail": {
- "pendingShipmentType": "EMAIL",
- "processingOptions": {
- "options": [
- "ALLOW_MODIFICATIONS"
- "recommendedDocumentSpecification": {
- "types": [
- "ANTIQUE_STATEMENT_EUROPEAN_UNION",
- "ANTIQUE_STATEMENT_UNITED_STATES"
- "emailLabelDetail": {
- "recipients": [
- {
- "emailAddress": "nnnnneena@fedex.com",
- "optionsRequested": {
- "options": [
- "PRODUCE_PAPERLESS_SHIPPING_FORMAT",
- "SUPPRESS_ACCESS_EMAILS"
- "role": "SHIPMENT_COMPLETOR",
- "locale": "en_US"
- "message": "your optional message"
- "attachedDocuments": [
- {
- "documentType": "PRO_FORMA_INVOICE",
- "documentReference": "DocumentReference",
- "description": "PRO FORMA INVOICE",
- "documentId": "090927d680038c61"
- "expirationTimeStamp": "2020-01-01"
- "holdAtLocationDetail": {
- "locationId": "YBZA",
- "locationContactAndAddress": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "38127",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "person name",
- "emailAddress": "email address",
- "phoneNumber": "phone number",
- "phoneExtension": "phone extension",
- "companyName": "company name",
- "faxNumber": "fax number"
- "locationType": "FEDEX_ONSITE"
- "shipmentCODDetail": {
- "addTransportationChargesDetail": {
- "rateType": "ACCOUNT",
- "rateLevelType": "BUNDLED_RATE",
- "chargeLevelType": "CURRENT_PACKAGE",
- "chargeType": "COD_SURCHARGE"
- "codRecipient": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneExtension": "000",
- "phoneNumber": "XXXX345671",
- "companyName": "Fedex"
- "accountNumber": {
- "value": "Your account number"
- "tins": [
- {
- "number": "123567",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2000-01-23T04:56:07.000+00:00",
- "expirationDate": "2000-01-23T04:56:07.000+00:00"
- "remitToName": "remitToName",
- "codCollectionType": "CASH",
- "financialInstitutionContactAndAddress": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "38127",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "person name",
- "emailAddress": "email address",
- "phoneNumber": "phone number",
- "phoneExtension": "phone extension",
- "companyName": "company name",
- "faxNumber": "fax number"
- "codCollectionAmount": {
- "amount": 12.45,
- "currency": "USD"
- "returnReferenceIndicatorType": "INVOICE",
- "shipmentCodAmount": {
- "amount": 12.45,
- "currency": "USD"
- "shipmentDryIceDetail": {
- "totalWeight": {
- "units": "LB",
- "value": 10
- "packageCount": 12
- "internationalControlledExportDetail": {
- "licenseOrPermitExpirationDate": "2019-12-03",
- "licenseOrPermitNumber": "11",
- "entryNumber": "125",
- "foreignTradeZoneCode": "US",
- "type": "WAREHOUSE_WITHDRAWAL"
- "homeDeliveryPremiumDetail": {
- "phoneNumber": {
- "areaCode": "901",
- "localNumber": "3575012",
- "extension": "200",
- "personalIdentificationNumber": "98712345"
- "deliveryDate": "2019-06-26",
- "homedeliveryPremiumType": "APPOINTMENT"
- "emailNotificationDetail": {
- "aggregationType": "PER_PACKAGE",
- "emailNotificationRecipients": [
- {
- "name": "Joe Smith",
- "emailNotificationRecipientType": "SHIPPER",
- "emailAddress": "jsmith3@aol.com",
- "notificationFormatType": "TEXT",
- "notificationType": "EMAIL",
- "locale": "en_US",
- "notificationEventType": [
- "ON_PICKUP_DRIVER_ARRIVED",
- "ON_SHIPMENT"
- "personalMessage": "your personal message here"
- "variableHandlingChargeDetail": {
- "rateType": "PREFERRED_CURRENCY",
- "percentValue": 12.45,
- "rateLevelType": "INDIVIDUAL_PACKAGE_RATE",
- "fixedValue": {
- "amount": 24.45,
- "currency": "USD"
- "rateElementBasis": "NET_CHARGE_EXCLUDING_TAXES"
- "customsClearanceDetail": {
- "regulatoryControls": [
- "NOT_IN_FREE_CIRCULATION",
- "USMCA"
- "brokers": [
- {
- "broker": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneNumber": "1234567890",
- "phoneExtension": 91,
- "companyName": "Fedex",
- "faxNumber": 1234567
- "accountNumber": {
- "value": "Your account number"
- "tins": [
- {
- "number": "number",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2000-01-23T04:56:07.000+00:00",
- "expirationDate": "2000-01-23T04:56:07.000+00:00"
- "deliveryInstructions": "deliveryInstructions"
- "type": "IMPORT"
- "commercialInvoice": {
- "originatorName": "originator Name",
- "comments": [
- "optional comments for the commercial invoice"
- "customerReferences": [
- {
- "customerReferenceType": "DEPARTMENT_NUMBER",
- "value": "3686"
- "taxesOrMiscellaneousCharge": {
- "amount": 12.45,
- "currency": "USD"
- "taxesOrMiscellaneousChargeType": "COMMISSIONS",
- "freightCharge": {
- "amount": 12.45,
- "currency": "USD"
- "packingCosts": {
- "amount": 12.45,
- "currency": "USD"
- "handlingCosts": {
- "amount": 12.45,
- "currency": "USD"
- "declarationStatement": "declarationStatement",
- "termsOfSale": "FCA",
- "specialInstructions": "specialInstructions\"",
- "shipmentPurpose": "REPAIR_AND_RETURN",
- "emailNotificationDetail": {
- "emailAddress": "neena@fedex.com",
- "type": "EMAILED",
- "recipientType": "SHIPPER"
- "freightOnValue": "OWN_RISK",
- "dutiesPayment": {
- "payor": {
- "responsibleParty": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "38127",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneNumber": "1234567890",
- "phoneExtension": "phone extension",
- "companyName": "Fedex",
- "faxNumber": "fax number"
- "accountNumber": {
- "value": "Your account number"
- "tins": [
- {
- "number": "number",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2024-06-13",
- "expirationDate": "2024-06-13"
- {
- "number": "number",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2024-06-13",
- "expirationDate": "2024-06-13"
- "billingDetails": {
- "billingCode": "billingCode",
- "billingType": "billingType",
- "aliasId": "aliasId",
- "accountNickname": "accountNickname",
- "accountNumber": "Your account number",
- "accountNumberCountryCode": "US"
- "paymentType": "SENDER"
- "commodities": [
- {
- "unitPrice": {
- "amount": 12.45,
- "currency": "USD"
- "additionalMeasures": [
- {
- "quantity": 12.45,
- "units": "KG"
- "numberOfPieces": 12,
- "quantity": 125,
- "quantityUnits": "Ea",
- "customsValue": {
- "amount": "1556.25",
- "currency": "USD"
- "countryOfManufacture": "US",
- "cIMarksAndNumbers": "87123",
- "harmonizedCode": "0613",
- "description": "description",
- "name": "non-threaded rivets",
- "weight": {
- "units": "KG",
- "value": 68
- "exportLicenseNumber": "26456",
- "exportLicenseExpirationDate": "2025-03-15T15:47:31Z",
- "partNumber": "167",
- "purpose": "BUSINESS",
- "usmcaDetail": {
- "originCriterion": "A"
- "isDocumentOnly": false,
- "recipientCustomsId": {
- "type": "PASSPORT",
- "value": "123"
- "customsOption": {
- "description": "Description",
- "type": "COURTESY_RETURN_LABEL"
- "importerOfRecord": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneExtension": "000",
- "phoneNumber": "XXXX345671",
- "companyName": "Fedex"
- "accountNumber": {
- "value": "Your account number"
- "tins": [
- {
- "number": "123567",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2000-01-23T04:56:07.000+00:00",
- "expirationDate": "2000-01-23T04:56:07.000+00:00"
- "generatedDocumentLocale": "en_US",
- "exportDetail": {
- "destinationControlDetail": {
- "endUser": "dest country user",
- "statementTypes": "DEPARTMENT_OF_COMMERCE",
- "destinationCountries": [
- "USA",
- "India"
- "b13AFilingOption": "NOT_REQUIRED",
- "exportComplianceStatement": "12345678901234567",
- "permitNumber": "12345"
- "totalCustomsValue": {
- "amount": 12.45,
- "currency": "USD"
- "partiesToTransactionAreRelated": true,
- "declarationStatementDetail": {
- "usmcaLowValueStatementDetail": {
- "countryOfOriginLowValueDocumentRequested": true,
- "customsRole": "EXPORTER"
- "insuranceCharge": {
- "amount": 12.45,
- "currency": "USD"
- "smartPostInfoDetail": {
- "ancillaryEndorsement": "RETURN_SERVICE",
- "hubId": "5015",
- "indicia": "PRESORTED_STANDARD",
- "specialServices": "USPS_DELIVERY_CONFIRMATION"
- "blockInsightVisibility": true,
- "labelSpecification": {
- "labelFormatType": "COMMON2D",
- "labelOrder": "SHIPPING_LABEL_FIRST",
- "customerSpecifiedDetail": {
- "maskedData": [
- "PACKAGE_SEQUENCE_AND_COUNT",
- "TOTAL_WEIGHT"
- "regulatoryLabels": [
- {
- "generationOptions": "CONTENT_ON_SHIPPING_LABEL_ONLY",
- "type": "ALCOHOL_SHIPMENT_LABEL"
- "additionalLabels": [
- {
- "type": "MANIFEST",
- "count": 1
- "docTabContent": {
- "docTabContentType": "BARCODED",
- "zone001": {
- "docTabZoneSpecifications": [
- {
- "zoneNumber": 0,
- "header": "string",
- "dataField": "string",
- "literalValue": "string",
- "justification": "RIGHT"
- "barcoded": {
- "symbology": "UCC128",
- "specification": {
- "zoneNumber": 0,
- "header": "string",
- "dataField": "string",
- "literalValue": "string",
- "justification": "RIGHT"
- "printedLabelOrigin": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "38127",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "person name",
- "emailAddress": "email address",
- "phoneNumber": "phone number",
- "phoneExtension": "phone extension",
- "companyName": "company name",
- "faxNumber": "fax number"
- "labelStockType": "PAPER_7X475",
- "labelRotation": "UPSIDE_DOWN",
- "imageType": "PDF",
- "labelPrintingOrientation": "TOP_EDGE_OF_TEXT_FIRST",
- "returnedDispositionDetail": "RETURNED",
- "resolution": 300
- "shippingDocumentSpecification": {
- "generalAgencyAgreementDetail": {
- "documentFormat": {
- "provideInstructions": true,
- "optionsRequested": {
- "options": [
- "SUPPRESS_ADDITIONAL_LANGUAGES",
- "SHIPPING_LABEL_LAST"
- "stockType": "PAPER_LETTER",
- "dispositions": [
- {
- "eMailDetail": {
- "eMailRecipients": [
- {
- "emailAddress": "email@fedex.com",
- "recipientType": "THIRD_PARTY"
- "locale": "en_US",
- "grouping": "NONE"
- "dispositionType": "CONFIRMED"
- "locale": "en_US",
- "docType": "PDF"
- "returnInstructionsDetail": {
- "customText": "This is additional text printed on Return instr",
- "documentFormat": {
- "provideInstructions": true,
- "optionsRequested": {
- "options": [
- "SUPPRESS_ADDITIONAL_LANGUAGES",
- "SHIPPING_LABEL_LAST"
- "stockType": "PAPER_LETTER",
- "dispositions": [
- {
- "eMailDetail": {
- "eMailRecipients": [
- {
- "emailAddress": "email@fedex.com",
- "recipientType": "THIRD_PARTY"
- "locale": "en_US",
- "grouping": "NONE"
- "dispositionType": "CONFIRMED"
- "locale": "en_US\"",
- "docType": "PNG"
- "op900Detail": {
- "customerImageUsages": [
- {
- "id": "IMAGE_5",
- "type": "SIGNATURE",
- "providedImageType": "SIGNATURE"
- "signatureName": "Signature Name",
- "documentFormat": {
- "provideInstructions": true,
- "optionsRequested": {
- "options": [
- "SUPPRESS_ADDITIONAL_LANGUAGES",
- "SHIPPING_LABEL_LAST"
- "stockType": "PAPER_LETTER",
- "dispositions": [
- {
- "eMailDetail": {
- "eMailRecipients": [
- {
- "emailAddress": "email@fedex.com",
- "recipientType": "THIRD_PARTY"
- "locale": "en_US",
- "grouping": "NONE"
- "dispositionType": "CONFIRMED"
- "locale": "en_US",
- "docType": "PDF"
- "usmcaCertificationOfOriginDetail": {
- "customerImageUsages": [
- {
- "id": "IMAGE_5",
- "type": "SIGNATURE",
- "providedImageType": "SIGNATURE"
- "documentFormat": {
- "provideInstructions": true,
- "optionsRequested": {
- "options": [
- "SUPPRESS_ADDITIONAL_LANGUAGES",
- "SHIPPING_LABEL_LAST"
- "stockType": "PAPER_LETTER",
- "dispositions": [
- {
- "eMailDetail": {
- "eMailRecipients": [
- {
- "emailAddress": "email@fedex.com",
- "recipientType": "THIRD_PARTY"
- "locale": "en_US",
- "grouping": "NONE"
- "dispositionType": "CONFIRMED"
- "locale": "en_US",
- "docType": "PDF"
- "certifierSpecification": "EXPORTER",
- "importerSpecification": "UNKNOWN",
- "producerSpecification": "SAME_AS_EXPORTER",
- "producer": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneExtension": "000",
- "phoneNumber": "XXXX345671",
- "companyName": "Fedex"
- "accountNumber": {
- "value": "Your account number"
- "tins": [
- {
- "number": "123567",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2000-01-23T04:56:07.000+00:00",
- "expirationDate": "2000-01-23T04:56:07.000+00:00"
- "blanketPeriod": {
- "begins": "22-01-2020",
- "ends": "2-01-2020"
- "certifierJobTitle": "Manager"
- "usmcaCommercialInvoiceCertificationOfOriginDetail": {
- "customerImageUsages": [
- {
- "id": "IMAGE_5",
- "type": "SIGNATURE",
- "providedImageType": "SIGNATURE"
- "documentFormat": {
- "provideInstructions": true,
- "optionsRequested": {
- "options": [
- "SUPPRESS_ADDITIONAL_LANGUAGES",
- "SHIPPING_LABEL_LAST"
- "stockType": "PAPER_LETTER",
- "dispositions": [
- {
- "eMailDetail": {
- "eMailRecipients": [
- {
- "emailAddress": "email@fedex.com",
- "recipientType": "THIRD_PARTY"
- "locale": "en_US",
- "grouping": "NONE"
- "dispositionType": "CONFIRMED"
- "locale": "en_US",
- "docType": "PDF"
- "certifierSpecification": "EXPORTER",
- "importerSpecification": "UNKNOWN",
- "producerSpecification": "SAME_AS_EXPORTER",
- "producer": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneExtension": "000",
- "phoneNumber": "XXXX345671",
- "companyName": "Fedex"
- "accountNumber": {
- "value": "Your account number"
- "tins": [
- {
- "number": "123567",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2000-01-23T04:56:07.000+00:00",
- "expirationDate": "2000-01-23T04:56:07.000+00:00"
- "certifierJobTitle": "Manager"
- "shippingDocumentTypes": [
- "RETURN_INSTRUCTIONS"
- "certificateOfOrigin": {
- "customerImageUsages": [
- {
- "id": "IMAGE_5",
- "type": "SIGNATURE",
- "providedImageType": "SIGNATURE"
- "documentFormat": {
- "provideInstructions": true,
- "optionsRequested": {
- "options": [
- "SUPPRESS_ADDITIONAL_LANGUAGES",
- "SHIPPING_LABEL_LAST"
- "stockType": "PAPER_LETTER",
- "dispositions": [
- {
- "eMailDetail": {
- "eMailRecipients": [
- {
- "emailAddress": "email@fedex.com",
- "recipientType": "THIRD_PARTY"
- "locale": "en_US",
- "grouping": "NONE"
- "dispositionType": "CONFIRMED"
- "locale": "en_US",
- "docType": "PDF"
- "commercialInvoiceDetail": {
- "customerImageUsages": [
- {
- "id": "IMAGE_5",
- "type": "SIGNATURE",
- "providedImageType": "SIGNATURE"
- "documentFormat": {
- "provideInstructions": true,
- "optionsRequested": {
- "options": [
- "SUPPRESS_ADDITIONAL_LANGUAGES",
- "SHIPPING_LABEL_LAST"
- "stockType": "PAPER_LETTER",
- "dispositions": [
- {
- "eMailDetail": {
- "eMailRecipients": [
- {
- "emailAddress": "email@fedex.com",
- "recipientType": "THIRD_PARTY"
- "locale": "en_US",
- "grouping": "NONE"
- "dispositionType": "CONFIRMED"
- "locale": "en_US",
- "docType": "PDF"
- "rateRequestType": [
- "LIST",
- "PREFERRED"
- "preferredCurrency": "USD",
- "requestedPackageLineItems": [
- {
- "sequenceNumber": "1",
- "subPackagingType": "BUCKET",
- "customerReferences": [
- {
- "customerReferenceType": "INVOICE_NUMBER",
- "value": "3686"
- "declaredValue": {
- "amount": 12.45,
- "currency": "USD"
- "weight": {
- "units": "KG",
- "value": 68
- "dimensions": {
- "length": 100,
- "width": 50,
- "height": 30,
- "units": "CM"
- "groupPackageCount": 2,
- "itemDescriptionForClearance": "description",
- "contentRecord": [
- {
- "itemNumber": "2876",
- "receivedQuantity": 256,
- "description": "Description",
- "partNumber": "456"
- "itemDescription": "item description for the package",
- "variableHandlingChargeDetail": {
- "rateType": "PREFERRED_CURRENCY",
- "percentValue": 12.45,
- "rateLevelType": "INDIVIDUAL_PACKAGE_RATE",
- "fixedValue": {
- "amount": 24.45,
- "currency": "USD"
- "rateElementBasis": "NET_CHARGE_EXCLUDING_TAXES"
- "packageSpecialServices": {
- "specialServiceTypes": [
- "ALCOHOL",
- "NON_STANDARD_CONTAINER",
- "DANGEROUS_GOODS",
- "SIGNATURE_OPTION",
- "PRIORITY_ALERT"
- "signatureOptionType": "ADULT",
- "priorityAlertDetail": {
- "enhancementTypes": [
- "PRIORITY_ALERT_PLUS"
- "content": [
- "string"
- "signatureOptionDetail": {
- "signatureReleaseNumber": "23456"
- "alcoholDetail": {
- "alcoholRecipientType": "LICENSEE",
- "shipperAgreementType": "Retailer"
- "dangerousGoodsDetail": {
- "cargoAircraftOnly": false,
- "regulation": "ADR",
- "accessibility": "INACCESSIBLE",
- "options": [
- "LIMITED_QUANTITIES_COMMODITIES",
- "ORM_D"
- "packageCODDetail": {
- "codCollectionAmount": {
- "amount": 12.45,
- "currency": "USD"
- "pieceCountVerificationBoxCount": 0,
- "batteryDetails": [
- {
- "batteryPackingType": "CONTAINED_IN_EQUIPMENT",
- "batteryRegulatoryType": "IATA_SECTION_II",
- "batteryMaterialType": "LITHIUM_METAL"
- "dryIceWeight": {
- "units": "KG",
- "value": 68
- "standaloneBatteryDetails": [
- {
- "batteryMaterialType": "LITHIUM_METAL"
- "accountNumber": {
- "value": "Your account number"
Response samples
- 200
- 400
- 401
- 403
- 404
- 500
- "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
- "customerTransactionId": "AnyCo_order123456789",
- "output": {
- "alerts": [
- {
- "code": "SHIPMENT.VALIDATION.SUCCESS",
- "alertType": "NOTE",
- "message": "Shipment validated successfully. No errors found."
Create Tag
FedEx creates and delivers a returnnn shipping label to your customer and collects the item for return. Your customer needs to have the package ready for pickup when the FedEx driver arrives. Use this endpoint to create tag requests for FedEx Express and FedEx Ground shipments.
Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS) mechanism.
header Parameters
x-customer-transaction-id | string Example: 624deea6-b709-470c-8c39-4b5511281492 This element allows you to assign a unique identifier to your transaction. This element is also returned in the reply and helps you match the request to the reply. |
content-type required | string Example: application/json This is used to indicate the media type of the resource. The media type is a string sent along with the file indicating format of the file. |
x-locale | string Example: en_US This indicates the combination of language code and country code. Click here to see Locales |
authorization required | string Example: Bearer XXX This indicates the authorization token for the input request. |
Request Body schema: application/json
- Full_Schema_Create_Tag
- Create_Express_Tag
- Create_Ground_Call_Tag
requestedShipment required | object The shipment data describing the shipment being tendered to FedEx. |
accountNumber required | object The specific FedEx customer account number (account value) associated with the shipment. |
Responses
Success
Bad Request
Unauthorized
Forbidden
Not Found
Failure
Service Unavailable
Sandbox Server
Production Server
Request samples
- Payload
- C#
- JAVA
- JAVASCRIPT
- PHP
- PYTHON
- RUST
- SWIFT
- "requestedShipment": {
- "shipDatestamp": "2019-10-14",
- "totalDeclaredValue": {
- "amount": 12.45,
- "currency": "USD"
- "shipper": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneExtension": "91",
- "phoneNumber": "XXXX567890",
- "companyName": "Fedex"
- "tins": [
- {
- "number": "XXX567",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2024-06-13",
- "expirationDate": "2024-06-13"
- "soldTo": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneExtension": "91",
- "phoneNumber": "1234567890",
- "companyName": "Fedex"
- "tins": [
- {
- "number": "123567",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2000-01-23T04:56:07.000+00:00",
- "expirationDate": "2000-01-23T04:56:07.000+00:00"
- "accountNumber": {
- "value": "Your account number"
- "recipients": [
- {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneExtension": "000",
- "phoneNumber": "XXXX345671",
- "companyName": "FedEx"
- "tins": [
- {
- "number": "123567",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2000-01-23T04:56:07.000+00:00",
- "expirationDate": "2000-01-23T04:56:07.000+00:00"
- "deliveryInstructions": "Delivery Instructions"
- "recipientLocationNumber": "1234567",
- "pickupType": "USE_SCHEDULED_PICKUP",
- "serviceType": "PRIORITY_OVERNIGHT",
- "packagingType": "YOUR_PACKAGING",
- "totalWeight": 20.6,
- "origin": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "38127",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "person name",
- "emailAddress": "email address",
- "phoneNumber": "phone number",
- "phoneExtension": "phone extension",
- "companyName": "company name",
- "faxNumber": "fax number"
- "shippingChargesPayment": {
- "paymentType": "SENDER",
- "payor": {
- "responsibleParty": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneNumber": "XXXX567890",
- "phoneExtension": "phone extension",
- "companyName": "Fedex",
- "faxNumber": "fax number"
- "accountNumber": {
- "value": "Your account number"
- "shipmentSpecialServices": {
- "specialServiceTypes": [
- "THIRD_PARTY_CONSIGNEE",
- "PROTECTION_FROM_FREEZING"
- "etdDetail": {
- "attributes": [
- "POST_SHIPMENT_UPLOAD_REQUESTED"
- "attachedDocuments": [
- {
- "documentType": "PRO_FORMA_INVOICE",
- "documentReference": "DocumentReference",
- "description": "PRO FORMA INVOICE",
- "documentId": "090927d680038c61"
- "requestedDocumentTypes": [
- "VICS_BILL_OF_LADING",
- "GENERAL_AGENCY_AGREEMENT"
- "returnShipmentDetail": {
- "returnEmailDetail": {
- "merchantPhoneNumber": "19012635656",
- "allowedSpecialService": [
- "SATURDAY_DELIVERY"
- "rma": {
- "reason": "Wrong Size or Color"
- "returnAssociationDetail": {
- "shipDatestamp": "2019-10-01",
- "trackingNumber": "123456789"
- "returnType": "PRINT_RETURN_LABEL"
- "deliveryOnInvoiceAcceptanceDetail": {
- "recipient": {
- "address": {
- "streetLines": [
- "23, RUE JOSEPH-DE MA",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneExtension": "000",
- "phoneNumber": "1234567890",
- "companyName": "Fedex"
- "tins": [
- {
- "number": "123567",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2000-01-23T04:56:07.000+00:00",
- "expirationDate": "2000-01-23T04:56:07.000+00:00"
- "deliveryInstructions": "Delivery Instructions"
- "internationalTrafficInArmsRegulationsDetail": {
- "licenseOrExemptionNumber": "9871234"
- "pendingShipmentDetail": {
- "pendingShipmentType": "EMAIL",
- "processingOptions": {
- "options": [
- "ALLOW_MODIFICATIONS"
- "recommendedDocumentSpecification": {
- "types": [
- "ANTIQUE_STATEMENT_EUROPEAN_UNION",
- "ANTIQUE_STATEMENT_UNITED_STATES"
- "emailLabelDetail": {
- "recipients": [
- {
- "emailAddress": "nnnnneena@fedex.com",
- "optionsRequested": {
- "options": [
- "PRODUCE_PAPERLESS_SHIPPING_FORMAT",
- "SUPPRESS_ACCESS_EMAILS"
- "role": "SHIPMENT_COMPLETOR",
- "locale": "en_US"
- "message": "your optional message"
- "attachedDocuments": [
- {
- "documentType": "PRO_FORMA_INVOICE",
- "documentReference": "DocumentReference",
- "description": "PRO FORMA INVOICE",
- "documentId": "090927d680038c61"
- "expirationTimeStamp": "2020-01-01"
- "holdAtLocationDetail": {
- "locationId": "YBZA",
- "locationContactAndAddress": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "38127",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "person name",
- "emailAddress": "email address",
- "phoneNumber": "phone number",
- "phoneExtension": "phone extension",
- "companyName": "company name",
- "faxNumber": "fax number"
- "locationType": "FEDEX_ONSITE"
- "shipmentCODDetail": {
- "addTransportationChargesDetail": {
- "rateType": "ACCOUNT",
- "rateLevelType": "BUNDLED_RATE",
- "chargeLevelType": "CURRENT_PACKAGE",
- "chargeType": "COD_SURCHARGE"
- "codRecipient": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneExtension": "000",
- "phoneNumber": "XXXX345671",
- "companyName": "Fedex"
- "accountNumber": {
- "value": "Your account number"
- "tins": [
- {
- "number": "123567",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2000-01-23T04:56:07.000+00:00",
- "expirationDate": "2000-01-23T04:56:07.000+00:00"
- "remitToName": "remitToName",
- "codCollectionType": "CASH",
- "financialInstitutionContactAndAddress": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "38127",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "person name",
- "emailAddress": "email address",
- "phoneNumber": "phone number",
- "phoneExtension": "phone extension",
- "companyName": "company name",
- "faxNumber": "fax number"
- "codCollectionAmount": {
- "amount": 12.45,
- "currency": "USD"
- "returnReferenceIndicatorType": "INVOICE",
- "shipmentCodAmount": {
- "amount": 12.45,
- "currency": "USD"
- "shipmentDryIceDetail": {
- "totalWeight": {
- "units": "LB",
- "value": 10
- "packageCount": 12
- "internationalControlledExportDetail": {
- "licenseOrPermitExpirationDate": "2019-12-03",
- "licenseOrPermitNumber": "11",
- "entryNumber": "125",
- "foreignTradeZoneCode": "US",
- "type": "WAREHOUSE_WITHDRAWAL"
- "homeDeliveryPremiumDetail": {
- "phoneNumber": {
- "areaCode": "901",
- "localNumber": "3575012",
- "extension": "200",
- "personalIdentificationNumber": "98712345"
- "deliveryDate": "2019-06-26",
- "homedeliveryPremiumType": "APPOINTMENT"
- "emailNotificationDetail": {
- "aggregationType": "PER_PACKAGE",
- "emailNotificationRecipients": [
- {
- "name": "Joe Smith",
- "emailNotificationRecipientType": "SHIPPER",
- "emailAddress": "jsmith3@aol.com",
- "notificationFormatType": "TEXT",
- "notificationType": "EMAIL",
- "locale": "en_US",
- "notificationEventType": [
- "ON_PICKUP_DRIVER_ARRIVED",
- "ON_SHIPMENT"
- "personalMessage": "your personal message here"
- "expressFreightDetail": {
- "bookingConfirmationNumber": "123456789812",
- "shippersLoadAndCount": 123,
- "packingListEnclosed": true
- "variableHandlingChargeDetail": {
- "rateType": "PREFERRED_CURRENCY",
- "percentValue": 12.45,
- "rateLevelType": "INDIVIDUAL_PACKAGE_RATE",
- "fixedValue": {
- "amount": 24.45,
- "currency": "USD"
- "rateElementBasis": "NET_CHARGE_EXCLUDING_TAXES"
- "customsClearanceDetail": {
- "regulatoryControls": [
- "NOT_IN_FREE_CIRCULATION",
- "USMCA"
- "brokers": [
- {
- "broker": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneNumber": "1234567890",
- "phoneExtension": 91,
- "companyName": "Fedex",
- "faxNumber": 1234567
- "accountNumber": {
- "value": "Your account number"
- "tins": [
- {
- "number": "number",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2000-01-23T04:56:07.000+00:00",
- "expirationDate": "2000-01-23T04:56:07.000+00:00"
- "deliveryInstructions": "deliveryInstructions"
- "type": "IMPORT"
- "commercialInvoice": {
- "originatorName": "originator Name",
- "comments": [
- "optional comments for the commercial invoice"
- "customerReferences": [
- {
- "customerReferenceType": "DEPARTMENT_NUMBER",
- "value": "3686"
- "taxesOrMiscellaneousCharge": {
- "amount": 12.45,
- "currency": "USD"
- "taxesOrMiscellaneousChargeType": "COMMISSIONS",
- "freightCharge": {
- "amount": 12.45,
- "currency": "USD"
- "packingCosts": {
- "amount": 12.45,
- "currency": "USD"
- "handlingCosts": {
- "amount": 12.45,
- "currency": "USD"
- "declarationStatement": "declarationStatement",
- "termsOfSale": "FCA",
- "specialInstructions": "specialInstructions\"",
- "shipmentPurpose": "REPAIR_AND_RETURN",
- "emailNotificationDetail": {
- "emailAddress": "neena@fedex.com",
- "type": "EMAILED",
- "recipientType": "SHIPPER"
- "freightOnValue": "OWN_RISK",
- "dutiesPayment": {
- "payor": {
- "responsibleParty": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "38127",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneNumber": "1234567890",
- "phoneExtension": "phone extension",
- "companyName": "Fedex",
- "faxNumber": "fax number"
- "accountNumber": {
- "value": "Your account number"
- "tins": [
- {
- "number": "number",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2024-06-13",
- "expirationDate": "2024-06-13"
- {
- "number": "number",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2024-06-13",
- "expirationDate": "2024-06-13"
- "billingDetails": {
- "billingCode": "billingCode",
- "billingType": "billingType",
- "aliasId": "aliasId",
- "accountNickname": "accountNickname",
- "accountNumber": "Your account number",
- "accountNumberCountryCode": "US"
- "paymentType": "SENDER"
- "commodities": [
- {
- "unitPrice": {
- "amount": 12.45,
- "currency": "USD"
- "additionalMeasures": [
- {
- "quantity": 12.45,
- "units": "KG"
- "numberOfPieces": 12,
- "quantity": 125,
- "quantityUnits": "Ea",
- "customsValue": {
- "amount": "1556.25",
- "currency": "USD"
- "countryOfManufacture": "US",
- "cIMarksAndNumbers": "87123",
- "harmonizedCode": "0613",
- "description": "description",
- "name": "non-threaded rivets",
- "weight": {
- "units": "KG",
- "value": 68
- "exportLicenseNumber": "26456",
- "exportLicenseExpirationDate": "2025-03-15T15:47:31Z",
- "partNumber": "167",
- "purpose": "BUSINESS",
- "usmcaDetail": {
- "originCriterion": "A"
- "isDocumentOnly": false,
- "recipientCustomsId": {
- "type": "PASSPORT",
- "value": "123"
- "customsOption": {
- "description": "Description",
- "type": "COURTESY_RETURN_LABEL"
- "importerOfRecord": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneExtension": "000",
- "phoneNumber": "XXXX345671",
- "companyName": "Fedex"
- "accountNumber": {
- "value": "Your account number"
- "tins": [
- {
- "number": "123567",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2000-01-23T04:56:07.000+00:00",
- "expirationDate": "2000-01-23T04:56:07.000+00:00"
- "generatedDocumentLocale": "en_US",
- "exportDetail": {
- "destinationControlDetail": {
- "endUser": "dest country user",
- "statementTypes": "DEPARTMENT_OF_COMMERCE",
- "destinationCountries": [
- "USA",
- "India"
- "b13AFilingOption": "NOT_REQUIRED",
- "exportComplianceStatement": "12345678901234567",
- "permitNumber": "12345"
- "totalCustomsValue": {
- "amount": 12.45,
- "currency": "USD"
- "partiesToTransactionAreRelated": true,
- "declarationStatementDetail": {
- "usmcaLowValueStatementDetail": {
- "countryOfOriginLowValueDocumentRequested": true,
- "customsRole": "EXPORTER"
- "insuranceCharge": {
- "amount": 12.45,
- "currency": "USD"
- "smartPostInfoDetail": {
- "ancillaryEndorsement": "RETURN_SERVICE",
- "hubId": "5015",
- "indicia": "PRESORTED_STANDARD",
- "specialServices": "USPS_DELIVERY_CONFIRMATION"
- "blockInsightVisibility": true,
- "labelSpecification": {
- "labelFormatType": "COMMON2D",
- "labelOrder": "SHIPPING_LABEL_FIRST",
- "customerSpecifiedDetail": {
- "maskedData": [
- "PACKAGE_SEQUENCE_AND_COUNT",
- "TOTAL_WEIGHT"
- "regulatoryLabels": [
- {
- "generationOptions": "CONTENT_ON_SHIPPING_LABEL_ONLY",
- "type": "ALCOHOL_SHIPMENT_LABEL"
- "additionalLabels": [
- {
- "type": "MANIFEST",
- "count": 1
- "docTabContent": {
- "docTabContentType": "BARCODED",
- "zone001": {
- "docTabZoneSpecifications": [
- {
- "zoneNumber": 0,
- "header": "string",
- "dataField": "string",
- "literalValue": "string",
- "justification": "RIGHT"
- "barcoded": {
- "symbology": "UCC128",
- "specification": {
- "zoneNumber": 0,
- "header": "string",
- "dataField": "string",
- "literalValue": "string",
- "justification": "RIGHT"
- "printedLabelOrigin": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "38127",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "person name",
- "emailAddress": "email address",
- "phoneNumber": "phone number",
- "phoneExtension": "phone extension",
- "companyName": "company name",
- "faxNumber": "fax number"
- "labelStockType": "PAPER_7X475",
- "labelRotation": "UPSIDE_DOWN",
- "imageType": "PDF",
- "labelPrintingOrientation": "TOP_EDGE_OF_TEXT_FIRST",
- "returnedDispositionDetail": "RETURNED",
- "resolution": 300
- "shippingDocumentSpecification": {
- "generalAgencyAgreementDetail": {
- "documentFormat": {
- "provideInstructions": true,
- "optionsRequested": {
- "options": [
- "SUPPRESS_ADDITIONAL_LANGUAGES",
- "SHIPPING_LABEL_LAST"
- "stockType": "PAPER_LETTER",
- "dispositions": [
- {
- "eMailDetail": {
- "eMailRecipients": [
- {
- "emailAddress": "email@fedex.com",
- "recipientType": "THIRD_PARTY"
- "locale": "en_US",
- "grouping": "NONE"
- "dispositionType": "CONFIRMED"
- "locale": "en_US",
- "docType": "PDF"
- "returnInstructionsDetail": {
- "customText": "This is additional text printed on Return instr",
- "documentFormat": {
- "provideInstructions": true,
- "optionsRequested": {
- "options": [
- "SUPPRESS_ADDITIONAL_LANGUAGES",
- "SHIPPING_LABEL_LAST"
- "stockType": "PAPER_LETTER",
- "dispositions": [
- {
- "eMailDetail": {
- "eMailRecipients": [
- {
- "emailAddress": "email@fedex.com",
- "recipientType": "THIRD_PARTY"
- "locale": "en_US",
- "grouping": "NONE"
- "dispositionType": "CONFIRMED"
- "locale": "en_US\"",
- "docType": "PNG"
- "op900Detail": {
- "customerImageUsages": [
- {
- "id": "IMAGE_5",
- "type": "SIGNATURE",
- "providedImageType": "SIGNATURE"
- "signatureName": "Signature Name",
- "documentFormat": {
- "provideInstructions": true,
- "optionsRequested": {
- "options": [
- "SUPPRESS_ADDITIONAL_LANGUAGES",
- "SHIPPING_LABEL_LAST"
- "stockType": "PAPER_LETTER",
- "dispositions": [
- {
- "eMailDetail": {
- "eMailRecipients": [
- {
- "emailAddress": "email@fedex.com",
- "recipientType": "THIRD_PARTY"
- "locale": "en_US",
- "grouping": "NONE"
- "dispositionType": "CONFIRMED"
- "locale": "en_US",
- "docType": "PDF"
- "usmcaCertificationOfOriginDetail": {
- "customerImageUsages": [
- {
- "id": "IMAGE_5",
- "type": "SIGNATURE",
- "providedImageType": "SIGNATURE"
- "documentFormat": {
- "provideInstructions": true,
- "optionsRequested": {
- "options": [
- "SUPPRESS_ADDITIONAL_LANGUAGES",
- "SHIPPING_LABEL_LAST"
- "stockType": "PAPER_LETTER",
- "dispositions": [
- {
- "eMailDetail": {
- "eMailRecipients": [
- {
- "emailAddress": "email@fedex.com",
- "recipientType": "THIRD_PARTY"
- "locale": "en_US",
- "grouping": "NONE"
- "dispositionType": "CONFIRMED"
- "locale": "en_US",
- "docType": "PDF"
- "certifierSpecification": "EXPORTER",
- "importerSpecification": "UNKNOWN",
- "producerSpecification": "SAME_AS_EXPORTER",
- "producer": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneExtension": "000",
- "phoneNumber": "XXXX345671",
- "companyName": "Fedex"
- "accountNumber": {
- "value": "Your account number"
- "tins": [
- {
- "number": "123567",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2000-01-23T04:56:07.000+00:00",
- "expirationDate": "2000-01-23T04:56:07.000+00:00"
- "blanketPeriod": {
- "begins": "22-01-2020",
- "ends": "2-01-2020"
- "certifierJobTitle": "Manager"
- "usmcaCommercialInvoiceCertificationOfOriginDetail": {
- "customerImageUsages": [
- {
- "id": "IMAGE_5",
- "type": "SIGNATURE",
- "providedImageType": "SIGNATURE"
- "documentFormat": {
- "provideInstructions": true,
- "optionsRequested": {
- "options": [
- "SUPPRESS_ADDITIONAL_LANGUAGES",
- "SHIPPING_LABEL_LAST"
- "stockType": "PAPER_LETTER",
- "dispositions": [
- {
- "eMailDetail": {
- "eMailRecipients": [
- {
- "emailAddress": "email@fedex.com",
- "recipientType": "THIRD_PARTY"
- "locale": "en_US",
- "grouping": "NONE"
- "dispositionType": "CONFIRMED"
- "locale": "en_US",
- "docType": "PDF"
- "certifierSpecification": "EXPORTER",
- "importerSpecification": "UNKNOWN",
- "producerSpecification": "SAME_AS_EXPORTER",
- "producer": {
- "address": {
- "streetLines": [
- "10 FedEx Parkway",
- "Suite 302"
- "city": "Beverly Hills",
- "stateOrProvinceCode": "CA",
- "postalCode": "90210",
- "countryCode": "US",
- "residential": false
- "contact": {
- "personName": "John Taylor",
- "emailAddress": "sample@company.com",
- "phoneExtension": "000",
- "phoneNumber": "XXXX345671",
- "companyName": "Fedex"
- "accountNumber": {
- "value": "Your account number"
- "tins": [
- {
- "number": "123567",
- "tinType": "FEDERAL",
- "usage": "usage",
- "effectiveDate": "2000-01-23T04:56:07.000+00:00",
- "expirationDate": "2000-01-23T04:56:07.000+00:00"
- "certifierJobTitle": "Manager"
- "shippingDocumentTypes": [
- "RETURN_INSTRUCTIONS"
- "certificateOfOrigin": {
- "customerImageUsages": [
- {
- "id": "IMAGE_5",
- "type": "SIGNATURE",
- "providedImageType": "SIGNATURE"
- "documentFormat": {
- "provideInstructions": true,
- "optionsRequested": {
- "options": [
- "SUPPRESS_ADDITIONAL_LANGUAGES",
- "SHIPPING_LABEL_LAST"
- "stockType": "PAPER_LETTER",
- "dispositions": [
- {
- "eMailDetail": {
- "eMailRecipients": [
- {
- "emailAddress": "email@fedex.com",
- "recipientType": "THIRD_PARTY"
- "locale": "en_US",
- "grouping": "NONE"
- "dispositionType": "CONFIRMED"
- "locale": "en_US",
- "docType": "PDF"
- "commercialInvoiceDetail": {
- "customerImageUsages": [
- {
- "id": "IMAGE_5",
- "type": "SIGNATURE",
- "providedImageType": "SIGNATURE"
- "documentFormat": {
- "provideInstructions": true,
- "optionsRequested": {
- "options": [
- "SUPPRESS_ADDITIONAL_LANGUAGES",
- "SHIPPING_LABEL_LAST"
- "stockType": "PAPER_LETTER",
- "dispositions": [
- {
- "eMailDetail": {
- "eMailRecipients": [
- {
- "emailAddress": "email@fedex.com",
- "recipientType": "THIRD_PARTY"
- "locale": "en_US",
- "grouping": "NONE"
- "dispositionType": "CONFIRMED"
- "locale": "en_US",
- "docType": "PDF"
- "rateRequestType": [
- "LIST",
- "PREFERRED"
- "preferredCurrency": "USD",
- "totalPackageCount": 25,
- "masterTrackingId": {
- "formId": "0201",
- "trackingIdType": "EXPRESS",
- "uspsApplicationId": "92",
- "trackingNumber": "49092000070120032835"
- "requestedPackageLineItems": [
- {
- "sequenceNumber": "1",
- "subPackagingType": "BUCKET",
- "customerReferences": [
- {
- "customerReferenceType": "INVOICE_NUMBER",
- "value": "3686"
- "declaredValue": {
- "amount": 12.45,
- "currency": "USD"
- "weight": {
- "units": "KG",
- "value": 68
- "dimensions": {
- "length": 100,
- "width": 50,
- "height": 30,
- "units": "CM"
- "groupPackageCount": 2,
- "itemDescriptionForClearance": "description",
- "contentRecord": [
- {
- "itemNumber": "2876",
- "receivedQuantity": 256,
- "description": "Description",
- "partNumber": "456"
- "itemDescription": "item description for the package",
- "variableHandlingChargeDetail": {
- "rateType": "PREFERRED_CURRENCY",
- "percentValue": 12.45,
- "rateLevelType": "INDIVIDUAL_PACKAGE_RATE",
- "fixedValue": {
- "amount": 24.45,
- "currency": "USD"
- "rateElementBasis": "NET_CHARGE_EXCLUDING_TAXES"
- "packageSpecialServices": {
- "specialServiceTypes": [
- "ALCOHOL",
- "NON_STANDARD_CONTAINER",
- "DANGEROUS_GOODS",
- "SIGNATURE_OPTION",
- "PRIORITY_ALERT"
- "signatureOptionType": "ADULT",
- "priorityAlertDetail": {
- "enhancementTypes": [
- "PRIORITY_ALERT_PLUS"
- "content": [
- "string"
- "signatureOptionDetail": {
- "signatureReleaseNumber": "23456"
- "alcoholDetail": {
- "alcoholRecipientType": "LICENSEE",
- "shipperAgreementType": "Retailer"
- "dangerousGoodsDetail": {
- "cargoAircraftOnly": false,
- "regulation": "ADR",
- "accessibility": "INACCESSIBLE",
- "options": [
- "LIMITED_QUANTITIES_COMMODITIES",
- "ORM_D"
- "packageCODDetail": {
- "codCollectionAmount": {
- "amount": 12.45,
- "currency": "USD"
- "pieceCountVerificationBoxCount": 0,
- "batteryDetails": [
- {
- "batteryPackingType": "CONTAINED_IN_EQUIPMENT",
- "batteryRegulatoryType": "IATA_SECTION_II",
- "batteryMaterialType": "LITHIUM_METAL"
- "dryIceWeight": {
- "units": "KG",
- "value": 68
- "standaloneBatteryDetails": [
- {
- "batteryMaterialType": "LITHIUM_METAL"
- "pickupDetail": {
- "readyPickupDateTime": "2020-07-03T09:00:00Z",
- "latestPickupDateTime": "2020-07-03T09:00:00Z"
- "accountNumber": {
- "value": "Your account number"
Response samples
- 200
- 400
- 401
- 403
- 404
- 500
- 503
- "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
- "customerTransactionId": "AnyCo_order123456789",
- "output": {
- "masterTrackingNumber": "997338100007320",
- "serviceType": "GROUND_HOME_DELIVERY",
- "shipTimestamp": "2019-10-04",
- "completedTagDetail": {
- "confirmationNumber": "275",
- "location": "NQAA",
- "dispatchDate": "2019-08-03"
- "alerts": [
- {
- "code": "SHIPMENT.VALIDATION.SUCCESS",
- "alertType": "NOTE",
- "message": "Shipment validated successfully. No errors found."
Cancel Tag
This endpoint cancels a FedEx Return Tag and the associated pickup for FedEx Express and FedEx Ground shipments if the shipment has not yet been picked up by the courier.
Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS) mechanism.
path Parameters
shipmentid required | string |
header Parameters
x-customer-transaction-id | string Example: 624deea6-b709-470c-8c39-4b5511281492 This element allows you to assign a unique identifier to your transaction. This element is also returned in the reply and helps you match the request to the reply. |
content-type required | string Example: application/json This is used to indicate the media type of the resource. The media type is a string sent along with the file indicating format of the file. |
x-locale | string Example: en_US This indicates the combination of language code and country code. Click here to see Locales |
authorization required | string Example: Bearer XXX This indicates the authorization token for the input request. |
Request Body schema: application/json
- FullSchema-CancelTag
- Cancel_Tag
accountNumber required | object The specific FedEx customer account number (account value and account key) associated with the shipment. |
serviceType required | string This is the FedEx service type associated with the shipment. |
trackingNumber | string The tracking number for the Express or Ground Tag to the cancelled. |
completedTagDetail required | object The details of the package for which shipping has been completed. The details include dispatch confirmation number, dispatch date, location, and the cxs alerts associated with the process. |
Responses
Success
Bad Request
Unauthorized
Forbidden
Not Found
Failure
Service Unavailable
Sandbox Server
Production Server
Request samples
- Payload
- C#
- JAVA
- JAVASCRIPT
- PHP
- PYTHON
- RUST
- SWIFT
- "accountNumber": {
- "value": "123456789"
- "serviceType": "PRIORITY_OVERNIGHT",
- "trackingNumber": "301025281523",
- "completedTagDetail": {
- "confirmationNumber": "275",
- "location": "NQAA",
- "dispatchDate": "2019-08-03"
Response samples
- 200
- 400
- 401
- 403
- 404
- 500
- 503
- "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
- "customerTransactionId": "AnyCo_order123456789",
- "output": {
- "cancelledTag": true,
- "successMessage": "success"
Response