Vanta Connect API 紀錄
目錄
一、使用情境
快速連結：外部系統說訂單送不進來 ｜ 門市 App 的操作沒有生效 ｜ 確認串接廠商實際做了什麼
情境 1：ERP 廠商說訂單送不進來
狀況：貨主反映今天早上的訂單沒有出現在倉庫，ERP 廠商堅持「我們有送」。您需要知道對方到底有沒有呼叫、被擋在哪一步。
用這個功能：依串接憑證與時間篩選那組 ERP 憑證，看建立訂單的呼叫狀態碼，展開該筆看對方送出的內容與系統回覆的錯誤原因。
結果：一眼分出是對方根本沒送、送了但資料有誤（例如物流類型代碼不存在），還是憑證被停用或 IP 不在白名單——直接把錯誤原因轉給廠商修正。
情境 2：門市用 POS App 宣告出貨，系統卻沒反應
狀況：門市人員在組織安裝的 POS App 上按了「出貨」，但訂單狀態沒變。店長想知道 App 有沒有把指令送到倉庫系統。
用這個功能：篩選 App 的憑證（選項名稱後面標「App」），找到那一筆宣告出貨呼叫。App 的呼叫不保存內容，展開後看到的是安裝、授權模式與代表哪位人員操作。
結果：從狀態碼確認這次呼叫是成功還是被拒絕，再從操作人員判斷是哪個門市帳號送出的，不必再請 App 廠商查他們的紀錄。
情境 3：盤點串接廠商這個月實際做了哪些事
狀況：您準備調整某組串接的權限範圍，想先確認對方平常實際會呼叫哪些功能，避免收回權限後對方的系統壞掉。
用這個功能：依串接憑證篩選，再用操作條件逐一確認是否出現建立訂單、取消訂單、轉倉等寫入動作。
結果：以實際紀錄決定要保留哪些權限範圍，調整後再回來確認沒有新增的失敗呼叫。
二、功能介紹
這是 Vanta Connect 串接的呼叫紀錄：組織的串接憑證（倉庫端自建的憑證，以及組織 App 安裝後代管的憑證）每次寫入資料、或任何一次呼叫失敗，都會在這裡留一筆。查串接問題時，從這裡可以看到對方送了什麼、系統回了什麼、花了多久、從哪個 IP 連進來。
2.1 哪些呼叫會留紀錄
| 呼叫 | 是否留紀錄 |
|---|---|
| 寫入動作：建立訂單、取消訂單、宣告出貨、重新檢查庫存、取消未出貨、出貨單轉倉、確認揀貨結果、建立入庫單、建立退貨單 | 成功與失敗都會留 |
| 查詢動作：查訂單、查庫存、查貨主／倉庫／物流類型等 | 只有失敗才留，成功的查詢不留 |
| 被串接設定擋下的呼叫：串接已停用、來源 IP 不在白名單、路徑與憑證的 API 版本不符、方案不含 Vanta Connect 串接 | 會留，狀態碼為 401 或 403 |
| Token 錯誤或沒帶 Token 的呼叫 | 不留：系統認不出是哪組串接 |
紀錄保留約 2 個月，更早的會被清除。
2.2 搜尋與篩選
搜尋框比對的是請求路徑與操作代碼（英文，例如 cancel_order）的片段，輸入畫面上的中文操作名稱不會命中；要依操作查，請用下方的「操作」篩選。篩選條件：
| 條件 | 用法 |
|---|---|
| 建立時間 | 預設釘選在篩選列；查特定時段的問題時先縮小日期範圍 |
| 串接憑證 | 列出組織內所有串接憑證，包含已停用的憑證與組織 App 的憑證（名稱後面標「App」）。已刪除的憑證不會出現在選項中，它留下的紀錄仍可用其他條件查到 |
| 操作 | 依操作篩選，例如只看「建立訂單」 |
| 狀態碼 | 輸入完整的 HTTP 狀態碼，例如 422；可一行一個同時查多個 |
2.3 列表欄位
| 欄位 | 說明 |
|---|---|
| 建立時間 | 呼叫進來的時間，可點欄位標題切換新到舊／舊到新 |
| 串接憑證 | 發出呼叫的串接憑證；組織 App 的憑證前面有「App」標記。憑證已被刪除時顯示「已刪除的憑證」 |
| 狀態碼 | 系統回覆的 HTTP 狀態碼：綠色為成功（2xx），橘色為對方資料或權限問題（4xx），紅色為系統錯誤（5xx） |
| IP 位址 | 對方連進來的 IP，可用來核對 IP 白名單該填哪個位址 |
| 處理耗時 | 系統處理這次呼叫花的時間 |
2.4 展開明細
點每列左側的「+」展開：
- 一般串接憑證：左邊是對方送出的請求內容，右邊是系統的回應內容；失敗時回應中會有錯誤代碼，可直接轉給串接廠商。密碼、Token 等敏感欄位在存檔時已遮蔽。
- 組織 App 的憑證：App 的呼叫不保存請求與回應內容，改顯示「App 授權摘要」——安裝 ID、授權版本、授權模式（線上（代表操作人員）或離線（App 背景作業））與操作人員。沒有內容不代表失敗，成功與否看狀態碼。
三、常見問題
3.1 FAQ
▪ 為什麼看不到「Vanta Connect API 紀錄」？
這一頁需要「Vanta Connect 串接 - 檢視」權限，且組織方案要包含 Vanta Connect 串接；只有「系統日誌」權限還不夠。請聯繫管理員確認權限。
▪ 為什麼要用 Vanta Connect 串接的權限，而不是紀錄的權限？
紀錄裡有對方送來的完整請求內容，可能包含組織內任何貨主的訂單與收件人資料。能看到這些內容的範圍，與能在 Vanta Connect 串接頁查看 Access Token 的人一致——持有 Token 本來就能呼叫整個組織的資料，因此只開給同一群人。
▪ 紀錄會只顯示我負責的倉庫或貨主嗎？
不會。這一頁列出整個組織的所有呼叫，不依倉庫或被指派的貨主篩掉；要看特定串接，請用串接憑證條件篩選。
▪ 對方說有查詢訂單，為什麼找不到紀錄？
成功的查詢不留紀錄，只有失敗的查詢才會出現，見哪些呼叫會留紀錄。
▪ 對方一直連不進來，紀錄裡卻一筆都沒有？
最常見的是 Token 錯誤或沒帶 Token，這類呼叫認不出是哪組串接，不會留紀錄。請對方確認使用的是最新一次重發後的 Token。
▪ 為什麼 App 的紀錄沒有請求內容？
組織 App 的呼叫一律不保存請求與回應內容，只記錄是哪個安裝、哪個授權版本、線上或離線授權，以及線上授權時代表哪位人員操作，見展開明細。
▪ 操作人員顯示一串代碼而不是名字？
代表該人員已不在您的組織中（例如帳號已刪除），系統無法對應到名字，只能顯示代碼。離線授權沒有操作人員，顯示「-」。
▪ 某張訂單的串接過程要怎麼查？
到該訂單的詳情頁開「串接紀錄」分頁，會列出這張訂單與它的出貨單經 Vanta Connect API 成功處理的呼叫，不必在這裡逐筆找。被拒絕的呼叫（例如宣告出貨回 422）不會掛在訂單上，要回到本頁依時間與操作篩選查看。
3.2 注意事項
⚠️ 重要提醒
- 紀錄保留約 2 個月，更早的紀錄會被清除且無法找回；需要長期留存的串接問題，請先把明細另存。
- 展開明細可看到收件人姓名、電話、地址等個資，請勿截圖外傳給與該貨主無關的對象。
💡 提示：排查某個廠商的問題時，先用「串接憑證」加「狀態碼」篩出失敗呼叫，再逐筆展開看錯誤代碼，比逐頁翻找快。
四、相關功能
| 功能 | 說明 | 連結 |
|---|---|---|
| Vanta Connect 串接 | 建立、停用串接憑證，調整權限範圍與 IP 白名單 | 前往 |
| 訂單詳情 | 在「串接紀錄」分頁查看單一訂單的串接紀錄 | 前往 |
| Webhook 紀錄 | 查看系統主動推送給串接方的通知 | 前往 |