程式資訊

程式 ID：Chkrecqry
所屬子系統：O.銀行票據
狀態：stable

應收票據查詢¶

功能簡介¶

「應收票據查詢」用來把客戶交付的應收票據（支票、本票等）依條件撈出來檢視與列印。它直接讀取應收票據檔，提供兩種查詢模式：

明細查詢：依收款日期、客戶、票據號碼、到期日、兌現日、託收日、帳戶與票況等條件，列出每一張票的完整明細。
餘額查詢：以某個基準日（餘額表日期）回算當時「尚在手上、未兌現」的應收票據庫存。

結果除了逐張明細，還會在畫面上方彙總本幣金額合計與各幣別原幣合計，適合出納、會計或財務主管掌握應收票據的水位、到期分布與兌現狀況。它屬於查詢報表，只看資料、不改資料，票據本身的維護請在票據相關作業中進行。

前置需求¶

權限：O.出納 → O-080 應收票據查詢 的瀏覽權限；要列印報表另需列印權限。
基礎資料：查詢結果是否完整、欄位是否有值，取決於下列資料的維護狀況——

資料	影響的結果
應收票據（票據主檔／異動）	查詢的資料來源，所有明細列與彙總金額
客戶主檔	條件面板的客戶起訖選擇、明細的對象簡稱
銀行帳戶主檔	條件面板的帳戶代號起訖選擇、明細的帳戶簡稱
票況代碼（`Cmb_C231`）	條件面板票況下拉的可選清單與明細的票況說明文字
立帳匯率（票據建檔時記錄）	明細的本幣金額＝票據金額 × 立帳匯率

操作步驟¶

一、選擇查詢模式¶

條件面板最上方有兩個選項：

點選 明細查詢（預設）：下方的明細條件區會啟用，餘額表日期會反灰。
點選 餘額查詢：明細條件區整區反灰，只剩餘額表日期可輸入。

兩種模式互斥

切換 明細查詢／餘額查詢 時，系統會自動把另一組條件停用（反灰），避免誤填。實際查詢時也只會採用目前啟用那一組條件。

二、設定查詢條件（明細查詢）¶

輸入收款日期起訖（預設起日為今天往前三個月、訖日 9999/12/31）。
視需要縮小範圍，輸入下列任一組起訖條件：客戶、到期日、兌現日期、託收日期、帳戶代號、票據號碼。未填的條件維持預設的「全範圍」（起＝空、訖＝zzzzz 或 9999/12/31），等於不限制。
在票況下拉選擇要看的票況：All（全部）、未兌現（CA／CB 兩種狀態）或單一票況代碼。
按工具列的 查詢。

三、設定查詢條件（餘額查詢）¶

在餘額表日期輸入基準日（預設今天）。
按 查詢。系統會撈出「收款日期在基準日（含）以前，且到該日仍未兌現」的票據（詳見餘額查詢的庫存判定）。

餘額表日期必填

餘額查詢模式下若沒填餘額表日期，按查詢會跳出提示要求輸入，不會執行。

四、看結果與彙總¶

查詢完成後，明細顯示在主格線，畫面上方同時顯示：

本幣金額彙總：所有列的本幣金額加總。
原幣金額彙總：依幣別分組，列出每個幣別的票據金額合計（例：TWD 1200000, USD 5000）。

查詢結果與彙總

五、調整排序¶

畫面右上方有四個排序選項，點選後立即重排目前的查詢結果，不必重查：

收款日期（預設）、到期日、票據號碼、客戶。

六、列印報表¶

工具列列印會輸出報表 O080-1 應收票據一覽表（國別 TW、A4）。報表資料就是目前查詢出來的明細，沒有資料時不會出表。

欄位說明¶

查詢條件¶

欄位	必填	說明/格式/預設
查詢別	✔	`明細查詢`（預設）或 `餘額查詢`，兩者互斥
收款日期（起～訖）	—	起＝今天 `AddMonths(-3)`、訖＝`9999/12/31`；明細查詢用
客戶（起～訖）	—	起＝空、訖＝`zzzzz`（全範圍）；以客戶搜尋帶入
到期日（起～訖）	—	起＝今天 `AddMonths(-3)`、訖＝`9999/12/31`
兌現日期（起～訖）	—	起／訖預設皆為空（不限制）
託收日期（起～訖）	—	起／訖預設皆為空（不限制）
帳戶代號（起～訖）	—	起＝空、訖＝`zzzzz`；以銀行帳戶搜尋帶入
票據號碼（起～訖）	—	起＝空、訖＝`zzzzz`
票況	—	預設 `All`；可選 `未兌現` 或單一票況代碼
餘額表日期	餘額查詢時 ✔	預設今天；僅餘額查詢模式可輸入、且必填

結果格線欄位¶

欄位	說明
收款日期	票據的收款（建檔）日期
交易對象／對象簡稱	票據對應的客戶代號與簡稱
開票銀行／開票分行／開票帳號	票據付款行資訊
票據號碼	票號
傳票號碼	票據對應的會計傳票
幣別／票據金額／立帳匯率	原幣別、原幣金額與建檔當時匯率
本幣金額	＝票據金額 × 立帳匯率（四捨五入至本幣小數位數）
到期日／預兌日	票據到期日與預計兌現日
票別	票據種類
票況	票況代碼＋票況說明文字（合併顯示）
禁止轉讓／平行線	票面註記
異動日期／託收日期／兌現日期	票據處理過程的各階段日期
帳戶代號／帳戶簡稱	託收／兌現所屬的銀行帳戶
自定欄位／票據備註／摘要	自訂與備註欄
對方科目	入帳對方科目
分類索引1	分類索引
轉入備註／轉出備註	票據轉入／轉出來源註記
收款單號	對應的收款單

欄位連動與附加功能¶

這一節整理「輸入某欄位／按某動作後，系統會做什麼」，都是程式碼實際存在的行為。

查詢別切換（明細 ⇄ 餘額）¶

當你選 明細查詢，系統會把明細條件區設為可用、把餘額表日期反灰。
當你選 餘額查詢，系統會把明細條件區整區反灰、只啟用餘額表日期。
兩者是互斥的單選，切換時自動連動啟用／停用，避免同時送出兩套條件。

票況下拉的清單組成¶

開窗時系統會組出票況下拉的選項，順序如下：

先放 All（代碼 C0）── 不過濾票況。
再放 未兌現（代碼 C1）── 只看 CA、CB 兩種票況。
後面接著票況代碼表（Cmb_C231）裡的每一個票況，並依使用者語系翻譯顯示。

選 All 時查詢條件加 1=1（等於不限制）；選 未兌現 時加「票況 in (CA, CB)」；選其他單一票況時就只比對該一種票況。

明細查詢的條件組裝¶

按 查詢 後，明細模式會把面板上所有起訖條件用 BETWEEN 串成查詢條件，一次比對：收款日期、交易對象（客戶）、票據號碼、到期日、兌現日期、託收日期、帳戶代號，再加上前述票況條件。沒填的欄位因為帶了 9999/12/31／zzzzz 這類預設值，等於該條件「全範圍不限制」。

餘額查詢的庫存判定¶

選 餘額查詢 時，系統不是用面板那些起訖條件，而是改用一條「以餘額表日期回推未兌現庫存」的邏輯：

收款日期 ≤ 餘額表日期，且
票況為 CA 或 CB（仍在手／未兌現），或票況為 CE（已兌現／結案）但異動日期晚於餘額表日期（代表在基準日當下其實還沒結案）。

換句話說，它回算的是「基準日那一刻帳上還掛著的應收票據」，CE 但異動日在基準日之後的票會被視為當時仍未結案而納入。

本幣金額自動換算¶

每一列的本幣金額不是直接取自資料，而是由系統算出來：票據金額 × 立帳匯率，再依本幣小數位數四捨五入。所以即使是外幣票據，也能用一致的本幣口徑加總。

兩個彙總值的算法¶

查詢完成後系統會自動算兩個彙總並顯示在畫面上方：

本幣金額彙總：把所有列的本幣金額直接加總。
原幣金額彙總：依幣別分組，分別加總各幣別的票據金額，組成像 TWD 1200000, USD 5000 的字串。多幣別時可一眼看出每種幣別各有多少。

排序即時重排（不必重查）¶

畫面右上的四個排序選項（收款日期／到期日／票據號碼／客戶）是對目前已查出的結果就地重新排序，切換時立刻生效，不會重新查資料庫。預設依收款日期排序。

列印報表¶

工具列列印會輸出報表 O080-1 應收票據一覽表（國別 TW、A4）。報表資料就是目前查詢出來的明細，沒有資料時不會出表。

常見問題¶

查不到任何資料？

先確認查詢別：明細查詢看的是收款日期等起訖條件，餘額查詢看的是餘額表日期。明細查詢的收款日期預設只往前抓三個月（今天 AddMonths(-3)），更早的票要把收款日期起日往前調。也請確認該區間內確實有應收票據，且票況符合下拉選的條件。

為什麼預設只看得到近三個月的票？

這是刻意的預設：收款日期與到期日的起日都帶今天往前三個月，避免一開窗就撈出全部歷史。要看更早資料，直接把起始日往前改即可。

餘額查詢按了沒反應、跳出要我輸入日期？

餘額查詢模式下餘額表日期為必填，沒填會被擋下並提示。填入基準日後再查即可。

本幣金額是 0 或不對？

本幣金額是「票據金額 × 立帳匯率」算出來的。若某張票的立帳匯率在建檔時是 0 或漏填，本幣金額就會算成 0。請回票據建檔資料確認立帳匯率。

原幣金額彙總出現好幾種幣別？

那是正常的——原幣金額彙總會依幣別分組分別加總，所以查詢結果若含多種幣別，就會列出每個幣別各自的合計。要單看某幣別，可先用條件縮小範圍。

票況下拉裡的「All」和「未兌現」是什麼？

All 代表不限票況（全部都看）；未兌現 是系統內建的快捷選項，等於只看 CA、CB 兩種票況。其餘選項則是票況代碼表（Cmb_C231）裡的個別票況。