Skip to main content
首頁博客指南海外倉如何使用追蹤 API 監控本地配送

海外倉如何使用追蹤 API 監控本地配送

17TRACK

海外倉庫可以透過連接每件出庫包裹的承運商及追蹤編號,將追蹤事件帶入倉庫或訂單管理系統,並將配送異常轉化為已分配的任務,從而使用追蹤 API 監察本地配送。最實用的設定會區分標籤建立與承運商接收,保留貨件歷史,並告知營運團隊哪些包裹需要處理,而不只是哪些包裹出現新狀態。

海外倉庫如何使用追蹤 API 監察本地配送

本指南專注於在商戶本土市場以外持有庫存,並向目的地市場的客戶出貨的倉庫。對這些團隊而言,海外追蹤需要將倉庫出庫記錄與本地承運商的配送流程連接起來。這種連接有助於倉庫經理、運輸協調員及商戶支援團隊使用同一份貨件記錄。

界定倉庫可見性結束及承運商可見性開始的位置

倉庫管理系統可以記錄訂單已完成揀貨、包裝、貼標及放置於出貨區。這些記錄本身並不能證明承運商已接收包裹。追蹤 API 可以加入由承運商報告的事件,但不能取代倉庫交接記錄,也不能製造從未發生的實體掃描。

將三個里程碑分開:準備收件、根據倉庫記錄已交接,以及根據承運商追蹤事件已接收。這種區分有助於調查內部看似已出貨、但承運商沒有任何動態的包裹。

例如,如果包裹出現在收件清單上,但沒有接收事件,下一步應檢查裝載記錄並聯絡收件承運商。此時將包裹歸類為遺失還為時過早。如果承運商已報告配送嘗試失敗,適當的處理方式則不同:調查原因,並與商戶或獲授權的收件人聯絡人協調下一步。

連接 API 前建立貨件記錄

基礎是建立客戶訂單、實體包裹及承運商追蹤識別碼之間可靠的關係。不要以訂單編號代替包裹識別碼。一張訂單可能會以數個包裹離開倉庫,而替換貨件亦需要有自己的記錄。

記錄建議欄位營運用途
貨件身份內部貨件 ID、訂單 ID、包裹 ID、商戶帳戶區分拆分貨件及不同客戶。
承運商身份承運商識別碼、追蹤編號、已知的服務類型提交正確的追蹤請求並分流調查。
倉庫交接倉庫、出貨時間、收件參考編號、清單參考編號將實體出貨證據與承運商事件進行比較。
追蹤歷史原始事件、對應狀態、事件時間、接收時間、提供的位置保留證據,並區分事件時間與報告延遲。
異常工作流程問題類型、負責人、下一步行動、檢視期限、解決方案將追蹤資訊轉化為有明確負責人的工作。

以文字格式儲存追蹤編號,以保留其格式。如果倉庫已在建立標籤時知道承運商,應透過整合傳遞該身份,而不是單靠編號識別。同時保留原始、替換、退貨及後續配送包裹之間的關係,而不要覆蓋各自的歷史記錄。

選擇適合倉庫承運商組合的整合方式

倉庫可以直接與承運商整合,或使用多承運商追蹤 API。對於使用少量承運商且運作穩定的業務,直接整合可能較為實際,尤其是在需要承運商特定資料時。當倉庫需要跨多個配送網絡使用共用追蹤介面時,則值得評估多承運商 API。

17TRACK 的 Tracking API 是這種整合模式的合適選項。使用其官方 API 文件,評估貨件登記、追蹤資料擷取及追蹤更新如何配合你的系統。確認每個倉庫實際使用的承運商及服務組合,不要將一般承運商可用性視為必定會返回所有所需事件的證明。

根據實際營運要求評估連接:

  • 你的系統能否可靠登記出貨高峰期間產生的包裹?
  • 你實際購買的本地配送服務會返回哪些事件?
  • 如何處理失敗請求、重複登記及無效承運商識別碼?
  • 如何傳送或擷取更新,以及如何核對遺漏的更新?
  • 你的帳戶適用哪些使用限制、保留條款、安全控制及商業條件?

不應假設追蹤連接包括購買標籤、更正地址、重新安排配送或提交索償。除非相關產品文件明確確認,否則應將這些視為獨立工作流程。

連接出貨、追蹤更新及異常處理

1. 在受控的出貨里程碑登記包裹

選擇一致的登記觸發點,例如標籤確認或出貨確認。在建立標籤時登記,可以暴露仍未收取的包裹,但亦需要處理已取消的標籤。只在出貨後登記,可以減少未使用的登記,但可能掩蓋標籤建立與實體交接之間的時間段。

無論選擇哪個觸發點,都應將登記結果儲存至包裹記錄。登記失敗應進入重試或更正佇列,而不是消失在應用程式記錄中。使用穩定的內部識別碼,避免重複處理產生重複的業務記錄。

2. 接收更新,但不要讓儀表板成為唯一真相來源

根據 API 文件所列的選項,更新可能透過請求擷取,或透過 webhook 通知接收。Webhook 是供應商有更新時傳送至你系統的訊息;輪詢則是由你的系統請求資料。

對於基於 webhook 的實作,應使用供應商文件所述的驗證方式驗證傳入訊息。在確認接收前,先可靠地儲存已接受的訊息,然後以非同步方式處理。應針對重複訊息及次序錯亂的事件進行設計。遵循文件所列的回應及重試要求,不要假設每個供應商的行為都完全相同。

對於輪詢,應優先處理活躍貨件及未解決的異常,同時遵守適用的使用限制。在支援的情況下,使用核對請求檢查更新歷史似乎不完整的貨件。將資料接收失敗與承運商配送異常分開記錄:連接故障不代表包裹已停止移動。

3. 標準化狀態,同時保留原始證據

建立一小組營運類別,例如等待接收、運輸中、派送中、嘗試配送、已送達及退回途中。這些是建議的倉庫類別,並不代表每個承運商都會提供相應事件。

在對應類別旁保留原始描述。「可供收取」不應在沒有提示的情況下變成「已送達」,而「已開始退回」也不應變成「已退回倉庫」。允許未知或未對應狀態,讓不熟悉的事件仍可供檢視。

同時儲存事件時間戳及系統接收時間。供應時保留原始時區或時差,並使用一致的內部時間標準。較晚到達的事件不應僅因最後才接收就自動令貨件狀態倒退;應套用明確的排序規則並保留歷史。

4. 為異常分配負責人

只有在有人可以採取行動時,提示才有用。將缺少接收掃描的問題分派給倉庫出貨團隊,將需要收件人提供資料的配送嘗試分派給商戶支援團隊,並將持續的承運商運輸問題分派給運輸協調員。這些是建議的起點;實際責任應配合倉庫的合約及營運模式。

為每個個案附上追蹤歷史、交接參考編號、最後事件、調查備註及下一次檢視時間。將重複提示歸入同一個未解決問題,避免同一個停滯包裹每次同步後都產生新任務。

根據服務期望而非任意計時器設定提示

沒有一個通用時間間隔,可以在包裹沒有新掃描後判定其延誤或遺失。應根據承運商服務、收件時間表、營運日、目的地及商戶承諾設定提示門檻。將內部調查門檻與面向客戶的配送承諾分開。

  • 交接後沒有接收:在升級處理前,檢查收件記錄及承運商確認。
  • 超過預期時間沒有動態:檢查最後事件、服務期望及已知的營運中斷。
  • 配送嘗試失敗:先閱讀原因,再決定下一步應由承運商、商戶還是收件人負責。
  • 退回途中:準備退貨流程,但在實體收貨及完成所需檢查前,不要增加可售庫存。
  • 顯示已送達但有爭議:開啟調查並尋找可用的配送證據;不要僅以狀態視為已解決投訴。

追蹤反映的是已報告的貨件事件,而不是包裹的持續位置。顯示最後更新時間戳,有助員工了解資訊的新鮮程度,而不會暗示具備即時 GPS 可見性。

為每個團隊提供可用的檢視畫面

倉庫主管需要查看出貨至接收的異常。運輸協調員需要按承運商分類的佇列及逾期個案。商戶支援團隊需要清晰的貨件時間線及下一項已協定行動。共用資料模型可以支援這些檢視,而不必讓每位使用者都能存取所有商戶的貨件。

對於多客戶倉庫,應在伺服器端執行商戶層級存取控制,而不只是依靠儀表板篩選器。不要將 API 憑證放在瀏覽器程式碼中,限制收件人資料的存取,並訂立保留及刪除規則。避免在追蹤參考資料或診斷記錄中放入不必要的個人資料。

有用的指標包括成功登記追蹤的已出貨包裹比例、具有承運商接收事件的比例、出貨至接收時間、未解決異常的時長,以及整合處理失敗次數。界定每項指標的分母及時間基準。如要衡量準時配送,應與已記錄的承諾或服務承諾比較,而不是與一般配送時長比較。

擴大前先試行工作流程

先從清楚界定的倉庫、承運商組合及商戶群組開始。除一般配送外,也應包括較難處理的記錄:已取消標籤、拆分訂單、缺少首次掃描、配送嘗試失敗、重複通知、次序錯亂的事件及退貨。在適當情況下使用獲授權的測試資料或歷史記錄;不要在生產環境中捏造承運商事件。

在推出前先就驗收標準達成共識。每件已出貨包裹都應有成功登記記錄,或有負責人跟進的失敗個案。重播訊息不應產生重複任務。追蹤事件應可追溯至其來源,而使用者不應看到其他商戶的記錄。

只有在營運員工能可靠處理異常佇列,且技術員工能恢復失敗的更新後,才應擴大範圍。實際目標不是建立一個充滿狀態的儀表板,而是建立從倉庫出貨至承運商配送的可追溯連接,並在旅程需要關注時清楚分配責任。

常見問題

追蹤 API 可以取代倉庫管理系統嗎?

不可以。追蹤 API 提供貨件可見性。倉庫系統仍負責庫存控制、揀貨、包裝及實體出貨記錄等活動。透過包裹識別碼連接兩者,讓承運商事件提供額外背景,而不取代倉庫證據。

追蹤 API 會提供即時 GPS 位置嗎?

不要假設會。包裹追蹤通常由已報告的事件及位置組成。更新時間取決於承運商及整合方式。持續的車輛或包裹位置需要另外驗證相關能力。

當包裹沒有追蹤更新時,員工應怎樣處理?

首先檢查登記是否成功、承運商身份及追蹤編號是否準確。然後將最後事件與倉庫交接證據及預期服務時間表進行比較。在決定哪個團隊應升級處理前,先將整合失敗與缺少承運商掃描分開調查。

追蹤事件可以自動觸發退款或庫存更新嗎?

追蹤事件可以為工作流程提供資訊,但具影響性的行動需要額外控制。配送異常不一定代表符合退款資格,而退回途中也不代表倉庫已實際收貨。在更改金額或庫存記錄前,應套用商戶政策、授權檢查及收貨程序。

拆分訂單應如何向商戶支援團隊顯示?

在父訂單下分別顯示每個包裹。一個包裹已送達時,不應在另一個包裹仍在運輸中的情況下將整張訂單標記為完成。保留替換貨件及退貨貨件的關聯,同時清楚區分它們。

來源

  • 17TRACK Tracking API — 追蹤 API 整合選項的官方產品參考資料。
  • 17TRACK API Documentation — 用於驗證登記、追蹤請求、更新處理及實作要求的技術參考資料。本指南中的營運工作流程及提示規則是建議,而不是對供應商或承運商行為的保證。