Fedex Logo

建立
Webhook 管理 Webhook

Advanced Integrated Visibility Webhook 類型

Advanced Integrated Visibility Webhook 可讓 FedEx 對與特定 FedEx 帳號相關聯的貨件目的地網址，推播近乎即時且受保護的追蹤事件資料。

您可以在 FedEx Developer Portal 建立 Advanced Integrated Visibility Webhook 專案，然後根據選取的訂閱類型，將其與一或多組 FedEx 帳號或 FedEx 追蹤號碼建立關聯。

導覽至：

ADVANCED INTEGRATED VISIBILITY 帳號訂閱或 ADVANCED INTEGRATED VISIBILITY 追蹤號碼訂閱，以檢視建立相應 Advanced Integrated Visibility Webhook 的步驟。

 

 

FedEx Advanced Integrated Visibility 總覽


FedEx 客戶可訂閱「帳號」或「追蹤號碼」，以接收近乎即時的運送中貨件事件，從建立標籤到包裹的簽收證明 (包括圖片簽收證明)，都能一手掌握。

訂閱類型


FedEx 客戶可依下列選項訂閱 Advanced Integrated Visibility：

  • 依帳號 — 訂閱 FedEx 帳號，接收與該帳戶相符貨件的最新消息。
  • 依追蹤號碼：訂閱 FedEx 追蹤號碼，透過 API 端點，接收符合特定追蹤號碼的貨件最新消息。

附註：訂閱功能目前需要美國 FedEx 9 位數帳戶來計費，且客戶須根據追蹤號碼數量支付月費。若要深入瞭解 Advanced Integrated Visibility 的定價，請參閱「Advanced Integrated Visibility 總覽定價指南」。

如果依帳號訂閱，則訂閱目前需要 FedEx 9 位數美國託運帳號。

下方表格提供有關帳號訂閱和 Advanced Integrated Visibility 追蹤號碼訂閱等功能的資訊

功能 帳號訂閱 追蹤號碼訂閱
回應 受保護的資料 = 個人識別資訊 (PII) 資料、寄件人和收件人資料、簽收證明 (SPOD)、CDO (便利遞送選項)/回應 匿名資料，包括貨件、運送中最新消息，不含 PII - 個人識別資訊/回應
關聯 與一個帳號建立關聯 = 一次與所有連結的追蹤號碼建立關聯 與追蹤號碼建立關聯
所有權 帳號須為使用者本人擁有 追蹤號碼不須為使用者擁有
篩選 可依進口、出口和第三方貨件篩選事件
 無法篩選事件
整合 透過 UI 與帳號建立關聯 透過應用程式開發介面 (API) 端點與追蹤號碼建立關聯
限制 可新增最多 100 組帳號 每個請求可新增最多 1,000 組追蹤號碼
合適的使用案例 第一方客戶 — 如果客戶擁有帳號 第三方客戶 — 如果客戶有屬於第一方客戶的追蹤號碼

 

FedEx Integrated Visibility – 依照訂閱類型的功能比較

功能/資料元素 追蹤號碼訂閱 帳號訂閱 備註
SPOD (簽收證明) 不適用 可用 (需要設定) 使用 TIFF 格式的簽名影像，在承載中傳送
PPOD (圖片簽收證明) 可用 (需要設定) 可用 (需要設定) 遞送位置的 JPEG 影像，以 Base64 編碼
PPODA (圖片嘗試遞送證明) 可用 (需要設定) 可用 (需要設定) 對於遞送嘗試，會提供 JPEG 影像
GPS 座標 (gpsPodCoordinates) 不適用 可用 在追蹤型訂閱中遮蔽
聯絡資訊 (姓名、電話、公司) 已遮蔽 可用 在寄件人、收件人、寄件地、目的地、清關代理人等之間
街道地址和郵遞區號 已遮蔽 可用 streetLines 和 postalCode 會在追蹤型承載中遮蔽
帳號 已遮蔽 可用 包括付款人、寄件人和收件人帳戶值
包裹財務 (例如 declaredValue、codAmount) 已遮蔽 可用 海關、貨到付款 (COD) 和申報價值會遮蔽
查詢和回件詳細資料 (查詢代碼、回件原因) 已遮蔽 可用 只會對帳戶型訂閱者顯示完整詳細資料
商品和內容資料 已遮蔽 可用 包括零件代碼、說明、數量
員工識別碼 (例如事件人員) 已遮蔽 不適用 基於隱私原因，兩種情況都會遮蔽
事件通知和 EDD/EDTW 可用 可用 兩者都支援預估送達日期/時間功能
多件包裹貨件 (MPS) 可用 可用 含其他查詢資訊
預估送達日期信心和風險分數 可用 可用 僅限部分 Premium 層級

 

Advanced Integrated Visibility 追蹤號碼訂閱的遮蔽資料欄位

摘要

客戶使用 Advanced Integrated Visibility 追蹤號碼訂閱而非 Advanced Integrated Visibility 帳號訂閱來訂閱貨件查詢更新時，特定資料欄位會被遮蔽，以維持客戶隱私並遵循資料安全政策。

此遮蔽動作可確保敏感資訊 (例如個人聯絡詳細資料、地址和財務值) 僅能由授權方存取。使用 Advanced Integrated Visibility 追蹤號碼訂閱的客戶將看到下方列出的遮蔽欄位顯示為「XXXXX」，即使該資料可透過 Advanced Integrated Visibility 追蹤號碼訂閱取得亦然。

此遮蔽涉及的內容包括：

  • 對寄件地/目的地詳細資料和相關當事方的能見度有限。
  • 缺少個人識別碼 (例如姓名、電話號碼) 和財務或海關相關的資料。
  • 為安全和法令規範而刻意保護專有或敏感的貨件資訊。

因為作業或業務使用案例而需要存取這些遮蔽欄位的客戶，建議使用其帳號訂閱。

Advanced Integrated Visibility 追蹤號碼訂閱中遮蔽的資料點：

掃描事件

  • scanEvent/location/locationContactAndAddress/address/streetLines
  • scanEvent/location/locationContactAndAddress/contact/phoneNumber
  • scanEvent/location/locationContactAndAddress/contact/companyName
  • scanEvent/location/locationContactAndAddress/contact/personName
  • scanEvent/previousEvents/[Array]/location/locationContactAndAddress/address/streetLines
  • scanEvent/previousEvents/[Array]/location/locationContactAndAddress/contact/phoneNumber
  • scanEvent/previousEvents/[Array]/location/locationContactAndAddress/contact/companyName
  • scanEvent/previousEvents/[Array]/location/locationContactAndAddress/contact/personName

託運人資訊

  • trackResult/shipperInfo/contactAndAddress/address/postalCode
  • trackResult/shipperInfo/contactAndAddress/address/streetLines
  • trackResult/shipperInfo/contactAndAddress/contact/phoneNumber
  • trackResult/shipperInfo/contactAndAddress/contact/companyName
  • trackResult/shipperInfo/contactAndAddress/contact/personName
  • trackResult/shipperInfo/account/value

收件人資料

  • trackResult/recipientInfo/contactAndAddress/address/postalCode
  • trackResult/recipientInfo/contactAndAddress/address/streetLines
  • trackResult/recipientInfo/account/value
  • trackResult/recipientInfo/contactAndAddress/contact/phoneNumber
  • trackResult/recipientInfo/contactAndAddress/contact/companyName
  • trackResultecipientInfo/contactAndAddress/contact/personName

寄件地和目的地地點

  • trackResult/originLocation/locationDetail/locationContactAndAddress/contact/personName
  • trackResult/originLocation/locationDetail/locationContactAndAddress/contact/phoneNumber
  • trackResult/originLocation/locationDetail/locationContactAndAddress/contact/companyName
  • trackResult/originLocation/locationDetail/locationContactAndAddress/address/streetLines
  • trackResult/originLocation/locationDetail/locationContactAndAddress/address/postalCode
  • trackResult/destinationLocation/locationDetail/locationContactAndAddress/contact/personName
  • trackResult/destinationLocation/locationDetail/locationContactAndAddress/contact/phoneNumber
  • trackResult/destinationLocation/locationDetail/locationContactAndAddress/contact/companyName
  • trackResult/destinationLocation/locationDetail/locationContactAndAddress/address/streetLines
  • trackResult/destinationLocation/locationDetail/locationContactAndAddress/address/postalCode

遞送和地址變更詳細資料

  • trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/address/streetLines
  • trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/address/postalCode
  • trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/address/gpsPodCoordinates
  • trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/contact/personName
  • trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/contact/phoneNumber
  • trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/contact/companyName
  • trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/address/streetLines
  • trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/address/postalCode
  • trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/contact/personName
  • trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/contact/phoneNumber
  • trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/contact/companyName

清關代理人資料

  • trackResult/broker/locationDetail/locationContactAndAddress/contact/phoneNumber
  • trackResult/broker/locationDetail/locationContactAndAddress/contact/companyName
  • trackResult/broker/locationDetail/locationContactAndAddress/contact/personName
  • trackResult/broker/locationDetail/locationContactAndAddress/address/streetLines
  • trackResult/broker/locationDetail/locationContactAndAddress/address/postalCode

包裹和財務詳細資料

  • trackResult/packageDetail/customsValue/value
  • trackResult/packageDetail/declaredValue/value
  • trackResult/packageDetail/originalTransportationCharge/value
  • trackResult/codDetail/codAmount/value

查詢和商品資訊

  • trackResult/inquiries/[Array]/categoryCode
  • trackResult/inquiries/[Array]/code
  • trackResult/inquiries/[Array]/createTime
  • trackResult/inquiries/[Array]/statusCode
  • trackResult/commodityInfo/[Array]/description
  • trackResult/commodityInfo/[Array]/code

包裹內容和回件原因

  • trackResult/contents/[Array]/partNumber
  • trackResult/contents/[Array]/partCode
  • trackResult/contents/[Array]/description
  • trackResult/contents/[Array]/quantity
  • trackResult/returnReason/[Array]/code
  • trackResult/returnReason/[Array]/description

帳單資訊

  • trackResult/billToParties/[Array]/billToParty/accountNumber

客戶享有的好處：

  • 接獲預估送達日期和送達時間範圍的即時變動通知，確保順利收取貨件。
  • FedEx 提供圖片簽收證明，減少客戶撥打電話詢問訂單狀態的成本，同時避免發生遞送爭議。
  • 提供近乎即時的貨件狀態通知，提升客戶體驗。
  • 接收即時貨件推播更新，不必持續查詢各貨件的最新狀態，提高營運效率。

功能和追蹤事件


查詢事件

此功能可追蹤貨件狀態，在貨件生命週期中主動通知客戶不同更新。此功能可提供多種選項，讓客戶選擇希望接收通知/警示的確切貨件程序/事件階段。可用的託運事件如下：

  • 託運：此選項可在選取的貨件事件發生時傳送通知。例如：已建立標籤、已取件等。
  • 運送中：此選項可傳送貨件運輸事件的通知。例如：運送中、物品由投遞站保管等。
  • 遞送：此選項可傳送貨件遞送事件的通知。例如：遞送途中、已送達等。
  • 例外狀況：此選項可傳送遞送的例外狀況通知。例如：清關延遲等。
  • 便利遞送選項：選取此選項可接收部分個人化追蹤事件的通知。例如：已接受由服務站保管的請求等。

如需有關可用貨件事件選項的詳細資訊，請參閱「Advanced Integrated Visibility 查詢事件的狀態代碼和狀態」表格。


簽收證明


此功能是用於確認訂單已經順利送達其預定的目的地。其中包括：

  • 圖片簽收證明 (PPOD)：PPOD 可讓客戶在包裹送達家門口時，收到顯示其包裹確切位置的圖片。
    Advanced Integrated Visibility 在 JSON 承載中會以 Base64 格式傳送 PPOD 影像。影像可以轉換為 JPEG 格式。

    附註：

    • PPOD 可在美國、加拿大、波多黎各、香港、紐西蘭、英國及愛爾蘭使用。
    • 圖片簽收證明 (PPOD) 僅適用於 FedEx Ground、FedEx Express，以及住宅包裹/地址。
    • 當不需要簽收證明 (SPOD) 時，則圖片簽收證明 (PPOD) 適用於合格遞送。PPOD 與簽收證明 (SPOD) 無法同時使用。
    • PPOD 適用於不須簽名 (NSR) 且不是直接交付客戶的遞送 (例如，在遞送期間直接交付給客戶)。
    • 圖片簽收證明 (PPOD) 支援 14000 到 33000 位元組的影像大小 (適用於 320x240 解析度影像)。

     

  • 圖片嘗試遞送證明 (PPODA)：PPODA 可在無法完成遞送時，讓客戶收到圖片，顯示其包裹遞送至哪個確切位置。Advanced Integrated Visibility 在 JSON 承載中會以 Base64 格式傳送 PPODA 影像。影像可以轉換為 JPEG 格式。
    • PPODA 適用於美國和波多黎各。
    • PPODA 僅適用於 FedEx Ground、FedEx Express，以及住宅和商業包裹/地址。
    • PPODA 影像可為：
      1. PPODA 影像，門上快遞通知單的照片。
      2. 前往遞送點時遇到阻礙 (即大門鎖住) 的照片。
      3. PPOD 影像，包裹已送達站點。
    • PPODA 支援 14000 到 33000 位元組的影像大小 (適用於 320 x 240 解析度)

    •  

  • 簽收證明 (SPOD)：SPOD 可讓客戶收到具有收件人簽章與其姓名、遞送日期、時間及地點的影像。SPOD 資訊將會以位元組陣列呈現，而非影像。位元組陣列為 base64 編碼字串，應經過解碼才可取得 PNG 格式的最終簽名圖像檔。
    • 簽收證明 (SPOD) 不適用於 Advanced Integrated Visibility 追蹤號碼訂閱。
    • 簽收證明 (SPOD) 影像大小為 4000 到 6000 位元組 (適用於 400x95 解析度影像)。
    • 簽收證明 (SPOD) 影像大小為 5000 到 8000 位元組 (適用於 230x150 解析度影像)。

    •  

  • GPS 簽收證明 (GPSPOD)：
    • GPS 簽收證明 (POD) 可讓客戶收到送達地點的地理座標。

      附註：GPSPOD 預設適用於 Advanced Integrated Visibility 帳號訂閱。

預估送達日期和送達時間範圍事件


此功能可透過提供貨件送達的日期和/或時間範圍，來協助貨件收件人規劃其行程。其中包括：

  • 預估送達日期 (EDD)：此選項可提供貨件的預估送達日期給收件人。範例：20XX 年 11 月 20 日。
  • 預估送達時間範圍 (EDTW)：此選項可向收件人提供貨件實際遞送當天的預估送達時間範圍。例如：下午 2:00 至下午 6:00。


事件型篩選


此功能可讓客戶根據貨件的付款方式整理其 Webhook 專案。選項如下：

  • 進口：針對將遞送給您，並由您以收件人身分付費的貨件，選取此選項。
  • 出口：針對將由您託運，並由您以寄件人身分付費的貨件，選取此選項。
  • 第三方：針對以您作為第三方付款方，向您收費的進口或出口貨件，選取此選項。

附註：您的 FedEx 帳號將用於為貨件收費或付費。如為第三方付款方，您可能不是寄件人或收件人，但我們會向您的 FedEx 帳號收取費用。


重試政策

此功能可在用戶端發生問題時，防止 FedEx 傳送查詢事件資料。FedEx 會保留資料，並嘗試每隔 5 分鐘重新傳送一次，共嘗試 3 次。

如果 FedEx 未在定義的時間範圍內收到成功回應，就會停止重新傳送該特定事件。但客戶可透過「Advanced Integrated Visibility Webhook 專案詳細資料」頁面的手動「重試」按鈕，請求過去 7 天期間遺漏的事件。

如需有關重試政策的詳細資訊，請參閱重試機制一節。

CLOSE

Response

Copy