電商帳號詳情
目錄
一、功能介紹
電商帳號詳情頁完整呈現一個電商帳號的串接狀態與設定,左半邊是「連線資訊」,右半邊是「功能設定」。除了檢視,您也能在這裡執行幾個手動同步動作(排程抓單、同步對應商品、手動同步庫存),以及進入編輯或刪除帳號。頁面下方的同步紀錄則供您回查每一次自動同步的結果與失敗原因。

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