Skip to main content
首頁博客指南購後服務供應商如何利用追蹤數據透過一個 API 為多個品牌提供服務

購後服務供應商如何利用追蹤數據透過一個 API 為多個品牌提供服務

17TRACK

購後服務供應商可透過一次追蹤 API 整合,為多個品牌提供服務:集中收集貨件更新、將每件貨件配對至正確的品牌及訂單,並透過每位客戶自有的渠道提供品牌專屬體驗。共享連接可簡化追蹤資料收集,但並不會免除每個品牌各自管理客戶資料、訊息規則、權限及服務流程的需要。

購後服務供應商如何使用追蹤資料提供服務

此模式適用於代理商、客戶支援平台、履約合作夥伴,以及其他代表多個商戶管理配送通訊的供應商。實際問題不只是單一 API 能否返回追蹤狀態,而是供應商能否將該狀態轉化為可靠且具適當品牌特色的行動,同時避免將一個客戶的資料顯示給另一個客戶。

共享 API 實際上能做甚麼

追蹤 API 為服務供應商提供一種程式化方式,可提交或查找貨件識別碼並接收追蹤資訊。供應商無需為每個商戶分別建立面向承運商的整合,而可透過一個共用的上游連接,將追蹤資料提供給自己的應用程式。之後,供應商的應用程式會判斷貨件屬於哪個品牌,以及應如何處理相關資訊。

這個區分十分重要。單一追蹤 API 並不等同於一個共用客戶賬戶、一個追蹤頁面或一套通知範本。上游整合負責資料收集,而服務供應商仍須負責其下游產品,包括商戶入駐、訂單配對、面向客戶的語言、存取控制、支援工具,以及已傳達訊息的記錄。

可行的架構分為三層。第一層是接收層,接受貨件參考資料並取得追蹤更新。第二層是內部貨件記錄,將更新連結至正確的商戶、訂單、承運商及收件人。第三層是呈現層,根據商戶規則決定是否更新訂單頁面、提醒支援人員或向客戶發送訊息。將這些層分開,可在不重寫追蹤連接的情況下,更容易加入另一個品牌。

追蹤一件貨件由登記到客戶行動的完整流程

假設一家供應商為兩間互不相關的網上商店管理配送更新。兩間商店都會向供應商發送貨件詳細資料,但每筆記錄都必須包含租戶識別碼,即供應商用來明確識別貨件所屬品牌的內部密鑰。供應商亦需要足夠資料將貨件配對至訂單。單靠追蹤號碼可能不是安全的全局密鑰,因為貨件可能涉及不同承運商、重複使用的識別碼,或原始訂單資料的更正。

  1. 登記貨件。接收品牌識別碼、訂單參考編號、追蹤號碼,以及配對所需的其他獲准資料。在請求追蹤資料前驗證輸入。實際可行時,將憑證及客戶聯絡資料與一般追蹤事件記錄分開儲存。
  2. 收集並保留來源更新。按照上游 API 的文件化方法取得追蹤資訊。保留來源狀態、事件描述、時間戳及位置(如有提供)。避免只以簡化標籤取代原始事件;支援團隊可能需要底層文字來調查異常。
  3. 謹慎進行標準化。將來源事件映射至一組精簡的內部狀態,例如運送中、派送中、已送達或異常。同時保留原始事件。概括狀態有助於自動化,但可能隱藏對客戶或支援人員重要的差異。
  4. 套用品牌規則。一個商戶可能希望收到派送中電郵,另一個商戶可能只想更新訂單頁面。應根據品牌設定、客戶通訊偏好、事件的新鮮程度,以及已發送訊息的歷史記錄,決定是否符合條件。
  5. 記錄結果。儲存哪個事件觸發哪項行動、套用了哪項品牌政策,以及向下游渠道傳送是否成功。這可為排查重複通知及客戶投訴提供追蹤記錄。

因此,同一個上游狀態可能會為不同品牌產生不同的行動。這正是共享服務模式的要點:集中收集及營運維護,同時保留每個商戶與其客戶的關係。

決定能否擴展的設計選擇

明確標示租戶擁有權

每件貨件、事件、訂單配對、通知規則及面向客戶的連結,都應可解析至特定租戶。資料進入系統時,以及應用程式或支援使用者讀取資料時,都要檢查租戶擁有權。品牌化商戶頁面不應只依靠追蹤號碼來決定要顯示哪個客戶記錄。存取權應由經驗證的商戶或適當限定範圍的客戶連結加以限制。

應根據上游供應商提供的實際賬戶模式,以及與每個商戶的合約關係,分開設定憑證及權限。單一技術整合並不會自動授予匯集所有商戶資料的權限,也不會讓每個客戶擁有相同的可見範圍。應記錄誰可以登記貨件、取得事件、匯出記錄及更改通知設定。

將追蹤事件視為更新,而非保證指令

追蹤資訊可能延遲抵達、以錯誤順序出現,或包含更正。如果系統每次讀取事件便發送新訊息,可能導致重複或誤導性的電郵。來源提供穩定事件密鑰時應使用該密鑰;否則應使用可用的貨件及事件欄位,制定文件化的去重規則。供應商觀察到更新的時間,應與來源報告的事件時間分開儲存。

不要假設每件貨件都會依照相同的狀態順序進行。異常之後可能獲得解決,而較晚抵達的事件可能描述較早發生的實體掃描。在使用某個狀態觸發承諾或升級處理前,應決定應用程式如何處理過時、互相矛盾或遺失的資訊。對於配送等面向客戶的聲稱,應顯示支持該聲稱的事件,而不是暗示內部標籤比來源記錄所說的更多。

規劃輪詢、回調及故障處理

供應商的更新策略必須遵循上游 API 的實際文件。如果相關賬戶及事件類型支援回調,應用程式仍須驗證傳入請求、處理重試,並安全地處理重複傳送。如果使用輪詢,則需要遵守文件化限制並避免不必要的重複請求的排程。無論採用哪種方式,當更新遺失或下游通知失敗時,仍然需要恢復機制。

HTTP 回應亦需要正確解讀。例如,已接受的請求不應被視為貨件已經收到新的追蹤事件的證明。HTTP 語義規範定義了回應代碼的含義;追蹤供應商自己的文件必須說明特定 API 回應對貨件登記或取得資料代表甚麼。應同時針對技術故障及業務故障建立監控,例如收到有效回應但無法將其配對至訂單。

選擇追蹤 API 前要確認的事項

對多品牌供應商而言,最佳整合方案是符合完整營運模式的方案,而不只是能返回範例追蹤結果的方案。要求準備合作的供應商展示其文件化 API 如何支援你實際處理的貨件及工作流程。簡短的概念驗證應包括多個商戶、這些商戶所使用的承運商,以及至少一筆不完整或有問題的貨件記錄。

  • 貨件接收:需要哪些識別碼及承運商資料?如何報告無效或重複提交?應用程式能否將自己的訂單或租戶參考資料與請求關聯,還是該關聯必須完全保留在其資料庫中?
  • 更新傳送:對相關方案而言,更新是被取得、被推送,還是兩者皆有?文件化的請求限制、重試要求、驗證方法及錯誤回應是甚麼?應根據最新文件核實,不要假設高層次描述的功能在每種設定中都可用。
  • 事件質素:會返回哪些原始欄位?應如何解讀時間戳、承運商名稱、位置及配送相關事件?應使用即將入駐商戶的真實貨件範例進行測試。
  • 租戶營運:供應商能否在自己的系統中按客戶分開存取權、使用量核算及支援調查?如需上游賬戶分離,應在確定架構前確認是否支援及如何支援。
  • 資料處理:必須向上游傳送哪些客戶或貨件資料?應與負責相關資料的各方檢視保留、刪除、安全及合約要求。包括 OWASP API Security Project 在內的 API 安全指引,可為檢視授權及存取風險提供有用基礎。

17TRACK 的追蹤 API 頁面及開發者文件,是供應商評估共享追蹤整合時的相關起點。應以文件作為實作細節的權威來源,並在圍繞其建立多客戶服務前,確認預期用途所需的方法、支援的貨件情況、存取條款及商業安排。單憑公開 API 頁面,並不能證明每個期望的商戶工作流程都獲支援。

供應商應保留控制權的範圍

追蹤資料可以協助形成購後體驗,但不應支配整個體驗。供應商應掌握貨件與商戶之間的配對、客戶聯絡規則,以及更新不確定時所使用的語言。如果事件只表示包裹抵達某個設施,品牌化訊息就不應承諾配送日期。如果追蹤停止更新,系統應區分缺乏新資訊與證明包裹遺失。

支援工作流程同樣值得重視。向獲授權的客服人員提供原始追蹤事件、標準化狀態、每項資料的記錄時間,以及通知歷史。這個檢視畫面可協助客服人員解釋客戶為何看到某則訊息,並決定問題是否需要進一步調查。這亦令多品牌營運更容易進行審核:問題可以追溯至上游更新、配對錯誤、商戶規則或訊息傳送失敗,而不是含糊地歸咎於 API。

先從小規模試點開始。連接一至兩個商戶,登記具代表性的貨件,並測試一般配送事件,以及異常、承運商資料遺失、重複更新及訂單更正等情況。確認每個品牌只能看到自己的貨件,並且失敗的通知可以重試而不會產生第二則客戶訊息。只有在這些行為變得可預測後,才加入更多商戶。單一 API 可以減少整合工作,但跨品牌的可靠服務源自其周邊建立的控制措施。

常見問題

單一追蹤 API 是否代表每個品牌都使用相同的追蹤頁面?

不是。API 可以向供應商的應用程式提供追蹤資訊,而每個品牌仍可保留自己的頁面設計、網域安排、客戶語言及通知規則。這些品牌化體驗必須分別實作及維護。

追蹤號碼能否單獨識別正確的品牌?

不應將其作為唯一的租戶識別碼。貨件進入系統時,應儲存明確的品牌或租戶密鑰,然後將追蹤號碼與該品牌的訂單記錄關聯。在顯示貨件資訊或發送訊息前,再次檢查該關聯。

供應商是否應為每個新的追蹤事件發送通知?

通常不應如此。有些事件會重複、延遲,或過於技術性,無法協助客戶。應定義符合條件的事件類型、抑制重複事件、檢查通訊偏好,並保留原始更新以供支援檢視。

加入另一個商戶前應測試甚麼?

測試商戶實際的貨件輸入、承運商組合、訂單配對、存取權限、通知規則及異常處理。加入追蹤資料遺失或延遲的情況,並確認任何貨件或客戶資料都不會跨入另一個商戶的賬戶。

來源