平台串接紀錄
目錄
一、使用情境
快速連結：查訂單為什麼沒進來 ｜ 查物流產單為什麼失敗
情境 1：某平台的訂單好像漏了，想知道是不是串接出錯
狀況：客服反映某張蝦皮訂單在系統裡找不到，或是平台庫存數字跟系統對不上。您懷疑是某次抓單或庫存推送沒成功，但不確定是哪一次、錯在哪裡。
用這個功能：在 「平台串接」 → 「平台串接紀錄」 用日期區間加上「電商串接」篩出該帳號的呼叫，再看「回應狀態」欄找出失敗的那筆（見 展開查看請求與回應）。
結果：您能定位到具體是哪一次抓單或推送失敗、平台回報了什麼原因，據此判斷是憑證過期、平台端錯誤還是商品對應問題，再回到對應帳號修正。
情境 2：物流托運單一直產不出來，想看物流商回了什麼
狀況：某張出貨單的托運單號遲遲沒產生，標籤狀態顯示失敗。您需要知道是地址問題、契約憑證問題，還是物流商系統當下的錯誤。
用這個功能：用「物流串接」篩出該物流帳號的呼叫，找到產單那筆失敗紀錄，展開看物流商回傳的錯誤內容。
結果：直接看到物流商回報的具體錯誤訊息，省去猜測，能快速判斷該補地址、改憑證還是稍後重試。
二、功能介紹
平台串接紀錄完整記錄系統替您向各電商與物流平台發出的每一次串接呼叫——訂單抓取、庫存推送、商品對應同步、物流產單、配送查件、平台主動通知（webhook）等。每一筆都保留請求與回應內容、回應狀態與處理耗時。這是一個唯讀的稽核紀錄，當訂單或庫存出現異常時，這裡是釐清「是不是串接出錯、錯在哪」的第一站。
2.1 搜尋與篩選
紀錄量很大，善用篩選才能快速定位：
| 篩選條件 | 用途 |
|---|---|
| 建立時間 | 預設展開的日期區間，先把範圍縮到事發那段時間 |
| 操作 | 只看特定動作（如只看抓單或只看庫存推送） |
| 電商串接 | 只看某個電商帳號的呼叫 |
| 物流串接 | 只看某個物流帳號的呼叫 |
2.2 列表欄位
| 欄位 | 說明 |
|---|---|
| 建立時間 | 這次呼叫發生的時間 |
| 操作 | 這次呼叫做的事（抓單、庫存推送、產單、查件等） |
| 請求方法 | 請求方法 |
| 來源 | 這次呼叫關聯到的對象（電商帳號、訂單、貨主、出貨單等） |
| 請求路徑 | 請求路徑 |
| 回應狀態 | 回應狀態：綠色代表成功、橘色代表請求有誤、紅色代表平台端錯誤 |
| 處理耗時 | 這次呼叫花費的時間 |
判斷成功或失敗，看「回應狀態」的顏色最快：綠色即成功，橘色或紅色就是要展開細看的對象。
2.3 展開查看請求與回應
點開任一筆紀錄，會展開顯示這次呼叫的「請求內容」與「回應內容」完整內容。失敗的呼叫，平台回傳的錯誤原因就在回應內容裡——這是釐清失敗根因最關鍵的資訊。
三、常見問題
3.1 FAQ
▪ 這裡記錄了哪些串接動作？
涵蓋電商與物流兩類：電商方面有抓取訂單、抓取賣場設定、商品對應同步、庫存推送等；物流方面有產生托運單、查詢配送狀態、回報出貨狀態等；另外也包含平台主動送來的通知。
▪ 怎麼快速找出失敗的呼叫？
先用日期區間縮小範圍，再看「回應狀態」欄的顏色——橘色或紅色即為異常。需要鎖定特定帳號時，加上「電商串接」或「物流串接」篩選。
▪ 橘色和紅色的狀態差在哪？
橘色代表這次請求本身有問題（例如憑證錯誤、參數不符，多半是設定或資料問題）；紅色代表平台端發生錯誤（例如平台系統當下異常）。橘色通常要您這邊修正，紅色多半稍後重試即可。
▪ 我可以在這頁重新觸發失敗的呼叫嗎？
不行。這裡是唯讀的紀錄頁，只供查詢。要重新抓單請到對應電商帳號的 詳情頁 用「手動抓取訂單」；要重產托運單請循出貨流程處理。
▪ 展開後看不太懂回應內容怎麼辦？
回應內容是平台原樣回傳的資料，重點看其中的錯誤描述。若仍無法判斷，可把該筆紀錄的時間、動作與回應內容提供給倉庫或客服協助釐清。
▪ 找不到某個動作的選項？
「操作」篩選只列出會寫入紀錄的動作。少數僅出現在失敗通知、不會留存紀錄的動作不會出現在選項中，屬正常。
3.2 注意事項
⚠️ 重要提醒
- 這是唯讀紀錄頁，無法在此重試或修改任何串接呼叫
- 失敗的根因以回應內容中平台回報的訊息為準，不要只看狀態顏色就下結論
💡 提示：排查問題時先用日期區間鎖定事發時間，再依帳號與動作逐步縮小，比逐筆翻找快得多。
四、相關功能
| 功能 | 說明 | 連結 |
|---|---|---|
| 電商串接 | 電商帳號的連線狀態與抓單、推送設定 | 前往 |
| 物流串接 | 物流帳號的契約憑證與啟用設定 | 前往 |
| 託運單列表 | 查看托運單號與配送狀態 | 前往 |