Skip to main content
首頁博客指南為什麼二手交易平台需要貨件追蹤 API?

為什麼二手交易平台需要貨件追蹤 API?

17TRACK

當送貨更新不應只支援追蹤連結時,二手交易平台便需要貨件追蹤 API。透過將貨件事件引入平台自己的系統,API 可以幫助買家追蹤購買的商品、賣家展示寄貨進度,以及支援團隊調查送貨問題。其最大價值在於將貨件可見度與平台營運連繫起來,而不會將追蹤資料視為商品身份、狀況或真偽的證明。

為甚麼二手交易平台需要貨件追蹤 API

對產品經理、工程團隊及平台營運人員而言,決定不只是是否顯示包裹位置,而是共享的貨件記錄能否改善平台處理賣家寄貨、買家溝通、送貨異常及爭議的方式。

為甚麼二手貨運會造成不同的可見度問題

二手交易平台可能需要協調眾多個人賣家之間的交易,而不是從受控的倉庫統一發貨。賣家可以使用不同承運商、透過不同渠道購買標籤,並在不同時間交付包裹。因此,平台需要區分賣家所報告的資料與承運商所記錄的資料。

轉售也會改變送貨出現問題時的處理方式。某件特定的二手外套、收藏品或翻新商品,可能沒有完全相同的替代品。支援團隊需要清楚掌握貨件情況,才可決定調查方向或向買家解釋下一步。

以一宗示例交易為例:賣家將一部二手相機標記為已寄出,並輸入追蹤號碼。承運商最初只顯示電子貨件資料。其後出現收件掃描,接着是派送嘗試。這些事件代表不同的營運狀態。若將所有狀態都簡化為「已寄出」,買家便無法獲得充分資訊,支援團隊也缺乏採取行動的依據。

追蹤 API 可以讓平台內部取得這些區分。平台仍須根據自身規則決定每個事件的含義。

貨件追蹤 API 的功能與限制

貨件追蹤 API 提供一種程式化方式,用於提交貨件識別資料及取得追蹤資訊。視乎服務及整合方式,更新可以透過 API 請求、webhook 通知,或兩者結合取得。Webhook 是當有更新可用時發送至應用程式的訊息。

有用的輸出不只是承運商最新的狀態文字,而是平台可以與訂單、賣家、買家及支援個案關聯的貨件歷史。

  • 買家體驗:在訂單頁內顯示進度,毋須買家解讀不同承運商網站的資料。
  • 賣家營運:區分已提交的追蹤號碼與已有承運商活動記錄的貨件。
  • 支援流程:將貨件事件與交易詳情及過往通訊一併顯示。
  • 異常處理:將特定送貨問題分派至調查隊列。
  • 營運報告:利用清晰定義的里程碑分析寄貨及送貨模式。

這些只是可能的應用,並非自動產生的結果。追蹤整合本身不會建立爭議政策、保證送貨、驗證包裹內容或提供貨件保險。同樣,購買標籤、安排收件、計算郵資及追蹤包裹也是不同的功能。不要假設一個 API 包含所有功能。

共享追蹤資料可改善的五種平台流程

1. 將賣家聲明與承運商活動分開

「賣家表示已寄出」與「承運商記錄了收件」應在訂單記錄中作為兩項獨立事實。建立標籤事件一般不應被呈現為承運商已實際持有包裹的確認。

分別保留賣家的寄貨聲明、提交追蹤資料的時間,以及任何相關承運商事件。這讓支援團隊可以解釋為何沒有收件掃描,而不會立即指責賣家未有寄貨。掃描缺失或延遲需要調查,而不是自動下結論。

2. 在避免製造錯誤確定性的同時,向買家提供有用更新

買家需要知道發生了甚麼變化,以及是否需要採取行動。收件掃描可能只需在訂單頁安靜地更新。可取件事件可能值得發出通知,而派送不成功則可能需要更清楚地解釋下一步。

通知應反映實際收到的資料。沒有提供送貨日期時,不要自行編造日期。如有預計日期,應標明為估算值並保留其來源。避免將追蹤描述為持續即時:更新取決於承運商事件、資料可用性及整合的處理行為。

3. 整理送貨異常

等待取件的包裹與正在退回寄件人的包裹需要不同處理。不要將每件未送達貨件都放入單一問題隊列,而應根據可採取行動的狀況定義不同隊列。

  • 沒有收件記錄:檢查賣家的交付資料及承運商指引。
  • 派送不成功:顯示任何可用的重新派送或取件指示。
  • 等待取件:可靠的取件資訊可用時通知買家。
  • 退回途中:將訂單分派至相關退貨或支援流程。
  • 已送達但有爭議:保留送達事件並開立獨立調查。

在可行的情況下,按貨運服務及路線設定不活躍門檻。單一通用延遲規則可能會為較慢的服務製造不必要警報,同時忽略較快服務的問題。

4. 支援爭議及款項發放決定

貨件事件可以納入交易時間線,但不應成為財務決定的唯一依據。已送達掃描不能證明包裹內是正確商品,亦不能證明商品與刊登內容相符。

如送貨事件會觸發款項發放流程,應使用獨立的政策層。該層應考慮平台公布的條款、適用要求、未解決爭議及審查程序。合理的設計應允許異常暫停自動操作,而不是事後迫使支援團隊撤銷操作。

5. 讓退貨旅程變得可見

退貨貨件是一段新的物流旅程。應將其與原始交易關聯,但為它建立獨立的貨件記錄及方向。否則,退貨的送達事件可能被誤認為商品已送達買家。

退貨追蹤可以確立運輸里程碑,但不能證明退回的商品是否為原商品,或其狀況是否已改變。這些問題需要獨立的檢查或證據流程。

實際的整合設計

應以貨件而非訂單上的單一追蹤欄位為整合基礎。一張訂單可能包含多個包裹,交易日後也可能產生退貨貨件。

  1. 建立貨件記錄。將其與訂單及賣家關聯。儲存追蹤號碼、已知的承運商、旅程方向及相關時間戳。
  2. 檢查提交的資料。捕捉空值、明顯格式問題及非預期重複資料。不要將看似合理的號碼視為真實貨件的證明。
  3. 註冊或取得追蹤資料。遵循所選供應商記錄的流程。將不支援、含糊不清及暫時不可用的結果分開處理。
  4. 可靠地接收更新。對於 webhook,使用供應商支援的驗證或認證機制。在適當情況下,透過持久化隊列處理已接受的訊息。
  5. 保留來源事件。將原始狀態文字與標準化狀態一併儲存,並設定存取及保留控制。
  6. 套用平台規則。從自己的政策層產生買家更新、支援任務及審查請求。
  7. 調查缺失更新。使用獲准的取得方法及營運警報調查缺口,而不是假設每項通知都會成功送達。

應為重複訊息及次序錯亂的事件作好設計。重新處理同一事件不應再次發送買家通知或觸發第二次財務操作。將事件的時間戳與系統接收時間分開;兩者回答的是不同問題。

追蹤號碼不應用作公開授權憑證。限制未經授權人士存取貨件記錄,在伺服器上保護 API 憑證,並避免在通知或應用程式日誌中暴露不必要的收件人資料。

如何評估適用於二手交易平台的 API

先從能代表實際賣家群組的貨件開始。廣泛的承運商清單,不及成功處理平台實際使用的服務、路線及事件類型有參考價值。

  • 承運商及服務適配度:測試賣家實際使用的服務,包括相關的國際交接及退貨旅程。
  • 狀態解讀:檢查應用程式能否在相關事件可用時,區分電子貨件資料、收件、運輸、派送嘗試、取件、送達及退貨。
  • 事件詳情:檢查時間戳、來源描述,以及修正或延遲事件的呈現方式。
  • Webhook 營運:在文件中核實認證選項、送達行為、重試處理及復原程序。
  • 整合限制:確認請求限制、註冊要求、錯誤回應及測試選項。
  • 資料管治:檢視存取控制、保留條款、合約責任及整合實際需要的資料。
  • 商業模式:確認哪些項目會收費、如何處理重複請求,以及用量超過約定額度時會發生甚麼。

17TRACK 的 Tracking API page 及 official API documentation 是評估其 API 產品的相關起點。使用這些資源,根據貨件樣本及技術要求檢查整合。在作出承諾前確認服務覆蓋範圍、商業條款及營運限制;本指南不會為特定帳戶或實施方式確立這些細節。

對於自訂平台,應評估 API 整合本身,而不是假設消費者追蹤頁面或店面應用程式能符合後端要求。重要問題是貨件資料如何進入訂單模型,以及如何驅動受控操作。

何時值得實施 API

當支援團隊反覆查閱承運商網站、買家缺乏一致的訂單檢視,或貨件事件需要觸發內部流程時,追蹤 API 便更值得投資。當手動追蹤檢查逐漸成為營運依賴時,這一點尤其重要。

運送量有限的小型平台,可以合理地先使用經驗證的追蹤連結及有文件記錄的手動流程。API 不能取代清晰的賣家寄貨要求或可行的爭議政策。自動化不清晰的流程,只會令不一致的決定更快發生。

在擴大使用前先進行受控試行。包括正常送貨、沒有收件掃描、送貨不成功、退貨途中、重複更新,以及已送達但有爭議的個案。檢查每種情況是否產生預期的買家訊息及支援操作。

除了技術交付,也要衡量業務成果。有用的指標包括每宗已寄出訂單的貨件狀態查詢數量、調查處理時間、重複通知頻率,以及具備可用里程碑資料的貨件比例。在推出前定義每項指標,並比較相似的貨件群組。單獨一次成功的 API 回應,不能證明平台體驗有所改善。

常見問題

追蹤 API 可以證明賣家寄出的是正確商品嗎?

不可以。追蹤描述的是包裹報告的旅程,而不是其內容。收件或送達事件可以支援寄貨時間線,但商品身份及狀況需要其他證據。

送達後是否應自動發放賣家款項?

只有當該操作符合平台政策及適用要求時才可以。將款項發放邏輯與追蹤資料接收分開,並提供讓爭議或審查條件暫停原本自動操作的方法。

追蹤號碼沒有更新時應怎樣處理?

顯示沒有可用的承運商更新,而不是自行編造進度。檢查號碼及承運商,區分電子標籤資料與收件,並在將貨件分類為遺失前遵循相關服務的指引。

Webhook 單獨使用是否足夠?

Webhook 可以支援事件驅動的更新,但應用程式仍需要重複處理、監控及復原程序。在供應商允許的情況下,調和請求可以幫助調查缺失或不一致的更新。

同一整合可以追蹤買家退貨嗎?

如果支援退貨承運商及服務,便有可能。建立與原始訂單關聯的獨立退貨貨件,並區分送達賣家與送達買家。

來源

以下官方資源為上述 17TRACK 評估提供產品及實施參考。指南中的流程建議屬編輯指引,並非任何特定平台政策或保證產品結果的聲明。