退貨平台如何利用貨件追蹤 API 處理退貨和換貨
退貨平台可以使用貨件追蹤 API,將退貨及換貨流程與即時包裹事件連接起來。API 可協助平台識別退貨標籤何時建立、監察包裹在承運商網絡中的運送情況、偵測派送或異常事件,以及觸發下一個營運步驟。結果是讓客戶更容易理解、商戶更容易管理的退貨流程。

追蹤功能並不能取代退貨規則、倉庫檢查、退款或庫存控制。它提供貨件數據,讓這些流程能夠更準確地安排時間,並減少人工檢查。
為甚麼貨件可見性對退貨至關重要
正向貨件通常只有一個主要目標:將訂單派送給買家。退貨或換貨則可能有多種結果。包裹可能會送達倉庫、由第三方處理中心接收、被轉送、延誤,或在商戶完成檢查前已被標記為已送達。客戶亦需要知道退回的貨品是否正在運送,而支援團隊則需要在不依賴承運商網站或人工搜尋追蹤資訊的情況下回答問題。
追蹤 API 為退貨平台提供一種結構化方式,從承運商取得並標準化貨件資訊。視乎 API 及承運商可提供的數據,資訊可能包括追蹤號碼、貨件狀態、事件時間戳、位置詳情、預計派送資訊及異常訊息。實際欄位及更新頻率應以所選供應商的文件為準,不應自行假設。
對於電子商務退貨流程而言,實際價值不只是顯示追蹤號碼,而是將貨件事件用作決策、客戶訊息、個案管理及倉庫協調的輸入資料。
退貨或換貨流程中的主要追蹤事件
退貨平台應將承運商事件對應至自身的營運狀態。承運商使用的術語並不總是一致,因此整合應採用標準化狀態模型,同時保留原始承運商事件,以便審計及支援用途。
| 貨件事件 | 平台可能採取的行動 | 對客戶的價值 |
|---|---|---|
| 已建立標籤 | 開啟追蹤記錄,並將其與退貨授權關聯。 | 顯示退貨指示已發出,但不表示包裹已經開始運送。 |
| 承運商已接收或首次掃描 | 開始計算運送時間,並減少包裹是否已進入網絡的不確定性。 | 確認承運商已收到包裹。 |
| 運送中 | 更新退貨時間線,並識別停滯貨件。 | 提供進度,無需聯絡支援團隊。 |
| 異常或延誤 | 建立提示、調整預期,或將個案轉交支援團隊。 | 解釋退貨可能未能按原定預期抵達的原因。 |
| 已送達 | 通知接收團隊,並開始檢查或換貨流程。 | 確認包裹已抵達指定目的地,同時清楚說明檢查可能仍在進行。 |
這些對應關係應與商戶最終的退款決定分開。已送達事件只表示承運商報告包裹已送達;它本身並不能證明退回的是正確貨品、貨品沒有損壞,或退貨符合商戶政策。
如何將 Tracking API 連接至退貨營運
1. 建立退貨貨件記錄
退貨獲批後,退貨平台應建立一項記錄,將退貨授權與原始訂單、客戶、貨品、目的地及貨件識別碼連結。如涉及換貨,記錄亦應識別替換訂單或履行操作。這種關聯可避免將追蹤事件視為孤立的包裹更新。
平台應區分原始出貨貨件與退貨貨件。兩者可能使用不同承運商、服務級別、追蹤號碼及派送目的地。簡單的數據模型可包括訂單 ID、退貨 ID、適用時的換貨 ID、承運商、追蹤號碼、方向、目前標準化狀態、最近事件時間及原始承運商事件。
2. 將追蹤號碼傳送至 API
整合系統會按照供應商的驗證、請求及承運商識別要求,將承運商及追蹤號碼提交至追蹤服務。如系統無法可靠識別承運商,應使用獲批准的偵測方法,或向用戶或商戶索取承運商資料。錯誤的承運商對應可能導致結果延遲或不準確。
在此階段,平台應記錄追蹤請求建立的時間,以及 API 已接受、拒絕或尚未能識別貨件。API 接受請求並不等同於承運商完成掃描。這些狀態不應在用戶介面中合併。
3. 透過輪詢或 webhooks 接收更新
追蹤供應商通常支援一種或多種取得後續事件的方法。平台可以輪詢更新、接收推送通知,或根據供應商文件及所需延遲,結合使用兩種方法。17TRACK API 文件是核實其目前整合模式、支援的請求方式及實施要求的適當來源。
無論採用哪種方法,平台都應讓更新具備冪等性。同一事件可能被傳送多次、以錯誤順序抵達,或由承運商修訂。可用時儲存事件識別碼,比較事件時間戳,並保留歷史記錄,而不是覆寫所有先前狀態。
4. 將事件標準化為業務狀態
承運商狀態是為運輸營運而設計,未必直接適用於退貨決策。退貨平台可以將其對應至「已發出標籤」、「等待投遞」、「運送中」、「延誤」、「已送達」、「派送異常」及「需要調查」等狀態。對應方式應保留不確定性。例如,「已送達」可以將個案移至「等待檢查」,而不是直接變成「退款已獲批」。
業務規則亦應處理缺失或互相矛盾的事件。包裹數天沒有新掃描可能需要內部提示,但除非商戶政策及承運商流程支持此結論,否則不應自動視為遺失。
5. 觸發營運及客戶行動
標準化事件可用後,平台便能套用規則。首次承運商掃描可能會向客戶發送確認通知。派送異常可能會建立支援工作。已送達事件可能會通知退貨倉庫尋找包裹。對於換貨,商戶可以決定在首次掃描、送達或檢查後才發出替換貨品。該決定取決於風險、庫存及政策;追蹤數據可以提供參考,但不能一概而論。
通知應使用簡單易明的語言,並指出下一個預期步驟。客戶應能區分「承運商已收到你的退貨」、「商戶已檢查你的退貨」及「退款已發出」。這些是由流程中不同部門負責的不同事件。
使用追蹤數據處理換貨
換貨流程多一項依賴:替換貨品可能需要在退回貨品完成運送前寄出。支援追蹤功能的退貨平台可以維持兩項相關貨件記錄:流入的退貨貨件及流出的替換貨件。將兩者連結,可讓支援人員更完整地了解換貨情況。
有用的換貨規則可能包括:
- 在履行系統確認狀態前,不要將替換貨品描述為已寄出。
- 分開顯示退貨及替換貨品的時間線,即使兩者屬於同一宗換貨個案。
- 退貨延誤但替換貨品已送達時,向支援團隊發出提示。
- 將客戶的資格判定與承運商的派送狀態分開。
- 記錄觸發自動操作的事件,讓團隊可以審計或撤銷該操作。
這種做法可減少一個常見的混淆來源:將替換貨品送達視為原始退貨已完成的證據。兩件貨物可以獨立運送,並可能需要不同的處理方式。
17TRACK 的定位
17TRACK 為開發者整合發布專用的 Tracking API,亦提供以退貨為重點的產品 17RETURNS。應根據商戶需要承擔的角色評估這些產品。當退貨平台需要在自身流程或應用程式內取得貨件數據時,Tracking API 便具有相關性。當商戶需要一套更完整的退貨發起、整理及管理流程時,退貨管理產品便較為適合。
在實施前,應使用 17TRACK 官方資料核實目前的 API 行為、支援的承運商及整合詳情、驗證要求,以及任何產品特定限制。17RETURNS 產品頁面及17RETURNS Shopify 列表提供產品背景,而API 文件則更適合作為技術整合決策的資料來源。已經營自訂退貨平台的商戶可以將 API 用作數據層;尋求託管式退貨流程的商戶,則應評估退貨產品本身,而不應假設單靠 API 便能提供這些功能。
上線前的實施檢查
概念驗證應使用真實退貨情境,而不只是成功運送中的例子。至少測試一宗本地退貨、如與業務相關則測試一宗跨境退貨、延誤貨件、派送異常、已送達包裹、重複更新,以及無法立即識別的追蹤號碼。
實施團隊應確認以下事項:
- 商戶退貨路線所需的承運商及服務,以及如何識別這些承運商。
- 每家相關承運商可提供哪些事件,以及事件詳情是否因目的地而異。
- 更新多久刷新一次,以及平台如何處理 API 錯誤、速率限制及臨時服務中斷。
- 如何儲存及核對重複、延遲、缺失或順序錯誤的事件。
- 哪些操作會自動執行,哪些操作需要人工審查。
- 客戶通知如何翻譯、加入品牌元素、暫停及審計。
- 如何按照商戶要求保護、保留及移除個人資料及貨件數據。
- 系統如何區分承運商派送、倉庫收貨、檢查、批准、退款及換貨履行。
營運責任與技術連接同樣重要。物流團隊應定義事件含義,支援團隊應定義面向客戶的訊息,財務團隊應定義退款控制,倉庫團隊應定義送達後的處理方式。沒有這些決定,即使 API 連接在技術上成功,仍可能造成誤導性的自動化。
實用決策框架
當退貨流程依賴及時的承運商事件、商戶需要連接多個系統,或客戶及支援人員需要共享包裹進度時,可使用貨件追蹤 API。當更大的問題包括政策配置、退貨授權、標籤流程、客戶溝通、庫存處置及報告時,則可考慮退貨管理平台。在部分營運模式中,兩個層面可以共同運作:退貨系統管理個案,而追蹤服務提供標準化貨件事件。
最完善的設計會將追蹤視為更大型狀態機中的證據。它告訴平台承運商報告了甚麼、何時報告,以及該事件屬於哪件貨物。業務規則再決定下一步應如何處理。這種分離方式可令退貨及換貨更透明,同時不會承諾承運商數據無法提供的確定程度。
常見問題
追蹤 API 可以確認應否退款嗎?
不可以。當相關事件可用時,API 可以報告接收、運送、異常或派送等貨件事件。退款資格通常還取決於退貨政策、貨品狀況、檢查、防欺詐控制及商戶批准。
已送達的退貨應否自動觸發退款?
不一定。已送達表示承運商報告包裹已抵達目的地。商戶可能仍需核實貨品、數量、狀況及退貨授權,然後才批准退款。
輪詢或 webhook 交付,哪種方式較適合退貨追蹤?
沒有一種方法在所有情況下都較好。選擇取決於供應商支援的方法、所需更新速度、實施工作量及對通知延遲的容忍度。部分平台會使用推送更新,並定期進行核對,以捕捉遺漏的事件。
換貨平台應如何追蹤兩件貨物?
將流入的退貨貨件及流出的替換貨件儲存為兩項獨立貨件記錄,並將其連結至同一換貨個案。分別顯示兩者的狀態,並定義規則,避免將其中一件貨物的狀態誤認為另一件已完成。
連接追蹤 API 前應測試甚麼?
測試成功追蹤、掃描延遲、異常、重複事件、錯誤或未知的承運商資料、相關的跨境情況,以及 API 中斷。同時測試每項事件後的客戶訊息及人工審查流程。


