程式資訊
- 程式 ID：
Cost - 所屬子系統：K.成本管理
- 狀態：stable
月成本明細檢視¶
功能簡介¶
「月成本明細檢視」用來查看某個會計月份已計算完成的成本資料：以「年月（YYYYMM）」為主檔鍵，向下展開該月份每一筆「倉庫 × 儲位 × 品號 × 批號 × 製程」的成本明細，列出期初、各類異動（進貨、入庫、領料、退料、出庫、盤盈虧、借入借出、報廢…）的數量與成本，一路結到期末數量與期末成本。
這支表單是檢視型畫面，本身不做計算——資料來自成本計算精靈跑完月成本後落地的成本資料表（Twork_cos_vw_costm / Twork_cos_vw_costd 兩個 View）。換句話說：
- 先用成本計算精靈結算某月份的成本。
- 再用本頁輸入年月，把該月每個品號的成本流水攤開來核對。
主要使用者為成本會計、財務人員，用途是月結後逐項核對成本，或在出問題時追查某品號的成本是怎麼算出來的。工具列上另外掛了一顆 成本計算 按鈕，讓你不必離開本頁就能直接呼叫精靈重算。
前置需求¶
- 權限：K.成本管理 →
K-070 月成本明細檢視的瀏覽權限（列印另需列印權限）。 - 資料來源：本頁只是把成本計算的結果讀出來顯示，下列前置作業缺一就會查不到或數字不全——
| 資料 | 影響什麼 |
|---|---|
| 該月份的成本計算（成本計算精靈） | 沒先結算，輸入年月後明細為空 |
| 各倉庫期初庫存與成本（上月期末結轉） | 期初數量／期初成本欄 |
| 當月各類進銷存異動單據（進貨、領退料、入出庫、盤點…） | 對應的各異動數量／成本欄 |
| BOM 與製程資料 | 製程別成本、製令完工入庫成本的展開 |
| 品號階級（SKURank）設定 | 成本計算的計算順序，連帶影響本頁明細是否齊全 |
查不到資料先確認月份已結算
本頁不會觸發計算。若輸入的年月尚未用成本計算精靈跑過，明細區會是空白——這是正常的，不是錯誤。請先完成成本計算再回來檢視。
操作步驟¶
查詢某月份的成本明細¶
- 在上方 Year And Month（年月） 欄輸入要檢視的會計月份，格式為
YYYYMM（例如202606）。此欄是主檔鍵。 - 按工具列的
查詢／瀏覽，系統載入該年月的主檔，並把對應的成本明細帶到下方格線。 - 在下方格線逐列檢視該月每個「倉庫 × 品號 × 批號 × 製程」的成本流水。格線支援欄位排序與篩選，可依倉庫、品號、批號等縮小範圍。
善用格線篩選
成本明細欄位很多（期初、進貨、領退料、入出庫、盤盈虧、借出借入、報廢、期末…超過 50 欄）。建議先用格線的欄位篩選鎖定要核對的倉庫或品號，再橫向捲動檢視各異動的數量與成本。明細格線也可右鍵匯出 Excel。
直接呼叫成本計算精靈（成本計算 按鈕）¶
- 在工具列按
成本計算（其他功能）。 - 系統開啟成本計算精靈視窗，依「計算前檢核 → 品號階級檢查 → 執行計算 → 計算後檢核」四個頁籤完成月成本結算。
- 精靈關閉後，本頁會自動重新整理目前年月的資料，讓你立刻看到剛算完的結果，不必手動重查。
新增鈕在本頁不產生資料
工具列雖有 新增，但本頁是成本資料的檢視畫面，成本明細是由計算精靈批次寫入的，手動新增不會產出有意義的成本列。實務上一律透過 成本計算 來產生資料。
列印¶
- 完成查詢後，按工具列的
列印／預覽。 - 系統依年月輸出該月成本明細報表。
欄位說明¶
主檔（上方）¶
| 欄位 | 必填 | 說明/格式/預設 |
|---|---|---|
| Year And Month（年月） | ✔ | 會計月份，格式 YYYYMM，為主檔鍵；輸入後查詢該月成本 |
明細（下方格線，主要欄位）¶
明細欄位多數成對出現——每個異動類別都有一組「數量」與「成本」。以下列出主要欄位；完整欄位請以畫面為準。
| 欄位群 | 說明 |
|---|---|
| Warehouse／Warehouse Description（倉庫／倉庫名稱） | 該成本列所屬倉庫 |
| Bin（儲位） | 倉庫內的儲位 |
| SKU／SKU Description（品號／品名） | 成本對象的品號與品名 |
| SKUCategory／SKURank（品號類別／品號階級） | 品號分類與計算階級 |
| Group Code／Cost Group（群組碼／成本群組） | 成本歸群用 |
| Lot Code／Lot Num（批號／批序） | 批次別成本時的批號與序號 |
| Processing Code／Name／Sequence No（製程碼／名稱／順序） | 製程別成本展開 |
| Production Order No（製令單號） | 對應的生產製令 |
| Unit Of Measurement（單位） | 數量單位 |
| Beginning Quantity／Cost（期初數量／成本） | 月初結轉的庫存與成本 |
| Receiving Quantity／Cost（進貨數量／成本） | 當月採購進貨 |
| Warehouse In Quantity／Cost（入庫數量／成本） | 製令完工入庫等 |
| Material Requisition Quantity／Cost（領料數量／成本） | 生產領用 |
| Material Return Quantity／Cost（退料數量／成本） | 退回未用料 |
| Other In／Out Quantity／Cost（其他入／出庫數量／成本） | 雜項進出 |
| Shipping Quantity／Cost（出貨數量／成本） | 銷貨出庫 |
| Delivery / Shipping / Receiving Return（各類退回數量／成本） | 銷退、進退等沖回 |
| Scrap Quantity／Cost（報廢數量／成本） | 報廢 |
| Lend / Borrow Quantity／Cost（借出／借入數量／成本） | 借貨往來 |
| Warehouse Transfer / SKU Transfer（調撥／品號轉換數量／成本） | 倉別調撥與品號轉換 |
| Inventory Count Discrepancy Quantity／Cost（盤點差異數量／成本） | 盤盈虧調整 |
| Cost Adjust Quantity／Cost（成本調整數量／成本） | 成本調整單 |
| Ending Quantity／Cost（期末數量／成本） | 結算後的月末庫存與成本，是核對重點 |
| Sales Amount／Sales Return Amount（銷貨金額／銷退金額） | 當月銷貨與銷退金額 |
| Remark（備註） | 計算過程的備註 |
數量、成本成對解讀
每一類異動都有「數量」與「成本」兩欄，核對時要一起看。期末成本＝期初成本＋各類進項成本－各類出項成本（含調整、盤差），數字應自洽；若期末成本與你預期不符，循各異動欄回推即可找出落差來源。
欄位連動與附加功能¶
這一節把「輸入欄位後會發生什麼」「按按鈕會做什麼」完整列出，全部來自實際程式碼（CostViewModel）。
-
輸入 Year And Month 後查詢：年月是主檔鍵。輸入並執行瀏覽後，系統載入
Twork_cos_vw_costm主檔該年月的紀錄，並把關聯的Twork_cos_vw_costd明細帶進下方格線（主從一對多）。改年月再查即切換到另一個月份的成本。 -
成本計算按鈕（工具列其他功能）：按下後執行ExtendedFunction1，開啟成本計算精靈視窗（WindowHelper.OpenWindow(CostCalculate)）。- 精靈本身是獨立視窗，預設帶入「當月年月」，內含四個頁籤：
計算前檢核、品號階級檢查、執行計算、計算後檢核。 - 你在精靈裡完成結算並關閉視窗後，本頁會自動呼叫資料重整（
DataNavigateHelper.Renew），重新載入目前年月的成本，讓剛算好的結果立即顯示。 - 若你在精靈中取消、沒有實際執行計算，本頁不會強制重整。
- 精靈本身是獨立視窗，預設帶入「當月年月」，內含四個頁籤：
-
新增鈕（AfterAddNew）：本頁有實作IAdd，但AfterAddNew的處理為空（不帶任何預設值、不產生成本列）。成本明細一律由計算精靈批次產出，所以這顆按鈕在本頁實務上不會用到——資料的「新增」等同於去跑成本計算。 -
明細格線（檢視為主）：明細來自 View，畫面以檢視/核對為主。可排序、篩選、橫向捲動檢視超過 50 個成本欄位，並可透過格線右鍵匯出 Excel 做進一步分析。
-
列印：依目前年月輸出月成本明細報表。
本頁不含沖帳／轉傳票
月成本結算後過帳到總帳的「傳票成本計算」是另一支程式（SliyCostCalculate），不在本頁。本頁只負責「看」當月算好的成本明細。
常見問題¶
輸入年月後明細區一片空白？
多半是該月份尚未做成本計算。本頁只讀取計算結果、本身不算成本。請先按工具列 成本計算 開啟成本計算精靈完成該月份結算，再回本頁查詢。也請確認年月格式為 YYYYMM（如 202606）。
期末成本對不上，怎麼追？
每一類異動都有「數量」與「成本」兩欄。期末成本應等於期初成本加總各類進項成本、減去各類出項與調整、盤差成本。橫向把該品號的各異動欄逐欄核對，即可定位是哪一類異動（進貨、領料、調整、盤差…）造成落差。若懷疑是計算邏輯，重跑成本計算後再比對。
某些異動欄都是 0，是漏算嗎？
不一定。某類異動為 0 通常只是該月該品號沒有發生那種異動（例如沒有借出借入、沒有報廢）。先確認當月確實有對應單據；若有單據卻顯示 0，再回去用成本計算精靈重算並看「計算後檢核」頁是否有提示。
按了 成本計算，回到本頁數字卻沒變？
精靈關閉後本頁會自動重整目前年月的資料。若你在精靈中算的是另一個月份，本頁仍停在原年月、自然看不到變化——把年月改成剛結算的月份再查即可。另外，若精靈中途取消沒有實際執行計算，也不會有變化。
可以在本頁直接改成本數字嗎？
不建議，也不是設計用途。成本明細來自計算結果（View），正確的修改方式是調整來源單據或成本參數後重跑成本計算，讓系統重新結算，而不是手動改本頁的數字。
相關功能¶
- 成本計算精靈：本頁資料的來源，月成本結算作業。
- 移動平均成本：以移動平均法計算與查詢品項成本。
- 標準成本：標準成本維護（與本頁的實際月成本相對）。
- 費用分攤：製造費用分攤至成本。
- K 成本管理總覽
- H 庫存管理：當月進銷存異動的來源單據。
- F 生產管理：製令完工入庫與實際用料。
- N 總帳管理：成本傳票過帳。
需補截圖清單
以下截圖待 runtime 驗收後補拍（放 docs/K-Cost/images/）：
cost-step1.png— 輸入年月查詢後的主從畫面（上方年月、下方成本明細格線）cost-step2.png— 明細格線橫向展開、顯示期初／各異動／期末成本欄位cost-step3.png— 按成本計算開啟成本計算精靈視窗