Fedex Logo

簡介

FedEx 郵區編號驗證 API 能讓 FedEx 客戶驗證郵區編號,並取得服務承諾。它支援城市、郵區編號、國家/地區以及與寄件地-目的地相關的查詢和驗證。它會在回覆中提供經過驗證的郵區編號和位置詳情。

郵區編號驗證 API 詳情

郵區編號驗證會驗證國家/地區和城市的郵區編號,並在回覆中提供清晰的郵區編號。目前格式化的郵區編號,為處理託運或建立託運標籤的必要條件。

此 API 使用所提供的輸入資料,例如託運日期、郵區編號、國家/地區代碼和其他各種資料,從而核對州份和城市值之間的不相符情況。如果找到不相符的情況,且國家為美國或加拿大,便會設定城市和州份。例如:FDXE - FedEx Express®、FDXG - FedEx Ground® 和 FXSP - FedEx Ground® Economy (前稱 FedEx SmartPost®)。API 會驗證所輸入的內容,並提供位置詳細資訊和清晰的郵區編號。

FedEx 支援向適用郵區編號和不適用郵區編號的國家/地區提供服務。

適用郵區編號的國家/地區

寄至該等國家/地區的貨件應在空運提單和其他文件上列明郵區編號,以協助減少延誤及將效率提升至最高。建議 FedEx Express 客戶將有效的郵區編號加入至下列國家/地區居住之收件人的地址中。

有關適用郵區編號國家/地區的更多資訊,請參閱適用郵區編號國家/地區

不適用郵區編號的國家/地區

顧名思義,FedEx 支援的該等國家/地區不適用郵區編號,因此不強制要求在貨件中提供郵區編號。客戶寄送貨件至不設郵區編號的國家/地區時,只須提供州份代碼或城市名稱。如果因此發生驗證錯誤,請嘗試輸入 \"00000\" 取代郵區編號,以便讓地址生效。使用該錯誤郵區編號不會導致遞送問題,因為它根本就不存在。

以下是使用 FedEx 郵區編號驗證 API 的好處:

  • 減少託運延誤並提高效率。
  • 增加準時及完成派送的數量。
  • 提升都市地區的 FedEx 服務,提供靈活的截件時間和收件時間表。

郵區編號驗證 API 的運作方式

FedEx 郵區編號驗證 API 會使用下方的端點,來驗證城市、國家/地區和寄件地-目的地的郵區編號。以下部分說明了端點的關鍵輸入和回應:

驗證郵區編號

此請求用於根據輸入詳情傳回郵遞詳情、清晰的郵區編號和位置說明。與此請求相關的關鍵輸入資料如下:

  • carrierCode
  • countryCode
  • stateOrProvinceCode
  • postalCode
  • shipDate

此請求的成功結果為 locationdetails,而所提供的輸入內容則為 cleanedpostalcode。如果郵區編號不正確,請求便會失敗,例如:國家/地區代碼、州份/省份和郵區編號的組合不正確。

釐清常見謬誤

  • 由於地區調整和郵區編號乃完全分開的調整流程輸出,因此無法將兩者互相參照。
  • 並非世界上的所有地理位置均有郵區編號。

如需《地區專屬清單》的更多資訊,請參閱《地區專屬服務清單》。

業務規則

  • 數字、街道名稱等的組合有效的實體地址須有至少一行;地址中不允許有空白行。
  • 如果收件人所在國家為美國或加拿大,或者若 EEI 適用且國家為墨西哥 {MX},便須提供 2 個英文字母的州份或省份代碼。
  • 實體地點的說明資料可用作實體地址 (一個可供人前往的地方),或者用作 \"address parts\" 的容器,並應作為單位進行處理 (例如美國境內的州份和城市郵區編號組合)。
  • 郵區編號欄位存在與否及其格式如何,視乎國家/地區而定。

JSON API 系列

CLOSE

Response

Copy