匯入商品
目錄
一、功能介紹
要一次建立或更新大量商品時，用匯入會比逐筆新增快得多。在 商品列表 右上角點「匯入」會打開匯入視窗，下載範本、填好整批商品後上傳，系統會逐列建立或更新商品。匯入是用品號（品號）對應商品：檔案裡的品號在該貨主底下找不到就新建一筆，找得到則更新既有那筆。
1.1 匯入步驟
▸ 選擇貨主與下載範本
多貨主環境要先選定這批商品屬於哪個貨主，整批會匯入到這個貨主底下。接著點「下載範例」取得範本——範本表頭就是要填的欄位。若該貨主有設定匯入模板，可在下拉選一個，下載的範本會對齊該模板的欄位對應。
▸ 填寫並上傳檔案
依範本逐列填寫商品資料，每一列是一筆商品。完成後把檔案拖入上傳區或點選上傳。只接受 Excel 檔（.xlsx、.xls），單檔上限 10MB。
▸ 送出並查看結果
確認「覆蓋現有資料」的勾選狀態後點「上傳」。送出後到背景任務通知查看結果，通知會顯示新增幾筆、更新幾筆、失敗幾筆，以及每一列失敗的原因。
1.2 覆蓋既有資料
視窗下方的「覆蓋現有資料」勾選框決定品號重複時怎麼處理：
| 勾選狀態 | 行為 |
|---|---|
| 勾選 | 檔案裡品號已存在的商品，會用檔案內容更新既有那筆 |
| 不勾選 | 檔案裡若有品號已存在的商品，該列會被擋下並回報「發現已存在的商品」，不會覆蓋 |
不論勾選與否，品號在該貨主底下找不到的列都會新建一筆。同一個檔案裡品號也不可重複，重複會被擋下。
1.3 部分欄位的匯入規則
| 欄位 | 規則 |
|---|---|
| 品號 | 每列必填，用來對應新建或更新 |
| 品名 | 每列必填 |
| 溫層 | 必須是系統認得的溫層值，否則該列失敗 |
| 分類 | 填分類名稱，找不到對應分類該列失敗 |
| 預設儲位 (商品入庫時的優先推薦儲位；若庫存匯入時未指定儲位，亦會自動匯入至此) | 填儲位位置，找不到對應儲位該列失敗 |
| 其他條碼 | 多組以逗號分隔；欄位留空代表清空既有其他條碼；範本完全沒這一欄則保留原值 |
| 單位名稱 | 不可以數字開頭 |
匯入採逐列處理：某一列出錯只會跳過該列，其餘正確的列照常匯入。所有失敗列的原因都會列在背景任務結果裡。
二、常見問題
2.1 FAQ
▪ 為什麼有些列匯入失敗？
常見原因有四類：必填欄位（品名、品號）沒填；溫層、分類、儲位等填了系統找不到的值；同一檔案裡品號重複；以及沒勾「覆蓋現有資料」時遇到品號已存在的商品。每一列的失敗原因都會在背景任務結果中列出，依訊息修正後重新匯入即可。
▪ 已經有的商品想批次更新，可以用匯入嗎？
可以。把要更新的商品填進檔案、品號保持與系統一致，並勾選「覆蓋現有資料」，匯入時就會更新既有商品而不是新建。
▪ 沒勾「覆蓋現有資料」，遇到重複品號會怎樣？
那幾列會被擋下並回報「發現已存在的商品」，不會動到原本的商品；品號是新的那幾列仍會照常新建。
▪ 範本表頭可以自己改嗎？
請依下載的範本表頭填寫。若貨主有設定匯入模板，選了模板後下載的範本會對齊該模板的欄位，照著填即可。
▪ 檔案上傳失敗，提示檔案類型或大小錯誤？
只接受 Excel 檔（.xlsx、.xls），且單檔不得超過 10MB。若檔案較大，先拆成多個檔分批匯入。
▪ 「其他條碼」這一欄留空，會把原本的條碼清掉嗎？
會。範本有帶這一欄但某列留空，視為要清空那筆商品的其他條碼。若不想動到既有條碼，就讓範本完全不含這一欄。
2.2 注意事項
⚠️ 重要提醒
- 勾選「覆蓋現有資料」後，品號相同的商品會被檔案內容覆蓋，匯入前請確認檔案內容正確。
- 「其他條碼」欄留空會清空既有條碼；不想更動條碼時，範本不要保留這一欄。
- 整批商品都會匯入到選定的貨主底下，多貨主環境匯入前務必確認選對貨主。
💡 提示：第一次匯入可先放少量幾列測試，確認欄位與值都正確後，再匯入完整檔案。
三、相關功能
| 功能 | 說明 | 連結 |
|---|---|---|
| 商品列表 | 回到商品列表 | 前往 |
| 新增商品 | 逐筆新增單一商品 | 前往 |
| 品牌管理 | 維護匯入時要對應的品牌 | 前往 |
| 商品分類 | 維護匯入時要對應的分類 | 前往 |