程式資訊

程式 ID：QRY_RA_NOGI
所屬子系統：M.主管資訊
狀態：stable

進貨資料查詢¶

本功能尚在規劃中（未提供）

「進貨資料查詢（QRY_RA_NOGI，M-070）」目前只有 VFP 舊版（scx_nogi.prg）的實作，新版 TsERP 尚未移植，主選單中暫不會出現此功能。本頁依舊版程式碼描述其規劃中的用途與運作邏輯，供規格參考；下列操作步驟對應 VFP 舊版行為，新版實際上線後可能調整。新版完成後本頁 status 會改為 beta 並補上對應 XAML 路徑與截圖。

功能簡介¶

「進貨資料查詢」把一段期間內的進貨單、進貨退出單、總務進貨單、總務進貨退出單與進貨費用彙整成一份多面向的進貨分析報表，並一次產出6 個頁籤：明細、產品彙總、廠商彙總、日期彙總、單號彙總與採購對照。適合採購／財會主管在對帳、結算進貨成本、檢視供應廠商進退貨狀況時使用，是主管資訊（M.EIS）查詢報表庫中的進貨分析入口。

資料來源是進貨主檔（TRRAMA）與進貨費用檔（TRRAFEE），透過後端 SP（DARB_QRY_STD / DARB_GETDATA4）撈出符合條件的交易，前端再依廠商／產品／日期／單號四種維度做彙總，並把進貨單對應的採購單列在「採購對照」頁，方便核對採購是否完納。

與一般進貨查詢的差異（NoGI）

程式 ID 帶 NOGI 後綴，代表這是主管資訊（EIS）查詢報表庫中不掛公司流程把關（No GI hook）的純查詢版本，只讀資料、不影響任何單據狀態。功能定位等同採購模組的採購資料查詢，但收斂在主管資訊的查詢報表面板下。

前置需求¶

權限：M.主管資訊 → M-070 進貨資料查詢 的瀏覽權限（列印需另具列印權限）。
基礎資料：查詢結果的完整度取決於下列資料的維護狀況——

資料	影響的結果
進貨單／進貨退出單（`TRRAMA`）	明細頁的全部進退貨交易、各彙總頁的金額
總務進貨單／總務進貨退出單	勾選對應單據別後才會納入（單號 `RC`／`RD`）
進貨費用檔（`TRRAFEE`）	勾「進貨費用」後額外列出的費用列（品號自動命名為「進貨費用xxx」）
廠商主檔（`SPDATA`）	各頁的廠商簡稱、進貨費用列的廠商對應
品號主檔／分類	產品彙總頁的品名、單位、群組、分類1～6
採購單（採購對照來源）	採購對照頁的採購單號／預訂交期／採購數量／已交數量、是否完納判斷
樞紐分析範本（`LCL樞紐分析表`，類別＝進貨）	樞紐分析功能可用的範本清單（選填）

操作步驟¶

以下為 VFP 舊版操作流程

新版尚未提供，實際 UI 與按鈕名稱待移植後確認。

從主選單開啟 主管資訊 → 進貨資料查詢。
在左側查詢條件面板設定範圍（詳見欄位說明）：
1. 輸入廠商代號起訖（預設空白～ zzzz，即全部廠商）。
2. 輸入品號起訖（預設空白～ zzzz，即全部品號）。
3. 輸入交易日期起訖（預設今天往前 15 天～今天）。
4. 視需要指定隸屬倉庫（預設 ALL 全倉）。
勾選要納入的單據別（至少勾一項，否則系統擋下並提示「請先選擇單據」）：
- 進貨單（RA）、進貨退出單（RB）、總務進貨單（RC）、總務進貨退出單（RD）、進貨費用。
選擇付款別：全部／已轉應付／未轉應付（依進貨是否已轉應付帳款過濾）。
按 查詢鈕。系統撈資料後，右側 6 個頁籤同步重算並刷新。
視需要切換 6 個頁籤檢視不同維度，或：
- 按 報表選擇 切換明細頁排序（廠商別／產品別／進貨日期別／單號別）。
- 在各頁籤工具列按 預覽／列印／匯出 Excel。
- 若可用樞紐分析，選好樞紐範本後按 分析鈕，系統開啟 Excel 套用範本。

小技巧

改了條件後直接再按一次 查詢鈕 即可整批重算，6 個頁籤會一起更新；各頁籤的格線都支援匯出 Excel。

欄位說明¶

查詢條件面板¶

欄位	必填	說明/格式/預設
起始廠商／截止廠商	—	廠商代號區間；預設空白～ `zzzz`（全部）
起始品號／截止品號	—	品號區間；預設空白～ `zzzz`（全部）
起始日期／截止日期	✔	比對交易日期；預設今天 −15 天～今天（`DTOC(DATE()-15)` ～ `DTOC(DATE())`）
隸屬倉庫	—	預設 `ALL`；非 ALL 時加上倉庫條件過濾
進貨單 / 進貨退出單 / 總務進貨單 / 總務進貨退出單 / 進貨費用	✔（至少一）	對應單號前綴 `RA`／`RB`／`RC`／`RD`／費用；五項全空會被擋
付款別	—	`全部`（預設）／`已轉應付`（轉帳款數量＞0）／`未轉應付`（轉帳款數量＝0）

明細頁（進貨明細）主要欄位¶

欄位	說明
廠商代號／廠商簡稱	進貨對象廠商（簡稱取自 `SPDATA`）
暫收日期／交易日期	進貨暫收與正式交易日
幣別／匯率	原幣別與當筆匯率
倉單號／隸屬倉庫	進貨倉單編號與所屬倉庫
發票號碼／稅額	進項發票與稅額
品號／品名／廠商品號／單位	品項資訊
數量	進貨為正、退貨為負（依交易別碼 `RA/RC` 正、`RB/RD` 負）
單重／總重	總重＝單重 × 數量 ÷ 1000（四捨五入至 0.1）
單價／本幣未稅	單價與本幣未稅金額（退貨為負）
關稅分攤／其他分攤／分攤小計／其他金額／微調金額	進口費用分攤相關
單位成本／成本	成本＝本幣未稅＋分攤小計
預訂交期／訂單編號／訂單序號	對應採購／訂單來源
暫收單號／暫收單序號／採購單號／採購單序號／採購日期	上游單據追溯
進口報單號／運送方式／交易條件／Invoice／起運點／請購人員	進口與請購資訊
箱數／備註／備註1／單號	其他補充欄位

各彙總頁欄位¶

頁籤	主要欄位
產品彙總	品號、品名、單位、進貨數量、退貨數量、進貨金額、退貨金額、進貨淨額、平均單價、關稅分攤、其他分攤、分攤小計、平均成本、成本、群組代號、說明、分類1～6
廠商彙總	廠商代號、廠商簡稱、進貨金額、退貨金額、進貨淨額
日期彙總	交易日期、進貨金額、退貨金額、進貨淨額
單號彙總	交易日期、倉單號、廠商代號／簡稱、進貨金額、進貨稅額、退貨金額、退貨稅額、貨款小計、分攤費用、成本合計、稅別、發票號碼
採購對照	廠商代號／簡稱、預訂交期、採購單號／序號、倉單號、進貨日期、品號、品名、數量、單位、單價、已交數量

欄位連動與附加功能¶

這節說明「按某條件／按鈕後系統會做什麼」，全部依 VFP 舊版 scx_nogi.prg 的 qry_ra_nogi 類別實作。

開窗預設值（Init）¶

當你開啟此查詢視窗，系統會自動帶入：

起始廠商＝空白、截止廠商＝zzzz；起始品號＝空白、截止品號＝zzzz（即預設查全部）。
起始日期＝今天往前 15 天、截止日期＝今天。
隸屬倉庫＝ALL。
若報表設定含「單價」分析項目，會顯示並勾選 包含金額 核取方塊。
若此程式允許樞紐分析（IS_可PIVOT），會從 LCL樞紐分析表（類別＝進貨）載入樞紐範本清單到 樞紐選單 下拉，並啟用 分析鈕。

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

先擋空查詢：若五個單據別核取方塊（進貨單／進貨退出單／總務進貨單／總務進貨退出單／進貨費用）全沒勾，跳出「請先選擇單據」並中止。
清空 6 個結果游標（RA_QRY1、RA產品彙總、RA廠商彙總、RA日期彙總、RA單號別、進貨採購對照）。
組查詢條件：以廠商代號、品號、交易日期三組 BETWEEN 為主；倉庫非 ALL 時加倉庫過濾；依勾選的單據別組成 單號 LIKE 'RA%' / 'RB%' / 'RC%' / 'RD%' 的 OR 條件。
套付款別：選「已轉應付」加 轉帳款數量>0；選「未轉應付」加 轉帳款數量=0。
呼叫後端 SP DARB_QRY_STD（查詢別＝4，單據別＝TRRAMA）撈出明細到 TMPMOVEREC，逐筆計算後寫入 RA_QRY1：
- 數量／本幣未稅：交易別 RA/RC 取正、RB/RD 取負。
- 總重＝單重 × 數量 ÷ 1000（ROUND 至 0.1）。
- 是否完納：採購數量 > 已交數量 → No，否則 Yes。
- 進貨數量／退貨數量／進貨金額／退貨金額：依交易別拆到對應欄位。
- 成本＝本幣未稅＋分攤小計。
進貨費用（若勾選）：另呼叫 DARB_GETDATA4，把 TRRAMA JOIN TRRAFEE JOIN SPDATA 撈出費用列，品號自動命名為「進貨費用」＋費用代碼，併入 RA_QRY1。
產生四張彙總（皆由 RA_QRY1 GROUP BY 而來）：
- 產品彙總：依品號彙總，並算 進貨淨額＝進貨金額＋退貨金額、平均單價＝進貨淨額 ÷ 數量（ROUND 4 位）、平均成本＝成本 ÷ 數量。
- 廠商彙總：依廠商彙總進退貨金額，算進貨淨額。
- 單號彙總：依倉單號彙總，算 貨款小計＝進貨金額＋退貨金額、成本合計＝貨款小計＋分攤費用，並區分進／退貨稅額。
- 日期彙總：由「單號別」再依交易日期彙總，進貨淨額＝進貨金額 − 退貨金額。
採購對照：把 RA_QRY1 依倉單號、採購單號、採購單序號整理，列出每張進貨對應的採購單與已交數量。
包含金額處理：若 包含金額CHK 未勾，把明細頁的單價、原幣未稅、本幣未稅全部清成 0（只看數量、不看金額）。
依報表選擇排序並刷新 6 個頁籤。

按 `報表選擇`（明細頁排序切換）¶

當你切換 報表選擇（廠商別／產品別／進貨日期別／單號別）時，系統會即時把明細頁 RA_QRY1 的索引切到廠商代號／品號／交易日期／倉單號，並重整格線——只改顯示排序，不重撈資料。

列印與匯出（`預覽`／`列印`／`匯出 Excel`）¶

按工具列列印鈕時，系統依「是否包含金額」與「報表選擇」挑對應 FastReport 報表：

不含金額：RA_DE1／RA_DE2／RA_DE3（依報表選擇 1/2/3）。
含金額：RA_DE11／RA_DE21／RA_DE31／RA_DE41。

預覽 開啟報表預覽、列印 送印表機、匯出 Excel 把目前頁籤資料輸出成 Excel（檔名取自頁籤的報表標題，如「進貨單報表」「產品彙總」等）。若無資料會提示「無資料可列印」。

樞紐分析（`分析鈕`）¶

需有樞紐範本才可用

僅在此程式啟用樞紐分析、且 LCL樞紐分析表（類別＝進貨）有對應範本時才有效。

當你選好 樞紐選單 的範本再按 分析鈕，系統會：

把目前頁籤格線的資料 COPY 成暫存 DBF。
找出範本對應的 Excel 樞紐檔，複製到暫存目錄。
用 Excel 開啟該樞紐檔並 RefreshAll，把最新查詢資料灌進樞紐分析表後顯示。

若查無樞紐檔會提示「查無樞紐分析表之檔案」。

常見問題¶

按查詢沒反應，跳出「請先選擇單據」？

五個單據別核取方塊（進貨單／進貨退出單／總務進貨單／總務進貨退出單／進貨費用）至少要勾一項，全空時系統會擋下查詢。

明細與彙總頁的金額全是 0？

若你（或報表設定）取消勾選 包含金額，系統會刻意把單價、原幣未稅、本幣未稅清成 0，只呈現數量。要看金額請勾回 包含金額 再查一次。

查不到某些進貨退出單／總務進貨？

退出單（RB）、總務進貨（RC）、總務退出（RD）只有在勾選對應單據別後才會納入。另外請確認交易日期落在起訖區間內——預設只查「今天往前 15 天」，跨月對帳記得把起始日期往前拉。

採購對照頁的「是否完納」怎麼判斷？

系統比對採購數量與已交數量：採購數量 > 已交數量顯示未完納（No），否則完納（Yes）。資料來自進貨單上記錄的採購單號／序號，若進貨未帶採購來源則無法對照。

為什麼主選單找不到這支功能？

本功能新版尚未移植，目前僅存於 VFP 舊版。請見頁首本功能尚在規劃中的說明；待移植上線後本頁會更新為可用狀態。