程式資訊

程式 ID：AcclParameter
所屬子系統：N.總帳管理
狀態：stable

會計科目參數設定¶

功能簡介¶

「會計科目參數設定」是一個設定用的彈出視窗，讓總帳人員把系統最常用的 9 個關鍵會計科目（存貨、進項稅額、應收、銷貨收入、銷貨退回、銷項稅額、應付、銷貨成本、存貨盤盈虧）一次設定好。

這 9 個科目是各模組在轉立傳票、產生自動分錄時的借貸對方科目來源——例如進貨暫收沖立傳票時要借「存貨」、銷貨開立發票時要貸「銷貨收入」與「銷項稅額」。設定值實際寫入財務類別碼（RPDEF） 對照表的「正值科目」欄位，供全系統共用。

本頁與科目維護的關係

本視窗是依附在會計科目維護（ACCL）下的子設定畫面，用來集中設定常用科目，而不是逐筆維護整張財務類別碼表。完整的財務類別碼對照（每一種單據類別對應的科目）仍由 ARAP 模組的「財務類別碼設定（RPDEF）」維護。

目前進入點尚未開放

本視窗的程式（View 與 ViewModel）已完成，但在現行版本中，會計科目維護用來開啟它的「其他功能2」呼叫被註解停用，因此目前無法從操作介面開啟此視窗。下方操作步驟描述的是程式既有的設計行為，待進入點重新接上後即可使用。

前置需求¶

權限：N.總帳 → 會計科目維護（ACCL） 的操作權限（本視窗由科目維護的工具列功能開啟）。
基礎資料：本視窗只能挑選已存在的會計科目，並把值寫回財務類別碼表，因此下列資料必須先維護——

資料	影響什麼
會計科目（會計科目維護）	9 個欄位只能輸入／挑選已建立的科目代號；找不到的代號無法通過驗證
財務類別碼（RPDEF 對照表）	存檔目標。每個欄位對應一個財務類別碼（如存貨＝`AK`、進項稅額＝`A9`），表中要先有對應的類別列，存檔才寫得進去
本機財務單據表快取（LCL財務單據表）	存檔成功後系統會重抓此快取，各單據才會立即套用新科目

操作步驟¶

這是一個一頁式設定視窗

本視窗沒有新增／刪除／查詢／列印等動作，只有「填入 9 個科目 → 存檔」一條流程。視窗開啟時會自動帶出目前財務類別碼表中已設定的科目值。

從會計科目維護開啟「會計科目參數設定」視窗（待進入點開放，見上方提示）。
視窗開啟時，9 個欄位會自動帶出目前已設定的科目代號（取自財務類別碼表的正值科目）。
逐欄輸入或修改科目代號。每個欄位都是科目查詢框：
1. 直接輸入科目代號。
2. 或按欄位旁的搜尋鈕叫出會計科目挑選清單，選取後自動帶回代號，右側並顯示科目名稱。
按 儲存，系統會：
1. 先做欄位驗證（科目代號需為有效科目）。
2. 只把有變動的欄位寫回財務類別碼表。
3. 重新整理本機財務單據表快取，讓新科目立即生效。
4. 顯示「儲存成功」訊息（存檔流程會把 DialogResult 設為 true，由外層視窗據此關閉）。
若不想存檔，請直接關閉視窗，不會寫入任何變更。

「取消」鈕目前無作用

畫面右下角有 儲存 與 取消 兩顆按鈕。取消 鈕在程式中綁的是 ExitCommand，但本視窗的 ViewModel 並未定義 此命令，因此這顆按鈕目前按下去沒有反應（屬已知缺口）。要離開請改用視窗本身的關閉鈕。

欄位說明¶

視窗上的 9 個欄位各對應一個財務類別碼。存檔時依此對照把科目寫入對應類別的「正值科目」欄位。

欄位（畫面標籤）	中文意義	對應財務類別碼	必填	說明
Inventory	存貨	`AK`	—	進貨／出庫等異動的存貨科目
Receiving Tax	進項稅額	`A9`	—	進貨發票的進項稅額科目
Account Receivable	應收帳款	`12`（出貨）	—	銷貨應收科目
Sales Revenue	銷貨收入	`AC`	—	銷貨收入科目
Sales Return	銷貨退回	`21`	—	銷貨退回沖銷科目
Sales Tax	銷項稅額	`A8`	—	銷貨發票的銷項稅額科目
Account Payable	應付帳款	`51`（進貨發票）	—	進貨應付科目
Cost of Goods Sold (COGS)	銷貨成本	`AL`	—	出貨結轉的銷貨成本科目
Inventory Gain	存貨盤盈虧	`AM`	—	盤點盈虧調整科目

欄位沒有「必填」硬性限制

程式不強制每個欄位都要填；只有與原值不同的欄位才會被寫回。未填或未變動的欄位維持原狀。但若某科目留空，依賴它的單據在轉立傳票時可能找不到對方科目，建議全部設定完整。

畫面標籤目前為英文

本視窗的欄位標籤（Inventory、Sales Revenue…）目前在程式中寫死為英文，尚未套用多語系。上表已附中文對照，操作時請依「中文意義」一欄判讀。

欄位連動與附加功能¶

這一節說明「輸入或操作每個元件後，系統實際會做什麼」，全部來自程式碼。

視窗開啟時的自動帶值¶

視窗一開啟，建構式會用財務類別碼表的目前值填入 9 個欄位。每個欄位的初值取自該財務類別碼的正值科目（Get(類別碼) → 本機財務單據表快取的對應科目）。
因此你看到的不是空白表單，而是目前生效中的設定，可在此基礎上修改。

存貨盤盈虧初值的已知狀況

程式中「存貨盤盈虧（Inventory Gain）」欄位的初值目前是用應收帳款（12） 的科目帶入，而非存貨盤盈虧本身的類別碼。這是帶值來源的設定狀況；存檔時則是以正確的 AM 類別寫回。若開啟視窗時 Inventory Gain 顯示的值看起來像應收科目，屬此已知行為，存檔前請自行確認填入正確的盤盈虧科目。

科目查詢框（每個欄位）¶

9 個欄位都套用 AcclSearch 樣式，屬於會計科目查詢框：
- 可直接鍵入科目代號。
- 也可叫出會計科目挑選清單選取，選後自動帶回代號，並可在旁顯示科目名稱。
當你輸入的代號不是有效會計科目時，欄位會進入驗證錯誤狀態。

按 `儲存`（ConfirmCommand）會做的事¶

當你按下 儲存，系統依序執行：

表單驗證：先檢查整個視窗有無欄位驗證錯誤（FormHasErrors）。只要有任一欄位是無效科目，跳出提示訊息並中止存檔。
讀取財務類別碼清單：呼叫 GetAcclParameter 取得目前財務類別碼資料。若一筆都讀不到，視為系統錯誤、跳錯誤訊息並中止。
逐欄比對寫回：把 9 個欄位的值，依「欄位 → 財務類別碼」對照，寫入對應類別列的科目欄位。
- 只有變動的列才更新：若某欄填的值與表中原值相同，該列不動；不同才把它標記為「修改（E）」。
上傳變更：若有任何被標記為修改的列，呼叫上傳程式把這些變動寫回資料庫（以 RPDEF 程式身分上傳）。
- 成功 → 顯示「儲存成功」、刷新本機財務單據表快取（見下）。
- 失敗 → 顯示「儲存失敗」訊息。
設定關閉旗標：流程最後把 DialogResult 設為 true（不論有無變動）。實際的視窗關閉由外層宿主視窗依此旗標處理，VM 本身不直接關窗。

存檔成功後的快取刷新（UpdateLocalParameter）¶

存檔成功後系統會：
1. 重新抓取本機財務單據表（LCL財務單據表） 快取。
2. 重建財務單據字典（GetDicFinance(true)）。
這一步是關鍵：刷新後，所有依賴這 9 個科目的單據／轉傳票功能在同一作業階段內即可立即套用新科目，不必重新登入系統。

按 `取消`（ExitCommand）— 目前無作用¶

畫面上的 取消 鈕在 XAML 中綁定 ExitCommand，但本視窗的 ViewModel（AcclParameterViewModel）沒有定義 ExitCommand（它只定義了 ConfirmCommand）。因此這是一個失效綁定，按下去不會有任何動作。
要離開視窗請改用視窗右上角的關閉鈕。此缺口待補上命令後即可正常運作。

新版尚未提供的相關行為

程式中保留了一段「存檔後逐筆同步各欄位到本機快取」的明細寫法，目前被註解、改以整批重抓快取取代。一般使用者無需理會此差異；功能結果一致（存完即生效）。

常見問題¶

我在科目維護裡找不到「會計科目參數設定」的入口？

本視窗由會計科目維護的「其他功能2」開啟，但該呼叫在現行版本被註解停用，所以目前無法從介面開啟。程式本體已完成，待進入點重新接上即可使用（詳見本頁開頭的提示）。

輸入科目代號後存不了檔，一直跳提示？

每個欄位都會驗證科目代號是否為有效會計科目。只要有任一欄填的是不存在的代號，存檔會被擋下並跳提示。請改用欄位旁的挑選清單選取有效科目，或先到會計科目維護建立該科目。

存檔顯示成功，但其他單據的對方科目沒變？

本視窗存檔時只更新與原值不同的欄位。若你填的值剛好和原設定相同，系統不會發出更新。請確認確實有改動，再重新存檔。存檔成功後系統已自動刷新本機財務單據表快取，新科目應即時生效。

Inventory Gain（存貨盤盈虧）開啟時帶出來的值怪怪的？

這是已知的帶值來源狀況——開啟視窗時該欄初值目前取自應收科目，而非盤盈虧本身。存檔仍以正確的盤盈虧類別寫回。請在存檔前自行確認填入正確的存貨盤盈虧科目。

存檔出現「系統錯誤」訊息？

代表系統讀不到財務類別碼（RPDEF）資料。請確認財務類別碼對照表已正確建立，且這 9 個欄位對應的類別碼（如 AK、A9、AC…）在表中都有對應列。

按「取消」鈕沒有反應、視窗關不掉？

取消 鈕在程式中綁的 ExitCommand 在本視窗的 ViewModel 尚未實作（屬已知缺口），因此按下去不會有動作。請改用視窗右上角的關閉鈕離開。