程式資訊

程式 ID：RFE
所屬子系統：I.帳款管理
狀態：stable

費用申請單（Request For Expense）¶

功能簡介¶

「費用申請單」（RFE，Request For Expense）是一張主檔＋明細結構的請款／費用申請單據：由申請人填寫單頭（申請日期、申請人、部門、費用類別、是否編列預算、是否優先、專案等），再於下方明細逐列登錄各筆費用項目（費用類型、說明、預估金額）。常見使用者為各部門提出費用申請的承辦人，以及財務／主管進行核准。

在帳款流程中，本單據屬於請款的前置申請階段——記錄「要花多少錢、花在什麼項目上、誰核准」。後續實際的付款沖銷與簽核仍由付款申請（Payapply）、付款單（Psheet）等單據處理。

目前實作範圍

本表單在新版 TsERP 屬於基本資料登錄表單：提供標準的單據新增／修改／刪除／查詢／列印（沿用系統共用工具列），但尚未內建費用申請特有的自動計算（如單頭金額自動加總明細）、轉傳票或專屬簽核流程。畫面欄位標籤目前仍為英文（RFENO、RFEDate…），中文化尚未套用。下文標示「規劃中／尚未提供」者，請以實際版本為準。

前置需求¶

權限：I.帳款管理 →「費用申請單（RFE）」的對應權限。需要新增／修改／刪除／列印時，分別需具備該動作的權限。
基礎資料：單頭多個欄位以放大鏡帶出代號，請先在主檔維護下列資料，否則對應欄位無法選取或會留空。

資料	影響的欄位／結果
使用者（員工）主檔	Request By（申請人）、Approve By（核准人）的代號查詢
部門主檔	Department Code（部門）的代號查詢
專案主檔	Project Code（專案）的代號查詢
費用類別 / 費用類型自訂值	RFECategory（費用類別）、明細的 Expense Type（費用類型）內容

操作步驟¶

本表單沿用系統共用工具列，動作鈕（新增／修改／刪除／查詢／儲存／列印）位於畫面上方。

新增一張費用申請單¶

按工具列 新增，系統建立一張空白單據。
填寫單頭欄位：
- RFEDate（申請日期）：以 ShortDate 格式輸入。
- Request By（申請人）、Approve By（核准人）：以放大鏡查詢使用者代號。
- Department Code（部門）、Project Code（專案）：以放大鏡查詢代號。
- RFECategory（費用類別）：以 TsComboBox 輸入；程式未綁定下拉資料來源，目前為手動輸入（清單為空）。
- 視需要勾選 Budgeted（已編列預算）、Is Priority（優先處理）。
- Notes（備註）：可換行輸入多行文字。
在下方明細格線逐列登錄費用項目：
- Expense Type（費用類型）、Description（說明）、Estimate Amount（預估金額）、User By（使用人）。
按 儲存。RFENO（單號） 欄位為唯讀（IsReadOnly），由系統於儲存時帶出，新增時不需自行輸入。

單頭金額（Amount）

主檔雖有 Amount／AmountSpt 欄位，但畫面上未提供輸入框，且 ViewModel 未內建「明細加總回填單頭」的自動計算。若需要單頭金額，目前須由後續流程或報表自行彙總（明細加總自動回填為規劃中功能）。

修改¶

先以 查詢 帶出欲修改的單據（或在格線中選取）。
按 修改，調整單頭或明細欄位後 儲存。RFENO 不可修改。

刪除¶

帶出目標單據。
按 刪除，確認後移除整張單據（含明細）。

查詢¶

按工具列 查詢，依系統共用查詢條件（單號／日期等）帶回符合的單據顯示於畫面。

列印¶

按工具列 列印 走系統共用列印管線輸出單據。

專屬報表格式

目前程式碼中未找到 RFE 專屬的報表（.frx）或 GetReports 覆寫，因此列印採系統預設輸出。客製化的費用申請單格式屬規劃中。

欄位說明¶

單頭（Rfem）¶

欄位	必填	說明／格式／預設
RFENO	—	單號，唯讀，由系統於儲存時帶出（新增時空白）
RFEDate	—	申請日期，`ShortDate` 格式（字串）；預設空字串
Request By	—	申請人，使用者代號查詢；預設空字串
Department Code	—	部門代號查詢；預設空字串
RFECategory	—	費用類別，`TsComboBox`（未綁定下拉來源，目前等同手動輸入），最長 50 字；預設空字串
Budgeted	—	是否已編列預算（核取方塊，整數 0／1）；預設 0（未勾）
Is Priority	—	是否優先處理（核取方塊，整數 0／1）；預設 0（未勾）
Project Code	—	專案代號查詢；預設空字串
Approve By	—	核准人，使用者代號查詢；預設空字串
Approve Date	—	核准日期，`ShortDate` 格式（字串）；預設空字串
Notes	—	備註，多行文字（`AcceptsReturn`），最長 999 字；預設空字串
Amount / AmountSpt	—	金額欄位（存在於資料模型，畫面未提供輸入框）；預設 0

BudgetedStrc 欄位

主檔另有 BudgetedStrc 欄位，但對應的 XAML 輸入框目前被註解停用，畫面上看不到、也不能編輯。

明細（Rfed）¶

欄位	必填	說明／格式／預設
Line No（LineNo_）	—	明細行號，最長 6 字
Expense Type	—	費用類型，最長 30 字
Description	—	說明，最長 60 字
Estimate Amount（Amount）	—	預估金額，數值欄（`PlaceEnum=Local`，依本幣小數位顯示）
User By	—	使用人

欄位連動與附加功能¶

本表單目前沒有自訂欄位連動或加值功能

RfeViewModel 僅在建構子註冊主檔（RfemSource）與明細（RfedSource）兩個 DataManager，沒有覆寫 SetNewData／Calculate*／HandleDataBeforeEndEdit／ExtensionFunction1~3／GetReports，也沒有對應的 SaveBll 或 VFP 原始程式。因此「輸入某欄後自動帶值或重算」「按延伸功能鈕做特殊處理」等行為，本表單目前都沒有。

實際生效的，是由共用控件與基底 ViewModel 提供的標準行為：

代號查詢控件帶值：當你在 Request By／Approve By 點放大鏡選人、在 Department Code 選部門、在 Project Code 選專案時，控件會把選定的代號寫回對應欄位（UserSearchControl／DeptSearch／ProjectSearch）。這是控件本身的查詢帶值，不是 RFE 專屬邏輯。
費用類別輸入：RFECategory 為下拉控件（TsComboBox），但 XAML 與程式皆未綁定 ItemsSource，因此清單為空，實際上等同手動文字輸入。
核取方塊狀態：Budgeted／Is Priority 為核取方塊，勾選後以整數 0／1 存入。
明細格線編輯：下方 TsRadGridView 綁定 DetailData.GridView，可直接於格線新增／編輯明細列；Estimate Amount 為數值欄，依本幣（PlaceEnum=Local）顯示小數位。
新增時的預設值：新增單據時，資料模型建構子會把字串欄位預設為空字串、SysRowStatus 設為 A（新增狀態），數值與核取方塊預設 0。
共用工具列功能：本表單為標準 B 型單據（FormType.BForm），沿用系統共用工具列的新增／修改／刪除／查詢／儲存／列印；附件、簽核等若由系統層級統一掛載，亦透過共用機制提供，非本表單自訂。

規劃中／尚未提供（只列程式碼確實沒有的）

單頭金額自動加總明細（明細 Estimate Amount 加總回填單頭 Amount）：尚未實作。
轉傳票／轉付款申請：本表單未提供轉單功能。
費用申請專屬簽核流程：未在本 ViewModel 內定義。
專屬報表（.frx）：未提供，列印走系統預設。
欄位中文化：畫面標籤目前仍為英文，多語系 JSON（Common/Lang/Xaml/Rfe.json）尚未填入中文翻譯。

常見問題¶

RFENO（單號）欄位是灰色、不能打字？

這是正常的。RFENO 設為唯讀，新增時留空，由系統於 儲存 時自動帶出單號，不需也不能手動輸入。

單頭看不到「金額」輸入框？單頭 Amount 為什麼是 0？

本表單畫面未提供單頭金額輸入框，且程式未內建「明細預估金額加總回填單頭」的自動計算。費用金額目前登錄在明細的 Estimate Amount；單頭 Amount 預設為 0。明細加總自動回填屬規劃中功能，詳見欄位連動與附加功能。

Request By／Department／Project 的放大鏡查不到資料？

這些欄位以使用者、部門、專案主檔為查詢來源。若查不到，請先確認對應主檔已維護且資料未停用，詳見前置需求。

畫面欄位標籤都是英文（RFENO、RFEDate…），是不是壞了？

不是。本表單尚未套用中文化，標籤目前以英文顯示（多語系字典 Rfe.json 中各欄仍是英文）。功能不受影響，中文化為待辦項目。

找不到費用申請的轉傳票或簽核按鈕？

本表單目前未提供費用申請專屬的轉傳票或簽核流程（程式中沒有對應實作）。實際付款與沖銷請改用付款申請（Payapply）與付款單（Psheet）。