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