新增電商帳號
目錄
一、功能介紹
這個頁面讓您替某一個貨主新增一個電商平台帳號，把蝦皮、Shopify、MOMO 等平台串接進倉庫系統。完成串接後，平台的訂單會自動抓進來成為出貨作業，倉庫的庫存也能依設定回推到平台。新增流程是一條線：先選貨主、填好連線資訊、測試連線或授權、連線通過後解鎖右側功能設定、最後儲存。
1.1 先選擇貨主
進入新增頁時，系統會先要求您選擇要替哪一個貨主建立帳號。電商帳號一定要掛在某個貨主底下，銷售通路等下拉資料也會跟著您選的貨主載入。選定貨主後才會出現下方的串接表單。
1.2 連線資訊（左欄）
左欄是串接平台所需的連線設定，分三步：
▸ 選平台、填名稱、綁通路
先選 電商平台（可串接的 17 個平台選一個）、填 顯示名稱，再綁一個 通路名稱。三個欄位都是必填。銷售通路只能選屬於這個貨主的通路；若該貨主底下還沒有任何通路，下拉會顯示「尚未建立銷售通路」並提供前往設定的連結。
▸ 填串接資訊（憑證）
選好平台後，左欄會依平台顯示不同的憑證欄位（例如 API 金鑰、token、商店帳密、商店網域）。請依平台後台提供的資料填入。
▸ 測試連線 / 授權連線
填完憑證後，依平台類型用不同方式建立連線：
- API 金鑰類平台：左欄出現 測試連線 按鈕。點擊後系統會先把帳號儲存起來，再向平台驗證憑證。成功後連線狀態變為 已連線，按鈕轉為「連線測試成功」。
- 授權類平台（蝦皮 / Shopify / Liteshop）：左欄出現 授權連線 按鈕。點擊後會離開倉庫系統、跳轉到該平台的授權頁面，您在平台上同意授權後返回，即視為已連線，不需要手動填憑證測試。
連線狀態共三種：未驗證（剛建立、尚未測試）、已連線（連線成功）、斷線（連線失敗）。
1.3 功能設定（右欄）
右欄是抓單與推送的功能設定。在連線測試或授權通過之前，右欄是鎖住的，畫面顯示「請先完成左側連線設定」。連線通過後右欄才解鎖，可設定以下項目：
- 抓取訂單：開啟後系統會依您設定的時段自動把平台訂單抓進倉庫。開啟時必須至少設定一個 抓單時間。
- 即時抓單：僅蝦皮帳號顯示，預設開啟。開啟時平台一有新訂單通知就會另外排一次抓單，新訂單約 5 分鐘內進到系統，不必等到下一個抓單時段；關閉後新訂單只會在您設定的抓單時段進入。
- 入庫推送：開啟後入庫完成時會把庫存回推到平台。可搭配 推送比例 控制要推送的百分比。
- 相依設定要先開總開關才能編輯：「抓單時間」與「即時抓單」跟著「抓取訂單」、「推送比例」跟著「入庫推送」。總開關關閉時，底下的欄位是灰色、無法點選，旁邊會標示要先開啟哪一個開關。新增帳號時「入庫推送」預設關閉，所以「推送比例」一進畫面就是灰的，打開開關即可編輯。
- 託運單版型：僅 Momo、Mo店+、Shopline 帳號顯示，預設 A4。改成熱感紙時，系統會把平台的 A4 託運單切成左右兩聯、各自成為一頁，標籤機可直接印；只影響宅配的託運單（Momo 為黑貓／宅配通／新竹／大榮，Mo店+ 為黑貓／新竹，Shopline 只有黑貓，含貨到付款），超商取貨的物流面單維持 A4 不切，Shopline 的新竹、跨境物流面單也不切。物流商有可能不接受切開的託運單而退件，切換前請先與平台／物流商確認。
- 物流代碼對應：僅部分支援的平台會顯示。把平台的物流選項對應到倉庫端的物流類型，出貨時系統才知道該用哪一種物流。若這是 Cyberbiz 帳號，倉庫端物流的選單除了貨主自己的物流類型，還會列出 Cyberbiz 的整合物流（例如 Cyberbiz 黑貓宅急便、Cyberbiz 新竹物流）；其他平台的帳號維持原樣，只列貨主自己的物流類型。Cyberbiz 的運送方式代碼可由貨主在後台自行修改，改過之後抓進來的訂單會通知「物流類型未對應」；此時在這裡把新代碼對到正確的 Cyberbiz 整合物流，訂單就會恢復自動轉換、取號與列印物流面單，不必請貨主把代碼改回原樣。
1.4 欄位一覽
標示 * 的欄位為必填項目
| 欄位名稱 | 如何填寫 | 注意事項 |
|---|---|---|
| *電商平台 | 從清單選一個要串接的電商平台 | 建立後無法變更；選錯只能刪掉重建 |
| *顯示名稱 | 輸入這個帳號在倉庫系統內的辨識名稱，例如「蝦皮-主帳號」 | 同一貨主有多個平台帳號時，靠這個名稱區分 |
| *通路名稱 | 從清單選一個屬於這個貨主的銷售通路 | 只能選該貨主底下的通路；找不到請先到新增銷售通路建立 |
| 串接資訊（憑證） | 依所選平台顯示的欄位填入，例如 API 金鑰、token、商店帳密、商店網域 | 授權類平台改用授權連線取得憑證，不需手動填寫 |
| 抓取訂單 | 開啟後自動抓取平台訂單 | 連線通過後才能設定 |
| 抓單時間 | 從時段清單選擇要抓單的時間，最多 3 個 | 開啟「抓取訂單」時必填，至少選一個 |
| 即時抓單 | 決定蝦皮新訂單要不要在收到平台通知後約 5 分鐘內抓進來，預設開啟 | 僅蝦皮帳號顯示；關閉後新訂單只在抓單時段進入，既有訂單的取消／出貨狀態同步不受影響 |
| 託運單版型 | 選擇託運單要印 A4 還是熱感紙，預設 A4 | 僅 Momo、Mo店+、Shopline 帳號顯示；熱感紙會把 A4 託運單切成左右兩聯各自成頁，只影響宅配（Momo 為黑貓／宅配通／新竹／大榮，Mo店+ 為黑貓／新竹，Shopline 只有黑貓，含貨到付款），超商物流面單與 Shopline 的新竹、跨境物流面單維持 A4。物流商有可能不接受切開的託運單而退件，切換前請先與平台／物流商確認 |
| 入庫推送 | 開啟後入庫完成時把庫存回推到平台 | 連線通過後才能設定 |
| 推送比例 | 輸入要推送到此平台的庫存百分比，範圍 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 分鐘內進到系統，不會等到您設定的時段。這 5 分鐘是刻意保留的：蝦皮在訂單成立的當下還沒配好物流資料，抓得更早會拿不到收件人的物流隱碼電話。若您希望新訂單只在指定時段進倉，把這個開關關閉即可。關閉後既有訂單的取消、出貨等狀態同步仍會照常進行，不受影響。
▪ 推送比例要填多少？
推送比例預設 100，代表把全部可售庫存推到這個平台。如果同一貨主在多個平台分售，可以調低比例分配。但要注意：同一貨主底下所有「已連線且開啟推送」的平台，比例合計達到或超過 100% 時，儲存後系統會跳出超賣風險提醒。
2.2 注意事項
⚠️ 重要提醒
- 電商平台 在建立後無法變更，選錯只能刪除帳號重建，請先確認平台再建立。
- 電商帳號一定要綁一個屬於該貨主的銷售通路，沒有通路就無法建立。
- 同一貨主多個已連線且開啟推送的平台，推送比例合計請勿超過 100%，否則有超賣風險。
💡 提示：授權類平台（蝦皮 / Shopify / Liteshop）會離開系統跳到平台授權頁，完成授權後會自動返回，過程中請勿關閉視窗。
三、相關功能
| 功能 | 說明 | 連結 |
|---|---|---|
| 新增銷售通路 | 替貨主建立電商帳號要綁的銷售通路 | 前往 |
| 電商串接列表 | 查看與管理該貨主已建立的電商帳號 | 前往 |
| 電商帳號詳情 | 查看單一電商帳號的連線與設定狀態 | 前往 |
| 物流類型 | 設定倉庫端物流類型，供物流代碼對應使用 | 前往 |