SHOPLINE bulk import
SHOPLINE 大量匯入商品失敗怎麼辦？先檢查商品編號、名稱、主圖與價格
SHOPLINE 大量匯入商品時，最常卡在必填欄位、商品重複、圖片網址、價格格式與庫存欄位。不要一開始就改完整表格，先切出 5 筆小檔，把商品編號、商品名稱、商品主圖、價格與庫存逐一確認。
先做小檔：
保留 SHOPLINE 範本表頭，加上 5 筆失敗商品。小檔成功後，再把同一套清理規則套回完整表格，避免整批商品越改越亂。
先確認三個必填欄位
SHOPLINE 官方說明中，大量匯入商品表格有三個必填欄位：商品編號、商品名稱、商品主圖。這三欄如果空白、格式錯、混入看不見的空白，匯入就很容易失敗。
| 欄位 | 常見問題 | 先怎麼修 |
|---|---|---|
| 商品編號 | 空白、重複、前後空白、全形英數、和既有商品撞號。 | 先排序查重，再清掉全形空白與不可見字元；更新既有商品時以後台匯出資料為準。 |
| 商品名稱 | 空白、換行、Emoji、特殊符號、從社群貼文複製來的隱藏字元。 | 用純文字貼上，移除換行與特殊空白，再做 5 筆小檔測試。 |
| 商品主圖 | 圖片網址不能公開讀取、貼到相簿頁、雲端權限不足、網址有空白。 | 用無痕視窗打開圖片 URL，確認一般訪客能直接看到圖片。 |
價格與庫存欄位不要混入文字
如果價格或數量欄位混入「NT$」、「元」、「約」、「售完」、「現貨」這類文字，平台通常無法當成數字處理。先把數字欄和文案欄分開，讓價格、庫存與重量維持平台可讀的格式。
- 價格欄只放數字，不放幣別、千分位逗號、促銷文案。
- 庫存欄不要填「有貨」「現貨」「售完」，改成平台允許的數字或狀態。
- 重量欄如果有小數限制，先統一小數位，不要混用公克與公斤文字。
- 如果沒有填價格，先確認商品前台是否會被設定成隱藏價格或無法直接購買。
商品重複通常不是單純重複列
大量匯入時，如果表格裡包含已存在的商品，又用新增商品的方式上傳，可能造成重複商品。另一些情況則是假重複：看起來不同的商品編號，其實只差前後空白、全形空白或大小寫。
- 先把商品編號欄複製出來，排序後查重。
- 清掉前後空白、全形空白、不可見字元後再查一次。
- 若是更新既有商品，先從後台匯出資料當作基準，不要自己重建欄位。
- 規格商品要確認主商品與款式的編號規則，不要讓不同規格共用同一個編號。
圖片網址失敗時，用這個順序查
| 檢查順序 | 問題 | 快速判斷 |
|---|---|---|
| 1 | 不是直接圖片網址 | 打開後是雲端預覽頁、相簿頁或下載頁。 |
| 2 | 權限不足 | 無痕視窗要求登入或顯示權限不足。 |
| 3 | 網址有空白或換行 | 複製到檢查器後看到全形空白、換行或不可見字元。 |
| 4 | 多圖分隔符錯誤 | 同一格塞了多個網址，但分隔符和範本要求不同。 |
5 筆小檔排查流程
- 下載或複製 SHOPLINE 提供的最新範本，不手打表頭。
- 保留表頭與 5 筆失敗商品，另存成小檔。
- 先確認商品編號、商品名稱、商品主圖三欄不空白。
- 清理商品編號與名稱裡的全形空白、換行與不可見字元。
- 再檢查價格、庫存、重量、分類與圖片網址。
- 小檔成功後，才把規則套回完整檔。
下一步：
把 5 筆小樣本貼到 商品資料免費健檢器，先查商品編號、價格、圖片與欄位風險。若你想拿到完整錯誤摘要、修正 sample 與欄位對照，可看 商品資料健檢報告樣本，或填寫 商品資料健檢需求單。
參考方向：SHOPLINE 大量建立商品、批次大量匯入商品與 CSV 庫存更新說明。實際欄位與限制請以你的 SHOPLINE 後台範本與官方說明為準。
廣告預留區：內容量與審核條件足夠後再啟用。