品項批次匯入
品項批次匯入是為了不上架販售的品項準備的（原物料、包材、藥品、耗材、活體等）。這類品項在這頁之前只能一筆一筆手動新增再一筆一筆調期初庫存——匯入幾百個品項時，一筆一筆建完全不現實。
整批全有全無
只要有一列不合格，一列都不會寫進去。不會出現「匯了一半」這種狀態。
進入路徑
後台左側 進銷存 → 基本設定 → 品項批次匯入。
2026-09-22 起側欄收斂
本頁原本沒有獨立側欄入口（是這次收斂一起新增的功能），現在收在「基本設定」導覽頁裡。詳見 中央帳與切讀 → 進入路徑。
目前沒有可下載的匯入範本
這是刻意留白，不是漏掉
由前端自己列一份欄位清單去產一份範本，容易生出「欄名跟匯入端實際認得的對不上」的範本——使用者照著填、匯入成功、某一欄卻是空的。所以這一頁刻意不發範本，也不做任何欄名翻譯：CSV 的標題列會原封當成欄位名送給後端。
必填欄位是 `sku`（品號）與 `name`（品名）；期初相關的欄位是 `opening_qty`（期初數量）、`unit_cost`（單位成本）、`warehouse_id`（倉別）。
標題打錯時後端不會回報「有一欄沒吃到」，只會靜默忽略那一欄，症狀會是「必填欄缺漏」或「期初沒被帶進去」。所以務必先用下方的試算確認欄位有沒有被正確吃到，不要只看「沒有錯誤」就當成沒問題，要逐項對照試算結果裡的筆數。
三段流程：選檔 → 試算 → 確認匯入
沒有任何路徑可以跳過試算。
- 選 CSV 檔案，並設定兩個參數：
- 預設倉別（期初要寫進哪個倉）：留空＝「不指定，每列自己帶 warehouse_id」。 - 品號已存在時：預設「整批擋下來」——只要 CSV 裡有一個品號已經存在，整批就不會匯入；也可以改成「沿用既有品項，只開期初」，這個模式下遇到已存在的品號不會報錯，只會替它開一筆期初庫存。 - 備註（選填）。
- 按「試算」。試算完全不寫入任何資料，回來會告訴你會新增幾個品項、開幾筆期初、有沒有錯誤列。
- 確認結果無誤後按「確認匯入」，才會真正寫入。
換檔案、改預設倉別、改「品號已存在時」都會讓試算作廢
這三個參數都會改變匯入結果，任何一個改變都要重新試算——確認匯入的按鈕只認「跟目前設定一致的最新一次試算」。
整批撤銷
匯入紀錄列表每一列有「整批撤銷」按鈕，用來撤銷一次錯誤的匯入。撤銷會：寫入對應的紅字沖銷、停用這批匯入建立的品項，但之後被動過的品項不會被停用（例如匯入後又被其他單據引用過的品項會保留）。撤銷結果會告訴你實際沖銷了幾筆、停用了幾個品項、保留了幾個。
常見問題
Q1 CSV 的欄位名稱要照抄文件裡的英文嗎
是的，標題列會原封當成欄位名送給後端辨識，必填欄位名稱固定是 sku、name（英文小寫），拼錯或用中文標題都會讓那一欄被忽略。
Q2 試算顯示沒有錯誤，匯入後卻發現期初數量是空的
先確認 CSV 標題列裡是否正確寫成 opening_qty 與 warehouse_id（或有沒有在匯入參數設「預設倉別」）。欄名打錯不會報錯，只會讓那一欄被靜默忽略，這正是為什麼試算結果要逐項核對筆數，不能只看「有沒有錯誤」。
Q3 匯錯了怎麼辦
到匯入紀錄找到那一次匯入，按「整批撤銷」。
其他問題協助
若遇本說明未涵蓋的問題，請透過後台右下角 LINE 客服 @ugomk 聯繫真人專員協助處理。