程式資訊

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

應收帳齡表查詢條件

功能簡介

本頁是 應收帳齡表（程式代號 I-120、REC_QRY1）的查詢條件面板，並不是獨立的單據。它顯示在帳齡表畫面的條件區，讓財會或業務人員設定「要算到哪一天的帳齡」「要看哪一段帳齡區間」「鎖定哪些客戶」，再按工具列的 查詢 取得五個分頁的結果（帳齡分析表、未收帳款彙總、未收帳款明細、會計師帳齡表、逾期帳齡表）。

換句話說，這一頁只負責「收條件」；真正的計算、顯示、列印與 Excel 匯出都在母查詢頁 應收帳齡表 完成。條件面板上的每一個選項都會直接改變母頁的計算基準與欄位標題。

與其他應收查詢的關係

本面板專屬於 應收帳齡表。若只想查單一客戶的逐筆收款明細，請改用 收款查詢（明細） 或 收款查詢（彙總）。

前置需求

• 權限：I.應收應付 → I-120 應收帳齡表 的瀏覽權限（列印另需列印權限）。條件面板沿用母頁的權限，不另設權限。
• 基礎資料：條件雖只有少數欄位，但查得到、算得準仍取決於下列主檔──

資料	影響的結果
客戶主檔	起始客戶／截止客戶 的代號搜尋、客戶簡稱顯示；停用客戶不列入
應收帳款／立帳資料（財務單）	帳齡各區間金額、未收餘額的來源
收款／沖帳資料	沖帳金額、未收餘額（已沖抵的部分不再列為帳齡）
收付款條件（付款條件主檔）	各列顯示的 付款條件、逾期帳齡表的到期判斷
匯率資料	原幣與本幣換算（明細各頁的本幣金額）

操作步驟

1. 在帳齡表畫面左側（或上方）的條件區，先選 查詢別：
   • 現有餘額（預設）：以今天為帳齡基準日，算出目前仍未收的餘額帳齡。
   • 截止日期：以你輸入的截止日為帳齡基準日，回推當天的帳齡狀態。選此項才會啟用右側的截止日期輸入框。
2. 選 客戶別，決定帳齡要掛在哪一個客戶上：
   • 出貨客戶（預設）：以出貨／開立發票的客戶歸帳。
   • 收款客戶：以實際收款對象（交易客戶）歸帳。
3. 設定 期間 六個帳齡區間天數（P1～P6），預設 30 / 30 / 30 / 90 / 180 / 360。系統會把這六格累加成帳齡分析表與逾期帳齡表的欄位標題（詳見欄位連動與附加功能）。
4. 設定 客戶代號 起訖範圍：左邊 起始客戶、右邊 截止客戶。可用放大鏡帶出客戶；不填則預設整段（起始空白～zzzzzz），即全部客戶。
5. 輸入 結帳年度 與 結帳月份：作為「前期／本期」的分界（結帳年月），預設帶上個月。
6. 若步驟 1 選了 截止日期，於右側的 截止日期 欄輸入帳齡基準日（預設今天）。
7. 條件確認後，按帳齡表工具列的 查詢，母頁即依上述條件重新計算並更新五個分頁。

小技巧

改完任何條件都要再按一次 查詢 才會重算。期間（P1～P6）只要調整就會連動所有帳齡分頁的欄位標題，常用來把預設的「30/60/90/180/360/720 天」改成公司慣用的帳齡切點。

欄位說明

欄位	必填	說明／格式／預設
查詢別	✔	現有餘額（預設，基準日＝今天）或 截止日期（基準日＝輸入的截止日）
截止日期	△	帳齡基準日；格式 yyyy/MM/dd，預設今天。僅當查詢別＝截止日期 時才可輸入
客戶別	✔	出貨客戶（預設）或 收款客戶
期間 P1	✔	第 1 段帳齡天數，預設 30，最多 3 位數
期間 P2	✔	第 2 段帳齡天數，預設 30
期間 P3	✔	第 3 段帳齡天數，預設 30
期間 P4	✔	第 4 段帳齡天數，預設 90
期間 P5	✔	第 5 段帳齡天數，預設 180
期間 P6	✔	第 6 段帳齡天數，預設 360
起始客戶	—	客戶代號範圍起點，預設空白（＝最小）；放大鏡可帶代號
截止客戶	—	客戶代號範圍終點，預設 zzzzzz（＝最大，等於不設上限）
結帳年度	✔	前期／本期分界的年，預設上個月所屬年度（西元 4 碼）
結帳月份	✔	前期／本期分界的月，預設上個月月份（2 碼，如 05）

查詢別 2（一般／會計師簡表）不在本面板

程式內部雖保留 QueryType2（一般應收／一般應收+24）參數，但這一頁沒有對應的輸入欄位，也不是資料過濾條件。「會計師簡表」其實是母頁 應收帳齡表 的一種 Excel 匯出變體（精簡欄位、只匯出未收原幣不為 0 的列），與本條件面板無關，請勿在這裡找它。

欄位連動與附加功能

這一節說明「改了某個條件後，母頁會發生什麼」。所有連動都來自實際程式碼（條件 ViewModel 的屬性連動、母頁 GetHeaders() 與載入事件、查詢 BLL 的基準日計算）。

查詢別 → 是否可輸入截止日、帳齡基準日如何決定

1. 當你把 查詢別 切到 截止日期，系統會把 截止日期 輸入框的 IsEnabled 設為 true（切回 現有餘額 則自動鎖灰、不可輸入）。
2. 按 查詢 時，帳齡的基準日由查詢別決定：
   • 現有餘額：基準日＝系統今天（算「現在」還欠多少）。
   • 截止日期：基準日＝你輸入的截止日（且該日能被正確解析為日期時才生效，否則退回今天）。
3. 客戶別 與 查詢別 會被合併成一個查詢參數送進帳齡 SP（收款客戶 會在內部加上偏移量），因此這兩個選項是一起決定「掛帳對象＋基準日」的，缺一不可。

期間 P1～P6 → 帳齡分析表／逾期帳齡表的欄位標題（累加邏輯）

1. 六個期間天數不是各自獨立的標題，而是會被逐段累加算成帳齡區間。母頁 GetHeaders() 的規則是：
   • 第 1 欄：1 ~ P1
   • 第 2 欄：P1+1 ~ P1+P2
   • 第 3 欄：P1+P2+1 ~ P1+P2+P3
   • …以此類推到第 6 欄
   • 第 7 欄：超過 (P1+P2+P3+P4+P5+P6)（最後一段以上全部歸入此欄）
2. 以預設值 30/30/30/90/180/360 為例，欄位標題會變成 1~30、31~60、61~90、91~180、181~360、361~720、超過720。
3. 查詢完成後，母頁會在資料載入事件（ArAgesChanged／OverDuesChanged）即時把這七段標題寫到：
   • 帳齡分析表 上、下兩個格線的 30/60/90/180/360/720/超過720 等欄位標題。
   • 逾期帳齡表 的 Day30～Over720 各欄標題。
4. 因此調整 P1～P6 後再按 查詢，看到的不只是金額重算，連欄位抬頭都會跟著改成新的帳齡切點。

注意

期間欄位每格最多 3 位數，請填正整數天數。若把某一段填 0，該段帳齡區間會出現「X+1 ~ X」這種頭尾相同的空區間，標題仍會顯示但實務上不會落任何金額；建議維持遞增且非 0 的天數。

截止日期 → 會計師帳齡表的 12 個月欄位標題

1. 會計師帳齡表 分頁的月份欄（月份01～月份12）標題不是固定的「1 月～12 月」，而是以你輸入的截止日期為起點，往回推 12 個月逐月命名（格式 yyyyMM）。
2. 例如截止日期為 2026/06/30，月份01＝202606、月份02＝202605、…、月份12＝202507。
3. 這段命名在母頁的 AccountantArAgesChanged 事件中完成；只有當截止日期能被解析為合法日期時才會套用。

現有餘額模式下的會計師帳齡月份

會計師帳齡表的月份標題一律讀「截止日期」欄的值來回推。即使查詢別選 現有餘額（帳齡基準日用今天），截止日期欄仍保有預設今天值，月份標題會以該值回推──若你想讓月份標題對齊某個月底，建議直接在截止日期欄填上該月底日期。

結帳年度／結帳月份 → 前期/本期分界

1. 結帳年度＋結帳月份 會被組成「結帳年月」，作為未收帳款彙總頁 前期未結款 與 本期應收款 的分界點。
2. 此分界一律採用你輸入的結帳年月，不會被截止日期覆寫（程式已特別處理，避免誤用截止日的字串去截月份）。
3. 因此若彙總頁的「前期／本期」切點不如預期，請回到本面板確認結帳年度／月份是否正確。

起始客戶／截止客戶 → 客戶範圍篩選

1. 兩個 客戶代號 欄使用客戶搜尋控件，可直接打代號或用放大鏡挑選；本面板設定為不強制驗證客戶存在（CheckDataExist=false），方便用代號區間掃描。
2. 不填時預設整段（起始空白～zzzzzz），等於查全部客戶。
3. 查詢時以「起始客戶 ≤ 客戶代號 ≤ 截止客戶」過濾，因此單查一家客戶時，把起訖兩欄填同一個代號即可。

條件如何送出（沒有獨立的「確定」鈕）

本面板沒有自己的存檔／確定按鈕。所有欄位都即時寫回查詢參數，真正的觸發動作是母頁 應收帳齡表 工具列上的 查詢。按下後母頁會：帳齡分析（ArAges）、彙總（NotReceives）、明細（ArDetails）、會計師帳齡（AccountantArAges）、逾期（Overdues）五組資料一次算出並更新各分頁，同時依本面板的條件刷新所有欄位標題。

常見問題

截止日期欄是灰的、打不了字？

截止日期只有在 查詢別＝截止日期 時才開放輸入。請先把查詢別由 現有餘額 切成 截止日期，欄位就會解除鎖定。若停在 現有餘額，帳齡基準日固定為今天，不需要也不能輸入截止日。

帳齡欄位標題（如 31~60、超過720）跟我想的不一樣？

欄位標題是由 期間 P1～P6 累加算出來的，不是各填各的。例如要得到「1~30 / 31~60 / 61~90」就要填 30/30/30，而不是 30/60/90。改完六個期間後記得再按一次 查詢 才會重算並更新標題。詳細累加規則見欄位連動與附加功能。

會計師帳齡表的月份標題不對／不是我要的那 12 個月？

月份標題是以 截止日期 為起點往回推 12 個月。請把截止日期填成想對齊的月底日期（並確認查詢別已切到 截止日期 以便輸入），再按 查詢。若截止日期是空白或無法解析，月份標題不會更新。

前期未結款／本期應收款的切點不對？

前期/本期分界一律以 結帳年度＋結帳月份 為準（預設帶上個月），不會跟著截止日期變動。請回本面板確認結帳年月是否填對。

查不到某家客戶的帳齡？

先確認：(1) 該客戶代號落在 起始客戶～截止客戶 範圍內（單查一家可把起訖填同一代號）；(2) 客戶別 選對（帳掛在出貨客戶或收款客戶）；(3) 該客戶在基準日前確有未沖抵的應收。停用客戶與已全額沖帳者不會出現。

找不到「會計師簡表」或「一般／會計師」的選項？

本條件面板沒有這個欄位。會計師簡表是母頁 應收帳齡表 的 Excel 匯出變體，請到母頁的匯出功能取用，而非在此設定。

相關功能

• 應收帳齡表（母查詢頁）
• 收款查詢（明細）
• 收款查詢（彙總）
• 應收帳款查詢
• 應收帳款列印條件
• 應收應付模組首頁
• 銷售訂單模組
• 總帳模組

---

需補截圖清單

以下截圖待 runtime 驗收後補拍（放 docs/I-ARAP/images/）：

1. aragecondition-step1.png — 條件面板全貌（含查詢別／客戶別兩組單選、期間 P1～P6、客戶代號起訖、結帳年月、截止日期）