合作夥伴 API 紀錄
目錄
一、使用情境
快速連結：ERP 說訂單已送出，倉庫卻沒有 ｜ 換串接廠商前確認對方做了什麼
情境 1：ERP 說訂單已經送出，倉庫卻查不到
狀況：您用 ERP 把今天的訂單送進倉庫，ERP 顯示送出成功，但倉庫說沒收到這幾張單，客人在等出貨。
用這個功能：依串接來源與時間篩出 ERP 那組串接的建立訂單呼叫，看狀態碼，展開看系統回覆的錯誤原因。
結果：分得出是 ERP 根本沒送到、送到了但資料有誤（例如商品 SKU 不存在），還是被擋在串接設定（停用、IP 不在白名單）；把錯誤原因交給 ERP 廠商修正後重送。
情境 2：準備更換串接廠商，先確認舊廠商做了哪些事
狀況：您要換一家 ERP 廠商，想先知道舊系統平常實際對倉庫做了哪些動作，避免新系統漏接。
用這個功能：依串接來源篩選舊廠商的串接，再用操作條件看有哪些寫入動作（建立訂單、建立入庫單、取消訂單等）。
結果：依實際紀錄列出新系統必須支援的動作清單，交接時不漏項。
二、功能介紹
您的 ERP、購物車或其他系統透過「串接管理」的 API 憑證呼叫倉庫系統時，每一次寫入（建單、改單、建立入庫單等）與每一次失敗的呼叫都會記在這裡。當對方系統說「有送」、倉庫卻沒資料時，這一頁讓您看到對方送了什麼、系統回了什麼。
2.1 搜尋與篩選
列表只會出現您這個品牌的串接所留下的紀錄。搜尋框比對的是請求路徑與操作代碼（英文，例如 create_order）的片段，輸入畫面上的中文操作名稱不會命中；要依操作查，請用下方的「操作」篩選。
| 條件 | 用法 |
|---|---|
| 建立時間 | 預設釘選在篩選列 |
| 串接來源 | 只看某一組串接的呼叫；選項包含還沒有任何紀錄的串接 |
| 操作 | 只看某類操作，例如建立訂單 |
| 狀態碼 | 輸入完整的 HTTP 狀態碼，例如 422；可一行一個同時查多個 |
2.2 列表欄位
| 欄位 | 說明 |
|---|---|
| 建立時間 | 呼叫進來的時間，可點欄位標題切換新到舊／舊到新 |
| 狀態碼 | 綠色為成功（2xx），橘色為送來的資料或權限有問題（4xx），紅色為系統錯誤（5xx） |
| IP 位址 | 對方連進來的 IP，可用來核對串接的 IP 白名單該填哪個位址 |
點每列左側的「+」展開，左邊是對方送出的內容，右邊是系統的回應；失敗時回應中會有錯誤代碼，可直接轉給串接廠商。密碼、Token 等敏感欄位在存檔時已遮蔽。
三、常見問題
3.1 FAQ
▪ 對方說有查詢訂單或商品，為什麼沒有紀錄？
成功的查詢不留紀錄，只有寫入動作與失敗的呼叫才會出現在這裡。
▪ 對方一直連不進來，紀錄卻一筆都沒有？
Token 錯誤或沒帶 Token 的呼叫認不出是哪組串接，不會留紀錄。請對方確認使用的是「串接管理」中目前有效的 Token。
▪ 對方說被回「超過呼叫上限」，為什麼查不到這些呼叫？
超過每日呼叫上限而被拒絕的呼叫不會記錄，避免對方一直重試把紀錄灌滿；上限隔天重置，請對方降低呼叫頻率或改在隔天補送。
▪ 某張訂單的串接過程要怎麼查？
到該訂單的詳情頁開「串接紀錄」分頁，會列出跟這張訂單有關的呼叫。
▪ 紀錄保留多久？
約 2 個月，更早的紀錄會被清除。
3.2 注意事項
⚠️ 重要提醒
- 紀錄約 2 個月後清除且無法找回；需要長期留存的問題請先另存明細。
💡 提示：排查某個廠商時，先用「串接來源」加「狀態碼」篩出失敗呼叫，再逐筆展開看錯誤代碼。
四、相關功能
| 功能 | 說明 | 連結 |
|---|---|---|
| 串接管理 | 建立與管理 API 憑證、設定 IP 白名單 | 前往 |
| 訂單詳情 | 在「串接紀錄」分頁查看單一訂單的串接紀錄 | 前往 |