呆滯庫存通知¶
系統定期盤點一次：撈出還有庫存、但長期沒有任何出入庫異動的品項，依呆滯天數由長到短排好，整理成一封信寄給倉管與採購。目的很直接——別再買已經躺在倉庫裡沒人動的料，並把該處理的呆料翻出來（降價出清、退料、報廢、轉用）。
這是一個背景排程任務
「呆滯庫存警示」由系統在背景依排程執行，設定屬於一次性作業（通常由導入人員或系統管理員完成）。門檻天數、收件人、啟用與否設定在警示規則維護，執行時間掛在排程事件上。
出廠預設是停用的
本警示屬第二批警示源，出廠時 是否啟用 = N。要開始收信，需先到警示規則維護把 STAGNANT_STOCK 這列改成 Y、填好收件人與門檻，並掛好排程事件——兩者缺一不可。
需補截圖清單
以下截圖尚未拍攝，請補上並放置於 docs/H-Inventory/images/：
stagnant-stock-mail.png— 收到的通知信全貌：主旨、摘要列（呆滯門檻／品項數／合計金額）與品項清單（紅框標示「呆滯天數」欄與「無異動紀錄」的列）stagnant-stock-rule.png— 警示規則維護中STAGNANT_STOCK那一列的編輯表單（門檻參數、收件人、是否啟用、抑制視窗小時）stagnant-stock-schedule.png— 排程事件（專案）的「新增事件範本」視窗，紅框標示呆滯庫存的執行參數
拍攝規格：1280×800 以上、PNG；請使用測試資料，避免真實品號與金額。
收到的信長什麼樣¶
主旨會直接寫出重點：「呆滯
信件開頭的摘要列出：檢查時間、呆滯門檻（幾天）、呆滯品項數（紅字）、合計金額（紅字）；命中筆數超過明細上限時，會另外註明「共 N 筆，明細僅列前 200 筆（依呆滯天數遞減）」。
本文是一張品項清單，每列一個呆滯品項：
| 欄位 | 說明 |
|---|---|
| 品號／品名 | 呆滯的料件 |
| 現有數量 | 目前庫存量（全倉合計） |
| 現有金額 | 該品號的庫存金額——這一欄決定要不要花力氣處理，數量再多、金額不大的可以先放著 |
| 最後異動日 | 最後一次出入庫異動的日期；從來沒有異動紀錄的品項此欄空白 |
| 呆滯天數 | 最後異動日距今天數；從無異動紀錄者顯示「無異動紀錄」，並排在整張清單最前面 |
先看前十列就好
清單依「呆滯天數由長到短、同天數再依金額由大到小」排序，所以最上面幾列就是最該處理的：不是躺最久，就是壓最多錢。信件本文預設只列前 200 筆，真正要看的通常在前 20 筆之內。
三種呆滯，三種處理¶
| 狀況 | 判讀 | 該做什麼 |
|---|---|---|
| 呆滯天數顯示「無異動紀錄」 | 這料進倉之後從來沒動過，或早期資料沒有交易紀錄 | 先確認實物是否還在（可能是舊料、樣品或帳面殘留），再決定盤點調整或報廢 |
| 呆滯天數長、現有金額大 | 壓著現金的呆料 | 優先處理：找業務問能不能出、找工程問能不能轉用、談降價出清 |
| 呆滯天數剛過門檻、金額小 | 慢動料，未必是呆料 | 觀察即可；重點是採購別再補這一項 |
哪些品項會被列進來¶
| 條件 | 說明 |
|---|---|
| 現有量 > 0 | 全倉庫存合計大於 0；已經沒有庫存的品號不會出現 |
| 品號未停用 | 品號主檔標記停用的料自動排除 |
| 長期無異動 | 最後一次出入庫異動距今 ≥ 呆滯天數（預設 180 天）；從未有異動紀錄者一律列入 |
「異動」指的是哪些交易
最後異動日採用與庫存查詢相同的口徑，涵蓋進貨、出貨、加工、出入庫等各類交易單據——只要有任何一種進出，就不算呆滯。因此本警示不會把「上週才剛領過料」的品項誤判成呆料。
金額口徑是庫存金額，不是重估後的市價
現有金額取自庫存結存的金額欄位，反映的是帳面成本。要做處分決策（降價／報廢）時，仍需搭配庫齡呆料分析等報表確認實際可回收價值。
前置需求¶
| 項目 | 說明 |
|---|---|
| 警示規則已啟用 | 在警示規則維護把 STAGNANT_STOCK 設為 Y，並設定門檻參數與收件人 |
| 排程事件已建立並審核 | 見下方「怎麼掛排程」 |
| 庫存與交易資料正常 | 呆滯天數依交易單據的日期計算；長期不入單或日期填錯會讓判定失準 |
| 收件人有效 | 規則列的收件人（多筆以 ; 分隔）；留空時退回排程事件的「通知帳號」，兩者都空白不會寄信 |
門檻怎麼設¶
在警示規則維護的 門檻參數 欄填 JSON：
{"呆滯天數":180,"明細上限":200}
| 鍵 | 預設 | 說明 |
|---|---|---|
呆滯天數 |
180 | 幾天沒動就算呆滯。導入初期建議先設大（例如 365），確認清單長度可接受再逐步收緊 |
明細上限 |
200 | 信件本文最多列幾筆；超過上限只影響信上看得到幾筆，判定與統計仍是全部品項 |
清單太長就先拉高門檻，不要改成不看
第一次啟用常會收到幾百筆——這通常代表門檻對貴公司太寬鬆。先把 呆滯天數 拉到 365、明細上限 降到 100，讓每次信件維持在「看得完、每筆都會被處理」的長度，再慢慢往回收。
多久寄一次¶
同一批呆滯品項在抑制視窗（規則列的「抑制視窗小時」，預設 24 小時）內只會通知一次；品項集合有變（新增或移除任一品號）才會再寄。呆滯清單變動很慢，建議：
- 排程頻率：每週或每月一次即可（不必每天）。
- 抑制視窗：可設 168（一週）避免同一份清單重複出現。
怎麼掛排程¶
掛法與其他自動化任務相同，完整步驟見 排程事件（專案），此處只列本任務的設定值。
- 到 L 聯絡傳訊 → 排程事件（專案），
新增一筆專案主檔後儲存。 - 編輯狀態按
批次新增，於「新增事件範本」視窗設定：
| 範本欄位 | 本任務要設的值 |
|---|---|
| 預定時間 | 要跑的時間（例如每週一早上 08:30） |
| 日期類別 | 每周 或 每月 |
| 是否自動執行 | 必須勾選；不勾排程器不會跑 |
| 執行項目 | 下拉選「執行 Log_Sys_Exec」 |
| 參數 | 把 Procedure 設為 TWORK_AUTO_STAGNANT_STOCK、Dispatcher 設為 SKD（其餘保持預設） |
| 通知人員／通知方式 | 決定待辦建給誰；信件收件人另在警示規則設定 |
- 按確定展開事件 →
儲存→審核。
單據別不要改
選「執行 Log_Sys_Exec」後系統帶出的單據別即為正確值，改成其他值排程會找不到要執行的程序。詳見排程事件（專案）。
通知對象設定¶
| 設定位置 | 決定什麼 | 備註 |
|---|---|---|
| 警示規則維護的收件人 | 信件寄給誰（Email） | 多筆以 ; 分隔；主要來源 |
| 排程事件明細的通知帳號 | 規則收件人留空時的退路 | 兩者都空白＝不寄信 |
| 排程事件明細的通知人員 | 待辦事項建給誰（員工代號） | 只要填了就會開待辦（見通知方式與待辦事項） |
常見問題¶
啟用了卻沒收到信？
依序檢查：1）警示規則維護的 STAGNANT_STOCK 是否 是否啟用 = Y；2）收件人是否填了（規則與事件通知帳號都空白時不寄）；3）排程事件是否已 審核、是否到觸發時間；4）是否落在抑制視窗內（同一批品項預設 24 小時只發一次）；5）是否根本沒有命中——無呆滯品項時不寄信也不留紀錄。
某個品項明明放很久了，卻沒出現在信裡？
最常見兩個原因：1）它曾經有異動（例如上個月做過調撥、盤點調整），最後異動日被更新了；2）它的現有量是 0 或品號已停用。可到庫齡呆料分析確認該品號的最後交易日。
「無異動紀錄」是什麼意思？系統壞了嗎？
表示這個品號在交易資料中查不到任何一筆出入庫紀錄（常見於早期匯入的期初庫存），系統一律視為呆滯並排在最前面。請以實物盤點確認後處理。
信裡列了三百筆，看不完？
信件本文最多列 明細上限 筆（預設 200），但更根本的做法是把 呆滯天數 拉高——一次列三百筆代表門檻對貴公司太寬鬆。詳見上方「門檻怎麼設」。
這封信跟呆料查詢、庫齡呆料分析有什麼不同？
本信是主動推播：不必有人記得去查，門檻一到就寄信提醒。呆料查詢以「交易比率」判定、庫齡呆料分析可分桶與估價、流動狀況表可指定單一倉庫——要追細節仍用那三支查詢，本信只負責把該看的人叫過來。