商品主檔（Dawu Product Master）使用說明書
本說明書對象：商品管理、營運、業務、倉管同仁
系統位置：Dawu → 商品管理 → 商品主檔
更新日期：2026-05-21
一、商品主檔是什麼
「商品主檔」是 Dawu 系統內所有商品的核心資料庫，包含商品基本資訊、分類、包裝、售價、儲位等。所有營運模組（調撥單、特殊訂單、客戶銷貨）都會從這裡讀取商品資訊。
跟 ERP 的關係：Dawu 商品主檔的資料會透過 cosmos-api 同步寫入 ERP。也就是說，在 Dawu 修改的商品資料，ERP 也會跟著更新。
二、商品列表（找商品）
進入路徑： /products 或從導覽列「商品主檔」
主要功能
| 功能 | 用法 |
|---|
| 搜尋商品 | 於搜尋框輸入商品代碼或商品名稱（支援部分匹配） |
| 分頁瀏覽 | 未搜尋時，每頁固定筆數，可上下翻頁 |
| 新增商品 | 點右上「新增商品」按鈕（需有「編輯商品主檔」權限） |
| 查看商品 | 點商品列表的任一項目進入詳情頁 |
列表頁會顯示：商品代碼、名稱、大/中/小分類、品號有效截止日、最新成本、來源更新時間。也會顯示商品縮圖（若有照片）。
三、新增商品
權限要求： 編輯商品主檔
進入路徑： 商品列表 → 右上「新增商品」
新增流程
- 點「產生商品代碼」按鈕，系統自動產生唯一代碼（或自訂）
- 填寫基本資料（名稱、規格、庫存單位等）
- 選擇分類（大分類、中分類、小分類、揀貨分類等）
- 填寫包裝資訊（淨重、外箱單位、每箱入數 ← 調撥單會用到）
- 填寫售價（標準售價、零售價、最低售價等，依權限可填）
- 點「儲存」
⚠️ 每箱入數很重要：這個欄位影響調撥單的整箱補貨邏輯。若為空或 0，系統補貨時會跳過整箱取整，可能造成補貨失效。
四、商品詳情頁
商品詳情頁分成多個區塊：
① 基本資料
- 商品代碼 — 系統內唯一識別碼
- 商品名稱 — 顯示名稱
- 規格 — 商品規格描述
- 庫存單位 — 單位（包、罐、瓶...）
- 庫存管理 — 是否需庫存管理
- 品號有效截止日 — 過期後不可調撥
- 條碼 — 商品條碼
- 說明 / 使用方法 — 商品文字描述
② 分類
- 大分類 / 中分類 / 小分類
- 揀貨分類 / 其他分類 / 供應商分類 / 海森分類 / 費用分類
分類選項由系統 lookup 表維護。
③ 包裝
- 淨重 / 重量單位
- 外箱單位
- 每箱入數 — ⭐ 影響補貨計算
- 揀貨限制 — 「散箱皆可撿」或「僅可整箱」
④ 售價
| 欄位 | 說明 | 權限 |
|---|
| 標準售價 | 主要參考價 | 檢視售價 |
| 零售價 | POS 售價 | 檢視售價 |
| 最低售價 | 業務最低可賣價 | 檢視最低售價 |
| 標準售價含稅 / 零售價含稅 / 最低售價含稅 | 含稅版本 | 同上 |
| 價格 1-N | 客戶分層售價 | 檢視售價 |
⑤ ERP 同步欄位（唯讀）
- 來源建立時間 / 來源更新時間
- 最新成本（從 ERP 同步，檢視最新成本 權限可看）
⑥ 庫存可用量
從 cosmos-api 取得各倉庫的可用量。若 cosmos-api 沒回傳資料會顯示「沒有可用庫存資料」。
⑦ 儲位
各倉庫商品擺放位置。詳見第八章。
⑧ 商務與目錄設定
商務類型、是否在公開目錄顯示、基礎商品連結、可訂購據點。詳見第七章。
⑨ 商品照片
6 種照片類型。詳見第六章。
⑩ 異動紀錄
顯示此商品的所有變更歷史（誰、何時、改了什麼）。
五、編輯商品
權限要求： 編輯商品主檔
進入路徑： 商品詳情頁 → 點「編輯商品」
編輯流程
- 於詳情頁點「編輯商品」進入編輯表單
- 修改要改的欄位（沒權限的欄位會顯示「唯讀」）
- 點「儲存」
- 系統會同步寫入 cosmos-api → ERP
⚠️ ERP 同步失敗時：若 ERP 寫入失敗，Dawu 的儲存也會一起失敗，並顯示錯誤訊息。請聯絡系統管理員。
⚠️ 若 ERP 已寫入但 Dawu 儲存失敗：會顯示「ERP 已成功寫入，但 Dawu 無法儲存商品主檔」。表示 ERP 資料正確，但 Dawu 端需要再試一次。
六、商品照片管理
6 種照片類型
| 類型 | 說明 |
|---|
| 正面包裝 | 商品主包裝正面照片 |
| 調理／使用情境照 | 調理後或使用情境照片 |
| 內容物／開封照 | 開封後內容物或商品本體 |
| 背面標示 | 成分、營養或背標資訊 |
| 外箱／箱裝 | 出貨外箱或箱裝包材 |
| 條碼／規格近照 | 條碼、規格或合規資訊近照 |
上傳/發布流程
- 於商品詳情頁的「商品照片」區，點對應類型的「上傳」
- 選擇圖片檔（JPEG / PNG / WebP）
- 上傳後狀態為「僅內部」，公開目錄看不到
- 確認 OK 後點「發布」→ 變為「已發布」，公開目錄可見
其他操作
- 取代：對同一類型重新上傳（會覆蓋原圖）
- 取消發布：把照片改回「僅內部」
- 刪除：完全移除照片
檔案大小限制：超過上限會被拒絕。
格式限制：只接受 JPEG / PNG / WebP，其他格式（如 HEIC、TIFF）需先轉檔。
七、商務設定（商品分類與目錄）
商務設定決定商品如何被銷售，包含商品類型、是否上架公開目錄、可訂購據點等。
商務類型
| 類型 | 說明 |
|---|
| 標準商品 | 一般商品，無特別商務模式 |
| 客戶私標 | 客戶委製的私有品牌商品 |
| 白標 | 白標模式商品 |
| OEM | OEM 代工生產 |
| 合約製造 | 合約製造模式 |
顯示於公開目錄
- 目錄顯示：商品出現在客戶可訂購清單
- 目錄隱藏：商品不在客戶端顯示（內部商品）
基礎商品代碼（可選）
若此商品是某個「基礎商品」的變體（例如不同包裝、不同規格），可填基礎商品代碼建立連結。
可訂購據點
| 模式 | 說明 |
|---|
| 全部據點 | 所有據點都可訂購 |
| 指定據點 | 只有「可訂購據點清單」內的據點可訂購 |
| 不開放訂購 | 所有據點都不可訂購 |
選「指定據點」時，下方會出現據點搜尋框，輸入據點代碼或名稱加入清單。
八、儲位管理
儲位 = 商品在各倉庫的擺放位置（例如 A 區 03 排 02 層）。
權限要求： 檢視儲位 / 編輯儲位
查看與編輯
- 於商品詳情頁找「儲位」區
- 每個倉庫顯示一行（倉庫代碼、倉庫名稱、儲位）
- 若有編輯權限，可直接在欄位修改後儲存
- 未設定的會顯示「（未設定）」
若 cosmos-api 沒回傳儲位資料會顯示「沒有回傳儲位資料」，這通常是 ERP 端沒設定。
九、權限說明
| 權限 | 能做什麼 |
|---|
| 檢視商品 | 讀取商品列表、搜尋、商品詳情頁 |
| 編輯商品主檔 | 新增/修改商品主檔、分類、條碼、基本販售設定 |
| 檢視儲位 | 查看各庫別儲位 |
| 編輯儲位 | 新增/修改各庫別儲位 |
| 檢視售價 | 查看商品售價欄位與價格層級 |
| 編輯售價 | 寫入商品標準售價、零售價與客戶價格層級 |
| 檢視最低售價 | 查看最低可延伸售價欄位 |
| 編輯最低售價 | 寫入最低可延伸售價欄位 |
| 檢視最新成本 | 查看商品最新成本欄位 |
若某些欄位看不到或不能改，請聯絡權限管理員確認你的角色是否有對應權限。
十、常見問題
Q1：為什麼有些商品無法調撥？
檢查商品詳情頁：
- 是否已過「品號有效截止日」
- 「每箱入數」是否為空（會跳過整箱補貨）
- 商品名稱是否含
# 後綴（系統會排除）
Q2：為什麼編輯後 ERP 沒同步？
正常情況下儲存時會同步寫入 ERP。若 ERP 寫入失敗，Dawu 也會拒絕儲存並顯示錯誤訊息。請確認：
- cosmos-api 是否正常運作
- ERP 系統是否處於可寫入狀態
- 有錯誤訊息時，找系統管理員查看
Q3：商品照片發布後在哪裡可以看到？
已發布的照片會顯示在公開目錄（客戶看得到的介面），未發布的只有內部人員可見。
Q4：為什麼新增商品時「產生商品代碼」按了沒反應？
確認你的權限有「編輯商品主檔」。沒權限時按鈕會被隱藏或無法觸發。
Q5：商品代碼可以自訂嗎？
可以。「產生商品代碼」會給一個自動編號，你也可以手動輸入想要的代碼，但必須是系統內唯一。
Q6：儲位欄位空白該怎麼填？
這欄通常由倉管同事填寫，格式依公司倉儲規範（例如「A-03-02」或「冷凍-12」）。沒設定不影響系統運作，但會降低揀貨效率。
Q7：每箱入數設定後可以改嗎？
可以，但要小心。若改了「每箱入數」：
- 調撥單的整箱取整邏輯會跟著變
- 已下單的調撥單不影響（已凍結）
- 下一次自動批次會用新值
Q8：價格欄位太多分不清
| 欄位 | 用途 |
|---|
| 標準售價 | 對大多數客戶的主要售價 |
| 零售價 | POS 門市零售用 |
| 最低售價 | 業務報價底線，不可低於此 |
| 價格 1, 2, ... | 不同客戶層級的差異價（如 VIP、批發） |
Q9：何時要設「基礎商品代碼」？
當這個商品是另一個「基礎商品」的延伸時。例如：
- 同一商品的不同規格（600g vs 1Kg）
- 同一商品的不同包裝（罐裝 vs 袋裝）
建立連結後，目錄會把它們視為同一系列商品。
Q10：忘了改可訂購據點，會發生什麼？
預設是「全部據點」。若沒改，所有據點都會看到並可訂購。若是內部商品，要記得改為「不開放訂購」或「指定據點」。
需要協助？
系統問題 → 工程值班（Google Chat）
流程疑問 → 陳梓維（chenziwei@hisunfoods.com）
ERP 同步問題 → 系統管理員
本說明書會隨系統更新而修改。最新版本請以 Dawu 系統內公告為準。
最後更新：2026-05-21