自動倉儲-API 串接倉庫

目錄：

‣ 一、串接前準備
‣ 二、串接 LiteShop 帳號
‣ 三、LiteShop 電商串接區塊欄位說明
‣ 四、常見問題
‣ 五、常見注意事項

一、串接前準備

欲了解倉庫資訊詳情請洽 LiteShop 客服，以下步驟適用已有倉庫後台的店家操作設定

1、到 「WMS 後台>商品清單」確認商品的「品號」是否與 LiteShop 後台的「品號」一致
WMS 後台：

LiteShop 後台：

2、如果在 LiteShop 有建立組合品，於倉庫也要建立組合品項，且「品號」是否與 LiteShop 後台的「品號」一致。
LiteShop 後台：

二、串接 LiteShop 帳號

步驟一：

至 WMS 後台「廠商設定>電商串接 」點擊右上角「新增串接」

選擇電商平台「LiteShop」，接著點擊「新增」。

完成後會看到電商串接頁面出現 LiteShop 的串接資訊。

步驟二：

登入 LiteShop 後台，進入「系統外掛>API 金鑰」頁面，新增 API 金鑰

完成後複製 TOKEN

步驟三：

回到 WMS 後台將 TOKEN 貼在 「介接金鑰」 欄位

至 LiteShop 複製店家網址貼在「 LiteShop 訂單來源網址」 欄位，點擊更新就完成囉。

三、LiteShop 電商串接區塊欄位說明

WMS 後台：

1、擷取訂單：調整為「是」，系統會將 LiteShop 系統上狀態為「 新訂單且準備出貨」的訂單抓進 WMS 系統 ; 調整為「否」則不抓取 LiteShop 訂單。
*請留意：若訂單已於 LiteShop 系統上進行出貨流程，那就會不符合狀態，會無法抓進 WMS 系統。
2、擷取待確認訂單：預設抓取付款狀態為「已付款、貨到付款」訂單，選項調整為「是」，會將 LiteShop 系統上，付款狀態為「尚未付款 or 確認付款（付款處理中） 」的訂單一併抓取至 WMS
3、擷取訂單時段：依照設定的時間進行訂單抓取 ，最多設定五個時段
*建議依照倉庫人員作業時段設定此欄位，避免漏單

4、即時同步庫存：調整為「是」後，當倉庫商品庫存有異動的時候，系統會更新該商品於 WMS 的庫存同步到 LiteShop ; 調整為「否」則不會因為庫存異動同步 LiteShop 商品庫存
同步所有商品庫存： 點擊「同步所有商品庫存」，系統會檢查 WMS 的商品，將 WMS 商品庫存同步至 LiteShop
5、保留庫存(回拋 EC 時會扣除此數字)：設定庫存保留量，系統會將位於 WMS 的指定倉別「商品庫存量」-「保留庫存」＝實際同步庫存至 LiteShop 後台的數量
*為避免超賣的狀況，建議設定此欄位

例如：
商品於 WMS 庫存：100
保留庫存設定：30
-
同步至 LiteShop 的商品庫存計算方式：
100（WMS 庫存）-30（保留庫存）=70
最終同步至 LiteShop 的庫存為 70

6、回拋庫存比例：設定回拋庫存比例，系統會先將位於 WMS 的指定倉別「商品庫存量」-「保留庫存」*「回拋庫存比例」＝實際同步庫存至 LiteShop 後台的數量
*支援設定 四捨五入、無條件進位、無條件捨去

A、無小數點舉例：

商品於 WMS 庫存：100
保留庫存設定：30
回拋庫存比例：80%
-
同步至 LiteShop 的商品庫存計算方式：
100（WMS 庫存）-30（保留庫存）=70
接著 70*80%（回拋庫存比例）=56
最終同步至 LiteShop 的庫存為 56

B、四捨五入舉例：

商品於 WMS 庫存：79
保留庫存設定：30
回拋庫存比例：80%
-
同步至 LiteShop 的商品庫存計算方式：
79（WMS 庫存）-30（保留庫存）=49
接著 49*80%（回拋庫存比例）=39.2
最終同步至 LiteShop 的庫存為 39

C、無條件進位舉例：

商品於 WMS 庫存：79
保留庫存設定：30
回拋庫存比例：80%
-
同步至 LiteShop 的商品庫存計算方式：
79（WMS 庫存）-30（保留庫存）=49
接著 49*80%（回拋庫存比例）=39.2
最終同步至 LiteShop 的庫存為 40

D、無條件捨去舉例：

商品於 WMS 庫存：63
保留庫存設定：30
回拋庫存比例：60%
-
同步至 LiteShop 的商品庫存計算方式：
63（WMS 庫存）-30（保留庫存）=33
接著 33*60%（回拋庫存比例）=19.8
最終同步至 LiteShop 的庫存為 19

7、LiteShop 訂單來源網址：支援設定多組來源網址
8、訂單建立時間：「依據平台時間」 代表 WMS 的訂單建立時間為顧客的下單時間 ; 「依據 WMS 建立時間」代表 WMS 至 LiteShop 抓單的時間
9、介接金鑰：LiteShop 與 WMS 串接的金鑰

10、通路：請依照此電商規則下拉選擇適合的通路，訂單將依照通路設定規則進入系統
11、物流代碼對應：

(1.)在 物流代碼對應欄位 點擊「新增物流對應」後，點擊「電商平台物流代碼」下拉選單會列出平台支援設定的物流方式。

(2.)接著點擊「倉庫端使用物流」，下拉選單會列出 WMS 後台提供的物流。

(3.)以下圖為例代表，當訂單所選物流為「宅配(regular)」時，在 WMS 要使用「新竹物流」出貨，確認設定正確後點擊更新即可。

四、注意事項

1、截取訂單失敗原因可以透過後台的小鈴鐺查看，常見情境有：

• WMS 商品「品號」與 LiteShop 後台「品號」不一致

• 訂單產生已超過 7 天（依據撈單時間計算 7 天）

• 訂單非「新訂單且準備出貨」狀態，例如：訂單已發出貨通知、已建立揀貨單

當訂單已發出出貨通知時，訂單狀態會轉為待收貨、出貨狀態為已出貨，不符合「新訂單且準備出貨」狀態

當訂單已建立揀貨單時，訂單狀態會轉為處理中，不符合「新訂單且準備出貨」狀態

2、訂單抓不到庫存

• LiteShop商品 SKU 不存在於 WMS

• WMS 商品設定安全庫存

• 庫存類型設定錯誤

3、商品庫存不同步

• 有設定保留庫存

• 未開啟即時同步庫存功能

• 商品 SKU 不存在於 WMS

4、物流代碼對應

• 7-11 以及全家，若配合的倉庫是使用綠界客代，物流對應請選擇「綠界 7-11 以及綠界全家」，系統會自動判斷是否要代收款項

五、常見問題

Ｑ：在 LiteShop 取消訂單後，WMS 的訂單也會取消嗎？
Ａ：若 WMS 尚未進行揀貨時，在 LiteShop 後台取消訂單會同步於 WMS 取消

Ｑ：在 WMS 取消訂單後，LiteShop 的訂單也會取消嗎？
Ａ：不會，倉庫取消訂單後，店家需要手動在 LiteShop 後台也取消該訂單

Ｑ：訂單為什麼沒有自動拋到倉庫？
Ａ：請確認商品是否都有設定 SKU、倉庫串接設定是否正確、是否尚未到截取訂單時間

Ｑ：我修改了 WMS 庫存，多久會同步到 LiteShop
Ａ：若有啟用「即時同步庫存」選項，庫存異動後約 1-2 分鐘內會進行同步

Ｑ：可以一次同步所有商品庫存嗎？
Ａ：可以，請至電商串接中點擊「同步所有商品庫存」