電商帳號詳情
目錄
一、功能介紹
電商帳號詳情頁完整呈現一個電商帳號的串接狀態與設定，左半邊是「連線資訊」，右半邊是「功能設定」。除了檢視，您也能在這裡執行幾個手動同步動作（排程抓單、同步對應商品、手動同步庫存），以及進入編輯或刪除帳號。頁面下方的同步紀錄則供您回查每一次自動同步的結果與失敗原因。
1.1 連線資訊（左半邊）
顯示帳號的基本資料與串接憑證：所屬電商平台、顯示名稱、綁定的銷售通路，以及該平台的串接資訊（為保護機密，金鑰類欄位會以遮罩呈現）。右上角的標籤顯示目前連線狀態，三種狀態的意義見 電商串接列表。
當帳號處於「斷線」時，頁面頂端會出現紅色提示，授權類平台提供「重新授權」按鈕、金鑰類平台提供「編輯」按鈕，方便您直接恢復連線。
1.2 功能設定（右半邊）
| 區塊 | 顯示內容 |
|---|---|
| 抓取訂單 | 是否開啟、設定的抓單時段、下次抓單時間；蝦皮帳號另顯示「即時抓單」是否開啟 |
| 入庫推送 | 是否開啟、推送比例、已對應商品數、最後同步時間 |
| 物流代碼對應 | 平台物流代碼對應到倉庫端物流的清單 |
這些設定的調整在 編輯頁 進行；詳情頁僅供檢視與執行下方的手動同步。
1.3 手動同步操作
詳情頁提供三個手動動作，依帳號狀態與設定決定是否出現：
| 動作 | 出現條件 | 效果 | 可逆性 |
|---|---|---|---|
| 立即觸發抓單 | 連線正常且已開啟抓取訂單 | 立刻排一次抓單，不必等下個排程時段 | 只是提早抓單，無副作用 |
| 同步對應商品 | 連線正常、已開啟入庫推送且平台支援 | 重新比對平台商品與倉庫商品的對應關係 | 僅更新對應表，不動庫存 |
| 手動同步庫存 | 連線正常、已開啟入庫推送且平台支援 | 把目前倉庫的實際庫存依推送比例「整批覆蓋」到平台 | 會直接改寫平台庫存，按下前有確認視窗 |
📌 補充：「手動同步庫存」與日常的入庫推送不同——入庫推送只在補貨時增加平台庫存，手動同步則是用目前庫存整批覆蓋平台數字，適合在數字對不上時做一次性校正。
1.4 即時通知自動檢查
每次開啟這一頁，系統都會自動到電商平台確認這個帳號的即時通知有沒有設定好，缺了或已失效就直接補上。檢查在背景進行，不影響頁面開啟速度，您不必按任何按鈕。
即時通知是讓平台一有訂單異動就立刻通知系統的機制，補上之後訂單不必等下一個抓單時段才進來。在即時進單功能上線前就串好的帳號，以及後來才在平台補上通知權限的帳號，過去都得有人回去重按一次連線測試才會啟用；現在只要進過一次這一頁就會自動修好。
| 這次檢查的結果 | 畫面上會看到 |
|---|---|
| 平台上還沒有 → 自動建立 | 浮動提示說明已啟用，並列出這次涵蓋哪些通知事件 |
| 已失效或涵蓋事件不齊 → 刪掉重建 | 浮動提示說明原本那組已失效、已重新建立，同樣列出涵蓋的事件 |
| 已存在且正確 → 什麼都沒做 | 完全沒有提示。重整頁面數次仍會實際檢查，但沒有新變動就不會重複跳提示 |
| 金鑰缺少即時通知權限 | 一則不會自動關閉的提示，指引您回平台補權限並重新產生金鑰 |
| 電商平台不接受本系統的連線來源（IP 未加入平台白名單） | 一則不會自動關閉的提示，說明要聯繫客服協助處理。這一種您自己重新產生金鑰沒有用，需要把本系統的連線 IP 加進平台白名單 |
| 平台逾時、回錯誤或達到呼叫頻率上限 | 不顯示任何提示，既有的定時抓單不受影響，下次進入這一頁自動再試一次 |
不會觸發檢查的情況：帳號不是「已連線」（未測試過或已斷線一律不對平台發出呼叫）、您的帳號只有電商串接的檢視權限、或該平台沒有可自動設定的即時通知。
1.5 同步紀錄
頁面下方的「同步紀錄」列出這個帳號最近幾次自動同步的結果，一列一次。某次同步既沒處理到任何資料、也沒有失敗時不會留下紀錄，所以清單上的每一列都代表系統真的做了事或遇到問題。
| 欄位 | 看什麼 |
|---|---|
| 類型 | 這次同步的項目：「抓單」把平台訂單抓進來、「退貨單同步」把平台退貨單建成退貨單、「庫存推送」把庫存推到平台、「商品對應」重建商品對應。四者各走各的，退貨單同步失敗不會影響抓單 |
| 狀態 | 「成功」全部完成；「部分失敗」部分成功、部分失敗；「失敗」這一輪完全沒有成功，多半是憑證或連線問題 |
| 結果 | 這一輪成功與失敗各幾筆 |
有失敗明細的列可以點開。展開後一列是一筆失敗：「對象」欄指出是哪一筆出問題（退貨單同步顯示的是平台的退貨單號，可直接拿回平台後台查），「錯誤」欄是失敗原因，附有「查看 API 紀錄」時可點進去看該次呼叫的完整內容。標示「整批」的列代表整輪都沒跑起來，不是單一筆的問題。同步出現失敗時系統會發通知給您，點通知會回到這一頁並自動展開那一次紀錄。
「退貨單同步」的失敗原因與處理方式：
| 失敗原因 | 怎麼處理 |
|---|---|
| 退貨品項對應不到商品 | 整張退貨單不會建立。錯誤訊息裡是對不上的平台品項編號，可回平台後台比對。把對應補起來——按 同步對應商品 重建商品對應，或到「未知商品」把來源訂單上對不到的品項對應到您的商品——之後不必再做任何事，平台端近 7 天內有更新的退貨單會在下一輪自動補建 |
| 退貨品項缺少庫存類型 | 系統不知道這些商品退回後要收進哪一種庫存分類。到這個帳號綁定的銷售通路確認已設定主要庫存類型，設定後同樣會在下一輪自動補建 |
| 整批失敗（整批） | 依「錯誤」欄的內容分三種：寫「平台授權已失效」是憑證或金鑰過期，帳號會同時被自動標記為「斷線」，請依頁面上方的紅色提示重新授權或更新憑證後再測試連線；寫「平台拒絕本系統的連線來源」是本系統的連線 IP 不在平台白名單內，重新授權沒有用，請聯繫客服協助處理；顯示的是平台原文時，多半是這組憑證在平台端沒有退貨相關的權限，需回平台後台確認 |
二、常見問題
2.1 FAQ
▪ 為什麼看不到「立即觸發抓單」按鈕？
這個按鈕只在帳號「連線正常」且「已開啟抓取訂單」時才會出現。若帳號斷線，請先恢復連線；若沒開抓取訂單，請到 編輯頁 開啟。
▪ 「手動同步庫存」會不會把平台庫存弄錯？
它會用倉庫目前的實際庫存、依推送比例整批覆蓋平台數字。如果平台上原本有其他通路的庫存（非本系統管理），覆蓋後會以本系統的數字為準。因此按下前務必確認推送比例設定正確，系統也會跳出確認視窗讓您再次確認。
▪ 「同步對應商品」是做什麼的？
它重新比對電商平台上的商品與倉庫系統商品的對應關係。當您剛在平台新增商品、或修正了平台品號後，可手動同步一次讓對應關係即時更新，避免訂單因找不到對應商品而變成未知商品。它只更新對應表，不會異動庫存。
▪ 顯示「尚無對應商品」是正常的嗎？
剛開啟入庫推送、還沒同步過對應商品時會顯示尚無對應。按一次「同步對應商品」即可建立對應。部分平台採即時反查、不保存對應表，這類平台不會顯示對應商品數，屬正常現象。
▪ 帳號斷線了，要在這頁修嗎？
頁面頂端的紅色提示會引導您：授權類平台點「重新授權」重新授權，金鑰類平台點「編輯」進編輯頁更新並重新測試憑證。
▪ 同步紀錄裡的「退貨單同步」是什麼？我沒設定過
那是 Shopline 退貨單自動進倉的紀錄。串接 Shopline 的帳號只要連線正常且開啟抓取訂單，平台上的退貨一成立、完成或取消，Shopline 就會即時通知系統，系統回平台讀取後把買家申請或確認的退貨自動建成退貨單；系統另外每 30 分鐘也會到平台檢查一次，補上漏送的通知。這組即時通知是測試連線成功時由系統自動向 Shopline 註冊的，您不需要做任何設定，也不需要您或倉庫再手動開單。詳細行為見退貨列表。
▪ 不想讓退貨單自動進來，要怎麼關？
退貨單同步跟著「抓取訂單」的開關走。到 編輯頁 關閉抓取訂單後，這個帳號就不再自動抓訂單、也不再自動建立退貨單；但已經建好的退貨單不會被移除，仍要照原流程處理或取消。
▪ 為什麼設定的時段到了，訂單卻晚一點才進來？
您底下的多個通路，依設定時段自動進行的抓單是依序執行的，同一時間只有一個在抓——這是為了避免兩個通路同時匯入含相同商品的訂單時互相搶同一批庫存，雙雙被判缺貨。所以設定的時段是「最早開始時間」而不是「保證開始時間」：排在後面的通路要等前面那個抓完才開始，通路愈多、平台回應愈慢，延後愈明顯。
這個依序執行只涵蓋自動排程。您自己按「立即觸發抓單」，以及平台即時推單造成的單筆補抓，都不受此限，可能與正在進行的排程抓單同時發生。
▪ 同步紀錄是空的，代表沒在同步嗎？
不一定。某次同步沒有任何資料要處理、也沒發生失敗時就不會留下紀錄，所以剛串接或平台端沒有異動時清單是空的很正常。要判斷有沒有在跑，看功能設定區的 下次抓單時間：自動排程那一輪要等抓完才會往後跳，所以它停在已經過去的時間通常代表正在抓，不是卡住。
按「立即觸發抓單」則不一樣——按下的當下這個時間就會立刻往後跳，所以它不能拿來判斷那一次手動抓單跑完了沒；手動抓單的結果要看同步紀錄（有訂單要處理或發生失敗時才會出現新的一列）。
▪ 一進這一頁就跳出「已啟用即時通知」的提示，是我按到什麼嗎？
不是。開啟這一頁時系統會自動檢查一次這個帳號的即時通知設定，缺了就補上，補好才會跳提示（見即時通知自動檢查）。提示裡列的是這組通知涵蓋哪些事件。沒有變動時完全不會有提示，所以看到它就代表這次真的幫這個帳號補上了設定。
▪ 提示說金鑰沒有即時通知權限，要怎麼處理？
到電商平台的後台，在授權頁勾選即時通知（webhook）權限後重新產生金鑰，再到編輯頁更新金鑰並測試連線。之後再進一次這一頁就會自動完成設定並跳出成功提示。在補權限之前，訂單仍會依設定的時段照常抓取，不會漏單。
▪ 刪除帳號會發生什麼事？
帳號會從列表移除，相關的商品對應資料一併清除，無法復原。刪除前請確認這個平台的訂單已不需要再透過系統處理。
2.2 注意事項
⚠️ 重要提醒
- 「手動同步庫存」會整批覆蓋平台庫存，操作前務必確認推送比例正確
- 刪除帳號會一併清除商品對應資料且無法復原
- 帳號斷線時訂單停止匯入，請盡快依頂端提示恢復連線
- 關閉抓取訂單會連帶停掉 Shopline 的退貨單自動建單，兩者共用同一個開關
- 退貨驗收結果不會回寫電商平台，退款與購物金請自行在平台後台處理
💡 提示：平台庫存數字與系統對不上時，先確認推送比例與對應商品都正確，再用「手動同步庫存」做一次整批校正。
三、相關功能
| 功能 | 說明 | 連結 |
|---|---|---|
| 電商串接（編輯） | 調整帳號的憑證與抓單、推送、物流對應設定 | 前往 |
| 電商串接（列表） | 查看與管理所有電商帳號 | 前往 |
| 平台串接紀錄 | 查看這個帳號的訂單抓取、庫存推送呼叫紀錄與失敗原因 | 前往 |
| 退貨列表 | 查看平台自動建立的退貨單與其處理進度 | 前往 |