程式資訊

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

主件達交率查詢¶

功能簡介¶

「主件達交率查詢」用來衡量銷售訂單的達交（出貨）狀況：把當年度（YTD）每一張客戶訂單的訂單數量／金額與實際出貨數量／金額逐月拉開，算出每個月與全年的達交率（出貨 ÷ 訂單 × 100%）。適合業務／生管主管檢視「接的單到底出了多少貨」，可依客戶或品號兩種口徑彙總。

報表分三個頁籤，由粗到細：

Sales Order Fill Rate Summary(YTD)：以客戶（或客戶＋品號）為單位，列出 Jan～Dec 十二個月與全年合計的訂單量、出貨量及達交率。
Each Cust PO Line Fill Rate：把每一張訂單（PO）彙總成一列，顯示該張訂單的訂單量、出貨量與達交率。
Cust PO List：最細的訂單明細清單，逐筆列出 SKU、群組、訂單量、出貨量與要求交期。

資料口徑

達交率以當年度 1/1 起算到查詢截止日為止；查詢條件只需給一個截止日，起始日由系統自動帶當年 1/1。

前置需求¶

權限：M.主管資訊 → 主件達交率查詢 的瀏覽權限。
基礎資料：查詢結果的完整度取決於下列資料的維護狀況——

資料	影響的結果
銷售訂單（含明細、要求交期）	三個頁籤的訂單數量／金額、訂單明細、要求交期
出貨資料（出貨單）	出貨數量／金額，連帶決定達交率
客戶主檔（客戶分類）	客戶分類欄、Summary 頁的 `Consumer`／`Industrial` 篩選
品號主檔（品名）	品號口徑下的 SKU／SKUDescription 欄

操作步驟¶

步驟① 設定查詢條件¶

輸入 Date（截止日期）：預設帶今天。系統會以「當年 1/1 ～此截止日」為查詢區間，比對訂單與出貨。
勾選 Include Direct Import（含直接進口）：勾選時把直接進口的單一併計入；不勾選則排除（對應 SP 的第一個參數 1／2）。
Catalog Item Only（僅型錄品號）：畫面上保留此勾選框，但目前不影響查詢結果（程式尚未接上篩選邏輯），勾或不勾統計範圍相同。
選擇 Calculate Mode（計算方式）：
- Count By Customer（依客戶）：以客戶為單位彙總，Summary 頁不顯示 SKU 欄。
- Count By Part No（依品號）：以客戶＋品號為單位彙總，Summary 頁顯示 SKU 欄。

步驟② 執行查詢¶

按工具列的 查詢，結果分別填入右側三個頁籤。各頁籤上方都有自己的篩選器，可在查詢後即時過濾，不必重查：

Summary 頁：用 Customer Classific 下拉（ALL／Consumer／Industrial）依客戶分類過濾。
Each Cust PO Line／Cust PO List 頁：用 Cust Filter 輸入客戶代號過濾（留 ALL 表示全部）。

小技巧

切換 Count By Customer / Count By Part No 後要再按一次 查詢 才會重算（SKU 欄的顯示與彙總顆粒度都在查詢時決定）。各頁籤的格線都支援匯出 Excel（格線右鍵）。

欄位說明¶

查詢條件¶

欄位	必填	說明
Date（截止日期）	✔	查詢截止日，預設今天；起始日自動帶當年 1/1
Include Direct Import	—	勾選＝含直接進口（SP 參數 `1`），不勾＝排除（`2`）
Catalog Item Only	—	畫面保留，但目前未接上篩選邏輯，勾選不影響結果
Calculate Mode	✔	`Count By Customer`（預設）／`Count By Part No`

Summary 頁（Sales Order Fill Rate Summary(YTD)）¶

每列代表一個客戶（依品號模式時為「客戶＋品號」），欄位每月一組：

欄位	說明
Customer Code／Name／Category	客戶代號／簡稱／分類
SKU／SKUDescription	品號／品名（僅 `Count By Part No` 模式顯示 SKU 欄）
〔月〕Order Qty／Order $	該月訂單數量／訂單金額
〔月〕Ship Qty／Ship $	該月出貨數量／出貨金額
〔月〕Qty %	該月數量達交率＝出貨數量 ÷ 訂單數量 × 100（訂單為 0 時顯示 0）
〔月〕$ %	該月金額達交率＝出貨金額 ÷ 訂單金額 × 100（訂單為 0 時顯示 0）
Tot Order Qty／Tot Order $	全年 12 個月訂單量／金額合計
Tot Ship Qty／Tot Ship $	全年 12 個月出貨量／金額合計
Tot Qty %／Tot $ %	全年數量／金額達交率（以合計重算）

Each Cust PO Line 頁¶

每列代表一張訂單（PO）的彙總：

欄位	說明
Customer Code／Name／Category	客戶代號／簡稱／分類
Order No／Customer Order No	系統訂單號／客戶訂單號
Order Quantity／Order Amount	該訂單的訂單數量／金額（明細加總）
Ship Quantity／Ship Amount	該訂單的出貨數量／金額
Qty %／Amount %	達交率＝出貨 ÷ 訂單 × 100（訂單為 0 時顯示 0）

Cust PO List 頁¶

最細的訂單明細清單：

欄位	說明
Customer Code／Name／Category	客戶代號／簡稱／分類
Old Order No／Customer Order No	舊系統訂單號／客戶訂單號
SKU／SKUDescription	品號／品名
Group No	群組號
Order Quantity／Order Amount	明細的訂單數量／金額
Ship Quantity／Ship Amount	明細的出貨數量／金額
Request Date	要求交期（ETD）

欄位連動與附加功能¶

把「輸入某欄位／按某鈕後系統會做什麼」整理如下，全部依實際程式碼行為描述：

截止日期決定整個查詢區間：你只輸入一個 Date，系統取它的「年份」組出當年 1/1 當起始日，截止日就是你輸入的日期。換句話說這是一份年初至截止日（YTD）的達交統計；改年份就等於換查詢年度。
Include Direct Import 切換 SP 參數：勾選時送給後端統計程序的第一個參數為 1（含直接進口），不勾選為 2（排除）。改完要重按 查詢 才生效。
Calculate Mode 決定彙總顆粒度與 SKU 欄顯示：
- 選 Count By Customer 查詢後，Summary 頁隱藏 SKU 欄，同一客戶的所有品號合併成一列。
- 選 Count By Part No 查詢後，Summary 頁顯示 SKU 欄，同一客戶會依品號拆成多列。
- 此切換只在按 查詢 當下生效，事後改下拉不會自動重畫。
每月達交率自動由出貨／訂單推算：Summary 與其他頁的 Qty %、$ %（Amount %）都是唯讀計算欄，公式為 出貨 ÷ 訂單 × 100，四捨五入到小數 2 位；訂單為 0 時直接顯示 0（避免除以 0）。你不能手動修改達交率欄。
Summary 頁的逐月歸戶完全依「出貨日期」：系統把每張訂單對應到其出貨日所在月份，並在該月同時累加訂單量與出貨量。換言之，Summary 頁的某月「Order Qty／Order $」其實是「出貨日落在該月的那些訂單」的訂單量，而非訂單交期落在該月。完全沒有出貨記錄的訂單，在 Summary 頁不會被計入任何月份（訂單量與出貨量皆不顯示）；此類訂單仍會出現在 Each Cust PO Line／Cust PO List 兩頁（出貨量為 0、達交率為 0）。
Summary 頁的 Customer Classific 下拉＝即時過濾：查詢後改 ALL／Consumer／Industrial，畫面立即依客戶分類（CustomerCategory）過濾，不會重新查資料庫。下拉選項固定為這三個值。
Each Cust PO Line／Cust PO List 的 Cust Filter＝即時過濾：在欄位輸入客戶代號（離開欄位即套用），畫面立即只留該客戶；輸入 ALL（不分大小寫）或留空則顯示全部。此過濾同樣不重查資料庫。
自動排除 CS／IN 開頭客戶：查詢完成後，三個頁籤都會把客戶代號以 CS 或 IN 開頭的資料剔除（內部統計用客戶，不列入達交率報表）。
訂單彙總（Each Cust PO Line）是由明細自動 group 而成：系統把 Cust PO List 的明細，依「客戶代號＋客戶簡稱＋客戶分類＋系統訂單號＋舊系統訂單號＋客戶訂單號」分組，加總訂單量／金額與出貨量／金額，得到每張 PO 一列。

列印／匯出報表尚未提供

程式內原本規劃了 Crystal 版的金額／數量達交率報表（FillRate），但相關 GetCrystalPrintSettings 程式碼目前整段註解、未啟用。如需把資料帶走，請改用各頁籤格線右鍵的匯出 Excel。

EachPO 嚴格達交模式（規劃中／未啟用）

程式保留了一個「逐張訂單達交（EachPO）」模式——只有當某月出貨量「達到或超過」訂單量時才把出貨計入。目前系統固定走一般模式（出貨一律累計），EachPO 嚴格模式尚未開放選擇。

常見問題¶

查不到任何資料？

請確認：(1) Date 的年份有訂單與出貨；查詢區間是「該年 1/1 ～截止日」，年份錯了就查不到。(2) 客戶代號不是 CS／IN 開頭——這類客戶會被系統自動排除。(3) Calculate Mode 切換後需重按 查詢 才會重算。（Catalog Item Only 目前無作用，與查得到與否無關。）

達交率（Qty % / $ %）顯示 0？

達交率＝出貨 ÷ 訂單 × 100。當訂單數量／金額為 0 時，系統會直接顯示 0（避免除以 0）；在 Each Cust PO Line／Cust PO List 兩頁，完全沒有出貨記錄的訂單出貨為 0、達交率自然為 0。請先確認該訂單已建立對應的出貨單。（Summary 頁的逐月歸戶完全依出貨日期，沒有出貨的訂單不會出現在月份欄。）

切到「Count By Part No」卻看不到 SKU 欄？

SKU 欄是否顯示、以及是否依品號拆列，都是在按 查詢 的當下決定的。改了 Calculate Mode 後要再按一次 查詢，畫面才會切到品號口徑並顯示 SKU 欄。

Summary 頁用 Customer Classific 過濾後是空的？

該下拉是依客戶分類（Customer Category）比對 Consumer／Industrial。若客戶主檔沒把分類維護成這兩個值，選 Consumer 或 Industrial 就會過濾掉全部；請改選 ALL 或回客戶主檔補分類。

想列印達交率報表，找不到列印鈕？

目前列印（Crystal 報表）功能尚未啟用，詳見欄位連動與附加功能中的說明。請改用格線右鍵匯出 Excel。