新增電商帳號
目錄
一、功能介紹
這個頁面讓您替某一個貨主新增一個電商平台帳號,把蝦皮、Shopify、MOMO 等平台串接進倉庫系統。完成串接後,平台的訂單會自動抓進來成為出貨作業,倉庫的庫存也能依設定回推到平台。新增流程是一條線:先選貨主、填好連線資訊、測試連線或授權、連線通過後解鎖右側功能設定、最後儲存。

1.1 先選擇貨主
進入新增頁時,系統會先要求您選擇要替哪一個貨主建立帳號。電商帳號一定要掛在某個貨主底下,銷售通路等下拉資料也會跟著您選的貨主載入。選定貨主後才會出現下方的串接表單。
1.2 連線資訊(左欄)
左欄是串接平台所需的連線設定,分三步:
▸ 選平台、填名稱、綁通路
先選 電商平台(可串接的 17 個平台選一個)、填 顯示名稱,再綁一個 通路名稱。三個欄位都是必填。銷售通路只能選屬於這個貨主的通路;若該貨主底下還沒有任何通路,下拉會顯示「尚未建立銷售通路」並提供前往設定的連結。
▸ 填串接資訊(憑證)
選好平台後,左欄會依平台顯示不同的憑證欄位(例如 API 金鑰、token、商店帳密、商店網域)。請依平台後台提供的資料填入。
Shopify 的商店網域必須填寫 Shopify 提供的網址,例如 shop-name.myshopify.com;也可貼上完整商店網址,系統會保留網域部分。不能使用自行綁定的品牌網址或其他主機,否則無法儲存。
▸ 測試連線 / 授權連線
填完憑證後,依平台類型用不同方式建立連線:
- API 金鑰類平台:左欄出現 測試連線 按鈕。點擊後系統會先把帳號儲存起來,再向平台驗證憑證。成功後連線狀態變為 已連線,按鈕轉為「連線測試成功」。
- 授權類平台(蝦皮 / Shopify / Liteshop):左欄出現 授權連線 按鈕。點擊後會離開倉庫系統、跳轉到該平台的授權頁面,您在平台上同意授權後返回,即視為已連線,不需要手動填憑證測試。
連線狀態共三種:未驗證(剛建立、尚未測試)、已連線(連線成功)、斷線(連線失敗)。
1.3 功能設定(右欄)
右欄是抓單與推送的功能設定。在連線測試或授權通過之前,右欄是鎖住的,畫面顯示「請先完成左側連線設定」。連線通過後右欄才解鎖,可設定以下項目:
- 出貨倉:位於功能設定最上方,只列這個貨主的可用倉庫,多個帳號可以選同一個倉。選定後,這個帳號之後抓進來的訂單落在這個倉出貨,回推到平台的庫存也只算這個倉:「手動同步庫存」與「定時同步(每 30 分鐘)」只用這個倉的可售量,入庫與盤盈也只有發生在這個倉時才推給這個帳號;推送比例與銷售通路的庫存類型、效期限制照常套用。平台退貨單對不到原訂單時,同樣落在這個倉。沒有選時,欄位顯示「使用貨主預設倉(目前:倉庫名稱)」,訂單落在貨主的預設倉庫,回推也只算預設倉庫的可售量;之後在貨主設定更換預設倉庫,沒有選的帳號會跟著改用新的預設倉庫。平台是 OneWarehouse 時不顯示這個欄位;貨主只有一個可用倉庫且帳號沒有指定出貨倉時也不顯示,已指定的帳號照常顯示,可清空改回使用貨主預設倉。「抓取訂單」與庫存推送都沒開啟時仍可選,欄位下方會提示此設定暫不生效。測試連線後選了與貨主預設倉不同的倉再儲存時,若帳號可以「手動同步庫存」,會跳出提醒手動同步的視窗,說明見編輯電商帳號。
- 抓取訂單:開啟後系統會依您設定的時段自動把平台訂單抓進倉庫。開啟時必須至少設定一個 抓單時間。
- 即時抓單:只在有即時通知的平台顯示(見平台對照表),預設開啟。開啟時平台一有新訂單通知就會另外排一次抓單,新訂單通常幾分鐘內進到系統(蝦皮約 5 分鐘),不必等到下一個抓單時段;關閉後新訂單只會在您設定的抓單時段進入。
- 庫存推送方式:只在支援「手動同步庫存」的平台顯示,三選一,新增帳號時預設「關閉」。選「關閉」以外的方式時,都用 推送比例 控制要推送的百分比。
- 「關閉」:不推任何庫存到平台,詳情頁也不會出現同步對應商品與手動同步庫存的按鈕。
- 「入庫時推送」:入庫與盤盈完成時,把增加的數量乘上推送比例推上平台;出貨、訂單佔用等其他異動不會反映到平台。
- 「定時同步(每 30 分鐘)」:帳號已連線時,系統每 30 分鐘(整點與半點)跑一輪:把上一輪之後庫存有異動的商品,用目前可售量乘上推送比例整批覆蓋到平台,算法與「手動同步庫存」相同;沒有異動的商品不推。異動不分原因,出貨、訂單佔用與取消釋放、移倉、上架、盤點、庫存調整(含報廢)都算。該時段同一個貨主有帳號排程抓單時,會等這些抓單結束(不論成功或失敗)才推,讓剛抓回的訂單先完成佔用。入庫與盤盈不另外推增量,改由下一輪一併更新。改成這個方式後的第一輪會全量同步一次,等同按一次「手動同步庫存」。
- 相依設定要先開總開關才能編輯:「抓單時間」與「即時抓單」跟著「抓取訂單」、「推送比例」跟著「庫存推送方式」。總開關關閉(或推送方式選「關閉」)時,底下的欄位是灰色、無法點選,旁邊會標示要先開啟哪一個開關或選擇推送方式。新增帳號時「庫存推送方式」預設「關閉」,所以「推送比例」一進畫面就是灰的,選了其他推送方式即可編輯。
- 託運單版型:僅 Momo、Mo店+、Shopline、Cyberbiz 帳號顯示,預設 A4。改成熱感紙時,系統會把平台的 A4 託運單切成左右兩聯、各自成為一頁,標籤機可直接印;只影響宅配的託運單(Momo 為黑貓/宅配通/新竹/大榮,Mo店+ 為黑貓/新竹,Shopline 只有黑貓,含貨到付款),超商取貨的物流面單維持 A4 不切,Shopline 的新竹、跨境物流面單也不切。Cyberbiz 的熱感紙只套用在黑貓快速到店,是把 Cyberbiz 提供的 A4 託運單取出兩聯、上下排成一張約 95×195mm 的單頁,其他 Cyberbiz 物流不受影響。物流商有可能不接受切開的託運單而退件,切換前請先與平台/物流商確認。
- 物流代碼對應:僅部分支援的平台會顯示。把平台的物流選項對應到倉庫端的物流類型,出貨時系統才知道該用哪一種物流。若這是 Cyberbiz 帳號,倉庫端物流的選單除了貨主自己的物流類型,還會列出 Cyberbiz 的整合物流(例如 Cyberbiz 黑貓宅急便、Cyberbiz 新竹物流);其他平台的帳號維持原樣,只列貨主自己的物流類型。Cyberbiz 的運送方式代碼可由貨主在後台自行修改,改過之後抓進來的訂單會通知「物流類型未對應」;此時在這裡把新代碼對到正確的 Cyberbiz 整合物流,訂單就會恢復自動轉換、取號與列印物流面單,不必請貨主把代碼改回原樣。
1.4 欄位一覽
標示 * 的欄位為必填項目
| 欄位名稱 | 如何填寫 | 注意事項 |
|---|---|---|
| *電商平台 | 從清單選一個要串接的電商平台 | 建立後無法變更;選錯只能刪掉重建 |
| *顯示名稱 | 輸入這個帳號在倉庫系統內的辨識名稱,例如「蝦皮-主帳號」 | 同一貨主有多個平台帳號時,靠這個名稱區分 |
| *通路名稱 | 從清單選一個屬於這個貨主的銷售通路 | 只能選該貨主底下的通路;找不到請先到新增銷售通路建立 |
| 串接資訊(憑證) | 依所選平台顯示的欄位填入,例如 API 金鑰、token、商店帳密、商店網域 | 授權類平台改用授權連線取得憑證,不需手動填寫 |
| 出貨倉 | 從這個貨主的可用倉庫選一個;留空即使用貨主預設倉 | 只影響之後抓進來的訂單,已在系統內的訂單不會搬倉;OneWarehouse 帳號、或貨主只有一個可用倉庫且未指定時不顯示,影響範圍見 1.3 |
| 抓取訂單 | 開啟後自動抓取平台訂單 | 連線通過後才能設定 |
| 抓單時間 | 從時段清單選擇要抓單的時間,最多 3 個 | 開啟「抓取訂單」時必填,至少選一個 |
| 即時抓單 | 決定新訂單要不要在收到平台通知後立即抓進來(通常幾分鐘內,蝦皮約 5 分鐘),預設開啟 | 只在有即時通知的平台顯示(見平台對照表);關閉後新訂單只在抓單時段進入,系統中既有訂單的取消、狀態更新等同步不受影響 |
| 託運單版型 | 選擇託運單要印 A4 還是熱感紙,預設 A4 | 僅 Momo、Mo店+、Shopline、Cyberbiz 帳號顯示;熱感紙會把 A4 託運單切成左右兩聯各自成頁,只影響宅配(Momo 為黑貓/宅配通/新竹/大榮,Mo店+ 為黑貓/新竹,Shopline 只有黑貓,含貨到付款),超商物流面單與 Shopline 的新竹、跨境物流面單維持 A4。Cyberbiz 只套用在黑貓快速到店,是取出兩聯上下排成一張單頁,其他 Cyberbiz 物流不受影響。物流商有可能不接受切開的託運單而退件,切換前請先與平台/物流商確認 |
| 庫存推送方式 | 從「關閉」「入庫時推送」「定時同步(每 30 分鐘)」三選一,預設「關閉」 | 連線通過後才能設定;各方式的差別見 1.3 |
| 推送比例 | 輸入要推送到此平台的庫存百分比,範圍 0–100,預設 100,必填、不能留空 | 同一貨主多個平台合計超過 100% 會有超賣風險 |
| 物流代碼對應 | 把平台的物流選項對應到倉庫端的物流類型 | 僅部分平台顯示;每一筆對應都要選一個倉庫端物流。Cyberbiz 帳號的可選物流另含 Cyberbiz 的整合物流,其他平台的帳號不會列出任何平台整合物流 |
填寫完成後,點頁面下方的 儲存 儲存。儲存成功後會回到電商串接列表。
Ragic 不提供「庫存推送方式」與「推送比例」設定。入庫表單改由「抓取入庫單」與獨立的「入庫抓取時間」控制;未開啟「抓取入庫單」時,「入庫抓取時間」是灰色、無法編輯,而新增帳號時「抓取入庫單」預設關閉,因此一進畫面就是灰的,打開開關即可編輯;首次連線可填訂單表路徑或入庫表路徑;只串入庫單時不需設定訂單表。連線成功後可設定匯入樣板、品項子表、匯入條件及收貨完成回寫。儲存後可到詳情頁的 Ragic 入庫單串接核對設定。
只串入庫單時,關閉訂單抓取即可;訂單表路徑、抓單時段、訂單匯入樣板、匯入條件、出貨回寫與「物流代碼對應」會隱藏。重新開啟時會恢復顯示,儲存停用設定不會清除原訂單設定。既有帳號重新測試連線時,會一併儲存畫面目前的入庫開關與設定;若已關閉入庫抓取,即使同時更換 API Key 或來源表,也會保持關閉。切換入庫表後,新表相同的紀錄 ID 仍可匯入(單號須保持唯一);舊單仍回寫原表,使用匯入時保存的回寫欄位設定。同一輪收貨重複結案會保留首次完成時間;重新開啟後再完成才會建立新一輪回寫。品項有內容卻缺商品編號,或指定了無效日期時,整張單不會匯入,請依串接紀錄修正來源資料。
樣板中的自訂屬性預設值,即使未對應來源欄位也會套用;來源已有值時優先採用來源。是/否屬性可填 Y/N 或 1/0,數字與日期會依屬性型別轉換;無效值會阻止整張單匯入,請依串接紀錄修正後重抓。收貨完成回寫若遭 Ragic 拒絕或服務暫時失敗,系統會保留重試,不會標成已成功回寫。
二、常見問題
2.1 常見問題
▪ 為什麼右側的功能設定是灰色、不能點?
右側功能設定要等左側連線通過後才會解鎖。連線通過前畫面會顯示「請先完成左側連線設定」。請先在左欄填好憑證並完成 測試連線或授權,連線狀態變成 已連線 後,右側才能設定抓單與推送。
▪ 銷售通路下拉裡找不到要綁的通路怎麼辦?
銷售通路只列出您目前選的這個貨主底下的通路。如果該貨主還沒有建立任何通路,下拉會顯示「尚未建立銷售通路」。請先到新增銷售通路替這個貨主建立通路,再回來新增電商帳號。
▪ 電商平台選錯了,建立後還能改嗎?
不能。電商平台(電商平台)在建立後就無法變更,編輯頁裡這個欄位是鎖住的。如果選錯平台,請刪掉這個帳號重新建立一個。
▪ 蝦皮、Shopify 這類平台怎麼連?
蝦皮、Shopify、Liteshop 屬於授權類平台,使用 授權連線 按鈕,不需要手動填憑證測試。點擊後會跳轉到該平台的授權頁面,您在平台上同意授權並返回後,即視為已連線。
▪ 按了「測試連線」失敗,看到平台的錯誤訊息是什麼意思?
測試連線失敗代表系統用您填的憑證向平台驗證時被拒絕,通常是憑證填錯或該憑證的權限不足。錯誤訊息中若帶有平台原始回應(例如未授權、無權限),請依該訊息回平台後台確認 API 金鑰、token 是否正確、是否有對應的讀寫權限,修正後再測一次。連線失敗時狀態會變成 斷線。
▪ 抓取訂單開了,但沒辦法儲存?
開啟「抓取訂單」時,「抓單時間」至少要選一個時段,否則無法儲存。請從時段清單選 1 到 3 個抓單時間。
▪ 設了抓單時間,新訂單卻還是在時段以外進來?
有即時通知的平台(見平台對照表)預設開啟「即時抓單」,平台一有新訂單通知就會另外排一次抓單,新訂單通常幾分鐘內進到系統,不會等到您設定的時段。蝦皮會等約 5 分鐘再抓,這是刻意保留的:蝦皮在訂單成立的當下還沒配好物流資料,抓得更早會拿不到收件人的物流隱碼電話。若您希望新訂單只在指定時段進倉,把這個開關關閉即可。關閉後系統中既有訂單的取消、狀態更新等同步仍會照常進行,不受影響。
▪ 為什麼看不到「出貨倉」欄位?
這個欄位在貨主有兩個以上可用倉庫時出現——只有一個倉時,訂單與回推本來就只會用到那個倉,選不選結果都一樣。例外是已指定出貨倉的帳號:即使貨主只剩一個可用倉庫仍會顯示,讓您可以清空、改回使用貨主預設倉。OneWarehouse 帳號也不顯示,因為它的訂單由 OneWarehouse 推進來、不回推庫存。要讓貨主多一個可用倉庫,請到貨主詳情與設定勾選。
▪ 推送比例要填多少?
推送比例預設 100,代表把全部可售庫存推到這個平台。如果同一貨主在多個平台分售,可以調低比例分配。但要注意:同一貨主底下所有已連線、且「庫存推送方式」不是「關閉」的平台,比例合計達到或超過 100% 時,儲存後系統會跳出超賣風險提醒。帳號分屬不同的倉時改成逐倉計算:依各帳號實際使用的倉(沒有指定「出貨倉」的帳號算在貨主預設倉庫)分組相加,任一倉達到或超過 100% 才提醒。
▪ 「入庫時推送」和「定時同步(每 30 分鐘)」差在哪?該選哪一個?
「入庫時推送」只在入庫與盤盈完成時把增加的數量推上平台;出貨、訂單佔用、移倉、盤虧等其他異動不會反映到平台,時間一久平台數字就會和倉庫對不上。「定時同步(每 30 分鐘)」每 30 分鐘用目前可售量覆蓋有異動的商品,補上這段落差;入庫也算異動,所以選它時入庫完成不另外推增量,改由下一輪定時同步一併以最新數量更新。兩者是二選一的推送方式,不能同時選。選「定時同步(每 30 分鐘)」前請先看注意事項的超賣風險。
2.2 注意事項
⚠️ 重要提醒
- 電商平台 在建立後無法變更,選錯只能刪除帳號重建,請先確認平台再建立。
- 電商帳號一定要綁一個屬於該貨主的銷售通路,沒有通路就無法建立。
- 同一貨主多個已連線、且「庫存推送方式」不是「關閉」的平台,推送比例合計請勿超過 100%,否則有超賣風險;以各帳號實際使用的倉為單位計算(沒有指定「出貨倉」的帳號算在貨主預設倉庫)。
- 指定「出貨倉」後,訂單的配貨與取號都依該倉庫的庫存與物流設定進行,指定前請先確認該倉庫的物流設定已就緒。
- 「定時同步(每 30 分鐘)」推送當下還沒抓回系統的平台訂單不會被扣掉,推上去的數字可能把平台上已賣掉的量加回去,造成超賣(定時同步會等同一時段的排程抓單結束才推,但抓單之後才成立、或要等下一個抓單時段才會抓回的訂單仍不會被扣掉);「手動同步庫存」也有同樣風險。有即時通知的平台可搭配「即時抓單」,其他平台可設定較密集的抓單時段來縮小落差。
- 「定時同步(每 30 分鐘)」只看庫存有沒有異動,以下情況庫存沒動、平台該看到的數字卻變了,不會自動更新,請在變更後按一次「手動同步庫存」:批次效期跨過通路的效期門檻、單一商品的推送比例或推送開關被調整、通路的效期規則或允許的庫存類型被修改、新對應到的平台商品
- 推送方式選「定時同步(每 30 分鐘)」時,入庫不另外推增量,改由下一輪定時同步更新;若在入庫後、下一輪定時同步推送之前改成其他推送方式,這批入庫量不會推上平台,改成「入庫時推送」後請按一次「手動同步庫存」
💡 提示:授權類平台(蝦皮 / Shopify / Liteshop)會離開系統跳到平台授權頁,完成授權後會自動返回,過程中請勿關閉視窗。
三、相關功能
| 功能 | 說明 | 連結 |
|---|---|---|
| 新增銷售通路 | 替貨主建立電商帳號要綁的銷售通路 | 前往 |
| 電商串接列表 | 查看與管理該貨主已建立的電商帳號 | 前往 |
| 電商帳號詳情 | 查看單一電商帳號的連線與設定狀態 | 前往 |
| 物流類型 | 設定倉庫端物流類型,供物流代碼對應使用 | 前往 |