Skip to main content
首頁博客指南3PL及履約服務商如何在客戶帳戶之間使用貨件追蹤API

3PL及履約服務商如何在客戶帳戶之間使用貨件追蹤API

17TRACK

3PL及履單服務供應商會使用貨件追蹤API,收集屬於多個客戶的貨件承運商更新,然後將每項更新傳送至正確的客戶帳戶、訂單、支援團隊及報告檢視。API提供追蹤資料;供應商自己的系統則必須維護客戶擁有權、控制存取權限、處理例外情況,並決定每位客戶及購物者可以看到的內容。

3PL及履單服務供應商如何使用貨件追蹤API

當一個倉庫營運服務多個商戶時,這項區分尤其重要。單靠追蹤號碼並不能識別客戶帳戶。要在不同帳戶之間提供可靠的可見性,履單服務供應商需要記錄每件貨件的擁有者,並建立可重複執行的流程,將承運商更新轉化為針對特定客戶的資訊。

基本工作流程:登記、接收、分流、處理

行動負責人通常是3PL的營運或工程團隊。團隊會先整合追蹤服務,然後利用倉庫管理系統、訂單管理系統或整合層,將追蹤記錄連接至個別客戶。實際工作流程分為四個階段:

  1. 登記貨件。建立標籤或將包裹交予承運商時,供應商會儲存追蹤號碼、承運商資料(如有)、客戶帳戶ID、訂單參考編號及任何內部貨件ID。供應商會使用已記錄的方法,將追蹤詳情提交至其追蹤整合服務。
  2. 接收更新。整合服務透過API實際支援的方法取得新的追蹤資料。視乎服務及設定,這可能包括查詢目前狀態、接收變更通知,或兩者兼有。
  3. 分流及解讀。供應商會將返回的追蹤記錄與內部貨件ID及客戶帳戶進行配對,儲存承運商的訊息,並將其映射至有限的營運狀態集合,同時保留有用的詳細資料。
  4. 採取行動。正確的客戶可以查看進度,客戶服務團隊可以回覆查詢,營運團隊則可以調查例外情況。面向購物者的更新應使用該客戶批准的渠道及訊息規則。

關鍵的設計決策發生在首次API請求之前:每件貨件都需要在3PL記錄中有一個明確無誤的擁有者。沒有這項連結,追蹤回應即使在技術上正確,也可能無法使用,或被錯誤的商戶看見。

將客戶擁有權與追蹤身份分開

多客戶資料模型應區分客戶帳戶、訂單、內部貨件、承運商及追蹤識別碼。這些資料彼此相關,但不能互相替代。一張訂單可以產生多個包裹;包裹可能在承運商出現有意義的掃描記錄之前便已有追蹤號碼;而同一客戶在不同訂單中也可能使用不同承運商。

例如,若倉庫為商戶的一張訂單派送兩個包裹,訂單頁面可能需要顯示兩條獨立的貨件時間線。如果其中一個包裹遇到派送例外,3PL應識別受影響的包裹,而不是將整張訂單標記為無法派送。即使面向客戶的訂單參考編號在不同客戶之間並不唯一,內部貨件ID仍可為這些記錄提供穩定的連接點。

將客戶帳戶ID與貨件記錄一同儲存,並在建立、取得、匯出記錄或將記錄傳送至其他系統時執行存取檢查。不要將追蹤號碼作為唯一授權鍵。追蹤號碼是營運識別碼,而不是憑證;共用儀表板不得僅因使用者知道某個號碼,便顯示某商戶的訂單。

如果客戶管理自己的承運商或提供自己的憑證,請決定這些憑證的儲存位置,以及哪些帳戶可以使用這些憑證。單一追蹤整合並不代表所有客戶都共用相同的承運商協議、資料權限或客戶溝通偏好。這些界限需要反映在設定中並經過測試。

將承運商訊息轉化為可供客戶使用的狀態

承運商的事件描述各不相同。3PL可能希望使用一組通用標籤,例如已建立標籤、運送中、派送中、已送達及例外,用於儀表板及例外佇列。這種映射是應用程式層面的決策,不能取代原始事件。請保留來源狀態、事件時間(如有提供)、承運商身份及位置(如有),讓支援人員可以了解實際發生的事情。

不要將每項新訊息都視為進度向前推進。更新可能延遲到達、描述較早的掃描,或重複已接收的事件。對於每項傳入更新,整合服務應檢查其是否屬於已知貨件、是否為重複內容,以及其事件時間是否改變了時間線。最新收到的訊息不一定是最近發生的事件。

同樣地,不應將「已送達」誇大為預定收件人親自接收了包裹。派送掃描的含義取決於承運商的事件詳情,以及該貨件可取得的送達證明資料。面向客戶的介面應顯示現有證據,而不是推斷超出資料支持範圍的內容。

一種實用做法是同時保留用於篩選的標準化狀態,以及用於調查的底層承運商事件。通用狀態可協助3PL在多個客戶帳戶中找出需要處理的貨件;原始詳細資料則可協助員工解釋個別貨件,而不會將廣泛分類誤解為錯誤結論。

根據問題由誰可以解決來設計例外處理

當追蹤資料改變團隊下一步的行動時,追蹤才具有營運價值。派送例外可能需要通知客戶、查詢承運商、核對地址,或在等待後續掃描期間暫不採取即時行動。正確回應取決於事件,以及3PL與其客戶之間分配的責任。

在建立警報前,先為常見情況設定擁有權規則。例如,對於看似在交接前停滯的包裹,3PL可能負責調查;而對於購物者要求更改派送地址的請求,則由商戶處理。這些只是可能的安排,並非普遍適用的規則。每家供應商都應記錄自己的服務界限及升級處理路徑。

通知規則也需要防護措施。為每次掃描發送訊息可能會令員工及購物者不堪重負;然而,抑制所有重複狀態也可能掩蓋位置的重大變化或新的例外情況。請定義哪些事件會進入營運佇列、哪些只會顯示在儀表板,以及哪些可能觸發客戶或購物者通訊。當規則需要檢討時,應讓員工可以查看底層追蹤時間線。

選擇或實施API時需要核實的事項

當3PL需要在自己的系統內取得貨件更新,而不是要求員工分別查看每家承運商時,追蹤API便很適合使用。採購問題不只是API是否會返回狀態,而是其記錄的行為是否支援供應商實際的貨件組合及帳戶工作流程。

  • 承運商及貨件適配性:檢查客戶使用的特定承運商及運送服務。確認API如何識別承運商,以及當追蹤號碼不明確或尚未有事件時會發生甚麼情況。
  • 更新傳送:查閱取得變更的記錄選項、預期請求及回應格式,以及應如何處理失敗或重試。如果可使用事件通知,應驗證其驗證及重試行為,而不要假設它們可以消除所有後續請求。
  • 帳戶映射:確定供應商能否將自己的參考資料附加至追蹤記錄。無論API具備哪些功能,都應保留從追蹤記錄到客戶帳戶及貨件ID的內部映射。
  • 資料詳細程度:檢查範例回應中的事件、時間戳記、承運商描述、位置及營運與支援所需的派送資料。確認哪些欄位可能缺失。
  • 營運限制:檢查記錄的驗證方式、使用限制、錯誤回應,以及與預期貨件量相關的商業條款。未經測試預期的請求模式,不要根據標題價格估算成本。
  • 安全性及保留:決定誰可以存取追蹤歷史、如何保護憑證、記錄保留多久,以及客戶如何接收或匯出自己的資料。

17TRACK的追蹤API頁面及開發者文件,是供應商評估多承運商追蹤整合時的相關起點。它們的存在並不代表該服務會管理3PL的客戶權限或帳戶結構。請在文件及測試整合中核實目前的API行為,然後在3PL自己的應用程式中實施租戶擁有權及存取控制,除非已確認某項特定且受支援的安排。

小型試點比功能清單揭示更多資訊

在連接所有客戶帳戶之前,先使用一組刻意混合的貨件進行試點。當中應包括多於一個客戶、這些客戶實際使用的承運商、多包裹訂單、尚無初始掃描記錄的追蹤號碼,以及抵達一般派送狀態和例外狀態的貨件。請將試點資料與生產通訊分隔,避免測試意外向購物者發送訊息。

追蹤每件貨件從倉庫記錄、追蹤登記到客戶檢視的完整流程。提出具體問題:正確帳戶是否擁有該記錄?另一個帳戶能否透過儀表板、搜尋、匯出或通知看到它?舊掃描是否正確放置在事件時間線中?如果追蹤服務暫時拒絕請求或沒有返回新資料,會發生甚麼情況?支援人員是否仍能識別承運商的原始措辭?

將答案記錄為驗收標準,而不是主觀印象。成功的試點應證明3PL能夠識別每件貨件的擁有者、顯示有用事件、從常規整合失敗中恢復,並將例外情況分流至正確團隊。如果未能符合這些條件,增加更多客戶帳戶只會放大問題,而不是解決問題。

最持久的架構會將追蹤視為共用資料輸入,並在其周圍建立針對客戶的控制。API有助於取得貨件資料;3PL則仍然負責將該資料連接至訂單、保護帳戶界限,以及令資料可供採取行動。

常見問題

3PL可以為多個客戶使用一個追蹤API整合嗎?

有可能,只要API的條款及技術模型支援預期用途。3PL仍需要識別每件貨件的擁有客戶,並在其所有系統中執行這項界限。請向API供應商確認帳戶、憑證及商業要求,不要假設一次整合便允許所有安排。

客戶帳戶應否共用同一個追蹤儀表板?

它們可以共用同一個底層應用程式,但每位客戶只能查看獲授權存取的貨件及資料。請測試搜尋、匯出、通知、支援工具及API回應中的隔離情況,而不只是主儀表板頁面。

如果追蹤號碼沒有即時返回更新,應怎樣處理?

保持貨件與訂單及客戶帳戶的連結,顯示準確的待處理狀態,並按照API的記錄指引再次查詢。承運商活動出現之前,標籤可能已經存在;不應自動將沒有掃描記錄呈現為包裹遺失。

追蹤API是否足以發送品牌化派送更新?

不足。追蹤資料可以提供觸發更新的事件,但3PL或商戶還必須決定由誰發送、適用哪個客戶品牌、哪些收件人獲准接收,以及訊息應包含甚麼內容。這些通訊及帳戶規則並不屬於追蹤事件本身。

多客戶推出方案時首先要建立甚麼控制?

建立並測試每個內部貨件ID與其擁有客戶帳戶之間的連結。在所有可以查看或分發追蹤資料的地方套用擁有權檢查。這是可靠報告、支援工作流程及帳戶隔離的基礎。

資料來源