平台串接紀錄
目錄
一、使用情境
快速連結:查訂單為什麼沒進來 | 查物流產單為什麼失敗
情境 1:某平台的訂單好像漏了,想知道是不是串接出錯
狀況:客服反映某張蝦皮訂單在系統裡找不到,或是平台庫存數字跟系統對不上。您懷疑是某次抓單或庫存推送沒成功,但不確定是哪一次、錯在哪裡。
用這個功能:在 「平台串接」 → 「平台串接紀錄」 用日期區間加上「電商串接」篩出該帳號的呼叫,再看「回應狀態」欄找出失敗的那筆(見 展開查看請求與回應)。
結果:您能定位到具體是哪一次抓單或推送失敗、平台回報了什麼原因,據此判斷是憑證過期、平台端錯誤還是商品對應問題,再回到對應帳號修正。
情境 2:物流託運單一直產不出來,想看物流商回了什麼
狀況:某張出貨單的託運單號遲遲沒產生,託運單狀態顯示失敗。您需要知道是地址問題、契約憑證問題,還是物流商系統當下的錯誤。
用這個功能:用「物流串接」篩出該物流帳號的呼叫,找到產單那筆失敗紀錄,展開看物流商回傳的錯誤內容。
結果:直接看到物流商回報的具體錯誤訊息,省去猜測,能快速判斷該補地址、改憑證還是稍後重試。
二、功能介紹
平台串接紀錄完整記錄系統替您向各電商與物流平台發出的每一次串接呼叫——訂單抓取、庫存推送、商品對應同步、物流產單、配送查件、平台主動通知(webhook)等。每一筆都保留請求與回應內容、回應狀態與處理耗時。除了平台推送可以重新處理,這裡是唯讀的稽核紀錄;當訂單或庫存出現異常時,這裡是釐清「是不是串接出錯、錯在哪」的第一站。

2.1 搜尋與篩選
紀錄量很大,善用篩選才能快速定位:
| 篩選條件 | 用途 |
|---|---|
| 建立時間 | 預設展開的日期區間,先把範圍縮到事發那段時間 |
| 操作 | 只看特定動作(如只看抓單或只看庫存推送) |
| 電商串接 | 只看某個電商帳號的呼叫 |
| 物流串接 | 只看某個物流帳號的呼叫 |
2.2 列表欄位
| 欄位 | 說明 |
|---|---|
| 建立時間 | 這次呼叫發生的時間;點它進到這筆紀錄的詳情頁 |
| 操作 | 這次呼叫做的事(抓單、庫存推送、產單、查件等) |
| 請求方法 | 請求方法 |
| 來源 | 這次呼叫關聯到的對象(電商帳號、訂單、貨主、出貨單等) |
| 請求路徑 | 請求路徑 |
| 回應狀態 | 回應狀態:綠色代表成功、橘色代表請求有誤、紅色代表平台端錯誤 |
| 處理耗時 | 這次呼叫花費的時間 |
判斷成功或失敗,看「回應狀態」的顏色最快:綠色即成功,橘色或紅色就是要展開細看的對象。
2.3 展開查看請求與回應
點開任一筆紀錄,會展開顯示這次呼叫的「請求內容」與「回應內容」完整內容。失敗的呼叫,平台回傳的錯誤原因就在回應內容裡——這是釐清失敗根因最關鍵的資訊。
2.4 重新處理平台推送

平台主動送來的通知(動作為「平台推送」)系統會先收下、再於背景處理。處理一直失敗或收下沒處理的那筆,可以在該筆紀錄的詳情頁按「重新處理」,讓系統依這則通知的原始內容再處理一次,例如同步取消訂單、重新抓取訂單或更新託運單狀態。在列表點該筆的「建立時間」,或點「推播處理失敗」通知,都會進到該筆紀錄的詳情頁。
| 項目 | 說明 |
|---|---|
| 誰按得到 | 具有電商帳號編輯權限的使用者;只有檢視權限的看得到按鈕但已鎖定,滑鼠移上去會提示缺少的權限 |
| 哪些紀錄有按鈕 | 自動重試用完仍失敗的(回應內容是 inbox_status: failed),以及收下沒處理的(回應內容是 reason);處理中、重試中、已成功的沒有,電商帳號已斷線的(ec_account_disconnected)也沒有 |
| 按下之後 | 確認後重新排入處理、按鈕消失;稍候重新整理看結果。成功轉綠色,再出錯會照常自動重試 6 次 |
| 稽核紀錄 | 每次重新處理都會記下誰、何時、重新處理了哪一筆推送,動作名稱為「重新處理平台推播」 |
收下沒處理的那筆,原因多半在通知內容本身(例如缺訂單編號),直接重按通常得到一樣的結果;適合在平台或系統修正之後再按,把只靠推送才帶得進來的事件(例如退貨完成)補回來。紀錄約 2 個月後清除,超過就無法重新處理。
三、常見問題
3.1 FAQ
▪ 這裡記錄了哪些串接動作?
涵蓋電商與物流兩類:電商方面有抓取訂單、抓取賣場設定、商品對應同步、庫存推送等;物流方面有產生託運單、查詢配送狀態、回報出貨狀態等;另外也包含平台主動送來的通知。
▪ 怎麼快速找出失敗的呼叫?
先用日期區間縮小範圍,再看「回應狀態」欄的顏色——橘色或紅色即為異常。需要鎖定特定帳號時,加上「電商串接」或「物流串接」篩選。
▪ 橘色和紅色的狀態差在哪?
橘色代表這次請求本身有問題(例如憑證錯誤、參數不符,多半是設定或資料問題);紅色代表平台端發生錯誤(例如平台系統當下異常)。橘色通常要您這邊修正,紅色多半稍後重試即可。
▪ 平台主動送來的通知是 200,為什麼也標紅色?
系統收到通知會先存下來、回平台 200,再於背景處理,所以紀錄剛出現時是綠色,稍候重新整理才會變成處理結果。之後標紅色有五種,展開看回應內容就分得出來:
| 回應內容 | 代表 |
|---|---|
reason | 收下了但沒處理,例如通知裡缺訂單編號或必要欄位、是系統不處理的事件類型、內容格式不對,或平台在通知裡回報了錯誤 |
reason: ec_account_disconnected | 輪到處理時電商帳號已斷線,這則通知沒有處理,也不能重新處理。請先依電商帳號詳情頁頂端的紅色提示重新連線 |
reason: fetch_orders_disabled | 這個電商帳號的「抓取訂單」關閉中,取消與買家申請取消以外的訂單與退貨通知(新訂單、狀態異動、退貨)不處理;取消與申請取消照常套用,那幾筆是綠色。Shopline、Free Store、Liteshop 的訂單通知與 BVSHOP 的申請取消通知,對應到還沒出貨的訂單時會當下向平台查一次、只套用取消或申請取消,查完是綠色、沒有重新處理;查詢失敗會自動重試。重新開啟抓取訂單後可以重新處理需要的那幾筆;開關見電商帳號編輯頁 |
inbox_status: retrying | 處理時出錯,系統正在自動重試,attempts 是已經試過的次數;重試成功就轉綠色 |
inbox_status: failed | 自動重試 6 次(約 10 小時)仍失敗,系統已發通知,可以重新處理 |
同一種 reason 反覆出現,通常是平台改了通知格式,或您在平台後台多訂閱了系統不處理的事件,可把該筆紀錄的時間與回應內容提供給倉庫或客服協助釐清。
▪ 我可以在這頁重新觸發失敗的呼叫嗎?
平台主動送來的通知可以:處理失敗或收下沒處理的那筆,到詳情頁按「重新處理」,見重新處理平台推送。系統主動發出的呼叫不能在這裡重送:要重新抓單請到對應電商帳號的 詳情頁 用「立即觸發抓單」;要重產託運單請循出貨流程處理。
▪ 收到「推播處理失敗」通知要怎麼處理?
這代表某則平台通知自動重試 6 次都沒處理成功。點通知進到那筆紀錄的詳情頁,看回應內容的錯誤;平台或網路一時異常造成的,直接按「重新處理」即可。同一個電商帳號 6 小時內只會收到第一則,之後失敗的仍會在列表標紅色,同樣可以重新處理。
▪ 收到「推播訂閱已自動修復」通知代表什麼?
系統每天凌晨會檢查各電商帳號在平台上的通知設定。這則通知代表平台上的設定曾被停用或移除(例如平台在連續送不到之後自動停用),系統已自動重新啟用或重建,之後的通知會照常進來。停用期間平台沒有送通知過來:新訂單與取消由定時抓單補回,只靠通知才會更新的狀態(例如 Shopify 的全額退款、WooCommerce 的已退款)不會補,請到平台後台核對這段期間的訂單。您在 WooCommerce 後台手動暫停(Paused)的通知設定,系統不會自動改回。
▪ 展開後看不太懂回應內容怎麼辦?
回應內容是平台原樣回傳的資料,重點看其中的錯誤描述。若仍無法判斷,可把該筆紀錄的時間、動作與回應內容提供給倉庫或客服協助釐清。
▪ 找不到某個動作的選項?
「操作」篩選只列出會寫入紀錄的動作。少數僅出現在失敗通知、不會留存紀錄的動作不會出現在選項中,屬正常。
3.2 注意事項
⚠️ 重要提醒
- 除了平台推送可以重新處理,這裡無法重試或修改任何串接呼叫
- 失敗的根因以回應內容中平台回報的訊息為準,不要只看狀態顏色就下結論
💡 提示:排查問題時先用日期區間鎖定事發時間,再依帳號與動作逐步縮小,比逐筆翻找快得多。
四、相關功能
| 功能 | 說明 | 連結 |
|---|---|---|
| 電商串接 | 電商帳號的連線狀態與抓單、推送設定 | 前往 |
| 物流串接 | 物流帳號的契約憑證與啟用設定 | 前往 |
| 託運單列表 | 查看託運單號與配送狀態 | 前往 |