程式資訊

程式 ID：TWRAMA
所屬子系統：J.品質管理
狀態：stable

委外暫收驗收單¶

功能簡介¶

「委外暫收驗收單」（TWRAMA）用來登記委外加工料件回廠時的暫收與品檢結果。委外廠商把代工完成的料件送回時，品管人員開立一張暫收單，逐筆記錄回廠品號的數量、抽檢／不良（NG）／特採數量與檢驗結果；全部檢驗完畢後切換「檢驗完畢」，後續才據以辦理正式入庫。

本表單與進貨暫收驗收單（PURAMA）、成品暫收驗收單（WKRAMA）是同一系列的暫收檢驗作業，三者共用同一張資料表與檢驗欄位，差別在於單據來源與單號前置碼：

單據	來源	單號前置碼
進貨暫收（PURAMA）	採購單	`TP`
委外暫收（TWRAMA）	委外發料／派工單	`TT`
成品暫收（WKRAMA）	生產製令	（成品）

主要使用者為品管（IQC/委外驗收）人員。流程上承接生產管理的委外發料，往後接合格入庫與不良統計。

與進貨暫收共用程式

本表單在程式內部共用 PURAMA 的畫面與資料 view（Twork_jqc_vw_purama／purade），但屬於選單上獨立的功能（J-020），擁有自己的權限與單號前置碼 TT。操作邏輯與進貨暫收幾乎相同，主要差異在「委外轉入」帶入的來源不同。

前置需求¶

權限：J.品質管理 → J-020 委外暫收驗收單 的對應權限（瀏覽／新增／修改／刪除／列印）。
基礎資料：下列主檔／參數會影響本單能否正確帶值與存檔——

資料	影響什麼
委外廠商（廠商主檔）	VendorCode 搜尋帶出客廠部簡稱；委外轉入時用來篩選回廠料件
倉庫主檔	倉儲代號搜尋與右側倉庫名稱顯示；新增時的預設倉庫
委外發料／派工單（生產）	「委外轉入」查得到的回廠明細來源
料號主檔（SKU）	明細輸入 SKU 後自動帶出品名、單位等
系統參數 `U_Prgpar 6008`	新增主檔時帶入的預設倉庫
系統參數 `U_Prgpar 30171`	委外轉入視窗的預設倉庫
本位幣（環境設定）	主檔與明細幣別預設值

操作步驟¶

新增暫收單¶

按工具列 新增。系統自動帶入下列預設值（詳見欄位說明）：
- 幣別＝本位幣、倉儲代號＝參數 6008、公司代碼＝1、建檔日期＝今天、暫收日期＝今天。
於 VendorCode 欄輸入或搜尋（放大鏡）委外廠商代號，系統帶出右側客廠部簡稱。
確認 / 修改 倉儲代號（搜尋後右側顯示倉庫名稱）與 暫收日期。
以下兩種方式建立明細：
- 直接在明細格線逐列輸入 SKU、Quantity 等（適合零星補登）。
- 按 其他1 開啟轉入視窗，從委外回廠料件批次帶入明細（見欄位連動與附加功能）。
逐筆填寫檢驗資料：NGQuantity（不良量）、Accept On Division Quantity（特採量）、Sample Quantity（抽檢量）、UOM、Unit Price、InspectionResult。
全部檢驗完成後，把 檢驗完畢 設為 是。
按 儲存。存檔時系統會自動帶單號前置碼 TT、依數量結算各列是否結案（見欄位連動與附加功能）。

修改暫收單¶

用工具列移動鈕或查詢叫出既有單據。
修改主檔欄位或明細檢驗資料後按 儲存。
已關聯採購單的明細列（Purchase Order Line Pkid > 0）為唯讀，不可改動，只能調整檢驗相關欄位。

刪除¶

刪除整張單據：用工具列 刪除。
刪除單一明細列：將該列 SKU 清空即視為待刪除列，存檔時移除。

列印¶

按工具列 列印，開啟暫收驗收明細表（Puramatl）列印條件視窗。
系統預設帶入目前單據的廠商代號（起訖同一家）與暫收日期（起訖同一天）作為列印範圍。

列印功能規劃中

列印報表（Puramatl／PuramatlDate）目前在程式中尚未啟用，報表取數與輸出邏輯仍為保留狀態。實際可列印的報表版型待後續開放，目前按 列印 僅會帶出條件視窗。

欄位說明¶

主檔欄位¶

欄位	必填	說明／格式／預設
暫收單號	系統產生	唯讀，存檔時依前置碼 `TT` 自動編號
暫收日期	✔	預設今天（YYYYMMDD）；存檔時若為空會擋下並提示
VendorCode（委外廠商）	✔	委外廠商代號，搜尋後帶出右側客廠部簡稱；對應資料欄位為「生產部門」
客廠部簡稱	—	唯讀，由廠商代號帶出
倉儲代號	✔	預設參數 `6008`；搜尋後右側顯示倉庫名稱
檢驗完畢	—	`是`／`否` 下拉；全部檢驗完成後設為 `是`
CreatedDate（建檔日期）	—	預設今天；新增／複製存檔時自動更新為當下時間
暫收備註	—	自由文字，上限 80 字
幣別	—	預設本位幣

明細欄位¶

欄位	必填	說明／格式／預設
Line No（序號）	系統產生	唯讀流水號
SKU（品號）	✔	輸入後自動帶出品名等（見下節）；空白列視為待刪除
SKUDescription（品名）	—	唯讀，由 SKU 帶出
Quantity（數量）	✔	暫收數量；變動時重算金額
Inspection Date（檢驗日期）	—	唯讀
NGQuantity（不良量）	—	存檔時若為負數自動歸 0
Accept On Division Quantity（特採量）	—	特採（讓步接受）數量
Sample Quantity（抽檢量）	—	抽檢數量
UOM（單位）	—	下拉選單，來源為系統單位清單
Unit Price（單價）	—	變動時重算金額
Currency Amount Without Tax（金額）	系統計算	唯讀＝數量 × 單價（四捨五入 2 位）
Remark（備註）	—	明細備註
ETA（預訂交期）	—	唯讀
InspectionResult（檢驗結果）	—	下拉：`1.特採`／`2.允收`／`3.退貨`／`4.其他`
Warehouse In Quantity（入庫數量）	系統計算	唯讀，後續入庫作業回寫
Warehouse In Date（入庫日期）	系統計算	唯讀
Closed（是否結案）	系統計算	勾選方塊；存檔時依「數量 − 入庫數量 − NG數量 ≤ 0」自動判定，亦可在編輯狀態下手動勾選
Purchase Order Line Pkid／No	—	唯讀，來源採購／委外單的關聯鍵與單號；> 0 時該列鎖定

欄位連動與附加功能¶

這一節整理「輸入某欄位後系統會做什麼」與「按某按鈕會發生什麼」，全部依實際程式行為列出。

新增時的自動帶值¶

當你按 新增，系統會自動把主檔帶成：

幣別＝本位幣（環境設定的 LocalCurrency）。
倉儲代號 ＝系統參數 U_Prgpar 6008，並同步帶出右側倉庫名稱。
公司代碼 ＝ 1。
建檔日期 ＝現在時間。
暫收日期 ＝今天（YYYYMMDD）。

明細欄位輸入後的連動¶

輸入 SKU：系統會以該品號查料號主檔，自動帶出品名等資料（透過 DescriptionHelper.SetISKU）。SKU 空白的列在存檔時會被當作待刪除列移除。
輸入 Quantity 或 Unit Price：任一變動都會立即重算金額＝數量 × 單價（四捨五入至 2 位小數），金額欄為唯讀。
已關聯來源單的明細列：當該列的 Purchase Order Line Pkid > 0（由轉入產生），整列設為唯讀不可編輯，避免破壞與來源單的數量勾稽。

移動到其他單據時¶

切換瀏覽到另一張單據後，系統會依該單的倉儲代號重新帶出右側倉庫名稱顯示。

其他1：委外轉入暫收¶

按 其他1 會開啟轉入視窗，讓你從委外回廠料件批次帶入明細，不必逐列手打。轉入後系統會以選入的明細導回對應的暫收單。

其他1 目前開啟的是「進貨」轉入視窗

本表單的 其他1 在程式中目前實際開啟的是 進貨單轉入暫收（Purama_E） 視窗（來源為採購單），而非委外來源。專屬的「委外單轉入暫收（Twrama_E）」視窗（來源為委外發料／派工單）在程式碼中已實作，但尚未掛進本表單的工具列，因此目前畫面上按 其他1 帶入的是採購來源。若需要委外來源轉入，請留意此差異。

委外轉入視窗（Twrama_E，規劃掛入後）的行為如下，供參考：

預設值：暫收日期＝今天、ETA＝今天 +30 天、倉庫＝參數 U_Prgpar 30171。
查詢條件：輸入 VendorCode（委外廠商）後按 查詢，系統以委外發料／派工單為來源（SP TWORK_TUR_WPTOTP），篩選「該廠商、預訂完工日 ≤ ETA、尚有未暫收量、未結案、且已領料」的回廠明細。
轉入：可直接在 Temp Receiving Quantity 欄手動輸入要暫收的數量；或按該列 Select 鈕一鍵帶入「剩餘可暫收量」（＝數量 − 已收量），再按一次 Select 則歸 0（切換式）。Subtotal 會即時加總所有列的暫收量。
鎖定來源頁籤（Locked Source）：被其他使用者正在編輯而鎖住的來源明細會列在此頁籤，頁籤標題顯示筆數。
存檔驗證：至少要有一列暫收量 > 0；且任一列暫收量不可超過剩餘可暫收量，否則擋下。

存檔時系統做的事¶

按 儲存 時，系統（TwramaSave）會：

檢核暫收日期不可為空，否則跳出輸入提示並中止存檔。
主檔自動帶單號前置碼＝TT（這是委外暫收與進貨暫收 TP 的唯一區別）；新增／複製時更新建檔日期。
明細逐列自動結算：
- 是否結案：當「數量 − 入庫數量 − NG數量 ≤ 0」時，該列標記為結案（Closed 打勾）。
- 合格判定：當該列已有品質管制日與檢驗日期時，若 NG 量 > 0 且特採量 > 0 視為「未完全合格」（合格清空），否則標記合格＝Y。
- NG 量校正：NG 量若為負數自動歸 0。

列印¶

按 列印 會帶出暫收驗收明細表（Puramatl）的列印條件視窗，並預設以目前單據的廠商代號與暫收日期作為起訖範圍。

列印報表規劃中

報表的實際取數與版型輸出在程式中尚未啟用，詳見操作步驟－列印。

常見問題¶

明細的金額一直是 0？

金額是由數量 × 單價自動算出的唯讀欄位。請確認該列已填入 Quantity 與 Unit Price——只要其中一欄有變動就會重算。若兩者皆為 0，金額自然是 0。

輸入 SKU 後品名沒有帶出來？

品名是依品號查料號主檔自動帶出的。請確認該 SKU 確實存在於料號主檔；若品號輸入錯誤或主檔尚未建檔，就帶不出品名。

某幾列明細變成灰色、改不動？

凡是 Purchase Order Line Pkid 大於 0 的明細列（由轉入功能從來源單帶入）會被鎖成唯讀，以維持與來源單的數量勾稽，這是正常設計。要調整數量請回到來源單處理。

存檔時一直跳「請輸入暫收日期」？

存檔會檢核暫收日期不可為空。新增時系統本來會帶今天，若被清空就會擋存，補上日期即可。

按了『其他1』怎麼帶進來的是採購單的料，不是委外的？

這是目前程式的已知狀況：本表單的 其他1 暫時連到進貨轉入（Purama_E）。委外專屬的轉入視窗（Twrama_E）雖已開發，但尚未掛進本表單工具列。詳見欄位連動與附加功能的說明。

委外暫收和進貨暫收看起來一模一樣，差在哪？

兩者共用同一畫面與資料表，差別在單據來源與單號前置碼：委外暫收前置碼為 TT、來源為委外發料；進貨暫收前置碼為 TP、來源為採購單。權限也是各自獨立（J-020 vs J-010）。