程式資訊

程式 ID：SAMPLE
所屬子系統：E.營業收款
狀態：stable

送樣聯絡單¶

功能簡介¶

「送樣聯絡單」用來登記要寄給客戶的樣品需求：一張單頭記載客戶與業務員，明細逐列記下要打樣／送樣的品號、材質、規格、份數與指定納期，並追蹤每列的完成日期、已交數量與結案狀態。常見使用者為業務或業務助理——在訂單成立前，先把打樣與送樣事項整理成可追蹤的單據，後續再用批次功能集中回填各列的完成日期。

本表單是一張採用 ADE（新增／修改／刪除）框架的主從式交易單據，單頭一筆、明細多列。它另外掛了一支 其他功能1，開啟送樣完成日期批次修改視窗，讓你跨多張送樣聯絡單一次回填完成日期。

前置需求¶

權限：E.銷售 → E-030 送樣聯絡單 的瀏覽與修改權限。
基礎資料：下列主檔會影響欄位自動帶值與檢核——

資料	影響什麼
客戶基本資料（CUDATA）	輸入客戶代號時自動帶出客戶簡稱、業務員編號與業務員姓名；客戶被停用會被擋下
業務員（員工）資料	業務員編號對應的姓名、申請人對應的員工姓名
品號主檔（庫存品）	明細輸入 SKU（品號）時自動帶出品名、材質、加工、型別、規格、中文描述
單位（UOM）代碼	明細單位欄的下拉選單來源
登入使用者	新增時自動帶入申請人＝目前登入者

操作步驟¶

新增一張送樣聯絡單¶

從主選單開啟 E.銷售 → 送樣聯絡單。
點工具列 新增。系統會自動帶入：
- 開立日期＝今天。
- 申請人＝目前登入者（同時帶出申請人姓名）。
在單頭輸入 客戶代號（可用放大鏡查詢）。離開欄位後系統自動帶出客戶簡稱、業務員編號與業務員姓名（詳見欄位連動與附加功能）。
視需要調整業務員編號（預設由客戶帶出，可改）。
在下方明細格線逐列輸入要送樣的品項：
1. 在 SKU 欄輸入或查詢品號，系統自動帶出品名、材質、加工、型別、規格、中文描述。
2. 填入數量、單位（下拉選 UOM）、份數、指定納期、承認書、圖號、備註等。
3. 視需要勾選 IsSample（是否打樣）。
點工具列 儲存。

小技巧

可用 Ctrl+S 快速儲存。
系統檢查通過後寫入並顯示送樣編號（送樣編號由系統自動產生、唯讀）。

存檔必填三欄

儲存時系統會檢查單頭的 客戶代號（或客戶簡稱）、開立日期、申請人 三者皆不可空白，缺一即擋下並提示。

修改 / 刪除¶

用工具列的筆數移動（第一筆／上一筆／下一筆／最末筆）或查詢找到要處理的單據。
點 修改 進入編輯狀態，調整單頭或明細後 儲存。
要整列刪除明細：把該列的品號／材質／規格／型別清空且數量為 0，存檔時系統會自動移除空白列（見欄位連動與附加功能）。
要刪整張單：點工具列 刪除。

批次回填完成日期¶

在送樣聯絡單畫面點 其他功能1，開啟「Batch Edit（送樣完成日期批次修改）」視窗。
視窗開啟時自動執行查詢，列出尚未填完成日期的送樣明細。
逐列填入 Completion Date（完成日期），或用 全選／取消全選 搭配操作。
存檔後，系統把有填完成日期的列回寫到原送樣聯絡單；關閉視窗後送樣聯絡單會自動重新整理（重抓目前這張單）。

詳細的批次邏輯與「Locked Source」鎖定頁說明見欄位連動與附加功能。

欄位說明¶

單頭¶

欄位	必填	說明/格式/預設
送樣編號	—	系統自動產生、唯讀
開立日期	✔	`yyyy/MM/dd`；新增時預設今天
申請人	✔	新增時預設目前登入者；右側顯示申請人姓名（唯讀）
客戶代號	✔	可放大鏡查詢；帶出客戶簡稱／業務員。客戶代號或客戶簡稱至少一個不可空白
客戶簡稱	—	由客戶代號自動帶出
業務員編號	—	由客戶帶出，可手動修改；右側顯示業務員姓名（唯讀）

明細¶

欄位	必填	說明/格式/預設
序號（Line No）	—	明細列序號
SKU（品號）	—	輸入後自動帶出以下品號相關欄位
品名（SKUDescription）	—	由品號帶出，唯讀
材質 / 型別 / 規格 / 加工 / 中文描述	—	由品號主檔自動帶出，可再修改
數量（Quantity）	—	數值；預設顯示 0
單位（UOM）	—	下拉選單，來源為 UOM 代碼
承認書（Acknowledgment）	—	文字
份數（Portion）	—	整數；預設顯示 0
指定納期（ETA）	—	日期
圖號（Image No）	—	文字
IsSample（是否打樣）	—	勾選框（Y/N）
備註（Notes）	—	文字
完成日期（Completion Date）	—	日期；可在本表單或批次修改視窗填寫
已交數量（Shipped Quantity）	—	數值，反映出貨狀況
Is Closed（是否結案）	—	勾選框（Y/N）

欄位連動與附加功能¶

這一節把「輸入某欄位後會發生什麼」「按某按鈕會做什麼」依真實程式行為列出。

新增時的預設值¶

按 新增 後，系統自動把單頭的 開立日期 設為今天、申請人 設為目前登入使用者，並一併帶出申請人姓名。
用筆數移動切換到某筆既有單據時，系統會依申請人重新查出並顯示對應的員工姓名。

單頭：輸入客戶代號的連動¶

當你在 客戶代號 輸入或查到一個客戶並離開欄位（LostFocus）時，系統會：

先檢查該客戶是否停用——若停用，跳出「已停用」提示並把客戶代號清空（不讓你選停用客戶）。
帶出 客戶簡稱。
帶出該客戶設定的 業務員編號，再依業務員編號帶出 業務員姓名。

因此正常情況下，你只要輸入客戶代號，簡稱與業務員（含姓名）會自動填好。

手動改業務員編號不會自動換姓名

業務員編號右側的姓名是在選定客戶時一併帶出的；若直接手動修改業務員編號，程式不會重新帶出對應姓名（此欄沒有掛獨立的帶值邏輯）。需要換業務員時，建議仍以客戶帶出的值為準。

明細：輸入 SKU 的連動¶

當你在明細 SKU（品號） 欄輸入或查到品號並離開欄位時，系統會：

套用品號相關設定（SKU 描述等）。
從品號主檔帶出該品號的材質、加工、型別、規格、中文描述 填入該列。

這些欄位帶出後仍可手動修改，不會鎖死。

空白明細列自動刪除¶

存檔時，若某明細列同時符合「數量為 0、且品號／材質／規格／型別皆空白」，系統會把它視為空列自動移除，不會寫進資料庫。利用這點即可「清空一列來刪除明細」。

存檔檢核¶

按 儲存 時，除了 ADE 框架的基本檢查外，本表單還會檢查單頭三欄：

客戶代號與客戶簡稱不可同時空白（兩者其一即可）。
開立日期 不可空白。
申請人 不可空白。

任何一項不符都會擋下存檔並提示對應欄位。

其他功能1：送樣完成日期批次修改（Batch Edit）¶

按 其他功能1 會開啟一個獨立視窗（標題 Batch Edit），用來跨多張送樣聯絡單集中回填完成日期：

自動查詢：視窗開啟時立即查詢，把符合條件的送樣明細列出在「Completion Date Edit」頁；表頭欄位（送樣編號／開立日期／客戶代號／客戶簡稱／序號／品號…）皆唯讀，只有 完成日期 可編輯。
全選 / 取消全選：對清單批次標記。
存檔回寫：存檔時，只有已填完成日期的列會被標記為「修改」並回寫到對應的送樣聯絡單明細；沒填完成日期的列不動。
Locked Source（鎖定）頁：另一個頁籤顯示目前被鎖定（其他人正在編輯／鎖定中）而無法批次修改的送樣明細，並在頁籤標題顯示鎖定筆數。這些列你看得到但改不了。
關閉後自動重整：關掉批次視窗回到送樣聯絡單時，系統會重新抓取目前這張單，讓你看到剛回填的完成日期。

批次修改只動完成日期

這支批次功能設計上只回寫完成日期這一欄；其餘明細欄位（品號、數量、是否結案等）在批次視窗中皆為唯讀，要改請回到送樣聯絡單本體編輯。

尚未在本表單提供的功能¶

無列印 / 無轉傳票 / 無簽核按鈕

目前送樣聯絡單的程式並未掛上列印報表、轉傳票或簽核流程按鈕（ViewModel 未實作對應介面）。單頭資料表雖保留工作流程／審核人員／審核日期／已審核等欄位，但本表單畫面沒有把簽核動作接出來。若日後需要這些功能，屬規劃中項目。

常見問題¶

存檔時提示客戶代號／開立日期／申請人不可空白？

這三欄是存檔必填。客戶代號與客戶簡稱至少要有一個，開立日期與申請人 都不可空白。新增時開立日期與申請人原本會自動帶值，若被清掉要補回。

輸入客戶代號後簡稱、業務員沒有自動帶出？

自動帶值發生在離開客戶代號欄位（LostFocus）之後。請確認客戶代號正確、客戶未停用，且該客戶在客戶主檔有設定業務員。若客戶已停用，系統會提示並清空你剛輸入的代號。

輸入品號後材質、規格等欄位還是空白？

這些欄位由品號主檔帶出，發生在離開 SKU 欄位之後。若帶不出來，請確認該品號存在於品號主檔，且主檔本身有填材質／加工／型別／規格／中文描述。帶出後你仍可手動補填。

想刪掉某一列明細怎麼做？

把該列的品號、材質、規格、型別清空，並把數量設為 0，存檔時系統會自動移除這列。整張單要刪則用工具列的 刪除。

批次修改視窗裡有些列灰掉改不了？

那些列被列在 Locked Source（鎖定） 頁，代表正被鎖定（例如他人編輯中）而無法批次更新。等鎖定釋放後重新查詢即可。

找不到列印或轉傳票按鈕？

送樣聯絡單目前未提供列印報表、轉傳票與簽核按鈕，屬規劃中。詳見尚未在本表單提供的功能。