Skip to main content
首頁博客指南航空貨運 vs. 跨境包裹追蹤:您需要哪些 API 功能?

航空貨運 vs. 跨境包裹追蹤:您需要哪些 API 功能?

17TRACK

當你的應用程式必須追蹤航空運單、航段、貨物處理里程碑及貨件數量時,應選擇空運貨物追蹤 API。當你需要跨承運商取得包裹層級更新、派送異常及最後一公里派送狀態時,應選擇跨境包裹追蹤 API。如果你的貨件結合了拼載空運與個別包裹派送,就需要這兩個可視性層級,以及一個可靠的方法來連接它們的識別碼。

空運貨物與跨境包裹追蹤:API 功能比較

對工程團隊、物流營運商及電子商務企業而言,採購決策重點不在於哪個 API 返回更多事件,而在於這些事件是否描述了你實際管理的貨件單位。航空公司顯示的到達事件本身,無法告訴買家其包裹目前在哪裏,或何時送抵家門。

從貨件單位開始,而不是運輸模式

空運貨物與跨境包裹並非互相排斥的運輸類別。包裹可能透過飛機進行國際運輸,而航空公司則將其作為較大型拼載貨件的一部分處理。選擇 API 時的區別,在於所追蹤的營運對象。

空運貨物可視性通常以航空運單及相關運輸動向為核心。視乎資料來源,資料可能描述收貨、離境、到達、貨物可提取及交接等狀態。包裹可視性則以個別包裹為核心,追蹤其經過收集、國際運輸、目的地處理及派送的進度。

主航空運單可以代表包含多個底層貨件的拼載運輸。分航空運單、包裹標籤及目的地承運商追蹤號碼,可能分別識別該運輸中的不同層級。不要假設追蹤服務提供商可以自動發現或連接所有這些關係。

決策範疇空運貨物追蹤跨境包裹追蹤
主要對象航空運單、託運貨件或運輸航段個別包裹及其承運商識別碼
營運問題貨物是否已收取、裝載運輸、到達或交接?包裹在哪裏、甚麼因素阻礙派送,以及是否已送達?
需要保留的關係主單與分單參考資料、航段、件數及拆分運輸訂單與包裹的關聯、承運商交接、替換識別碼及退貨
典型負責團隊貨運代理、運輸或貨物營運團隊電子商務營運、客戶服務或派送管理團隊
主要解讀風險將單一航段或部分到達視為整個貨件已完成將交接或含糊的派送事件視為買家已收貨

空運貨物追蹤 API 需要支援甚麼

航空運單識別及貨件關係

了解 API 接受哪些識別碼,以及每次查詢會返回甚麼內容。支援主航空運單並不會自動代表支援分單層級的可視性。如果你的營運依賴分單貨件,應要求使用你自己的參考資料及獲授權資料來源進行示範。

資料模型應保留貨件、其運輸航段及任何分開運輸部分之間的關係。對於重視數量的工作流程,應了解件數及重量可在貨件層級、事件層級,還是兩者同時取得。貨件層級的總數,不能替代了解有多少貨物抵達特定機場。

運輸航段及處理可視性

要求足夠的背景資料,以區分始發地離境與轉機離境,以及計劃中的運輸與實際運輸。有用欄位可能包括始發及目的地機場、航班參考資料、事件位置,以及計劃與實際時間戳。這些資料是否可用取決於來源,應加以驗證而非假設具備。

亦要區分航班動向與貨物動向。飛機抵達本身並不能證明每件相關貨物均已裝載、卸載、處理或可供提取。應了解事件是特定於貨件,還是由航班資料流推導而來。

部分運輸及里程碑含義

貨物貨件可能分批運輸。你的系統不應僅因部分貨物存在到達事件,就將整個託運貨件標記為已到達。測試 API 如何表示多個航班、部分數量、路線修訂及更正。

里程碑定義同樣需要仔細審查。交接予貨運代理或另一物流方,不一定等同於交付予最終收貨人。要求服務提供商解釋完成事件的營運含義,並在你的內部狀態模型中保留該含義。

IATA 的 ONE Record 倡議為貨物資料共享及標準化資料結構提供相關行業參考。然而,聲稱符合標準並不證明可以存取每家航空公司、處理商、貨件或里程碑。應了解實際可用的實施方式、資料關係、權限及營運來源。

跨境包裹追蹤 API 需要支援甚麼

承運商識別及交接連續性

國際包裹旅程可能涉及始發地營運商、跨境物流服務提供商及目的地派送承運商。整合方案應協助你在識別碼或負責承運商變更時維持追蹤連續性。

檢查 API 是否返回下游追蹤號碼、承運商關係,還是只返回你提交的識別碼所對應的事件。如果這些關係不可用,應確定你的運輸平台、倉庫或物流合作夥伴能否提供。未經測試,不要承諾可自動建立端到端關聯。

承運商偵測亦需要備用方案。相似的追蹤號碼模式可能造成歧義,因此在支援的情況下,你的整合方案應允許明確選擇承運商,或使用另一種有文件記載的消歧方法。

保留原始證據的標準化狀態

常見的狀態模型有助於跨承運商自動化通知。但標準化不應刪除原始事件描述、位置、時間戳或來源承運商。

例如,廣泛的異常狀態可能代表地址問題、與海關相關的延誤,或派送嘗試失敗。這些情況需要不同的處理方式。保留原始訊息,並只在來源支援時使用具體的異常類別。

派送結果及可採取行動的異常

包裹團隊通常需要區分派送中、嘗試派送、可供領取、已送達及退貨相關事件。應了解 API 提供哪些區分,以及它們在你使用的承運商之間是否一致。

將派送證明視為獨立要求。已送達狀態不保證可以取得簽名、照片、收件人姓名或文件。對於相關服務,應確認可用性、存取權限、保留期限及私隱限制。

海關資料亦有其限制。提及海關的追蹤事件不一定會提供報關記錄、稅費說明或可靠的放行預測。應根據事件實際所述內容建立升級規則,而非推斷法律或海關結果。

兩種 API 類型都需要的功能

可靠的事件接收及恢復

對於事件驅動的工作流程,應評估 webhook 傳送、驗證、重試、重複處理及服務中斷後的恢復能力。這些是需要驗證的採購要求,不應假設每個服務提供商都具備。

設計你的消費端,以處理重複及亂序訊息。將事件發生時間與系統接收更新的時間分開儲存。如果沒有穩定的事件識別碼,應使用可用欄位定義有文件記載的去重方法。

了解在錯過通知後,是否可以取得貨件的事件歷史。Webhook 適合觸發工作;支援的資料擷取或對賬流程,才有助於在觸發被錯過時進行恢復。

資料新鮮度、來源及時間戳處理

分開處理三個時間:實體事件發生的時間、來源發布事件的時間,以及你的應用程式接收更新的時間。並非每個來源都會提供這三個時間,但將可用時間戳分開保存,有助於診斷延誤。

同樣地,應區分沒有新事件與查詢失敗。貨件歷史沒有變化,可能反映掃描之間的正常間隔、來源中斷、未識別的識別碼或整合問題。你的營運團隊需要足夠的診斷資料,才能選擇適當的回應。

在來源提供時保留時區資料。如果來源時間戳缺少時區,應記錄這項限制,而不是悄悄將其轉換為看似精確的全球時間。

存取、成本及營運控制

確認驗證、帳戶隔離、資料保留、刪除程序、速率限制及生產支援安排。追蹤資料可能包含個人資料,因此只收集及公開工作流程所需的內容。

根據實際工作量比較商業條款。了解可計費項目是已登記貨件、請求、刷新,還是其他單位。釐清無效號碼、重複登記、重新追蹤、歷史查詢及超額用量的處理方式。沒有這些定義,標示價格就不能作為可靠的成本比較。

何時使用單一 API,何時結合資料來源

當選擇以貨物為核心的可視性:當你的團隊需要處理航空運單里程碑、機場處理、轉機失敗或部分貨物到達時。除非明確示範具備所需的貨物層級詳細資料,否則單靠包裹追蹤不足以取代這些工作流程。

當選擇以包裹為核心的可視性:當你的團隊需要包裹層級的派送更新、客戶通知、目的地承運商事件及派送異常管理時。單靠航空運單資料流不足以支援面向買家的派送追蹤。

結合兩者:當你同時管理國際幹線運輸及個別包裹派送時。為拼載貨件及其包裹分別保留記錄,然後透過你自己的物流流程或經驗證的合作夥伴資料流所提供的參考資料連接兩者。

例如,商戶可能先以空運方式運送一批拼載貨件,然後在目的地注入包裹網絡。將貨物到達記錄在拼載貨件上。只有在有與個別包裹相關的證據時,才更新該包裹;不要將整批貨物抵達機場轉換為每張訂單都已送達的事件。

17TRACK 的定位

對於此架構中的包裹部分,17TRACK 的 Tracking API 可用於評估多承運商追蹤整合。使用官方 API 文件,根據所需識別碼、回應欄位、通知流程及營運限制檢查整合方案。

不要將包裹 API 評估視為確認其具備空運貨物功能。如果你還需要主單至分單的關係、航段詳細資料或部分件數運輸,應要求就這些要求提供明確確認及示例回應。產品的正確角色取決於其能夠證明支援的工作流程,而不是「追蹤」一詞的涵蓋範圍。

在作出承諾前進行概念驗證

使用來自實際承運商、路線及服務類型的代表性貨件。包括已完成且結果已知的貨件,以及正在運輸的貨件。成功查詢一件簡單貨件,並不足以驗證整合方案。

  1. 定義每個事件必須支援的決策。例子包括調查錯過的貨物轉機、就地址問題聯絡買家,或發送派送通知。
  2. 建立具代表性的測試集。在相關情況下,加入承運商交接、無更新時段、派送嘗試、退貨及貨物拆分運輸。
  3. 檢查對象層級的準確性。確認每個事件適用於航班、託運貨件、部分貨物,還是個別包裹。
  4. 與營運來源比較。根據你獲授權存取的承運商或合作夥伴記錄,檢查缺失的里程碑、時間戳、位置、原始訊息及更正處理。
  5. 測試故障恢復。測試重複事件、延遲事件、無效識別碼、含糊的承運商、webhook 中斷及對賬。
  6. 驗證成本效益及責任歸屬。根據工作量估算成本,並為來源資料問題、整合故障及客戶溝通分配責任。

在檢視結果前設定驗收標準。標準應涵蓋每個工作流程所需的欄位、事件含義、恢復行為及可接受的更新延誤。客戶通知與貨物干預可能需要不同的門檻。

常見問題

一個追蹤 API 可以同時涵蓋空運貨物及包裹嗎?

有可能,但要確認兩者的資料模型及資料來源存取權限。共用端點並不能證明支援貨物數量、航段、分單關係或包裹交接。應要求就兩種工作流程分別進行示範。

可以使用航空運單號碼追蹤個別包裹嗎?

不一定。航空運單可能識別的是較大的託運貨件,而非個別包裹。你需要驗證該託運貨件與包裹識別碼之間的關係,才能連接兩者的歷史記錄。

「即時追蹤」是否代表持續取得實體位置?

不要如此假設。追蹤可能基於按時間間隔發布的營運事件,而非持續的位置遙測。應了解更新由甚麼觸發、提供哪些時間戳,以及任何位置資料是否來自獨立的感測器來源。

Webhook 比輪詢更好嗎?

Webhook 適合在無需重複發送狀態請求的情況下接收事件通知。輪詢或其他資料擷取機制仍可支援對賬及恢復。應根據服務提供商記載的行為、限制,以及你對遺漏或延遲更新的容忍程度選擇設計。

已送達事件是否證明買家已收到貨件?

並非在所有情況下都能證明。貨物完成可能描述交接予物流方,而包裹派送事件則取決於承運商的派送流程。應驗證事件定義,並在工作流程需要時取得獨立的派送證明。

來源