平台串接紀錄
目錄
一、使用情境
快速連結：電商平台的訂單沒進來 ｜ 託運單產生失敗
情境 1：電商平台剛成立的訂單一直沒出現在倉庫
狀況：貨主說買家半小時前在電商平台下單，倉庫卻還沒看到這張訂單，懷疑抓單壞了。
用這個功能：用操作與電商串接篩出該貨主帳號最近的抓單呼叫，看回應狀態，展開看平台回了什麼。
結果：分得出是平台授權過期、平台回錯誤，還是抓單成功但訂單還沒輪到——依結果決定要請貨主重新授權，還是等下一輪抓單。
情境 2：一批出貨單的託運單一直產生失敗
狀況：包裝區回報整批出貨單印不出託運單，畫面只說「產生失敗」。
用這個功能：用物流串接篩出該物流帳號的「產生託運單」呼叫，展開看物流商回應中的錯誤原因。
結果：從物流商的錯誤原因判斷是收件資料不合規格、物流帳號額度用完，還是物流商系統異常，對症處理。
二、功能介紹
系統主動呼叫電商平台與物流商時（抓單、回壓出貨、同步庫存、產生託運單、取號等），每一次呼叫都記在這裡。當平台或物流的串接出問題，這一頁讓您看到系統送了什麼、對方回了什麼，找出是哪一端的問題。
2.1 搜尋與篩選
列表只會出現您被指派貨主的呼叫；頁首切換貨主時，列表跟著只看該貨主。
| 條件 | 用法 |
|---|---|
| 建立時間 | 預設釘選在篩選列 |
| 操作 | 只看某類呼叫，例如抓單、產生託運單 |
| 電商串接 | 只看某個電商帳號的呼叫；選項名稱後面附平台名稱 |
| 物流串接 | 只看某個物流帳號的呼叫；選項只列實際出現過呼叫的物流帳號 |
2.2 列表欄位
| 欄位 | 說明 |
|---|---|
| 來源 | 這次呼叫是為了哪一類單據，例如訂單、出貨單、商品 |
| 回應狀態 | 先看對方的處理結果：有些平台即使處理失敗也回 HTTP 200，這種情況仍標成紅色失敗；沒有處理結果時才依 HTTP 狀態碼著色（2xx 綠、4xx 橘、5xx 紅）。物流商連線逾時沒有狀態碼時顯示「—」並標紅 |
點每列左側的「+」可展開看系統送出的請求內容與對方的回應內容。
三、常見問題
3.1 FAQ
▪ 狀態是 200，為什麼標成紅色？
對方平台回了 HTTP 200，但回應內容表示處理失敗，系統以處理結果為準，見列表欄位。
▪ 為什麼看不到某個貨主的呼叫？
列表只顯示您被指派貨主的呼叫；也請確認頁首目前選的貨主。
▪ 物流商的回應看起來被截斷了？
多數物流商的回應過長時只保留前 2,000 個字，錯誤原因通常在開頭，仍可判讀。
▪ 某張訂單的串接過程要怎麼查？
到該訂單的詳情頁開「串接紀錄」分頁，會只列出跟這張訂單有關的呼叫；批次抓單只顯示屬於這張訂單的那一段。
▪ 紀錄保留多久？
約 2 個月，更早的紀錄會被清除。
3.2 注意事項
⚠️ 重要提醒
- 展開內容可能包含收件人姓名、電話、地址等個資，請勿外傳給與該貨主無關的對象。
- 紀錄約 2 個月後清除且無法找回，需要長期留存請先另存。
💡 提示：排查單一貨主的平台問題時，先用「電商串接」篩出該帳號，再看失敗是從哪一筆開始連續出現，通常就是問題發生的時間點。
四、相關功能
| 功能 | 說明 | 連結 |
|---|---|---|
| 訂單詳情 | 在「串接紀錄」分頁查看單一訂單的串接紀錄 | 前往 |
| Webhook 紀錄 | 查看系統推送給貨主與串接方的通知 | 前往 |
| Vanta Connect API 紀錄 | 查看外部系統呼叫 Vanta Connect API 的紀錄 | 前往 |