客戶代料查詢¶

此功能尚在規劃，目前版本未提供

本頁對應的程式代號 QRY_CUSTKP_CSTK（客戶代料查詢，M-130） 在新版 TsERP（C# / WPF）中 尚未實作：系統僅在程式對照表（docs/programmap.txt）保留了程式代號與名稱位置，並無對應的查詢畫面、ViewModel（VM）、商業邏輯（BLL）或資料來源（Source / View），也沒有可比對的 VFP 舊版 .prg 原始碼。

本頁僅就規劃用途做說明，不要當成現行可操作的功能。畫面、條件欄位與結果欄位等內容，待功能實際開發後再由真實程式碼補齊。

功能簡介¶

「客戶代料查詢」（規劃中） 預期屬於主管資訊（M-EIS）的查詢／報表類程式（代號 QRY_CUSTKP_CSTK，歸屬 M-130）。名稱中的「代料」指的是客戶代料／客供料 （由客戶提供、廠內代為使用或加工的材料）。其規劃定位是讓主管或承辦人員，從主管資訊端集中查詢客戶代料的相關資料，而非在單據端逐筆翻找。

名稱中的 _CSTK 字尾與系統內其他同系列查詢報表（銷售單價異動記錄（QRY_SALPX_CSTK，M-120）、採購資料查詢（QRY_PUR_CSTK，G-050）、領料資料查詢（QRY_PA_CSTK，C-150）等）一致，研判其定位為以查詢／報表方式呈現資料，而非單據維護表單；因此本頁不描述新增／修改／刪除等異動動作。

與一般主管資訊查詢報表的共同形態（規劃）

本系統的主管資訊查詢報表（如客戶資料查詢）通常都是先在條件面板設定查詢範圍 → 按查詢 → 在結果格線檢視，並可右鍵匯出 Excel，沒有存檔動作。「客戶代料查詢」實作時預期沿用相同形態。但實際的查詢條件、結果欄位與算法，須等程式實作後依真實程式碼補寫，本頁不預先臆測。

前置需求¶

待開發後補齊

本功能尚未實作，前置需求（所需權限、必須先維護的主檔與參數）待程式開發完成後，依實際程式碼補上。依命名研判，未來預期至少需要：

權限：M-130 客戶代料查詢 的瀏覽權限。
基礎資料：客戶主檔、品號主檔，以及客供料／客戶代料相關的庫存與進出料記錄—— 實際相依以開發完成後的程式碼為準。

操作步驟¶

目前無操作步驟

QRY_CUSTKP_CSTK 在新版 TsERP 尚未實作，沒有可操作的查詢畫面。功能完成後，本節將補上編號操作步驟與對應截圖。在此之前，主選單即使列出此項目，開啟後也不會有可用畫面。

預期（待開發確認）的操作流程，會與同模組其他查詢報表一致：先在條件面板設定查詢範圍，再按 查詢 將結果顯示於格線，必要時 列印 或匯出 Excel。具體欄位待實作後補齊。

目前狀態¶

項目	狀態
主管資訊選單登錄（`M-130`）	已登錄於程式對照表（`QRY_CUSTKP_CSTK｜客戶代料查詢｜M-130`）
新版 C# 畫面（XAML）	尚未提供
ViewModel／查詢條件面板	尚未提供
查詢邏輯（BLL／SP）	尚未提供
資料來源（Source／View）	尚未提供
VFP 舊版來源（`vfpcode/`）	查無對應 `.prg` 來源

如何確認是否已開放

若日後此功能完成開發，本頁的 status 會由 planned 更新為 beta／stable，並補上實際的條件面板、結果欄位與操作步驟。在那之前，主選單即使列出此項目，開啟後也不會有可用的查詢畫面。

無 VFP 舊版來源可供還原

與同模組多數查詢報表不同，目前 repo 的 vfpcode/scx_qry、vfpcode/scx_qry_cy 兩處都找不到 qry_custkp_cstk 的 VFP 原始碼。也就是說，這支查詢沒有可直接逐項還原的舊版欄位事件與算法。日後若要開發，須先向使用單位確認查詢需求（要查的條件、要列的欄位、彙總方式），無法單純照舊版搬移。

欄位說明¶

待開發後補齊

本功能尚無條件欄位或結果欄位可說明。待程式開發完成、由真實程式碼確認欄位後，再以下列格式補齊：

欄位	必填	格式	說明
（待補）	—	—	（待補）

欄位連動與附加功能¶

尚未實作，無欄位連動可描述

本功能在新版 C# 中尚無 ViewModel、Source 或 BLL，因此沒有任何欄位連動、按鈕動作、重算邏輯、列印或匯出行為可供說明。也查無對應的 VFP 舊版 .prg，無法從舊版欄位事件（valid／when／gotfocus 等）推得連動規則。

為避免誤導，本節在功能實作前刻意留白。待程式開發完成後，會依真實程式碼（VM 的 SetNewData／預設值、Calculate*／重算、GetReports／列印來源、Excel 匯出、開窗等）補上「當你⋯⋯，系統會⋯⋯」的完整說明。

常見問題¶

在主管資訊選單裡找不到「客戶代料查詢」，是不是壞了？

不是故障。此功能目前尚未在新版 TsERP 實作，因此即使選單對照表登錄了 M-130，實際系統中也不會有可開啟的查詢視窗。請改用其他已上線的主管資訊查詢報表，或向系統管理者確認此功能的開發排程。

可以從哪裡先查到客戶代料相關的資料？

在本功能上線前，建議改用與客供料相關的既有單據與報表查詢，例如庫存模組的代料庫存、採購模組的代料進貨等。各模組的實際查詢入口請見對應模組首頁。

這支查詢會有條件面板和 Excel 匯出嗎？

依本系統主管資訊查詢報表的一致形態，規劃上會是「條件面板 → 查詢 → 格線結果（可右鍵匯出 Excel）」。但這是規劃方向，並非目前可用功能；確切的條件欄位與結果欄位會在實作完成後，依真實程式碼補寫到本頁。