Advanced Integrated Visibility Webhook 設定
總覽
透過 Advanced Integrated Visibility Webhook，FedEx 可針對與一組或多組 FedEx 帳號建立關聯的貨件，將近乎即時且安全的追蹤事件資料推送到特定目的地網址。只要在 FedEx Developer Portal 建立 Webhook 專案，即可存取這項功能。
導覽路徑
您可以透過下列任一方式存取 Webhook 建立頁面：
- 我的專案：依序點選左側「導覽面板」→「Webhook」索引標籤 →「+ 建立 Webhook 專案」
API 目錄：
- 依序點選左側「導覽面板」→「API 目錄」
- 搜尋或篩選「Advanced Integrated Visibility」
- 依序點選「總覽」→「文件」→ 沙箱主控台中的「+ 建立專案」
- 依序按一下「文件」→「+ 建立 Webhook」
Webhook 建立步驟
步驟 1：選取公司類型
按一下「+ 建立專案」，然後從下拉清單中選擇公司類型：
- 使用 FedEx 託運，且需要將 FedEx Webhook 整合至公司系統。
- 銷售或提供使用 FedEx 資料的軟體解決方案，而且並未獲得 FedEx 電商兼容供應商認證。
- 是經認證的 FedEx 電商兼容供應商。
附註：目前 FedEx Advanced Integrated Visibility Webhook 解決方案無法用於此選項。身為 FedEx 電商兼容計畫的成員，若您想存取 Basic Integrated Visibility 或其他 FedEx 整合解決方案，請聯絡您的通路管理員。如果不清楚通路管理員是誰，請聯絡您的公司管理員。
接著，選取「Advanced Integrated Visibility 帳號訂閱」為訂閱類型。
建立 Advanced Integrated Visibility 帳號訂閱
此流程共有四個主要步驟：
- 設定專案
- 輸入專案詳細資料
- 選擇託運帳戶
- 確認詳細資料並接受條款
步驟 1：設定專案
在「設定 Webhook」頁面中：
- 帳單帳號：
- 檢視預設帳單帳戶。
- 如要變更，請依情況執行以下操作：
- 按一下「新增帳單帳戶至您的組織」(如果只有一個帳戶)。
- 按一下「選取另一個帳單帳戶」(如果有多個帳戶)。
附註：須使用位於美國的帳單帳戶。如需定價詳細資料，請參閱 Advanced Integrated Visibility 總覽指南。
功能選取：
- 選擇要啟用的功能，然後點選「下一步」。
功能說明
| 資料欄名稱 | 說明 |
|---|---|
| 送達證明 | 確認貨件已成功送達。 圖片簽收證明 (PPODA)：提供顯示確切送達地點的照片。 簽收證明 (SPOD)：提供具有收件人簽章與其姓名、送達日期、時間及地點的影像。 |
| 預估送達日期 | 提供以下資訊，協助收件人規劃收件： 預估送達日期 (EDD) 預估送達時間範圍 (EDTW) |
| 查詢事件 | 允許選取要接收通知的一個或多個事件類別： 託運 運送中 遞送 例外狀況 自訂遞送選項 |
| 事件型篩選 | 依以下條件篩選 Webhook 回應： 進口貨件 出口貨件 第三方貨件 |
在「輸入詳細資料」頁面提供以下資訊：
| 資料欄名稱 | 說明 |
|---|---|
| Webhook 專案名稱 | Webhook 專案的專屬名稱，不可留空。系統會自動填入建議名稱，但您可以編輯。此名稱不得與任何其他 Webhook 重複。 |
| 目的地 URL | FedEx 傳送追蹤事件資料時，所使用的安全 HTTPS 端點。 要求： 必須有效且正常運作 必須採用標準語法 不得包含 fedex.com 或其子網域 可重複用於多個 Webhook 如需詳細資料，請參閱「商務規則與最佳做法」一節。 |
| 安全性權杖 | 透過 HMAC 驗證身分及 Webhook 回應時，所用的共用密碼。 要求： 26 至 100 個半形字元 必須包含至少 1 個大寫字母、1 個小寫字母和 1 個數字字元 可重複用於多個 Webhook |
| 承載語言 (國家/地區) | 請從下拉清單中選取追蹤資料翻譯的偏好語言。 |
| 追蹤類型 | 選擇追蹤資料的交付方式 詳細追蹤資料 – 完整事件記錄 特定事件追蹤資料 – 僅限最近的事件 |
| 電子郵件 | 請提供有效電子郵件地址，以便接收通知。 |
| 電子郵件語言 (國家/地區) | 請選取電子郵件通知的偏好語言。 附註：僅支援美國地區語系 (例如 en-US、es-US)。 |
步驟 3：選擇託運帳戶
在「選擇託運帳戶」頁面中：
- 選取一或多個 FedEx 帳號，與您的 Webhook 專案建立關聯。
重要事項：
- 清單中只會顯示尚未與其他 Webhook 建立關聯的帳戶。
- 必須與至少一個帳戶建立關聯，才能繼續操作。
- 最多可透過 Webhook UI 新增 100 個帳戶。
- 如要與 超過 100 個帳戶建立關聯，請使用 Webhook API。
如欲申請 API 存取權，請聯絡 FedEx 顧客支援或服務台。
步驟 4：確認詳細資料並建立專案
在「確認詳細資料」頁面中：
1. 檢查您輸入的所有 Webhook 專案資訊。
2. 勾選相應方塊，接受條款及細則。
3. 按一下「建立」，完成 Webhook 設定。
成功提交資訊後即可建立 Webhook，系統會產生訂閱識別碼，並將 Webhook 狀態設為「啟用」。
驗證規則
一般要求：
- 「Webhook 名稱」不得重複。
- 「目的地網址」須採用標準語法格式 (安全 HTTPS，不含 fedex.com 或其子網域)。
- 所有必填欄位均須妥善填寫，不得留空。
- Webhook 必須與至少一個有效的 FedEx 託運帳號建立關聯。
驗證成功：
如果成功建立 Webhook，客戶會收到以下確認訊息：
<<Webhook 名稱>> 已成功建立。變更可能需要 10 分鐘才會生效。
驗證未成功/失敗：
如果 FedEx 從目的地網址收到 HTTP 200 (確定) 或 202 (已接受) 以外的任何回應，Webhook 驗證即視為失敗。
