程式資訊

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

客戶應收查詢¶

功能簡介¶

「客戶應收查詢」把每個客戶在指定截止日（或現有餘額）以前的應收帳款立帳、沖帳、未收餘額整理成一份多頁籤的查詢報表，供財會、業務主管掌握各客戶的欠款狀況與帳齡。它不是輸入單據的作業，而是純查詢——資料來源是後端 SP DARB_QRY_REC_QRY0，把財務應收檔（立帳）與收款沖帳資料彙整後，分成五張表呈現：

應收帳款彙總表：以客戶為單位，看出前期未結、本期應收、本期沖帳與最新未結款，並可往下鑽到單據明細與沖帳分錄。
應收帳款明細表：逐筆立帳／沖帳明細，含原幣與本幣金額、發票、稅別。
產品明細表：把每筆應收的銷貨品項展開，看單一客戶買了哪些品號、金額多少。
年度應收帳款統計表：以「結帳月份」為起點，把客戶整年 12 個月的應收金額橫向攤開。
年度應收未收統計表：同上格式，但金額換成各月未收餘額。

與收款作業的差異

本功能只是「看帳」，不會建立或沖銷任何收款。應收的立帳請用收款 / 應收立帳，實際收款與沖帳請用收款單。

前置需求¶

權限：I.AR/AP → I-110 客戶應收查詢 的瀏覽權限；列印報表需另有列印權限。
基礎資料：查詢結果的完整度取決於下列資料——

資料	影響的結果
客戶主檔（含業務員、客戶簡稱）	彙總表的客戶名稱／業務員編號／業務員姓名欄
應收立帳（出貨／銷貨開立的應收）	各頁籤的本幣應收付／稅額／發票號碼／帳款期別
收款沖帳資料	本期沖帳／沖帳本幣／未收帳款的扣抵
財務分錄（沖帳分錄明細）	彙總表下方第四格的借貸方金額／科目／部門等沖帳分錄
倉庫設定	彙總表第二格的倉庫欄（依單號回查所屬倉庫）

操作步驟¶

本功能採「條件面板 + 查詢」模式，沒有新增／修改／刪除動作。

步驟① 設定查詢條件¶

選擇查詢別（兩選一，互斥）：
- 現有餘額（預設）：計算到今天為止的應收與未收餘額，右側「截止日期」欄會變灰、不可輸入。
- 截止日期：勾選後右側日期欄解鎖，改以你輸入的日期為計算基準。
（查詢別為 截止日期 時）輸入截止日期：預設帶今天，系統只彙整此日（含）以前立帳／沖帳的資料。
輸入客戶代號起訖區間：左格起始、右格截止，可用放大鏡挑選客戶。預設起始為空、截止為 zzzzzz，代表全部客戶。
輸入結帳年度／結帳月份：預設為「今天往前一個月」的年月（例如今天 6 月，預設帶 5 月）。這組年月決定彙總表中「前期／本期／最新」的切點，也是年度統計表 12 個欄位的第一個月。
視需要勾選兩個選項：
- 應收彙總明細只含本期（預設勾選）：勾選時彙總表往下鑽的單據明細只列出帳款期別等於結帳年月的那一期；取消勾選則列出全部期別。
- 已沖帳不顯示：勾選時，彙總表會剔除「前期／本期／最新／小計／未收」金額全為 0 的客戶列。

步驟② 執行查詢¶

按工具列的 查詢，系統呼叫 SP 取回資料並填入五個頁籤。彙總表底部同時顯示前期未結款／本期應收款／前期本期小計／最新未結款／總未收帳款五個合計數字。

步驟③ 鑽研明細（彙總表頁）¶

在「應收帳款彙總表」頁籤：

點選上方某一客戶列（第一張表），中間第二張表會自動列出該客戶的單據明細（立帳日期、單號、貨款、稅額、未收帳款、沖帳本幣⋯）。
再點中間某一張單據，下方左右兩張表會帶出該財務單號對應的產品明細（左）與沖帳分錄（右）。

步驟④ 列印與匯出¶

工具列 列印：可印兩張報表——年度應收帳款統計表（I110-1）與 年度應收未收款統計表（I110-2）。報表會帶入以結帳月份為起點的 12 個月份抬頭。
工具列 匯出 Excel：一次把五個頁籤連同彙總明細寫成多工作表的 Excel 檔（檔名 Recqry），工作表包含「應收帳款彙總表-彙總／-明細」「應收帳款明細」「產品明細表」「年度應收帳款統計表」「年度應收未收款統計表」。

小技巧

改了任何條件（例如把查詢別從現有餘額改成截止日期、或調整客戶區間）後，要再按一次 查詢 才會重算，畫面不會即時刷新。

欄位說明¶

查詢條件¶

欄位	必填	說明／格式／預設
查詢別	✔	`現有餘額`（預設，算到今天）或 `截止日期`（算到指定日）
截止日期	—	僅查詢別為 `截止日期` 時可輸入；預設帶當天
客戶代號（起／訖）	—	預設起始空白、截止 `zzzzzz`（全部客戶）
結帳年度	✔	4 碼西元年，預設今天往前一個月的年份
結帳月份	✔	2 碼月份，預設今天往前一個月的月份
應收彙總明細只含本期	—	預設勾選；只列帳款期別＝結帳年月的單據明細
已沖帳不顯示	—	勾選時剔除金額全為 0 的客戶列（預設不勾）

應收帳款彙總表（第一張：客戶彙總）¶

欄位	說明
客戶代號／客戶名稱	客戶主檔
前期未結款	帳款期別小於結帳年月的（本幣應收付－沖帳本幣）加總
本期沖帳	帳款期別等於結帳年月的沖帳本幣加總
本期應收款	帳款期別等於結帳年月的（本幣應收付－沖帳本幣）加總
前期本期小計	帳款期別小於等於結帳年月的（本幣應收付－沖帳本幣）加總
最新未結款	未收帳款－前期未結款－本期應收款（即結帳年月之後尚未結清者）
未收帳款	全部（本幣應收付－沖帳本幣）加總
業務員編號／姓名	該客戶的負責業務員

應收帳款彙總表（第二張：單據明細）¶

欄位	說明
財務單號／立帳日期／交易日期	該筆應收的立帳憑證
倉庫	依單號回查所屬倉庫
訂單編號／單號	來源單據
稅別／貨款／稅額	貨款＝本幣應收付－稅額
本幣應收付／沖帳本幣／未收帳款	未收帳款＝本幣應收付－沖帳本幣
發票號碼／帳款期別	對應發票與期別

應收帳款明細表（第二頁籤）¶

逐筆列出立帳明細，含原幣應收付／本幣應收付／沖帳原幣／沖帳本幣／未收原幣／未收本幣／幣別／匯率/稅額/稅別，以及發票抬頭／統一編號／發票金額／發票號碼／到期日／收款日／訂單編號等。「年度月份」取交易日期前 7 碼。

產品明細表（第三頁籤）¶

把每筆應收的銷貨品項展開，欄位含品號／品名／客廠品號／數量／單位／單價／原幣未稅／原幣含稅／本幣未稅／本幣含稅／沖帳原幣／沖帳本幣／轉入倉儲／轉出倉儲／交易別碼等。

年度應收帳款統計表／年度應收未收統計表（第四、五頁籤）¶

欄位	說明
客戶代號／客戶名稱	客戶
C01～C12 月份欄	以結帳月份為起點橫向 12 個月；欄抬頭隨結帳月份動態變動（例如結帳月份 5 → 第一欄抬頭「05月」）
總計	該客戶 12 個月加總
最末「總計」列	全部客戶各月加總

兩張表格式相同，差別在金額：第四頁籤填本幣應收付、第五頁籤填未收本幣。

欄位連動與附加功能¶

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

查詢別與截止日期連動¶

當你把查詢別切到 現有餘額，系統把截止日期欄停用（截止日期IsEnabled = false），並在查詢時以「今天」為計算基準（送給 SP 的查詢別參數＝1，截止日期帶當天字串）。
當你切到 截止日期，截止日期欄解鎖，查詢時改以你輸入的日期為基準（查詢別參數＝2）。

按 `查詢` 時系統做的事¶

以查詢別與截止日期、客戶起訖呼叫 SP DARB_QRY_REC_QRY0，回傳三張資料表（立帳明細、產品明細、沖帳分錄）。
彙總表第一張：把立帳明細依客戶＋業務員分組，算出前期未結、本期沖帳、本期應收、前期本期小計與未收帳款（規則見欄位說明）。
彙總表第二張：逐筆建立單據明細，貨款＝本幣應收付－稅額、未收帳款＝本幣應收付－沖帳本幣，並透過單號回查倉庫；若勾了應收彙總明細只含本期，只保留帳款期別＝結帳年月的列；最後依交易日期排序。
若勾了已沖帳不顯示，把彙總第一張中五項金額全為 0 的客戶列移除。
合併單號還原：第二張中單號為 合併 的列，系統會到產品明細用同一財務單號把實際的多張來源單號串成「A,B,C,」回填到單號欄，方便辨識合併立帳的來源。
建立應收明細表（未收原幣＝原幣應收付－沖帳原幣、未收本幣＝本幣應收付－沖帳本幣）、產品明細表。
建立兩張年度統計：依帳款期別的月份對應到 C01～C12（以結帳月份為第一欄、跨年循環回捲），分別累加本幣應收付與未收本幣，並在最後補一列「總計」。

彙總表的層層帶出（鑽研）¶

點選彙總第一張的某客戶列 → 以客戶代號查 lookup，帶出該客戶的單據明細到第二張，並自動選取第一筆。
點選第二張某單據 → 以財務單號查 lookup，同時帶出產品明細（左下）與沖帳分錄（右下）。
取消選取時對應的下層表會清空。

底部合計¶

查詢完成後，彙總表底部五個唯讀數字直接由第一張彙總加總而來：前期未結款／本期應收款／前期本期小計／最新未結款／總未收帳款。

年度統計表的月份抬頭¶

第四、五頁籤的 12 個月份欄抬頭不是固定 1～12 月，而是以你輸入的結帳月份為第一欄往後排，超過 12 月自動回捲（例如結帳月份 11，欄序為 11月、12月、01月⋯10月）。列印報表時同樣帶入這組動態抬頭。

列印（`列印`）¶

提供兩張報表：年度應收帳款統計表（報表編號 I110-1）與 年度應收未收款統計表（報表編號 I110-2），資料分別取自第四、五頁籤。
兩張報表都會帶入以結帳月份為起點的 12 個月份抬頭（H1～H12）。

匯出 Excel（`匯出 Excel`）¶

按下後一次輸出含六個工作表的 Excel（檔名 Recqry）：應收帳款彙總表-彙總、應收帳款彙總表-明細（所有客戶的完整單據明細）、應收帳款明細、產品明細表、年度應收帳款統計表、年度應收未收款統計表。

VFP 舊版的『報表選擇／刪除已沖帳』

VFP 原版列印鈕另有「彙總表／明細表」單選與獨立的「刪除已沖帳」核取方塊。新版 C# 把列印固定為兩張年度統計報表，沖帳剔除邏輯則由條件面板的已沖帳不顯示承接，行為對齊但操作位置不同。

常見問題¶

查詢別選了「現有餘額」，為什麼截止日期欄是灰的、改不了？

這是正常設計。現有餘額 一律算到今天，所以截止日期欄會被停用。若要查指定日的餘額，請改選 截止日期，欄位就會解鎖。

彙總表查得到客戶，但往下鑽（第二、三、四張表）沒有資料？

下層表是「點選上層列才會帶出」的。請先點選彙總第一張的客戶列，再點中間出現的單據列，左下產品明細與右下沖帳分錄才會出現。若該客戶該期確實沒有對應單據，下層也會是空的。

本期應收款／前期未結款都是 0，但客戶明明有欠款？

這三欄是以結帳年度／結帳月份為切點計算的。請確認結帳年月設定正確（預設是今天往前一個月）——若帳款期別都落在你設的結帳年月「之後」，金額會全跑進「最新未結款」而不是本期。

想看到所有客戶的每一筆單據明細，但彙總往下鑽只看到一期？

這是應收彙總明細只含本期（預設勾選）造成的，它只列帳款期別等於結帳年月的單據。取消勾選後再查詢，就會列出該客戶所有期別的單據明細。

彙總表客戶列太多、夾雜很多 0 元的客戶怎麼辦？

勾選已沖帳不顯示再查詢，系統會剔除前期、本期、最新、小計、未收金額全為 0 的客戶列。

單號顯示「合併」是什麼意思？

代表該筆財務單是由多張來源單據合併立帳的。查詢時系統會自動到產品明細把實際的多張單號串起來回填，若仍顯示合併字樣，表示找不到對應的明細單號。