電商帳號詳情
目錄
一、功能介紹
電商帳號詳情頁是您查看單一電商串接「現在連得上嗎、設定了什麼、要不要手動觸發一次」的地方。代客操作時,您在這裡確認某個平台帳號的連線狀態與遮罩過的串接資訊,檢視抓單與庫存推送的設定,並在需要時手動排一次抓單、同步對應商品或覆寫平台庫存。頁面左欄是連線資訊、右欄是功能設定,斷線時最上方會跳紅色提示讓您直接重新授權或編輯。頁面最下方的同步紀錄則是排查「訂單/退貨單怎麼沒進來」的第一站。

1.1 連線資訊(左欄)
左欄標題為 連線資訊,右上角顯示目前的連線狀態標籤。
連線狀態共三種,整頁只在這裡完整列出:
| 狀態 | 代表意義 |
|---|---|
| 未驗證 | 帳號剛建立、或串接參數變更後尚未測試連線 |
| 已連線 | 上次測試連線成功,可正常抓單與推送 |
| 斷線 | 上次測試失敗、或系統判定已斷線 |
基本資訊以表格列出貨主、電商平台(平台標籤)、顯示名稱 與 通路名稱。
串接資訊區(標題帶鎖頭圖示)依平台顯示對應的憑證欄位,不同平台欄位不同(例如金鑰、帳號、商店代碼)。其中密鑰、權杖、密碼類的敏感欄位一律以 ******** 遮罩,畫面上不會顯示真實值。
最底部以小字標示 建立時間 與 更新時間。
當帳號狀態為「斷線」時,頁面最上方會出現紅色提示,並依平台類型給不同的修復按鈕:
- 授權型平台(Shopify、Shopee、Liteshop):顯示 重新授權 按鈕,點擊會帶您回到該平台重新授權。
- 金鑰型平台:顯示 編輯 按鈕,帶您到編輯頁更新串接參數後重新測試連線。
1.2 功能設定(右欄)
右欄標題為 功能設定,依平台支援的功能顯示設定。
出貨倉:位於功能設定最上方,顯示這個帳號抓進來的訂單落在哪個倉、回推庫存只算哪個倉;顯示「使用貨主預設倉(目前:倉庫名稱)」時,代表沒有指定出貨倉,訂單落在貨主目前的預設倉庫、回推也只算這個倉的可售量。OneWarehouse 帳號不顯示;貨主只有一個可用倉庫且這個帳號沒有指定出貨倉時也不顯示。抓取訂單與庫存推送都沒有開啟時(平台不支援庫存推送時只看抓取訂單),出貨倉不會產生任何效果,旁邊會標示「抓取訂單與庫存推送都未開啟,此設定暫不生效」(不支援庫存推送的平台標示「需先開啟「抓取訂單」才會生效」)。要更改請到編輯頁。
抓單設定:顯示 抓取訂單 是開啟或關閉,以及 抓單時間(每天自動抓單的時段標籤)。下次抓單時間 只在抓單開啟時列出。有即時通知的平台還會顯示 即時抓單:開啟時平台一有新訂單通知就會另外排一次抓單,新訂單通常幾分鐘內進到系統(蝦皮約 5 分鐘);關閉時新訂單只在上述時段進入。
抓單關閉時,系統不會自動把這個平台的訂單匯入倉庫;平台送來的通知只套用取消與買家申請取消,其他訂單與退貨通知不處理。此時時段仍會列出您先前存的值,方便您確認設定內容,但旁邊會標示「需先開啟「抓取訂單」才會生效」。即時抓單 此時不會執行,一律顯示與抓取訂單相同的灰色「關閉」;若您存的是開啟,旁邊另標示「需先開啟「抓取訂單」才會生效」,重新開啟抓取訂單後即恢復。要確認即時抓單存的值請到編輯頁。
庫存推送設定:顯示 庫存推送方式 目前選的方式(「關閉」為灰色標籤,「入庫時推送」或「定時同步(每 30 分鐘)」為綠色標籤),以及 推送比例(推送到平台的庫存比例)。選「關閉」時,比例仍會列出您先前存的值,下方標示「需先選擇庫存推送方式才會生效」。推送方式不是「關閉」、且平台會把對應關係保存下來時,還會顯示對應商品數量與 最後同步時間;尚未同步過時顯示「尚無對應商品」。已建立組合商品對應時,下方另列一行組合商品的對應數(與單品對應數分開計算,沒有組合商品對應時不顯示)。推送方式不是「關閉」、平台支援手動同步庫存或同步對應商品,但綁定銷售通路的「商品對應規則」不是以 SKU 對應時,會標示「此通路的商品對應規則不是 SKU,組合商品不會回拋」——平台訂單回來時只有以 SKU 對應的通路能認出組合商品,因此不推組合商品的數量。
託運單版型:只有 Momo、Mo店+、Shopline、Cyberbiz 帳號會出現,顯示目前列印物流面單使用的版型——A4(平台原始版型)(預設)或 熱感紙(切成左右兩聯)。Cyberbiz 帳號的熱感紙顯示為「熱感紙(兩聯上下排成一張)」,且只套用在黑貓快速到店。要更改請到編輯頁。
物流代碼對應:以表格呈現「平台物流代碼 → 倉庫端物流」的對應關係,只有設定過對應時才會出現這個表格。
▸ Ragic 入庫單串接
Ragic 顯示「抓取入庫單」、「入庫抓取時間」及「下次入庫抓取時間」,可確認入庫單何時會自動匯入。入庫抓取與訂單抓取各有獨立的開關和排程;停用或斷線時不顯示下次入庫抓取時間。停用入庫抓取時,已設定的抓取時段仍會列出,旁邊標示「需先開啟「抓取入庫單」才會生效」。
「入庫單欄位對應與匯入條件」列出入庫表路徑、匯入樣板、品項子表及匯入條件。「收貨完成回寫」列出回寫的狀態欄位、完成值與收貨日期欄位;未設定的欄位顯示「-」。設定需到編輯頁調整。
Ragic 目前不支援庫存推送,因此不顯示「庫存推送方式」及「推送比例」。收貨完成後依設定回寫原入庫表單,與把庫存數量推回平台是不同功能;即使之後停用入庫抓取,已匯入單據的收貨結果仍會在連線正常時依設定回寫。
只串入庫單時,關閉訂單抓取即可;訂單表路徑、抓單時段、訂單匯入樣板、匯入條件、出貨回寫與「物流代碼對應」會隱藏。其中抓單時段只在編輯頁隱藏;本頁仍會列出您已存的時段,旁邊標示「需先開啟「抓取訂單」才會生效」提醒目前不生效,不是設定遺失。重新開啟時會恢復顯示,儲存停用設定不會清除原訂單設定。既有帳號重新測試連線時,會一併儲存畫面目前的入庫開關與設定;若已關閉入庫抓取,即使同時更換 API Key 或來源表,也會保持關閉。切換入庫表後,新表相同的紀錄 ID 仍可匯入(單號須保持唯一);舊單仍回寫原表,使用匯入時保存的回寫欄位設定。同一輪收貨重複結案會保留首次完成時間;重新開啟後再完成才會建立新一輪回寫。每次回寫只補原表的空白欄位,已有狀態或收貨日期會保留。品項有內容卻缺商品編號,或指定了無效日期時,整張單不會匯入,請依串接紀錄修正來源資料。
入庫品項只能使用貨主目前啟用的庫存類型。未指定類型而沿用銷售通路預設值時,也適用此限制;若該類型已停用,整張單不會匯入,請先修正通路設定或啟用類型,再重新抓取。
樣板中的自訂屬性預設值,即使未對應來源欄位也會套用;來源已有值時優先採用來源。是/否屬性可填 Y/N 或 1/0,數字與日期會依屬性型別轉換;無效值會阻止整張單匯入,請依串接紀錄修正後重抓。收貨完成回寫若失敗,系統最多自動重試 2 次,耗盡後停止並通知;回寫結果與處理方式見入庫單詳情。
已連線且啟用入庫抓取時,具有電商帳號編輯權限的使用者可按「立即抓取入庫單」,不用等待下一個抓取時段。觸發後到串接紀錄查看結果;同一帳號每 10 分鐘可手動觸發一次,與訂單抓取的限制分開計算。
1.3 手動觸發的操作
右欄的兩個設定區塊各自帶有可手動觸發的按鈕,這些按鈕的出現條件由帳號目前的狀態與平台決定,不是每個帳號都看得到(看不到的原因見常見問題)。
▪ 立即觸發抓單
立即把一次抓單作業排入佇列,不必等下一個自動排程時段。
- 出現條件:帳號已連線、且抓取訂單已開啟;OneWarehouse 帳號的訂單由對方推進來,沒有這個按鈕。
- 副作用:只是提前觸發一次抓單,不影響自動排程設定;觸發後「下次抓單時間」顯示的仍是下一個自動排程時間。抓單期間若遇到排程時段,該時段的排程抓單與定時同步會順延一輪。
- 限制:有 10 分鐘冷卻時間。冷卻中再次點擊,系統會提示「操作太頻繁,請於 N 分鐘後再試」。
- 排隊:同一個貨主有抓單進行中(排程或另一次手動抓單)時,會在它結束後幾分鐘內自動開始,不需要重按;等待期間冷卻會一直延長,再按只會提示「操作太頻繁」。若約一小時內都排不上,這次手動抓單會取消,改由下一個整點或半點的排程補抓。
▪ 同步對應商品
從電商平台拉回商品清單,建立 WMS 商品與平台商品的對應關係。
- 出現條件:帳號已連線、「庫存推送方式」不是「關閉」、且該平台支援同步對應商品。
- 組合商品:平台品號對不到單品、但對得到該貨主組合商品品號的品項,會建成組合商品對應;手動同步庫存時就是依這份對應推組合商品的數量。
- Shopline 商品狀態:只有「上架中」與「隱藏」(前台列表看不到、只能用連結購買,例如團購商品)的商品會建立對應;「下架」(草稿)與已刪除的商品不會建立對應,原有對應也會在同步時清掉。同一個 WMS 商品同時對到上架中與隱藏商品時,推送的庫存會由兩者平分,避免超賣。
- 91APP 多商品頁:91APP 沒有這個按鈕、也不建立對應,每次推送庫存都直接用品號到 91APP 找出它的所有商品頁。推送寫入的是 91APP 商品頁的「可售數量」,不是總庫存:入庫等庫存增加時,先讀商品頁目前的可售數量再加上增量;定時同步與「手動同步庫存」直接把可售數量設成推送的數量。同一個品號在 91APP 有多個商品頁時,推送的數量(入庫等庫存增加時推的增量、定時同步與「手動同步庫存」推的可售量,組合商品的可售量也一樣)會平分到各商品頁,除不盡的餘數給商品頁序號較小的,避免超賣。貨主要每個商品頁都賣滿量,需在 WMS 拆成不同商品、各用不同品號。
- 結果:對應建立完成後,可在右上角的通知中看到結果;本頁上方的對應商品數量與最後同步時間也會自動換成新值,不需要重新整理。
▪ 手動同步庫存
以 WMS 當下的可售量「絕對值覆寫」平台上的庫存數字。
- 出現條件:帳號已連線、「庫存推送方式」不是「關閉」、且該平台支援手動同步庫存。
- 副作用:直接覆寫電商平台端的庫存數量,會影響線上銷售(詳見注意事項)。
- 計算範圍:只算「出貨倉」的可售量,沒有指定時只算貨主預設倉庫;推送比例與通路的庫存類型、效期限制照常套用。剛改過出貨倉時,按一次就能讓平台換成新倉的數字。
- 組合商品:同一次也會推組合商品的可售量(算法見新增組合商品);組合商品推送失敗不影響單品照常推送。通路商品對應規則不是以 SKU 對應時不推組合商品。有「同步對應商品」按鈕的平台,只推已建立對應的組合商品,需先同步對應商品;Liteshop、91APP 沒有這個按鈕,直接以該貨主所有組合商品為對象,平台上沒有的品號會略過。已停用或刪除的組合商品推 0,原品號已改由其他商品或組合商品使用時則不推 0。推送方式為「定時同步(每 30 分鐘)」時,組合商品也會在定時同步中隨子品在這個帳號採計的庫存(銷售通路或組合指定的庫存類型、出貨倉)、組合內容、回拋比例或啟用狀態的異動更新;「入庫時推送」不會帶動組合商品。
- 確認步驟:點擊後會跳出紅色確認對話框「確認手動同步庫存」,確認後才執行。
- 同步進行中:同一帳號已有同步在進行時,這次手動同步會在稍後自動執行,不必重按;等待期間重複點擊也只會補跑一輪。若前一輪超過約 30 分鐘仍未結束,這次同步會放棄不執行,請稍後再按一次。
- 同步失敗時:平台連線暫時中斷(逾時)時,這次同步記為失敗、帳號不會被標成斷線,抓單與其他功能照常;失敗會留在同步紀錄,這次不會自動重推,請稍後再按一次。平台授權失效時,帳號會被標成「斷線」,請依頁面頂端的紅色提示恢復連線。Shopee、Liteshop、Shopify、東森購物 B2B、Free Store 開店平台 更新授權時,只有平台明確拒絕才會把帳號標成斷線;若帳號仍顯示已連線、同步紀錄卻每一輪都失敗,處理方式依平台而定:Shopee、Liteshop 到編輯頁先按「取消授權」再按「授權連線」;Shopify 到編輯頁按「取消授權」後,回本頁按頂端紅色提示的「重新授權」;東森購物 B2B、Free Store 開店平台 到編輯頁更新串接參數,再按「測試連線」。
- 自動版本:「庫存推送方式」選「定時同步(每 30 分鐘)」時,系統每 30 分鐘會自動對有庫存異動的商品做同樣的覆寫,運作方式見新增電商帳號的功能設定。
1.4 即時通知自動檢查
只要有人開啟本頁,系統就會自動到電商平台確認這個帳號的即時通知有沒有設定好,沒設定或已失效就直接補上。檢查在背景進行,不影響頁面開啟速度,您不必按任何按鈕。
即時通知是讓平台一有訂單異動就立刻通知系統的機制,補上之後訂單不必等下一個抓單時段才進來。在即時進單功能上線前就串好的帳號,以及後來才在平台補上通知權限的帳號,過去都得有人回去重按一次連線測試才會啟用;現在只要進過一次本頁就會自動修好。
| 這次檢查的結果 | 畫面上會看到 |
|---|---|
| 平台上還沒有 → 自動建立 | 浮動提示說明已啟用,並列出這次涵蓋哪些通知事件 |
| 已失效或涵蓋事件不齊 → 刪掉重建 | 浮動提示說明原本那組已失效、已重新建立,同樣列出涵蓋的事件 |
| 已存在且正確 → 什麼都沒做 | 完全沒有提示。重整頁面數次仍會實際檢查,但沒有新變動就不會重複跳提示 |
| 金鑰缺少即時通知權限 | 一則不會自動關閉的提示,指引到平台補權限並重新產生金鑰 |
| 電商平台不接受本系統的連線來源(IP 未加入平台白名單) | 一則不會自動關閉的提示,說明要聯繫客服協助處理。這一種貨主自己重新產生金鑰沒有用,需要把本系統的連線 IP 加進平台白名單 |
| 平台逾時、回錯誤或達到呼叫頻率上限 | 不顯示任何提示,既有的定時抓單不受影響,下次進入本頁自動再試一次 |
不會觸發檢查的情況:帳號不是「已連線」(未測試過或已斷線一律不對平台發出呼叫)、您只有唯讀權限(不觸發也不顯示任何提示)、或該平台沒有可自動設定的即時通知。
會自動檢查的平台是 Shopline、Shopify、WooCommerce、Liteshop、EasyStore 與 Free Store 開店平台;BV SHOP、蝦皮與 Yahoo 不在範圍內,開本頁也不會替它們做任何設定。
每天凌晨也會自動檢查一次:系統每天凌晨會對所有「已連線」的帳號做同樣的檢查,不必有人開本頁。電商平台在推送連續失敗後會自己把通知移除(Shopify)或停用(WooCommerce、Shopline),之後就不再推過來、訂單只能等抓單時段;每日檢查發現時會重建或重新啟用,這段空窗最多一天。
- 通知只發給原本註冊成功過的帳號:這個帳號的即時通知曾經設定成功、後來被平台移除或停用,這次被救回時,倉庫端與貨主後台才會收到「推播訂閱已自動修復」的系統通知。從來沒設定成功、這次才補上的照樣會修好,但不發通知;本來就正常的也不發。
- WooCommerce 手動暫停的不會被改回:只有被平台自動停用(Disabled)的會被重新啟用。貨主在 WooCommerce 後台自己把 webhook 設成暫停(Paused),系統視為刻意暫停,不會改回啟用。
- 檢查失敗(平台逾時、回錯誤)不發通知,隔天凌晨再試。
1.5 頁首操作
頁面右上角固定提供帳號層級的兩個操作:
- 編輯:前往編輯電商帳號頁修改顯示名稱、串接參數、抓單與推送設定、「物流代碼對應」等。
- 刪除:點擊後跳出確認對話框,確認後刪除此帳號。刪除前系統會先嘗試清除先前在平台上建立的自動通知,再移除帳號,且無法復原(詳見注意事項)。
1.6 同步紀錄
頁面最下方的「同步紀錄」列出這個帳號最近幾次自動同步的結果,一列一次。貨主問「訂單/退貨單怎麼沒進來」時,先看這裡。抓單、退貨單與庫存推送在沒有任何資料要處理、也沒失敗時不會留下紀錄,所以這三種的空清單不等於故障(「定時同步(每 30 分鐘)」每一輪有推送商品就留一列「庫存推送」,和按「手動同步庫存」留下的列看起來一樣,不區分是哪一種觸發;兩輪之間庫存沒有異動就不留紀錄);抓單或退貨單那一輪即使只處理了平台取消(本地取消,或訂單已進出貨流程而改建「電商平台取消」攔截),也會留下一列「成功」;「商品對應」則成功或失敗都會留下一列,只有每日自動的增量同步碰上平台端完全沒有商品異動時不留紀錄(那是正常結果)。按「同步對應商品」或剛連線後的首次全量同步,若一份商品清單都沒取得也會留下一列(尚未成功取得過商品清單的帳號,同步進度還停在起點,每日自動那一輪會被當成全量處理,因此會持續每晚留下一列,直到它第一次真的取到商品為止)。「Yahoo 購物中心」的商品檔案由平台非同步回送:觸發失敗會立刻留下一列,觸發成功則要等平台回送商品檔案之後才寫成功那列,按下按鈕後要等幾分鐘才會出現;商品檔案回送後若下載或解析失敗,則不會留下任何一列,改看系統通知。
| 欄位 | 看什麼 |
|---|---|
| 類型 | 這次同步的項目:「抓單」抓平台訂單、「退貨單同步」把平台退貨單建成退貨單、「庫存推送」推庫存到平台、「商品對應」重建商品對應。四者各跑各的,退貨單同步失敗不會連累抓單 |
| 狀態 | 「成功」全部完成;「部分失敗」部分失敗;「失敗」整輪都沒成功:可能是憑證或連線問題讓整輪中斷,也可能是每一筆都逐筆失敗(例如運送方式沒設定對應),展開看明細就分得出來。「商品對應」另有一種「清理未執行」,代表這次沒取得完整商品清單,系統為了安全不動任何既有對應(其中連一份商品清單都沒取得的那一種,同步進度也不會推進),下一次會重試 |
| 結果 | 「抓單」、「退貨單同步」、「庫存推送」顯示這一輪成功與失敗各幾筆。抓單與退貨單的成功包含平台取消後在本地處理完成的單(本地取消,或訂單已進出貨流程而改建攔截),同一張單之後幾輪不會重複計;本地取消被拒的只算失敗,即使系統已改建攔截;「商品對應」沒有逐筆成敗,改顯示這一輪掃到幾個商品、更新幾筆對應、清理幾筆對應 |
有失敗明細的列點一下就展開,一列一筆失敗:「對象」欄指出是哪一筆(退貨單同步顯示平台的退貨單號),「錯誤」欄是原因,附「查看 API 紀錄」時可點進去看該次呼叫的完整內容。標示「整批」的是整輪中斷或某段請求失敗,不是單一筆的問題。
「抓單」與「庫存推送」的「錯誤」欄若寫「正在更新授權,請稍後再試」或「平台暫時無法更新授權,請稍後再試」,是這輪更新平台授權沒有完成:前者是另一個工作正在更新這個帳號的授權,後者是平台這次沒能完成更新。這輪會中止、帳號不會被標成斷線,下一輪會再試,看到時不用處理;每一輪都這樣才要處理,方式見手動同步庫存的說明。
「商品對應」沒有單筆失敗,被平台擋下時整列就是「失敗」、展開只有一列「整批」。「錯誤」欄有三種寫法:系統自己攔下的情況(例如平台回的商品資料讀不懂、商品清單沒讀完)以及憑證、連線問題,只顯示翻成中文的說明;平台明確拒絕這次商品清單查詢時,中文說明後面會接上平台回的那句原文(通常夾帶英文的技術字樣,也是唯一看得到平台實際理由的地方);其餘平台回報但系統歸類不出來的錯誤(例如平台系統忙碌)則整句照原文顯示。附有「查看 API 紀錄」時可點進去看那次呼叫的完整往返內容。這種失敗幾乎都發生在讀取平台清單的階段,還沒動到任何既有對應;同步進度也不會推進,請貨主稍後再按一次「同步對應商品」重試。
「退貨單同步」的失敗原因與處理方式:
| 失敗原因 | 怎麼處理 |
|---|---|
| 退貨品項對應不到商品 | 整張退貨單不會建立,貨還是會實體退回倉庫。到「未知商品」把來源訂單上對不到的品項對應到系統商品,或請貨主按 同步對應商品 重建對應;補好之後平台端近 7 天內有更新的退貨單會在下一輪自動建進來,不必手動補單 |
| 退貨品項缺少庫存類型 | 系統不知道這些商品要收進哪一種庫存類型。到這個帳號綁定的銷售通路確認已設定主要庫存類型,設定後下一輪會自動補建 |
| 整批失敗(整批) | 依「錯誤」欄的內容分三種:寫「平台授權已失效」是憑證或金鑰過期,帳號會同時被自動標記為「斷線」,請貨主更新憑證後重新測試連線;寫「平台拒絕本系統的連線來源」是本系統的連線 IP 不在平台白名單內,重新授權沒有用,請聯繫客服協助把 IP 加進白名單;顯示的是平台原文時,多半是這組憑證在平台端沒有退貨相關權限,要請貨主回平台後台確認 |
二、常見問題
2.1 常見問題
▪ 為什麼我看不到「立即觸發抓單」按鈕?
這個按鈕只在帳號「已連線」且「抓取訂單已開啟」時出現。若帳號目前是「斷線」或「未驗證」,或抓單設定為關閉,按鈕就不會顯示。先讓帳號回到已連線(見下方斷線處理),並到編輯頁開啟抓取訂單。OneWarehouse 帳號的訂單由對方推進來,沒有抓取訂單設定,也不會有這個按鈕。
▪ 為什麼我看不到「同步對應商品」或「手動同步庫存」按鈕?
這兩個按鈕的共同條件是「已連線 + 「庫存推送方式」不是「關閉」 + 該平台支援」。任一條件不符就不會出現。部分平台不支援同步對應商品或手動同步庫存,即使已連線且選了推送方式也不會顯示對應按鈕。
▪ 串接資訊裡的 ******** 是什麼?
那是被遮罩的敏感欄位。為了安全,密鑰、權杖、密碼類的串接參數不會在畫面上顯示真實值,一律以 ******** 呈現。需要更新時請到編輯電商帳號頁重新填寫。
▪ 帳號顯示「斷線」要怎麼處理?
頁面最上方的紅色提示會給對應的修復按鈕:授權型平台(Shopify、Shopee、Liteshop)點 重新授權 回平台重新授權;金鑰型平台點 編輯 到編輯頁更新串接參數,存檔後再測試一次連線。連線恢復後抓單與推送才會繼續運作。
▪ 帳號斷線時,平台的訂單還會進來嗎?
不會。帳號處於「斷線」時,系統不會自動抓取並匯入這個平台的訂單,「立即觸發抓單」按鈕也不會出現,「定時同步(每 30 分鐘)」也會停止。請先讓連線恢復。
▪ 點了「手動同步庫存」會發生什麼事?
系統會以 WMS 當下的可售量為準,把這個帳號下所有對應商品(含組合商品)的庫存「絕對值覆寫」到電商平台。也就是直接把平台上的庫存數字改成 WMS 的數字,會影響線上銷售,且改了無法自動還原。執行前務必確認 WMS 庫存正確。另外,推送當下還沒抓回系統的平台訂單不會被扣掉,見注意事項。
▪ 推送方式選「定時同步(每 30 分鐘)」,平台數字多久會更新?
帳號已連線時,每 30 分鐘(整點與半點)跑一輪:同一個貨主在這個時段有帳號排程抓單時,等這些抓單結束(不論成功或失敗)才推送,讓剛抓回的訂單先扣掉可售量;沒有排程抓單就直接推送。所以倉庫這邊的異動約 30 分鐘內反映到平台,抓單跑得久時會跟著延後。改成這個方式後的第一輪會全量同步一次;之後每輪只推上一輪之後庫存有異動的商品;組合商品看子品在這個帳號採計的庫存(銷售通路或組合指定的庫存類型、出貨倉)、組合內容、回拋比例或啟用狀態有沒有異動。幾種會延後的情況:
- 「手動同步庫存」正在推送中,或上一輪還沒推完,這一輪會直接跳過,下一輪補上
- 同一個貨主上一個時段的排程抓單到了下一個整點或半點還沒跑完:這個時段的排程抓單順延到下一個時段,定時同步則由還在跑的那一輪抓完後推送;若當時正在跑的是「立即觸發抓單」,這個時段的排程抓單與定時同步都順延到下一個時段
- 選定時同步時,入庫與庫存調整不會另外推增量,改由下一輪定時同步以最新數量更新,入庫單歷程記為「EC 庫存未推送(交由庫存同步)」。選「入庫時推送」時照舊推增量;若剛好有人在按「手動同步庫存」,入庫時的推送會排隊,每分鐘重試一次,最多等 30 分鐘,超過才在入庫單歷程記為推送失敗
- 組合商品的數量算不出來或整批推不上去時,單品照常更新,這一輪記為失敗,下一輪重算同一段期間
- 平台拒絕其中某些商品(含組合商品):其餘商品照常更新;被拒的商品即使之後沒有異動,接下來兩輪也會自動重推,仍失敗就停止,等該商品下次有庫存異動時再推。失敗原因看同步紀錄。91APP 個別被拒的商品不會自動重推,要等下次有庫存異動才會再推;Liteshop、91APP 遇平台故障(Liteshop 整批被拒、平台回傳伺服器錯誤或限流)時,這一輪記為失敗,下一輪重推同一段期間
- 平台連線暫時中斷(逾時)時,這一輪記為失敗、下一輪重試,帳號不會被標成斷線;平台授權失效時,帳號會被標成「斷線」並停止定時同步;依頁面頂端的紅色提示恢復連線後,下一輪會補上斷線期間的異動
▪ 貨主說平台上組合商品的庫存沒更新?
依序確認:綁定通路的「商品對應規則」是以 SKU 對應(本頁會標示「此通路的商品對應規則不是 SKU,組合商品不會回拋」就代表不是);有「同步對應商品」按鈕的平台,庫存推送區塊要看得到組合商品對應數,沒有就先按一次同步對應商品,並確認組合的品號與平台上一致;最後按「手動同步庫存」。組合商品不會隨「入庫時推送」更新;推送方式不是「定時同步(每 30 分鐘)」時,改了組合內容或回拋比例後也要手動同步一次才會反映,是「定時同步(每 30 分鐘)」時下一輪定時同步會自動更新。
▪ 想停止把某個商品的庫存推到平台(例如團購結束)?
到該商品的編輯頁關閉「電商平台庫存同步」。關閉後這個商品之後不再推送(入庫、定時同步與「手動同步庫存」都會略過),但不會把平台上的數量推成 0,平台保留最後一次推送的數量;平台商品若仍可購買,剩下的數量仍可能被下單。這個開關是 WMS 商品層級,同一個 WMS 商品對應到的所有平台商品(例如同品號的上架中與隱藏商品、其他電商帳號的商品)會一起停推。只想停掉 Shopline 的隱藏商品時,改在 Shopline 把它下架或刪除,再按一次「同步對應商品」清掉對應。
▪ 「立即觸發抓單」按了沒反應、提示「操作太頻繁」?
手動抓單有 10 分鐘冷卻時間。同一帳號在 10 分鐘內重複觸發,系統會提示「操作太頻繁,請於 N 分鐘後再試」。等冷卻結束即可再次手動抓單,或等下一個自動排程時段自動抓取。若同一個貨主有抓單進行中,前一次手動抓單其實還在排隊,冷卻會持續延長,不需要重按;約一小時內都排不上就會取消,改由下一個整點或半點的排程補抓。
▪ 貨主說抓單時段到了,訂單卻還沒進來?
同一個貨主底下的多個通路,依設定時段自動進行的抓單是依序執行的,同一時間只有一個在抓——這是為了避免兩個通路同時匯入含相同商品的訂單時互相搶同一批庫存,雙雙被判缺貨。設定的時段是「最早開始時間」而不是「保證開始時間」:排在後面的通路要等前面那個抓完才開始。不同貨主之間各自獨立,不會互相等待。
貨主按「立即觸發抓單」也在這個順序裡:當下同一個貨主有抓單進行中時,會在它結束後幾分鐘內自動開始,等待期間按鈕一直處於冷卻;若約一小時內都排不上,這次手動抓單會取消,改由下一個整點或半點的排程補抓;反過來,手動抓單還在跑時到了排程時段,那個時段的排程抓單與定時同步會順延到下一個時段。平台即時推單造成的單筆補抓則不在這個順序裡,可能與排程抓單同時發生。
判斷「是不是正在抓」不要看同步紀錄有沒有新的一列——抓單沒有資料要處理、也沒失敗的那一輪不會留下紀錄。改看 下次抓單時間:自動排程那一輪要等抓完才會往後跳,停在已經過去的時間通常代表正在抓(例外:手動抓單排隊約一小時仍排不上而取消時,這個時間會被拉回當下,暫時停在過去的時間,等下一個整點或半點的排程補抓)。注意貨主按「立即觸發抓單」時這個時間會立刻往後跳(見手動觸發的操作),所以手動抓單不適用這個判斷方式。
▪ 同步紀錄裡的「退貨單同步」是什麼?
那是 Shopline 退貨單自動進倉的紀錄。串接 Shopline 的帳號只要已連線且抓取訂單為開啟,平台上的退貨一成立、完成或取消,Shopline 就會即時通知系統,系統回平台讀取後把買家申請或已確認的退貨自動建成退貨單;系統另外每 30 分鐘也會到平台檢查一次,補上漏送的通知。這組即時通知是測試連線成功時由系統自動向 Shopline 註冊的,貨主不必做任何設定,倉庫與貨主也都不必再手動開單。這些單的驗收與轉入庫流程和手動建的完全一樣,見退貨列表。
▪ SHOPLINE 平台上已退款的訂單,為什麼沒進系統?
SHOPLINE 訂單的付款狀態是「已退款」或「退款處理中」時,抓單不會匯入:新單不會建立,所以「訂單列表」查不到;同步紀錄也不會顯示原因,被略過的單不會留下失敗明細,那一輪可能完全沒有紀錄,不能靠同步紀錄排查(系統裡已有、被攔截的已退款單情形不同,見下段)。已付款但付款狀態不是「已完成」或「部分退款」的單(例如付款失敗)同樣不會匯入。部分退款(例如退差價)的單照常匯入。
排查時請貨主到 SHOPLINE 後台確認這張單的付款狀態。付款狀態之後有變動,近 7 天內有更新的單下一輪抓單會重新判斷。系統裡已經有的單處理方式不同:
- 已退款、退款處理中:下一輪抓單以「電商平台已退款」攔截(還沒揀貨、揀貨中都一樣),不會自動取消,攔截期間不更新。已經出貨的單不會被動到。解除後恢復跟著平台更新,但系統不再改代收金額,請自行確認並修改。解除「已退款」的攔截後不會再被這個原因攔下;解除「退款處理中」的攔截後,繼續退款處理中不會再攔,平台轉成「已退款」會再攔一次,前一筆還沒解除時兩筆並存。
- 已付款但付款狀態不是「已完成」或「部分退款」(例如付款失敗):開始揀貨前照常跟著平台更新;只有代收金額會因此變成 0 時才以「其他原因」攔截。
已經出了一部分、還有剩餘件沒出的已退款單也攔得到:已退款的單走獨立的查詢,不受訂單在平台上的狀態限制(系統出貨時會把平台上的訂單狀態推成「已確認」,這類單不在一般抓單的查詢範圍內,但查得到)。這道有兩個限制:只查近 7 天內有更新的單;退款若發生在上一輪抓單之後,要到下一輪抓單才攔得到。品檢不會因為已退款而中斷,見出貨品檢。同步紀錄的呈現:建立攔截的那一輪會多記一筆成功,但不會註明是因為退款,要看原因請看訂單上的攔截紀錄;已建立攔截的單不會再記成功。
▪ 貨主說平台上有退貨單,系統裡卻找不到,怎麼查?
先確認這個帳號是 Shopline、已連線、抓取訂單為開啟——三者缺一,退貨單就不會自動進來。都正常時到同步紀錄找「退貨單同步」那幾列展開看失敗原因,最常見的是退貨品項對應不到商品,整張單因此沒建立。
▪ 一進本頁就跳出「已啟用即時通知」的提示,是我按到什麼嗎?
不是。開啟本頁時系統會自動檢查一次這個帳號的即時通知設定,缺了就補上,補好才會跳提示(見即時通知自動檢查)。提示裡列的是這組通知涵蓋哪些事件。沒有變動時完全不會有提示,所以看到它就代表這次真的幫這個帳號補上了設定。
▪ 提示說金鑰沒有即時通知權限,要怎麼處理?
請貨主回電商平台的後台,在授權頁勾選即時通知(webhook)權限後重新產生金鑰,再到編輯電商帳號更新金鑰並測試連線。之後任何人再進一次本頁就會自動完成設定並跳出成功提示。在補權限之前,訂單仍會依設定的時段照常抓取,不會漏單。
▪ 刪除電商帳號後可以救回來嗎?
不行。刪除為不可復原操作。刪除前系統會先嘗試清除先前在平台上建立的自動通知,再移除帳號。若不想再用這個帳號但又怕誤刪,建議改為到編輯頁關閉抓單與推送即可。
▪ LiteShop 出貨回報失敗或結果不明,要怎麼處理?
系統依每張訂單分開回報實際出貨數量;組合商品依訂單記錄的組合內容(每組幾件)計算完整組數,同商品的成分即使改用相同庫存類別,仍須湊滿原本每組所需的總件數,累計回報最多為該平台品項原訂購的組數;成分分在不同出貨單出貨時,要等成分湊滿一組才回報那一組,所以在其餘成分出貨前,LiteShop 顯示的已出貨組數會比較少。若訂單上同商品的組合成分總數量多於組合內容乘上組數(例如組合內容改過後平台訂單又同步),這個組合品項不會回報、其他品項照常回報,並會通知「組合商品成分數量與訂單記錄的組合內容對不上」;之後也不會自動補報,請確認訂單的組合內容後,到 LiteShop 後台手動更新這個品項的出貨數量。若在送出前遇到暫時錯誤,最多自動重試 10 次,不影響其他訂單;重試仍失敗時會通知「出貨回報重試多次仍失敗」,請確認 LiteShop 帳號授權與連線狀態後聯絡支援重新回報。
如果提示「出貨回報結果不明」,系統會停止自動重送,避免重複累計出貨數量。請先核對 LiteShop 的出貨明細,再提供訂單與出貨單編號給支援人員處理;不要自行在平台再次出貨。倉庫端已完成的出貨不會因此取消。
2.2 注意事項
⚠️ 重要提醒
- 手動同步庫存會覆寫平台庫存、影響線上銷售,且無法自動還原。執行前先確認 WMS 的可售量正確,避免把錯誤數字推到電商平台。
- 定時同步與手動同步都可能把已賣掉的量加回去:推送當下還沒抓回系統的平台訂單不會被扣掉,推上去的數字可能把平台上已賣掉的量加回去,造成超賣。定時同步雖然會等同一時段的排程抓單結束才推,但抓單之後才成立、或要等下一個抓單時段才會抓回的訂單仍不會被扣掉。有即時通知的平台可搭配「即時抓單」,其他平台可設定較密集的抓單時段來縮小落差。
- 「定時同步(每 30 分鐘)」只看庫存有沒有異動,以下情況庫存沒動、平台該看到的數字卻變了,不會自動更新,請在變更後按一次「手動同步庫存」:批次效期跨過通路的效期門檻、單一商品的推送比例或推送開關被調整、通路的效期規則或允許的庫存類型被修改、新對應到的平台商品
- 推送方式選「定時同步(每 30 分鐘)」時,入庫不另外推增量,改由下一輪定時同步更新;若在入庫後、下一輪定時同步推送之前改成其他推送方式,這批入庫量不會推上平台,改成「入庫時推送」後請按一次「手動同步庫存」
- 刪除電商帳號不可復原。刪除後該帳號的串接設定即消失,無法救回。
- 串接後請勿在電商平台手動出貨或變更訂單狀態。倉庫端與平台端的貨態以系統同步為準,雙邊各自操作會造成狀態不一致。
- 關閉抓取訂單會連帶停掉退貨單自動建單,兩者共用同一個開關;改設定前先跟貨主確認。
- 退貨驗收結果不會回寫電商平台。倉庫收完貨、轉完入庫,平台端不會有任何變化,退款與購物金是貨主自己在平台後台處理的事。
💡 提示:帳號顯示斷線時,訂單不會自動匯入;發現少了訂單時,先回到本頁確認連線狀態,依紅色提示重新授權或編輯重測,再用「立即觸發抓單」補抓一次。
三、相關功能
| 功能 | 說明 | 連結 |
|---|---|---|
| 編輯電商帳號 | 修改串接參數、抓單與推送設定、「物流代碼對應」 | 前往 |
| 電商串接列表 | 查看所有電商帳號的連線狀態與設定 | 前往 |
| 銷售通路詳情 | 查看此帳號對應的銷售通路設定 | 前往 |
| 訂單管理 | 查看從各電商平台抓回的訂單 | 前往 |
| 退貨列表 | 查看平台自動建立的退貨單與驗收進度 | 前往 |