訂閱制電商品牌如何使用 Tracking API 追蹤定期發貨
要使用追蹤 API 追蹤定期出貨,請為每件實體包裹建立一筆出貨記錄,將其連結至該訂閱週期的履行訂單,並在倉庫或履行合作夥伴提供追蹤號碼後登記該號碼。使用 API 的追蹤更新向客戶顯示包裹所在位置,並為團隊標記配送例外情況。請將訂閱 ID 作為各週期之間的連結,而不要將其用作包裹的識別碼。

追蹤包裹,而不是訂閱
訂閱記錄客戶按計劃會隨時間收到的商品。履行訂單記錄某一週期需要寄出的商品。追蹤號碼則記錄特定包裹的資訊。將這些記錄分開,可避免某一週期延遲的出貨出現在下一週期的追蹤頁面上。
例如,假設五月訂閱盒分成兩個包裹,而六月訂閱盒已出貨,但其中一個五月包裹仍在運送途中。客戶應在五月訂單下看到兩個包裹,並在六月訂單下看到另一個獨立包裹。五月包裹的延遲更新只應更改五月包裹的狀態。如果寄出替換品,請建立新的出貨記錄並將其連結至原記錄,讓支援人員了解兩者同時存在的原因。
- 訂閱:儲存訂閱 ID,讓支援人員可以查找客戶的出貨歷史。
- 週期及訂單:記錄週期識別碼或預定履行日期、訂單 ID,以及將包裹配對至正確訂單所需的任何履行 ID。不要根據追蹤事件到達的日期推斷週期。
- 出貨:為每個包裹提供內部出貨 ID。儲存承運商及追蹤號碼、相關履行參考資料,以及供應商返回的任何追蹤登記 ID。不要在客戶目前的檢視中顯示已取消的標籤及已被取代的追蹤號碼,但應保留歷史記錄供支援人員查閱。
在訂單頁面上,除了訂單摘要外,亦應顯示包裹層級的進度。如果一個包裹已送達而另一個仍在運送途中,請明確說明。只有在完成訂單所需的所有包裹均已送達後,才將整張訂單顯示為已送達,同時考慮已取消的出貨及替換品。
將履行流程連接至追蹤 API
- 從履行事件登記。當履行系統、倉庫或第三方物流合作夥伴發送承運商及追蹤號碼時觸發登記。續訂付款時間太早:訂單可能仍在等待出貨,而且可能尚未有追蹤號碼。
- 在呼叫 API 前儲存出貨記錄。持久儲存內部出貨記錄,並將登記請求加入佇列。如果同一履行訊息到達兩次,請重用該記錄,而不是建立另一個包裹。如果 API 呼叫逾時,且供應商提供相關方式,請在重試前確認原始請求是否已成功。
- 將更新配對至已登記的包裹。如果更新中返回供應商的登記識別碼,請使用該識別碼。否則,請根據其文件指定的識別碼進行配對,並使用出貨記錄驗證結果。如果某項更新可能屬於多筆記錄,請將其送交審核,而不要套用至最新訂單。
- 將標籤建立與承運商運送分開。承運商確認接收包裹前,追蹤號碼可能已經存在。若目前只有標籤,請使用「準備交予承運商取件」等訊息。只有在有承運商資料支持時,才使用「運送中」。
17TRACK Tracking API 是此設定的一個選項。其開發者文件是登記追蹤號碼及接收追蹤更新的參考資料。使用這些更新維護系統中的包裹記錄;週期分配、訂單完成及客戶通知規則則應保留在電商應用程式中。推出前,請使用來自實際承運商路線及履行合作夥伴的包裹進行測試,而不要只依賴承運商清單。
確保更新可安全處理兩次
如果供應商提供 webhooks,請使用它們接收更新,而不要持續輪詢每個包裹。Webhook 是供應商發送至應用程式的 HTTP 請求。遵循供應商的驗證要求,持久儲存已接受的 payload,並根據其文件所述的回應規則確認請求。更新訂單檢視或發送電郵等較慢的工作,應在請求處理常式之外執行。
建立處理流程,讓重複更新不會產生額外影響。如果供應商提供穩定的事件 ID,請使用它們識別重複項目。如果供應商發送的是追蹤快照而非個別事件,請在採取行動前,將傳入狀態及掃描歷史與現有資料比較。客戶訊息應獨立去重:已發出的送達通知不應因相同出貨資料被處理兩次而再次發送。
請將掃描發生的時間與應用程式接收掃描的時間分開記錄。較晚到達的運送中掃描可以加入包裹歷史,但不應取代較新的已送達狀態。不過,不要假設每項合法變更都會令包裹狀態向前推進。承運商更正或退回寄件人更新可能需要更改顯示內容。如果新資料與已儲存狀態衝突,而你無法判斷哪一項正確,請將出貨放入審核佇列。
定期檢查可能需要處理的未完成出貨:仍在等待登記的出貨、預期交接後仍沒有首次掃描的包裹,以及追蹤長時間沒有更新的出貨。如果 API 支援查詢或刷新,請在供應商限制內選擇性地使用。升級個別配送個案前,先檢查不同承運商及倉庫的整體模式。如果許多不相關的出貨同時停止更新,請先調查整合流程,而不是逐一開啟配送個案。
將追蹤資料轉化為實用的客戶訊息
客戶通常不需要每次掃描都收到電郵。先從與客戶需要知道或採取的行動相關的訊息開始:包裹已進入承運商網絡、配送嘗試需要採取行動,或承運商報告已送達。顯示訂單參考資料及相關包裹或週期,讓訂閱客戶能分辨訊息涉及哪一件出貨。對於拆分訂單,請識別包裹,並清楚說明訂單其餘部分是否仍在運送途中。
- 已建立標籤,沒有掃描:將預期交接情況與倉庫記錄核對。如果交接時限已過,請要求履行團隊確認包裹是否已離開設施,然後才告知客戶包裹在運送途中延遲。
- 追蹤停止更新:使用反映路線及服務的門檻,而不要為每個包裹使用同一個計時器。對於跨境出貨,請先檢查承運商最後一項事件,再決定是否聯絡客戶或升級處理。
- 嘗試配送失敗或需要取件:如果承運商提供清晰指示,請告訴客戶需要採取的行動。如果事件資料含糊,請將個案轉交支援,而不要猜測重新配送日期或取件地點。
- 標記為已送達但未收到:保留承運商報告的狀態,並另行開立支援個案。支援流程應區分客戶報告與承運商更正。
為支援人員提供週期、訂單、包裹歷史及已發送訊息的單一檢視。對於每項例外情況,指定負責人及下一步行動。履行團隊可以調查交接遺失問題,物流團隊可以跟進承運商例外情況,而支援團隊可以處理客戶溝通。追蹤狀態描述的是包裹情況;它不會決定是否應提供替換品或退款。
推出前測試週期重疊情況
先從一個履行合作夥伴及一組反映其實際出貨方式的出貨開始。包括一個含多個包裹的週期、一個已作廢的標籤、一件替換品,以及下一個週期出貨時仍未完成的較早出貨。然後刻意重播重複的 webhook,並在較新的事件之後傳送較舊事件。檢查包裹記錄、客戶訂單頁面、支援檢視及通知記錄。只驗證 API 成功回應的測試,可能會漏掉代價最高的錯誤:更新錯誤訂單或向錯誤客戶發送訊息。
監控登記失敗、符合條件且成功登記的包裹比例、晚於預期的首次掃描,以及未配對的更新。如果追蹤更新延遲,請區分承運商事件發生至系統接收之間的時間,以及系統自行處理所需的時間。這有助於判斷應調查承運商資料流、webhook 端點,還是應用程式內的佇列。
當你能夠針對任何包裹回答三個問題後,再擴展至更多路線:它屬於哪個週期?承運商最後報告了甚麼?如果更新遺失或錯誤,由誰採取行動?如果任何答案不清晰,請先修正記錄配對或例外處理流程,再增加更多通知規則。
常見問題
追蹤 API 可以告訴客戶下一個訂閱盒何時出貨嗎?
下一個計劃出貨日期應使用訂閱時間表及履行系統。追蹤 API 用於特定包裹,而且要在追蹤資訊存在後才適用。計劃出貨日期、承運商配送預計時間及已確認的送達是不同事實,應分開標示。
如果倉庫在電郵發出後更換追蹤號碼,該怎麼辦?
將舊標籤標記為已被取代,並將新追蹤號碼連結至同一訂單。如果電郵連結至訂單層級的追蹤頁面,請更新該頁面,讓客戶無需原始承運商連結也能找到目前有效的包裹。如果變更影響客戶需要採取行動的資訊,請發送更正通知。
如果履行合作夥伴在沒有承運商代碼的情況下發送追蹤號碼,該怎麼辦?
要求合作夥伴提供一致的承運商欄位,或提供其配送服務代碼的對應表。如果你的 API 提供承運商識別功能,請先確認該功能處理合作夥伴標籤的效果,再依賴它。對於含糊的配對,請送交審核,而不要單憑追蹤號碼選擇承運商。
已暫停或跳過的訂閱需要追蹤記錄嗎?
從未出貨的週期不需要建立包裹記錄。如果之前的出貨仍未完成,即使訂閱已暫停、跳過或取消,也應繼續追蹤。訂閱狀態控制未來的履行流程;它不會告訴你已離開倉庫的包裹發生了甚麼事。
來源
- 17TRACK Tracking API — 將包裹追蹤整合至商業系統的產品概覽。
- 17TRACK Tracking API documentation — 登記追蹤號碼及接收追蹤資料的實作參考。
- Stripe webhook documentation — 一般 webhook 實務參考,例如處理重複事件及避免假設配送順序。請遵循你的追蹤供應商自身的驗證及確認規則。


