取件請求應用程式開發介面 (API) 可讓您檢查是否可以取件、預約運務員進行取件，以及取消取件請求。

取件請求應用程式開發介面 (API) 適用於 FedEx Express 和 FedEx Ground (出口和回件) 貨件之所有地區中全新或之前處理的包裹。此詳細指南將協助您快速上手，並說明取件請求應用程式開發介面 (API) 的所有相關須知。

以下是與取件請求應用程式開發介面 (API) 關聯的重要特點：

是否可以取件

透過「是否可以取件」功能，您可以根據輸入請求檢查是否可以使用取件服務。是否可以取件取決於兩項因素：截止時間和進出時間。

截止時間：預約取件的最晚可允許時間。此時間是根據取件郵遞區號所在位置的當地時間。

進出時間：取件就緒時間 (已備妥包裹可供取件的時間) 與司機準備好收取包裹的時間之間的間隔時間。

建立取件

此選項可讓您預約取件，且適用於 FedEx Express^® 和 FedEx Ground^® 國內和國際貨件。FedEx Ground 和 Express 取件請求應用程式開發介面 (API) 會傳回取件確認號碼，此外，會針對已預約取件的 Express 取件請求傳回位置代碼。您也可以使用此應用程式開發介面 (API) 為回件貨件預約取件。

額外的收件人地址行 (地址行 3) 可讓您提供更完整且準確的位置詳細資料，以實現更快速的 FedEx Express^® 貨件遞送。預約 FedEx 運務員前往您的所在地或其他地點取件 (需額外付費)，藉此節省時間和精力。

取消取件

此選項可讓您取消之前預約的取件。此選項適用於 FedEx Express 和 FedEx Ground 國內和國際貨件。FedEx Express 國內和國際取件可於當日取消。FedEx Ground 國內和國際貨件將可於取件請求提交後的 24 小時取消。如果您的貨件已取件，請聯絡 FedEx 顧客服務部 (800 FedEx (800 3339))，以繼續進行取消作業。

取件請求詳細資料

FedEx Express 取件請求

• 您的包裹準備就緒可供取件的時間不得晚於您所在位置的郵遞區號截止時間。您可在「是否可以取件」請求中擷取截止時間。
• 從包裹將準備就緒的時間到運務員將無法再進入所在處收取包裹之間的時間長度不得小於「進出時間」，這也可以透過「是否可以取件」請求擷取。

例如：‘PT4H0M’ 表示取件時間為 4 小時 0 分鐘。

• 您可預約目前或下一個工作天的 FedEx Express 取件。
• 單一取件請求的包裹數量上限為 99。
• 如果您已經有定期的預約取件，則不需要預約一次性取件或新增另一個定期預約取件。
• 您無法變更取件請求。若要變更請求，您必須取消原始請求，然後輸入新請求。
• FedEx 系統現可支援英國國內取件功能。

FedEx Ground 取件請求

• 您可預約下一個工作天或任何工作天 (最多提前 2 週) 的取件。
• 單一取件請求的包裹數量上限為 99。
• 如果您已經有定期的預約取件，則不需要預約一次性取件或新增另一個定期預約取件。
• 只要支付額外附加費用，即可使用住家地址取件服務。
• 您無法變更取件請求。若要變更請求，您必須取消原始請求，然後輸入新請求。

取件請求應用程式開發介面 (API) 服務類型

FedEx Express 取件

當您請求 FedEx Express 取件 (包括透過 fedex.com 和 FedEx 顧客服務部提出的請求)，則須支付運務員取件費。

FedEx Ground 取件

FedEx Ground 會依請求提供取件服務，將收取額外費用。針對定期預約取件客戶，我們會對與定期預約取件關聯的帳號評估每週取件費用。

• 針對沒有定期預約取件的客戶，我們會依每件包裹評估待命取件費。如果您在 FedEx 託運服務站自行投遞包裹，則不會收取待命取件費。此外，亦不會對 FedEx Ground^® Economy (先前稱為 FedEx SmartPost^®) 列印回件標籤、FedEx Ground^® Economy (先前稱為 FedEx SmartPost^®) 電子郵件回件標籤和 FedEx Ground^® 包裹回件方案取件收取待命取件費。
• 針對定期預約取件客戶，FedEx Ground 會依請求為來自 FedEx Ground 帳號之託運位置以外的地址提供取件服務。使用本服務須支付額外的替代地址取件費 (每個地址按週收取額外費用)。

FedEx 額外時間

FedEx 額外時間服務適用於週一至週五隔夜 1 日運送，讓零售商能夠透過 FedEx Express 本地隔日送達服務履行夜間訂單。

如需有關可用服務的詳細資訊，請造訪 fedex.com。

以下是取件請求應用程式開發介面 (API) 提供的取件選項：

檢查是否可以取件

使用此端點請求可用的取件預約詳細資料。

與此請求關聯的關鍵輸入資訊如下：

• 取件地址/郵遞區號詳細資料。
• 取件請求類型 (例如：當日/未來)。
• 取件的 FedEx 運輸承運人 (例如：Express/Ground)。
• 無論是否為國內/國際取件。

若此請求成功，將會傳回可用的取件預約詳細資料，例如：取件截止時間、取件日期、取件的進出時間、預設貨件備妥時間，以及其他已預約的是否可以取件之詳細資料。如果發生任何原因導致失敗，此請求亦會傳回錯誤和說明。

建立取件

使用此端點針對待取件的包裹建立取件請求。

與此請求關聯的關鍵輸入資訊如下：

• FedEx 帳號，針對取件開立發票時將需要此資訊。
• 寄件地詳細資料 (地址、位置和取件地址類型，例如帳號/寄件人/其他)。
• 取件的 FedEx 運輸承運人 (Express/Ground)。
• 關聯帳號的地址詳細資料。

若取件請求成功，將會針對預約的取件傳回取件確認號碼、取件通知和位置代碼。如果發生任何失敗，它也會傳回錯誤和說明。

取消取件

使用此請求取消已預約的包裹取件請求。

與此請求關聯的關鍵輸入資訊如下：

• 取件確認代碼 (可在提交取件請求時取得)
• 取件的 FedEx 運輸承運人 (Express/Ground)
• 已預約的日期 (取件派送的發生日期)
• 位置 (負責處理取件請求的 FedEx Express 位置)

若成功取消取件，將會傳回確認號碼和取件取消確認訊息。如果發生任何失敗，它也會傳回錯誤和說明。

備註：提交取件確認號碼和對應的位置代碼 (僅適用於 FDXE)，以取消已預約的取件。提交取件請求時，可取得取件確認號碼和對應的位置代碼 (僅適用於 FDXE) 資訊。如果您試圖在 FedEx 運務員已派送到取件位置後取消取件，將會傳送失敗通知。

• 若要請求不同國家/地區的取件，請針對您要 FedEx 收取貨件的所在位置，使用適當的國家/地區代碼來包含國家/地區元素。
• 若派送請求成功，則 FedEx 會傳回派送確認號碼。除非您新增超過原始請求之尺寸或重量的包裹，否則派送請求應限制為每天一個請求。
• 如果您輸入之包裹就緒與公司打烊之間的間隔時段不足，派送請求可能會失敗。如果您對取件時間有任何疑問，請聯絡您所在地區的 FedEx 支援專線。
• 取件請求 API 可支援的重量類型為「磅」和「公斤」。包裹和商品的重量單位應一致，否則請求將會導致錯誤。
• 如果您需要針對 FedEx Express (包括墨西哥內部託運) 和 FedEx Ground 包裹預約取件，您必須個別針對各個承運人逐一預約取件。
• 如果您的取件位置位於偏遠地區，請提早確認您的包裹已備妥，以因應偏遠地區取件排程。
• 請務必包含包裹可取件的最晚時間 (或貴公司的下班時間)。
• 全球僅部分地區提供 FedEx Express 包裹的星期六取件服務，許多 FedEx 服務站亦提供星期六投遞服務。使用服務站服務端點來擷取星期六投遞地點清單。
• 針對 FedEx Ground 和 FedEx Express 取件，您可請求隨附於您 FedEx 帳號之託運地址之外的替代取件地址。
• 如果您想要定期的 FedEx Express 或 FedEx Ground 取件服務，請聯絡 FedEx 業務專員。
• 只有發生以下情況，才能取消 FedEx Express 或 FedEx Ground 取件：
  • 尚未到達請求包裹就緒時間，以及
  • 尚未派送運務員。