2025 年 8 月 12 日
2025 年 7 月以及即將發行版本的 FedEx Advanced Integrated Visibility 增強功能
我們不斷在改善 Webhook 產品、客戶能見度及整合體驗，現已推出並部署了下列幾項重要更新。
版本日期：2025 年 7 月 31 日
- 能夠在組織的多個 Webhook 訂閱中新增相同的託運帳號。
- 重新設計 Webhook 文件頁面以提高可讀性。
- 瑕疵修正 – 從帳號訂閱應用程式開發介面 (API) 和追蹤號碼訂閱 API 移除沙箱網址。預設會顯示生產環境網址。
- 瑕疵修正 – 修正 Webhook 儀表板 UI 問題，讓使用者能夠檢視和搜尋大量託運帳號。
即將推出的增強功能 – 2025 年 9 月
- 事件說明標準化 (移除句號)。
- 移除查詢架構中已不再使用的欄位。
- 在由服務站保管、取件節點中新增地址詳細資料、設施類型。
其他詳細資料：
請查看下方的版本詳細資料，以確保即將推出的變更不會對您的 Webhook 整合產生不良影響。
2025 年 7 月 31 日版本 – 詳細資訊
1. 在多個 Webhook 訂閱中重複託運帳戶
客戶在同一組織內建立或更新 Webhook 時，可在多個訂閱 ID 中新增相同的託運帳號，無國家/地區限制。
範例情境：
- 託運帳號：ABC123456
- 訂閱 ID：SubscriptionID-001、SubscriptionID-002、SubscriptionID-003
現在您可以在建立或更新 Webhook 時，將 ABC123456 新增至所有三個訂閱中，在整個組織的系統中一致地查詢和處理事件。
更新 Webhook 文件
Webhook 文件頁面現在提供更清晰、更詳細的說明，並改善格式與視覺輔助工具，以支援開發人員。
瑕疵修正
- 在此版本中，我們只會針對帳號訂閱 API 和追蹤號碼訂閱 API，共用 API 端點文件中的生產伺服器網址。這是為了確保明確性、減少混淆，並支援生產就緒的實作項目。
- 我們已解決以下問題：使用者嘗試在 FedEx Developer Portal (FDP) 使用大量託運帳戶建立 Webhook 時，會遇到錯誤。此錯誤是由於在 Webhook 設定過程中，無法載入或顯示完整的帳戶清單所導致。使用者現在可以在使用多個託運帳戶來設定 Webhook 時，順利檢視並選取所有帳戶。
即將發行版本的詳細資料 – 2025 年 9 月
下方提供即將發行版本的詳細資料供您檢閱。完成必要的開發工作後，我們會立即分享詳細的發行時程表。
1. Webhook 資料中的事件說明標準化
為確保系統與整合之間的一致性，我們將移除事件說明中的句號。此變更適用於所有事件類型，並有助於維持各平台的格式統一。
這對您的 Webhook 整合而言意味著什麼？
如果您的系統仰賴準確的事件說明形式 (例如，為了進行剖析或比對)，這會是一項突破性的變更。
下方提供了受影響事件說明的完整清單。
| 目前的事件說明 (之前) | 新的事件說明 (之後) |
|---|---|
| 機場貨運清單資料。 | 機場貨運清單資料 |
| 已在海關清關代理人處清關。 | 已在海關清關代理人處清關 |
| 已運抵海關清關代理人處。 | 已運抵海關清關代理人處 |
| 海關清關代理人清關延遲。 | 海關清關代理人清關延遲 |
| 已運抵目的地 FedEx 服務站。 | 已運抵目的地 FedEx 服務站 |
| 在目的地 FedEx 服務站。 | 在目的地 Fedex 服務站 |
| 準時抵達目的地 FedEx 服務站。 | 準時抵達目的地 FedEx 服務站 |
| 提前抵達目的地 FedEx 服務站。 | 提前抵達目的地 FedEx 服務站 |
| 已可在目的地 FedEx 服務站取件。 | 已可在目的地 FedEx 服務站取件 |
| 目的地 FedEx 服務站出現遞送的例外狀況。 | 目的地 FedEx 服務站出現遞送的例外狀況 |
| 於目的地 FedEx 服務站延誤。 | 於目的地 FedEx 服務站延誤 |
| 由目的地 FedEx 服務站保管。 | 由目的地 FedEx 服務站保管 |
| 已送達遞送地點。 | 已送達遞送地點 |
| 遞送地點出現遞送的例外狀況。 | 遞送地點出現遞送的例外狀況 |
| 準時抵達遞送地點。 | 準時抵達遞送地點 |
| 提前抵達遞送地點。 | 提前抵達遞送地點 |
| 於遞送地點出現遞送延誤狀況。 | 於遞送地點出現遞送延誤狀況 |
| 在途中已取消遞送選項請求。 | 在途中已取消遞送選項請求 |
| 在途中提前抵達。 | 在途中提前抵達 |
| 在途中準時抵達。 | 在途中準時抵達 |
| 在途中出現取件延誤狀況。 | 在途中出現取件延誤狀況 |
| 在途中已清關。 | 在途中已清關 |
| 在途中出現遞送延誤狀況。 | 在途中出現遞送延誤狀況 |
| 在 FedEx 服務站已清關。 | 在 FedEx 服務站已清關 |
| 在 FedEx 服務站出現清關延遲的狀況。 | 在 FedEx 服務站出現清關延遲的狀況 |
| 在 FedEx 服務站。 | 在 FedEx 中心 |
| 已離開 FedEx 服務站。 | 已離開 FedEx 服務站 |
| 已運抵 FedEx 服務站。 | 已運抵 FedEx 服務站 |
| 正在 FedEx 服務站清關。 | 正在 FedEx 服務站清關 |
| 準時抵達 FedEx 服務站。 | 準時抵達 FedEx 服務站 |
| 提前抵達 FedEx 服務站。 | 提前抵達 FedEx 服務站 |
| 已運抵寄件地 FedEx 服務站。 | 已運抵寄件地 FedEx 服務站 |
| 於 FedEx 服務站延誤。 | 於 FedEx 服務站延誤 |
| 已離開寄件地 FedEx 服務站。 | 已離開寄件地 FedEx 服務站 |
| 在 FedEx 服務站由 FedEx 保管。 | 在 FedEx 服務站由 FedEx 保管 |
| 在 FedEx 服務站轉運。 | 在 FedEx 服務站轉運 |
| 在 FedEx 服務站依需服務。 | 在 FedEx 服務站依需服務 |
| 準時抵達寄件地 FedEx 服務站。 | 準時抵達寄件地 FedEx 服務站 |
| 提前抵達寄件地 FedEx 服務站。 | 提前抵達寄件地 FedEx 服務站 |
| 在寄件地 FedEx 服務站出現清關延遲的狀況。 | 在寄件地 FedEx 服務站出現清關延遲的狀況 |
| 已在寄件地 FedEx 服務站變更地點。 | 已在寄件地 FedEx 服務站變更地點 |
| 在寄件地 FedEx 服務站已清關。 | 在寄件地 FedEx 服務站已清關 |
| 在寄件地 FedEx 服務站轉運。 | 在寄件地 FedEx 服務站轉運 |
| 準時抵達取件地點。 | 準時抵達取件地點 |
| 提前抵達取件地點。 | 提前抵達取件地點 |
| 在取件地點由 FedEx 保管。 | 在取件地點由 FedEx 保管 |
| 提前抵達車輛。 | 提前抵達車輛 |
| 準時抵達車輛。 | 準時抵達車輛 |
| 已離開目的地。 | 已離開目的地 |
| 已送達目的地。 | 已送達目的地 |
| 提前抵達目的地。 | 提前抵達目的地 |
| 準時抵達目的地。 | 準時抵達目的地 |
| 已送達取件地點。 | 已送達取件地點 |
| 在取件地址出現取件延誤狀況。 | 在取件地址出現取件延誤狀況 |
2. 架構清理和欄位移除
為了減少冗餘並簡化承載，系統將從查詢回應架構中移除下列欄位：
- scanEvent/eventAdditionalInfo/employeeId
- scanEvent/previousEvents/[Array]/eventAdditionalInfo/employeeId
- trackResult/documents/[Array]/systemId
- trackResult/documents/[Array]/lineNbr
- trackResult/documents/[Array]/recordId
- trackResult/documents/[Array]/folderId
已不再需要這些欄位，且會在即將發行的版本中停用。
3. 保管服務站、可取件事件的增強功能
我們正在新增服務站詳細資料。先前版本的保管事件會顯示：
由 <Facility> 保管
現在將改為：
保管地點：<Address> (<Facility Type>)
此變更可讓客戶更清楚瞭解保管其包裹以供取件的確切地點，提升整體遞送體驗。
「可取貨」事件直接在事件說明中取消遮蔽並新增地址行。此增強功能可讓客戶立即查看領取包裹的地點，而不必參考其他欄位。
範例：
之前：
在 FedEx 服務站取件
之後：
收件人已可取件
(已可至 FedEx 服務站 – 610.9TH ST, DURHAM, NC 領取包裹)
這有助於客戶瞭解確切地點以便領取包裹，尤其是當附近有多個 FedEx 服務站時，這就非常實用。
