程式資訊

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

銷售單價異動記錄¶

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

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

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

功能簡介¶

「銷售單價異動記錄」（規劃中） 預期屬於主管資訊（M-EIS）的查詢／報表類程式（代號 QRY_SALPX_CSTK，歸屬 M-120），用來追蹤銷售單價（售價）的歷次變動，供業務、業務主管在議價、調價或稽核售價合理性時參考。

名稱中的 _CSTK 字尾與系統內其他同系列查詢報表（客戶代料查詢、領料資料查詢、加工資料查詢等）一致，研判其定位為以查詢／報表方式呈現資料，而非單據維護表單；因此本頁不描述新增／修改／刪除等異動動作。

與「最近進價與售價」是不同的程式

勿與已實作的最近進價與售價（程式代號 PX_QRY，M-040）混淆。兩者代號不同、定位也不同：

PX_QRY（最近進價與售價）：已實作。把期間內的銷貨與進貨交易，依品號彙整出 最近一筆／最低／最高三組代表性單價，重點在「目前成交區間」的快照。
QRY_SALPX_CSTK（銷售單價異動記錄）：尚未實作，本頁所述。依命名研判偏向呈現 售價隨時間的異動歷程（誰、何時、把單價從多少改成多少）。

若您目前要查近期成交單價，請先使用最近進價與售價。

目前狀態¶

項目	狀態
程式代號登錄（programmap）	已保留 `QRY_SALPX_CSTK｜銷售單價異動記錄｜M-120`
查詢畫面（XAML）	尚未提供
ViewModel／商業邏輯（VM／BLL）	尚未提供
資料來源（Source／View）	尚未提供
VFP 舊版原始碼（`.prg`）	查無對應檔案
主選單入口	視部署的選單權限而定，功能本身尚未可用

如何確認是否已開放

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

規劃用途（暫定，待開發確認）¶

依代號命名與所屬系列推測，本功能未來預期可能涵蓋：

以條件面板查詢一段期間內銷售單價的異動記錄（例如客戶、品號、異動日期區間等條件）。
將結果以清單／報表形式呈現，每筆顯示異動前後的單價、異動日期、來源單據／操作者等，供業務主管檢視售價變動軌跡。
可能支援列印與匯出 Excel（與同系列查詢報表一致的慣例）。

以上為推測

上述用途為依命名規則與同系列功能推測的暫定範圍，並非已實作的行為。實際的條件欄位、結果欄位、算法與輸出內容，必須等程式開發後由真實程式碼確認，屆時再改寫本頁。

前置需求¶

待開發後補齊

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

權限：M-120 銷售單價異動記錄 的瀏覽權限。
基礎資料：客戶與品號主檔、客戶報價（CUPDMA）、銷售訂單（ORMAST）等售價來源資料——實際相依以開發完成後的程式碼為準。

操作步驟¶

目前無操作步驟

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

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

欄位說明¶

待開發後補齊

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

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

欄位連動與附加功能¶

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

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

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

常見問題¶

在主選單看到「銷售單價異動記錄」，但點開沒有畫面或無法查詢？

這是正常的。QRY_SALPX_CSTK 目前只在程式對照表保留了代號與名稱，新版尚未實作對應的查詢畫面。在功能完成前無法使用。

我現在就想查某品號的近期售價，有沒有可用的功能？

有。請改用已實作的最近進價與售價（代號 PX_QRY，M-040），它能依品號列出期間內的最近一筆、最低與最高售價（與進價），並支援匯出 Excel。

這個功能什麼時候會開放？

開發時程未定。功能完成後，本頁狀態會由「規劃中」更新為可用，並補上真實的條件欄位、結果欄位、欄位連動與操作步驟說明。在那之前，本頁僅供了解規劃用途之用。