Skip to main content
首頁博客指南沒有運輸標籤,追蹤 API 能否正常運作?如何追蹤 3Pl 和 Marketplace 訂單?

沒有運輸標籤,追蹤 API 能否正常運作?如何追蹤 3Pl 和 Marketplace 訂單?

17TRACK

是。只要承運商或運輸合作夥伴已建立可追蹤的貨件,而你可以取得 API 支援的有效追蹤號碼或其他識別碼,追蹤 API 便可以在你的企業沒有建立寄件標籤的情況下運作。當第三方物流服務供應商(3PL)或平台負責履行訂單時,這種情況很常見。重點在於區分不是由你自行購買標籤與完全沒有貨件識別碼:前者通常可行;後者可能令 API 沒有任何可供追蹤的資料。

沒有寄件標籤時,追蹤 API 能否運作:追蹤 3PL

對賣家、平台營運商或整合團隊而言,實際工作是將每張訂單連結至實際負責發貨的一方所建立的貨件。這需要取得正確資料,而不一定要控制標籤的建立。

不建立標籤時,追蹤 API 需要甚麼

寄件標籤是產生貨件識別碼的一種方式,但通常不是追蹤 API 讀取的輸入。追蹤整合一般使用標籤在其他地方建立後所提供的貨件資料。在設計連接方式之前,請分開以下三種經常被視為可互換的記錄:

  • 訂單 ID:識別你在商店、平台帳戶或訂單管理系統中的購買記錄。它可能涵蓋多件商品及多個貨件。
  • 履行或包裹 ID:識別 3PL 或平台系統中的履行操作或包裹。其格式和含義取決於該系統。
  • 承運商追蹤號碼:用於追蹤目的識別貨件,但前提是承運商及追蹤服務接受該號碼。

你的內部訂單 ID 有助你找出正確的客戶訂單,但不會自動作為承運商追蹤號碼。通常的整合方式是從 3PL 或平台取得追蹤號碼,透過追蹤 API 登記或查詢該號碼,然後將返回的貨件資料儲存至相關訂單或包裹。

可能還需要承運商名稱或代碼。部分服務可以嘗試自動識別承運商,但你應先進行測試,而不應直接假設,尤其是不同承運商使用重疊識別碼,或訂單需要經過多個配送網絡時。在確定實作方案前,請查閱 API 文件,了解其接受的識別碼、承運商選擇規則、登記要求及狀態欄位。

追蹤由 3PL 發出的訂單

當 3PL 包裝訂單、購買標籤並將包裹交給承運商時,你的企業可能完全看不到標籤本身。但你仍然需要該流程所產生的貨件資料。請向 3PL 查詢哪個系統或資料來源會提供追蹤號碼、承運商資料、包裹識別碼,以及你在要求履行訂單時提供的訂單參考編號。

可行的 3PL 流程通常如下:

  1. 透過現有的履行流程,向 3PL 傳送訂單及穩定的參考編號。
  2. 接收包含包裹層級追蹤號碼及(如有)承運商資料的履行確認。
  3. 將該包裹配對至正確的客戶訂單及商品。
  4. 將受支援的貨件識別碼提交至追蹤 API,或使用 API 規定的查詢流程。
  5. 記錄包裹的追蹤更新,然後向營運團隊或客戶呈現訂單層級的狀態。

配對步驟尤其值得注意。單一訂單可能分成兩個紙箱離開倉庫,或者其中一件商品可能比其他商品較遲寄出。在這兩種情況下,都沒有單一包裹狀態可以準確描述整張訂單。請保留包裹層級記錄,並根據這些記錄產生任何訂單層級訊息。例如,不要僅因第一個包裹已送達,便將整張訂單標記為已送達。

請與 3PL 確定如何傳送更正資料。標籤可能被作廢,包裹可能重新包裝,而原有追蹤號碼也可能被替換。你的整合應能將替換後的號碼與同一張訂單建立關聯,而不會長期將兩個號碼都顯示為有效貨件。

平台控制配送時如何追蹤平台訂單

平台履行提出類似的技術問題,但資料存取問題有所不同。平台或其履行合作夥伴可能會建立標籤,但賣家只能取得其帳戶、訂單流程或獲授權整合所提供的配送資料。對於平台沒有向你提供的追蹤號碼,追蹤 API 無法替你解決。

先為每張訂單確認其履行模式。對於賣家自行履行的訂單,你自己的配送流程或 3PL 可能是包裹資料來源。對於由平台履行的訂單,平台可能是貨件資料來源,而賣家可取得的欄位亦可能不同。不要假設訂單頁面顯示配送狀態,就同時提供適合向另一個 API 登記的承運商追蹤號碼。

如果平台提供可追蹤號碼,請確認你獲准在預定系統中擷取及使用該號碼。然後測試追蹤 API 是否接受該識別碼,以及返回的事件是否能提供平台狀態以外的實用資料。如果平台只提供自己的訂單或配送參考編號,請查詢是否有明確支援的查詢方式。不要將平台內部訂單 ID 當作承運商號碼提交,並期待獲得可靠結果。

請將平台的訂單狀態與追蹤 API 的貨件狀態分開保存。平台可能在確認履行後便將訂單描述為已發貨,但承運商追蹤仍可能顯示尚未有接收掃描。這些記錄回答的是不同問題,更新時間亦可能不同。

沒有標籤的追蹤何時無法解決問題

「不是由我們建立標籤」並不是障礙。以下情況則可能構成障礙:

  • 尚未建立貨件:在履行流程產生可用識別碼之前,可能沒有可供查詢的承運商貨件。單憑訂單確認並不能證明包裹正在運送。
  • 你無法取得識別碼:3PL 或平台可能持有該號碼,但沒有透過你獲授權的流程提供。請從資料來源端解決資料存取問題。
  • 識別碼不受支援:參考編號、僅限平台使用的代碼或不受支援的承運商格式,可能無法與所選 API 配合使用。請在文件及測試貨件中確認接受的輸入資料。
  • 包裹尚未有新的掃描記錄:承運商記錄接收事件之前,號碼可能已經建立。請將空白或沒有變化的結果視為需要調查的狀態,而不是自動判定號碼無效。
  • 追蹤受限或不完整:承運商、服務或貨件流程可能無法提供面向客戶的使用場景所需的事件。請使用具代表性的貨件確認實際事件質素。

這些限制十分重要,因為 API 無法建立缺失的實體事件,也無法授予你存取其他方訂單資料的權限。只有在必要的識別碼及權限存在後,API 才能發揮擷取及整理受支援追蹤資料的價值。

如何為這種流程評估 API

當你的團隊需要在自有系統中取得貨件追蹤資料,而不是使用購買標籤的工具時,17TRACK 的 Tracking API 是值得研究的選項。其開發者文件可用於確認受接受的登記欄位、支援的承運商、回應結構、驗證方式,以及適用於你使用場景的可用更新傳送方法。不要因為存在通用追蹤 API,便推斷其必然支援某個特定 3PL、平台或專有識別碼。

在選擇或部署任何供應商之前,先建立一組小型測試資料。當中應包括:帶有承運商號碼的 3PL 訂單、帳戶會提供追蹤號碼的平台訂單、多包裹訂單、在首次掃描前建立的號碼,以及稍後才出現配送事件的貨件。如果替換號碼或國際轉運是常見情況,也請將其納入測試。測試應回答營運問題,而不只是確認請求是否返回成功的 HTTP 回應:

  • 你能否傳送實際收到的識別碼,而無需手動重新輸入?
  • 你能否可靠地將每筆追蹤記錄連結至正確的訂單及包裹?
  • 事件描述、時間戳記及承運商資料是否足以支援客戶訊息及客服流程?
  • 你的系統將如何處理重複更新、缺失事件、號碼變更及失敗請求?
  • 你預定使用平台及客戶資料的方式,是否符合適用於該等資料的存取條款?

至於整合本身,請同時保留原始來源記錄及追蹤 API 記錄。儲存訂單參考編號、包裹參考編號、提交的追蹤號碼、承運商資料(如有)以及每次收到更新的時間。這樣可以更容易調查不一致之處,而不會將 API 事件呈現為完整的履行歷史。如果 API 讓你選擇按時間表查詢,或透過受支援的傳送機制接收更新,請根據文件所述行為及你對即時更新的需要作出選擇;無論採用哪種方式,都不能免除錯誤處理的需要。

實際決定

當另一方負責寄送包裹,並且向你提供你獲授權使用且受支援的貨件識別碼時,即使不建立標籤,也可以使用追蹤 API。首先,從 3PL 或平台取得可靠的包裹資料來源。然後,針對 API 及你的訂單配對邏輯測試識別碼和追蹤事件。如果你只有訂單 ID 或平台狀態,請先解決來源資料缺口,再投資於承運商追蹤整合。

常見問題

我可以只使用商店的訂單編號追蹤訂單嗎?

通常不能透過承運商追蹤 API 完成。你的商店訂單編號只會在你的系統中識別該筆購買記錄。一般而言,你需要相應的貨件識別碼,除非特定服務明確支援使用你的訂單參考編號類型進行查詢。

我需要取得 3PL 的許可才能使用其追蹤號碼嗎?

請確認你對貨件資料的合約及技術存取權限。3PL 可能已在其履行資料來源中返回追蹤號碼,但整合必須使用獲授權的渠道,並妥善處理客戶資料。

為甚麼 3PL 傳送號碼後,API 仍顯示沒有動態?

該號碼可能在承運商首次記錄掃描前已經建立。請檢查識別碼及承運商是否正確、原始標籤是否已被替換,以及稍後查詢是否會產生事件。未有掃描並不等於未發貨,除非你已核對履行記錄。

如果一張平台訂單分成多個包裹寄出,該怎麼辦?

分別追蹤每個可用的包裹識別碼,並將所有包裹與同一張訂單建立關聯。請將面向客戶的訂單狀態與個別包裹狀態分開,以免一個包裹送達便令整張訂單看起來已完成。

來源