程式資訊

程式 ID：GINVREC
所屬子系統：C.總務管理
狀態：stable

G盤點單¶

功能簡介¶

「G盤點單」（GINVREC，選單代號 C-130）用來對庫存做實地盤點：先由系統依條件抓出庫存當作盤點底稿（帳列數），再由倉管人員填入初盤、複盤、抽盤的實際數量，系統算出各階段的差異量與差異額，最後一鍵轉成盤點調整單（領料／倉庫異動單 GTRLIMA 的 AA 調整單）回沖庫存。

適合倉管或會計在期末（半）年度盤點、或臨時抽盤時使用。它在流程中的位置是：

從庫存產生盤點底稿（新增查詢）。
現場清點、輸入實盤數（初盤／複盤／抽盤）。
確認最終盤點數（執行確認）。
把帳實差異轉成庫存調整單（轉盤點調整單）。

與 H 庫存模組盤點的關係

本表單在程式內部結構（產生底稿的 DARB_GINVREC、三顆其他鈕走 INPUT-ELSE 的 Log_Sys_Input）與 H 庫存模組的盤點單同構，差別在於本支屬於 G 一般事務 的盤點作業。

前置需求¶

權限：C.一般事務 → C-130 G盤點單 的瀏覽、修改權限。
檢視單價權限：差異金額欄（初盤差異額、複盤差異額、抽盤差異額）與單位成本欄只有具「檢視單價」權限者才看得到（見欄位連動與附加功能）。
基礎資料：盤點底稿與差異計算的完整度取決於下列主檔——

資料	影響什麼
G倉庫主檔 GSTKBAS	隸屬倉庫搜尋與驗證
G倉儲位置 GSPLACE	明細倉儲代號搜尋；新增查詢的起訖倉儲範圍
G品號主檔 GINVENT	明細品號搜尋、帶入品名／單位、單位成本來源
製程／工程主檔	明細工程代號搜尋
庫存異動資料	新增查詢時各品號的帳列數（製單日期當日結存）

操作步驟¶

新增一張盤點單¶

從主選單開啟 C.一般事務 → G盤點單。
點工具列 新增。此時 盤點單號 留空，由系統存檔時自動編號。
輸入製單日期與隸屬倉庫（必填，兩者缺一存檔會被擋）。主檔不會自動帶今天日期，請手動填入。
設定盤點別：0 一般盤點、1（半）年度盤點（只接受 0 或 1）。
按 盤點單號 右側的 新增查詢 鈕，開啟盤點底稿查詢視窗，依條件把庫存抓進明細（見從庫存產生盤點底稿）。

新增查詢只在新增模式可用

新增查詢 鈕只有在新增狀態下才能按；瀏覽或修改既有單據時無法重新抓底稿。
點工具列 儲存。

從庫存產生盤點底稿¶

在新增狀態按 新增查詢，彈出查詢視窗。視窗會帶入主檔已填的製單日期與隸屬倉庫；主檔製單日期若留空，視窗的製單日期則預設為今天。
視需要設定起訖倉儲（預設 空白 ~ zzzz，即全部倉儲位置）。
在篩選條件中擇一：
1. 全部：該倉庫所有品號。
2. 品號：填起訖品號範圍。
3. 群組代號：填起訖群組範圍。
4. 品別：填單一品別代碼。
5. 儲位：填起訖儲位範圍。
6. 異動天數：依製單日期回推 N 天內有異動的品號。
7. 隨機抽樣：隨機抽出指定筆數（預設 100）。
設定數量條件（以製單日期當日的帳列數判斷）：全部 / <> 0（預設，排除結存為 0）/ < 0。
按 查詢。系統依條件呼叫 DARB_GINVREC 把符合的庫存逐筆塞進明細，並自動編盤點卡號（1、2、3…）。
查詢成功後視窗關閉，明細已填滿帳列數，回到主畫面繼續輸入實盤數。

查詢會清空現有明細

每次按 查詢 都會先清空目前明細再重塞，請勿在已輸入實盤數後重抓底稿。

輸入實盤數與差異¶

逐列在初盤數填入第一次清點的數量。離開欄位時系統即時算出初盤差異量＝初盤數－帳列數、初盤差異額＝差異量×單位成本（四捨五入至整數）。
需要複盤／抽盤時，於複盤數、抽盤數填入實盤值（這兩欄為文字輸入），系統同樣即時算出對應差異量與差異額。
如為臨時新增的品項，可在空白列直接搜尋品號，系統帶入品名與單位。

重算、確認與轉調整單¶

填完實盤數後，依序使用工具列的三顆其他功能鈕（詳見欄位連動與附加功能）：

重算帳列數：把帳列數重新抓成最新庫存結存（盤點期間若有異動）。
執行確認：把確認盤點數定案、寫回明細。
轉盤點調整單：把帳實差異產生一張庫存調整單。

修改與刪除¶

修改：在瀏覽狀態按 修改 進入編輯。已轉盤點調整單（盤點備註已被回寫）的單據會被擋下，不允許修改或刪除。
刪除：在瀏覽狀態按 刪除；同樣受「已轉調整單不得刪除」限制。
存檔時，倉儲代號與品號皆空白的明細列會被自動標記刪除、不寫入。

欄位說明¶

主檔欄位¶

欄位	必填	說明／格式／預設
盤點單號	自動	唯讀，存檔時系統自動編號
製單日期	✔	`yyyy/MM/dd`，主檔不自動帶今天（需手動輸入）；決定帳列數的結存基準日
隸屬倉庫	✔	搜尋自 G倉庫主檔；存檔與新增查詢都會檢核
盤點別	✔	數字，只接受 `0` 一般盤點 / `1`（半）年度盤點
盤點備註	—	最多 40 字；轉盤點調整單後由系統回寫，作為「已轉單」旗標
盤點調整單	自動	唯讀超連結，轉單後顯示，點擊可跳至對應 GTRLIMA 調整單

明細欄位¶

欄位	必填	說明／格式／預設
盤點卡號	自動	新增查詢時依序自動編號（1、2、3…）
倉儲代號	—	搜尋自 G倉儲位置
品號	—	搜尋自 G品號主檔；帶入品名／單位
品名	自動	由品號帶入，瀏覽唯讀
途程序號	—	文字
工程代號	—	搜尋自製程主檔
批號別／批號	—	批號管理用
單位	—	下拉選單（單位代碼 104），僅編輯模式可改
廠別	—	文字
帳列數	唯讀	系統結存；由新增查詢帶入、`重算帳列數` 重抓
初盤數	—	第一次實盤數量（數值），輸入後即時算差異
複盤數	—	第二次實盤數量（文字欄），輸入後即時算差異
抽盤數	—	抽盤實盤數量（文字欄），輸入後即時算差異
確認盤點數	唯讀	由 `執行確認` 回寫
初／複／抽盤差異量	唯讀	實盤數 − 帳列數
初／複／抽盤差異額	唯讀	差異量 × 單位成本（四捨五入至整數）；需檢視單價權限
單位成本	唯讀	來源庫存成本；需檢視單價權限
備註	—	最多 30 字

欄位連動與附加功能¶

這一節整理「輸入某欄位／按某按鈕後，系統會做什麼」，全部來自實際程式碼。

主檔輸入連動¶

按 新增查詢：開啟盤點底稿查詢視窗（GinvrecmViewModel）。系統會把主檔已填的製單日期與隸屬倉庫先帶進視窗當預設值；查詢成功後，視窗反過來把視窗內的製單日期、隸屬倉庫寫回主檔，並用查回的庫存重建整個明細。此鈕僅新增模式可按。
盤點別輸入檢核：VFP 原本在輸入當下檢查 0/1，新版改在存檔時把關——盤點別不是 0 也不是 1 會擋存檔並提示「(0/1) 資料不正確」。

明細輸入連動（即時重算）¶

輸入品號（離開欄位時）：
- 一般品號：自動帶入該品號的品名與單位。
- 品號為 MISC（雜項）：只有在品名／單位原本空白時才帶入，已輸入的值會保留，讓使用者自行填寫雜項描述。
輸入初盤數（離開欄位時）：系統即時計算
- 初盤差異量 ＝初盤數 − 帳列數
- 初盤差異額 ＝ ROUND(初盤差異量 × 單位成本, 0)
輸入複盤數（離開欄位時）：複盤數是文字欄，系統以 VAL() 規則解析（非數字內容視為 0）：
- 複盤差異量 ＝複盤數空白時為 0，否則 VAL(複盤數) − 帳列數
- 複盤差異額 ＝ ROUND(複盤差異量 × 單位成本, 0)
輸入抽盤數（離開欄位時）：規則同複盤數，算出抽盤差異量／抽盤差異額。

為什麼複盤／抽盤是文字欄

這沿用 VFP 原始設計（InputMask X12 的文字欄），差異一律用 VAL() 解析。輸入非數字（例如留白或符號）時當作 0 計算，不會報錯。

三顆其他功能鈕¶

三顆鈕都會先做共同把關：必須已有存檔資料、盤點單號不可空白、盤點備註非空（代表已轉調整單）則不得再執行、並取得「放行碼」。通過後分別呼叫對應 SP：

重算帳列數（ExtendedFunction1 → DARB_LOG_GINVREC_RECOUNT）：把每列帳列數重新抓成最新庫存結存，用於盤點期間庫存又有異動的情形。成功顯示「重算帳列數，執行成功」並重新整理畫面。
執行確認（ExtendedFunction2 → DARB_LOG_GINVREC_CONFIRM）：把實盤結果定案、回寫確認盤點數欄。成功顯示「執行確認，執行成功」。
轉盤點調整單（ExtendedFunction3 → DARB_LOG_GINVREC_TO_AA）：先檢查是否真有差異——
- 若所有列的帳列數都等於確認盤點數（沒有任何差異），會提示「帳列數與確認盤點數相等，無須盤點調整」並中止。
- 否則跳出「是否確定轉為盤點調整單」確認框，按「是」才執行。
- 成功後系統產生一張庫存調整單（GTRLIMA 的 AA 調整單），並把單號回寫到盤點調整單欄、把盤點備註標記為已轉單（此後該單不可再修改／刪除／重複執行）。

單價權限控制¶

具「檢視單價」權限者，明細的單位成本與三個差異額欄會顯示；無此權限者這些欄位整欄隱藏。

編輯模式限制¶

品名欄在瀏覽模式唯讀（由品號帶入）。
單位欄只有在編輯模式可改。
帳列數／確認盤點數／差異量／差異額／單位成本 全部唯讀，皆由系統計算或 SP 回寫。

尚未提供的部分

VFP 的列印程式（GINVREC_P）尚未移植，本版暫無盤點單列印功能。
簽核（快速審核／工作流程／審核三欄）改走新版集中式 workflow，不在本表單內單獨呈現。
VFP 原有的「測試匯出」（COPY TO C:\TEMPS）為測試碼，未移植。

常見問題¶

按 儲存 出現「請先輸入製單日期／隸屬倉庫」？

這兩欄是必填，且主檔不會自動帶今天日期，請手動輸入製單日期；隸屬倉庫請用搜尋鈕選一個有效倉庫。兩者缺一都會擋存檔。

新增查詢 鈕灰掉按不下去？

新增查詢 只在新增狀態可用。若你正在瀏覽或修改既有單據，請先按 新增 開一張新單。

按 轉盤點調整單 卻說「無須盤點調整」？

代表所有明細的帳列數都等於確認盤點數，帳實無差異就不需要產生調整單。請先確認已輸入實盤數並按過 執行確認，讓確認盤點數正確反映差異。

為什麼看不到差異金額和單位成本欄？

那幾欄受「檢視單價」權限控管。沒有該權限時，單位成本與初／複／抽盤差異額會整欄隱藏，只看得到差異量。

差異額一直是 0，但差異量有數字？

差異額＝差異量 × 單位成本。若該品號在庫存沒有成本（單位成本為 0），差異額自然算出 0。請確認品號的成本資料。

這張單為什麼不能修改或刪除了？

一旦按過 轉盤點調整單，系統會把盤點備註標記為已轉單。此後該盤點單視為已過帳，不允許再修改或刪除，避免與已產生的調整單不一致。