程式資訊
- 程式 ID：
INVENT_BS - 所屬子系統：D.工程資料
- 狀態：stable
品號基本資料¶
功能簡介¶
「品號基本資料」是整個 ERP 的料件主檔（SKU master）——每一個會出現在訂單、BOM、製令、採購、進貨、庫存、成本帳上的品號，都先在這支表單建檔。它一筆品號集中維護基本識別、規格、庫存管制、包裝、工程文件、廠商、品質管制、採購政策、生產計畫參數、售價與成本等所有屬性，是工程、生管、採購、品保、業務各部門共用的源頭資料。
畫面以多個頁籤組織，左半的編輯頁（基本／工程／採購／價格）維護該品號本身的屬性；統計頁與右半（依使用者權限顯示）的客戶報價／訂單／出貨／廠商報價／廠商採購／進貨／派工頁則是把目前品號帶進對應模組的查詢，讓你不離開主檔就能查到這個品號的交易歷史。
誰會用到這支表單
工程人員建立品號與規格、品保設定檢驗條件、採購維護廠商與採購政策、業務維護售價、生管設定生產計畫參數。BOM、訂單、採購等所有單據都只能挑選已建檔的品號。
前置需求¶
- 權限：D.工程資料 →
D-010 品號基本資料的瀏覽／新增／修改／刪除權限。價格頁另受「檢視成本」權限控管（GetViewPricePermission），沒有此權限時整個價格頁籤會隱藏。 - 基礎資料：下列主檔／代碼維護得越完整，建檔時可挑選的選項與帶出的說明就越齊全——
| 資料 | 影響什麼 |
|---|---|
| 群組主檔（GRPM，含自定義分類） | 群組代號的選擇與說明、右側「自定義分類」明細的選項來源 |
| 代碼檔（SMEMS：C204 品別、C205 來源別、C206 檢驗、C207 檢驗水準、C208 取樣標準、C209 採購政策、C210 批量法則、C281 顏色、C282 採購別） | 各對應下拉選單的可選值；新增時的預設品別／來源別 |
| 單位代碼（C104） | 單位下拉選單；新增時預設帶第一筆單位 |
| 廠商主檔 | 廠商代號 1～3 的挑選與簡稱帶出 |
| 部門主檔 | 調自部門、生產部門等部門欄位的挑選 |
| 會計科目主檔 | 科目代號 的挑選 |
| 品號圖檔目錄（ERPIO 設定） | 圖檔名稱選檔與圖片預覽、存檔時自動複製圖檔 |
操作步驟¶
品號基本資料採標準主檔的「上一筆／下一筆」瀏覽搭配工具列的新增／修改／刪除／儲存。
查詢與瀏覽¶
- 開啟表單後，工具列的瀏覽鈕（第一筆／上一筆／下一筆／最末筆）可逐筆切換品號。
- 切換到不同品號時，系統會自動把目前品號帶入右側各查詢頁的條件（起訖品號都設為目前品號），並重設查詢狀態；切到該頁時才實際執行查詢。詳見欄位連動與附加功能。
新增品號¶
- 按工具列
新增。系統自動帶入數個預設值（單位、品別、來源別、ABC 分類，見欄位說明）。 - 在基本頁輸入 品號（主鍵，必填）、品名、群組代號、單位等。品名留白時存檔會自動補成品號。
- 視需要切換到 工程／採購／價格 頁補齊其餘屬性。
- 右側「自定義分類」區可按
設定，依該品號群組帶出自定義分類明細（見下節）。 - 按
儲存。存檔前系統會處理停用日期、補品名、重算包裝量與淨重／毛重，並把新圖檔複製進品號圖檔目錄。
修改品號¶
- 瀏覽到要改的品號，按
修改進入編輯狀態。 - 修改任一頁的欄位。部分欄位輸入後會即時重算其他欄位（材積、重量、包裝量等）。
- 按
儲存寫回。
特殊修改
工具列的擴充功能 1（SpecialEdit，特殊修改）會進入只開放特定欄位的編輯模式，可在不做整筆修改的情況下，單獨改幾個被標記為可特殊修改的欄位。
刪除品號¶
- 瀏覽到要刪的品號，按
刪除。 - 系統會擋下仍被 BOM、單據或庫存引用的品號（由資料庫端關聯檢核），無法刪除時會出現訊息。
欄位說明¶
下表列出主要欄位。標「✔」者為建檔關鍵欄位；標「系統」者由系統自動計算或帶出、唯讀。
基本頁¶
| 欄位 | 必填 | 說明／格式／預設 |
|---|---|---|
| 品號 | ✔ | 主鍵，最長 30 字，建檔後即為各單據挑選的識別碼 |
| 舊品號 | — | 對應換版前的舊料號，供查詢 |
| 新增日期 | 系統 | 唯讀，系統自動產生 |
| 品名 | — | 留白存檔時自動補成品號（見 SetSKUDescription） |
| 英文品名 | — | 出口文件用 |
| 群組代號 | — | 由群組主檔挑選；決定右側自定義分類選項 |
| 品別 | — | 下拉（C204）；新增時若為 0，預設帶第一筆 |
| 來源別 | — | 下拉（C205）；新增時若為 0，預設帶第一筆 |
| 品階／ABC 分類 | — | ABC 分類下拉 (空)／A／B／C；新增時預設 C |
| 單位 | — | 下拉（C104）；新增時預設帶第一筆單位 |
| 科目代號 | — | 由會計科目挑選 |
| 停用 | — | 是（Y）／否（N）；切換會連動停用日期（見下節） |
| 停用日期 | 系統 | 由停用旗標連動產生／清空，唯讀 |
| 材質／表面處理／型別／規格／顏色 | — | 規格群組；顏色為下拉（C281） |
| 替代品 1～3 | — | 由品號挑選 |
庫存控制與包裝（基本頁）¶
| 欄位 | 必填 | 說明／格式／預設 |
|---|---|---|
| 儲位 | — | 預設儲位，由儲位主檔挑選 |
| 庫存管制 | — | Y／N，控制此品號是否納入庫存帳 |
| 安全庫存／最大庫存量／最低訂單量／最小採購量／安全時間／leadtime | — | MRP／補貨參數，整數 |
| 容量／保存期限／庫存壽命 | — | 容量與效期參數 |
| 最小包裝數／小包裝件數／內箱箱數 | — | 輸入後系統自動算 內箱包裝數與箱裝量（包裝量_箱）（唯讀） |
| 內箱包裝數 | 系統 | 由包裝公式自動算出（最小包裝數×小包裝件數），唯讀 |
| 外箱數量 | 系統 | 唯讀欄位（由其他作業帶入，不在本表單即時計算） |
| 箱高／箱長／箱寬 (cm) | — | 輸入後系統自動算 材積 (Cuft)（唯讀） |
| 材積 | 系統 | 箱高×箱長×箱寬×0.0000353，四捨五入 2 位，唯讀 |
| 單重／箱重 | — | 輸入後系統自動算 淨重／毛重（唯讀） |
| 淨重／毛重 | 系統 | 淨重＝單重×箱裝量、毛重＝淨重＋箱重，唯讀 |
| 內箱品號／外箱品號 | — | 由品號挑選 |
| 圖檔名稱 | — | 選圖檔後右側即時預覽；存檔時複製進品號圖檔目錄 |
工程頁¶
| 欄位 | 說明 |
|---|---|
| BOM 製作日／製作者 | 由 BOM 維護回填，唯讀；製作者旁顯示員工姓名 |
| BOM 代碼／零件編號 | 由 BOM 維護回填，唯讀 |
| 工程圖號／版次 | 工程文件識別 |
| 圖製作日／圖製作者 | 圖製作者用使用者挑選控件，帶出姓名 |
| 文件編號／文件名稱 | 工程文件 |
| 設變編號／設變導入日／設變資料 | 設計變更紀錄 |
| 包裝方式／包裝材料 | 文字說明 |
採購頁¶
| 欄位 | 說明 |
|---|---|
| 廠商代號 1～3／比例／檢驗／成績表 | 主要供應廠商與配比；檢驗為下拉（C206）；成績表為勾選 |
| HSF／REACH／RoHS／RoHS 等級 | 環保危害等級；前三者勾選，RoHS 等級下拉（A 完全不含／B 含，在合格標準內／C 含，超標） |
| 品質管制日／不良率／管制批數／批號參考碼 | 品保參數 |
| 批次取樣／允收水準 | 取樣設定；批次取樣為勾選 |
| 檢驗水準／取樣標準 | 下拉（C207／C208） |
| 成績表／檢驗規範 | 品保文字 |
| 採購政策／採購別／採購緊急度 | 採購政策（C209）、採購別（C282） |
| 最小／最大採購量、批量、最小／最大使用量、經濟採購量、再採購點、固定採購量、日用量 | 採購數量參數 |
| 虛擬品號／關鍵品號 | 生產計畫用替身與關鍵件 |
| 主生產計劃／計劃訂單 | Y／N |
| 調自部門／最低訂單量／批量法則／經濟訂購量 | 生產計畫參數；批量法則下拉（C210） |
價格頁（需檢視成本權限）¶
| 欄位 | 必填 | 說明 |
|---|---|---|
| 特殊價／特價 1／特價 2／稽核價 | — | 業務維護的售價 |
| 標準售價／標準訂價 | 系統 | 唯讀，由成本／價格作業計算 |
| 材料／人工／間接／委外／整備成本 | 系統 | 唯讀，由成本展開回填 |
| 標準成本／平均成本／成本／真實成本 | 系統 | 唯讀，由成本作業計算 |
真實成本欄位的顯示
瀏覽時若使用者的權限備註未含「真實成本」，系統會在背景把瀏覽清單的真實成本欄歸零顯示（見 AfterBrowse），屬刻意的成本遮蔽，不是資料遺失。
統計頁與查詢頁¶
統計頁與右側各查詢頁不直接編輯品號屬性，而是把目前品號帶入對應模組（報價／訂單／出貨／採購／進貨／派工）的查詢結果，僅供檢視。
欄位連動與附加功能¶
這一節把「輸入某欄位／按某按鈕後系統會做什麼」逐條列出，全部來自實際程式碼（Invent_bsViewModel、InventTab1~4ViewModel、Twork_bom_vw_inventSource、Invent_bsSave）。
包裝量自動換算¶
當你修改 最小包裝數、小包裝件數或內箱箱數任一欄（透過 最小包裝數Binding／小包裝件數Binding／內箱箱數Binding），系統會立即依下式重算（SetPackageQuantity）：
- 內箱包裝數 ＝ 最小包裝數 × 小包裝件數
- 箱裝量（包裝量_箱） ＝ 內箱包裝數 × 內箱箱數
- 接著連帶重算淨重與毛重（見下）
因此「內箱包裝數」是唯讀的衍生欄位，不需自己填。存檔前 HandleDataBeforeEndEdit 也會再呼叫一次 SetPackageQuantity 確保一致。
重量自動換算¶
當你修改 單重或箱重（透過 單重Binding／箱重Binding），系統會立即重算（SetWeight）：
- 淨重 ＝ 單重 × 箱裝量（包裝量_箱）
- 毛重 ＝ 淨重 ＋ 箱重
修改包裝量時也會一併觸發重量重算，所以淨重、毛重唯讀。
材積自動換算¶
當你修改 箱高／箱長／箱寬任一欄（透過 箱高Binding／箱長Binding／箱寬Binding），系統會立即重算（CalculateVolume）：
- 材積 ＝ 箱高 × 箱長 × 箱寬 × 0.0000353，四捨五入到小數 2 位（換算成材積 Cuft）
材積欄唯讀。
停用旗標連動停用日期¶
存檔前（HandleDataBeforeEndEdit → SetDisabledDate）系統會處理停用日期：
- 停用＝否（N） → 清空停用日期。
- 停用＝是（Y）且停用日期空白 → 自動填當天日期。
品名留白自動補品號¶
存檔前若品名為空白，系統會自動把品名設為品號（SetSKUDescription），確保每個品號都有名稱。
新增時的預設值¶
按 新增 後系統自動帶入（AfterAddNew）：
- 單位 ＝ 單位清單（C104）的第一筆。
- 品別 ＝ 若目前為 0，帶 C204 的第一筆代碼。
- 來源別 ＝ 若目前為 0，帶 C205 的第一筆代碼。
- ABC 分類 ＝
C（清單(空)／A／B／C的第四項）。
群組代號 → 自定義分類¶
右側「自定義分類」明細的內容跟著群組代號走：
- 進入編輯狀態時（
AdeViewModel.Status == Edit），系統依目前品號的群組代號讀取自定義分類定義（GrpmBll.GetSelfDefined），並把每一列的可選內容（分類內容下拉）填好。 - 按自定義分類區的
設定鈕（SelfDefinedExecute），系統會先把現有明細列標記刪除（增刪修＝D），再依群組重新展開一份新的分類清單，每列的分類內容預設帶第一個選項。
分類內容是下拉
每列的分類內容是依該分類定義動態產生的下拉清單，不能任意輸入文字，只能挑群組定義好的選項。設定 只有在編輯（新增／修改）狀態才會作用。
廠商成績表與批次取樣的點擊切換¶
採購頁的幾個勾選欄是用「點一下切換」的方式運作，而且只在編輯狀態才有效：
- 點 成績表 1／2／3 勾選框 → 切換對應廠商的成績表旗標（Y ↔ 空）（
Toggle成績表）。 - 點 批次取樣 勾選框 → 切換批次取樣旗標（Y ↔ 空）（
Toggle批次取樣）。 - 非編輯狀態（瀏覽中）點擊不會有反應（程式內
Status == Normal直接 return）。
主要供應廠商的判定¶
系統在需要單一供應廠商時（例如帶到查詢、採購分析）會取比例最高的那一家（GetVendorCode）：依序比較廠商 1／2／3 比例，回傳比例最大者的廠商代號。維護時請把主力供應商的比例設高。
切換品號時自動帶入查詢條件¶
每次移動到不同品號（AfterMoverRecord），系統會：
- 重設右側所有查詢頁的查詢狀態（
ResetQueryState，下次切到該頁才重查）。 - 把目前品號帶入客戶報價／訂單／出貨／廠商報價／廠商採購／進貨／派工各頁的起訖品號條件（都設成同一個品號）。
- 若目前停在統計頁，立即重新統計（
InventStatisticsViewModel.Query）。 - 帶出 BOM 製作者／圖製作者的員工姓名（
GetDescription）。
查詢頁的權限與來源¶
右側查詢頁依使用者對對應程式的瀏覽權限決定是否顯示：客戶報價對應 CUPDMA、訂單對應 ORMAST、出貨對應 TRSAMA、廠商報價對應 SPPDT、廠商採購對應 PURCH、進貨對應 RECEIVE、派工對應 WKPAPER。沒有對應程式瀏覽權限的頁籤不會出現。進入編輯狀態時這些查詢頁會被停用（IsEnabledByAdeStatus），存完回到瀏覽狀態才再啟用；若編輯時正停在查詢頁，會自動切回第一個頁籤。
圖檔的選取、預覽與儲存¶
- 在圖檔名稱選一個圖檔後，基本頁右下的圖片區會即時預覽（
圖檔完整路徑Binding依圖檔完整路徑載入）。 - 存檔時（
Invent_bsSave.AllowSave）若指定的圖檔尚未在品號圖檔目錄中（CheckImageExist），系統會自動把它複製進去（SaveImage）並改存相對路徑；複製失敗會擋下存檔並提示「影像儲存錯誤」。
Excel 批次匯入產品¶
系統另有一支 轉產品 批次工具（Excel轉資料Bll.轉產品），會讀取 EDI 目錄下固定檔名的 ITEM.xlsx，依 INVENT_BS 的欄位對照把資料大量新增成品號（主檔 + 自定義分類明細）。
匯入是後台批次、非本表單按鈕
轉產品 讀的是固定路徑 EdiDirectory\ITEM.xlsx，不是品號基本資料畫面上的按鈕。需要大量建檔時請與系統管理員確認檔案格式與放置位置。
常見問題¶
淨重／毛重／材積／內箱包裝數填不進去（唯讀）？
這些都是系統自動計算的衍生欄位：材積由箱高／箱長／箱寬算出、淨重毛重由單重／箱重與箱裝量算出、內箱包裝數由最小包裝數×小包裝件數算出。請改填來源欄位（箱尺寸、單重、箱重、最小包裝數、小包裝件數、內箱箱數），系統會即時重算。
右側少了某個查詢頁（例如「採購」或「進貨」）？
查詢頁是依對應程式的瀏覽權限動態顯示的：採購對應 PURCH、進貨對應 RECEIVE、訂單對應 ORMAST 等。看不到該頁，代表你沒有對應程式的瀏覽權限，請洽系統管理員開權限。
看不到「價格」頁，或真實成本顯示為 0？
「價格」頁受檢視成本權限控管，沒有此權限整頁會隱藏。瀏覽清單中的真實成本欄也會在權限備註未含「真實成本」時被歸零顯示，這是刻意的成本遮蔽，並非資料遺失。
成績表／批次取樣的勾選點不動？
這些勾選欄用「點擊切換」運作，而且只有在編輯（新增／修改）狀態才會切換。請先按 修改 進入編輯狀態再點。
右側「自定義分類」沒有任何分類可選？
自定義分類的選項來自該品號群組代號對應的群組自定義定義（GRPM）。請先填好群組代號，再按自定義分類區的 設定 鈕展開分類；若群組本身沒有定義自定義分類，這裡就會是空的。
存檔時跳出「影像儲存錯誤」？
代表你選的圖檔無法複製進品號圖檔目錄（路徑、權限或檔案不存在）。請確認圖檔來源存在且可讀，或清空圖檔名稱後再存。
品號刪不掉？
已被 BOM、訂單、採購、庫存等引用的品號會被資料庫端關聯檢核擋下。請先處理或停用相關單據，或改用停用旗標讓它退場而不刪除。
相關功能¶
- BOM 主檔：用本表單建好的品號組成多階物料清單
- 工程資料模組首頁
- 基本資料（品項主檔）
- 銷售訂單 / 客戶報價：採購頁、查詢頁的訂單與報價來源
- 採購付款：廠商採購／進貨查詢來源
- 品質管制：檢驗水準、取樣標準等品保設定
- 成本管理：價格頁各項成本的計算來源
- 欄位連動與附加功能
需補截圖清單
以下截圖待 runtime 驗收後補拍（放 docs/D-Bom/images/）：
invent_bs-step1.png— 基本頁全貌（基本資料／規格／庫存控制／包裝／圖檔／右側自定義分類）invent_bs-step2.png— 工程頁（工程文件／文件設變／包裝）invent_bs-step3.png— 採購頁（廠商管理／危害等級／品質管制／採購政策與數量／生產計畫）invent_bs-step4.png— 價格頁（售價／成本分析，需檢視成本權限）invent_bs-step5.png— 右側查詢頁（依權限顯示的客戶報價／訂單／進貨等其中一頁）