Skip to content

新增電商帳號 ​


目錄 ​


一、功能介紹 ​

這個頁面讓您替某一個貨主新增一個電商平台帳號,把蝦皮、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)會離開系統跳到平台授權頁,完成授權後會自動返回,過程中請勿關閉視窗。


功能說明連結
新增銷售通路替貨主建立電商帳號要綁的銷售通路前往
電商串接列表查看與管理該貨主已建立的電商帳號前往
電商帳號詳情查看單一電商帳號的連線與設定狀態前往
物流類型設定倉庫端物流類型,供物流代碼對應使用前往

最後更新 2026-11-16 19:57