跳轉到

程式資訊

  • 程式 ID：TRINOUT
  • 所屬子系統：H.庫存管理
  • 狀態：stable

出入庫申請

功能簡介

「出入庫申請」（Application No / Turn Out 申請單）用來先行登錄一筆要從某倉庫領出（或調撥）的庫存需求，例如出樣品、倉庫間調撥、送 QC 檢測、保固換貨、展場或行銷用料等。它本身是一張「申請」單據——記錄要動哪個倉庫、哪些品號、各要多少量，等後續由倉管在領料／異動轉出據以核發實際數量。

適用對象是業務、生管、倉管或行政人員。在流程中，它位於實際庫存異動之前：申請通過後才會產生真正的進出庫交易。

目前實作狀態（beta）

本表單的主檔基本欄位、明細品號／數量、金額重算、存檔檢核都已可用。但畫面右側一批「客戶聯絡資訊」欄位（連絡人、Email、傳真、收貨地址、City / State / Country、Attention / Instruction、訂單型態 Order Type、用途 Purpose、是否樣品 Free Sample、To Warehouse 等）在現行版本尚未接上後端欄位——輸入後不會被保存。詳見欄位連動與附加功能。本頁只描述真正會作用的部分。

前置需求

  • 權限：H.庫存 → H-070 出入庫申請 的瀏覽／修改權限（對應 frontmatter 的 [瀏覽, 修改]）。
  • 基礎資料：下列主檔會直接影響本單可選的值與帶出的內容——
資料 影響的結果
倉庫主檔 From Warehouse（隸屬倉庫） 的可選清單；明細 Destination Bin（轉入倉儲） 只會列出該倉庫底下的儲位
部門主檔 Department（申請部門） 搜尋與簡稱帶出；申請部門不得與隸屬倉庫相同
使用者主檔 Applicant（申請人員） 搜尋與姓名帶出（新增時預設帶登入者）
品號主檔（含品名） 明細 SKU（品號） 搜尋；輸入品號後自動帶出 SKU Description（品名）
廠商／客戶主檔 Customer（廠商代號） 搜尋
單據序號設定（LCLTritem，前置碼含 PC／SS） Prefix（序號前置碼） 下拉清單與單號開頭
幣別與匯率 主檔 幣別／匯率 影響明細金額換算（預設本位幣、匯率 1）

操作步驟

新增一張申請單

  1. 從主選單開啟 H.庫存 → 出入庫申請。
  2. 點工具列 新增。系統自動帶入下列預設值（見欄位連動與附加功能）：
    • Apply Date（申請日期）＝今天
    • Applicant（申請人員）＝登入者代號與姓名
    • 幣別＝本位幣、匯率＝1
    • Prefix（序號前置碼）＝清單第一個前置碼
  3. 在主檔區填寫：
    • Prefix：選擇單號前置碼（PC／SS 系列）。
    • From Warehouse（隸屬倉庫）：要領出／調出的倉庫（必填）。
    • Applicant（申請人員）：申請人（必填，預設登入者）。
    • Customer（廠商代號）：相關客戶／廠商（選填）。
    • Department（申請部門）：申請部門（必填，且不得與隸屬倉庫相同）。
    • Reason（申請原因）／Turn Out Note（轉出備註）：文字說明。
  4. 在下方明細格線逐列輸入：
    1. SKU（品號）：輸入或搜尋品號，系統自動帶出 SKU Description（品名）。
    2. Quantity（申請量）：本列要申請的數量。
    3. 視需要填 Unit Price（單價）、Destination Bin（轉入倉儲）、Processing Code（工程代號）、Reason（備註）。
    4. 輸入後系統即時重算該列 Currency Amount Without Tax（原幣未稅） 與畫面下方合計（見下節）。

  5. 點 儲存。

    小技巧

    可用 Ctrl+S 快速儲存。存檔前系統會逐項檢核必填欄位（見常見問題）。

  6. 系統顯示儲存成功，單號（Application No）由前置碼自動編成。

新增出入庫申請

修改／刪除

  1. 用工具列的上一筆／下一筆或查詢功能找到要編輯的單據。

  2. 點 修改 進入編輯狀態。

    已轉出的單據不可修改

    若該單的 Turn Out Note（轉出備註） 已有內容（代表已被後續流程轉出處理），系統會擋下修改並提示「已轉檔至其他單據，不可修改」。此時請改從下游單據處理。

  3. 修改主檔或明細後再次 儲存。

    • 明細列若把 SKU（品號） 清空，存檔時該列會被自動標記為刪除。
  4. 整張單作廢請用工具列 刪除。

查詢已申請的領用紀錄（Application Query）

明細格線下方／側邊的 Application Query 面板會隨「目前選取的明細列」自動帶出該品號這筆申請後續被領用（轉交易）的歷史紀錄：

  1. 在明細格線點選某一列。
  2. 系統自動以該列的 pkid 查詢，列出交易單號、交易日期、申請日期、倉庫、SKU、數量、單價、金額、Destination／Source Bin 等。

這讓你不必離開本單，即可確認某列「申請了多少、已被領走多少」。

欄位說明

主檔欄位（已實作）

欄位 必填 說明／格式／預設
Application No（申請單號） 自動 系統依前置碼自動編號，唯讀
Apply Date（申請日期） ✔ yyyy/MM/dd；新增預設今天；未輸入不可存檔
Prefix（序號前置碼） ✔ 下拉，來源為 PC／SS 系列單據設定；新增預設第一個；未選不可存檔
Applicant（申請人員） ✔ 使用者搜尋；新增預設登入者；未輸入不可存檔
From Warehouse（隸屬倉庫） ✔ 倉庫搜尋；未輸入不可存檔；同時決定明細可選的轉入儲位
Department（申請部門） ✔ 部門搜尋；未輸入不可存檔；不得與隸屬倉庫相同
Customer（廠商代號） — 廠商／客戶搜尋
Reason（申請原因） — 文字，最長 60 字
Turn Out Note（轉出備註） — 文字，最長 40 字；一旦有值即視為已轉出，鎖定修改
幣別／匯率 — 新增預設本位幣、匯率 1；變更會連動重算明細金額

明細欄位（已實作）

欄位 必填 說明／格式／預設
Line No（序號） 自動 明細列序號
SKU（品號） ✔ 品號搜尋；輸入後自動帶出品名；空白列存檔時自動刪除
SKU Description（品名） 自動 由品號帶出，唯讀
Quantity（申請量） ✔ 數量；變更即時重算金額與合計
Unit Price（單價） — 單價；變更即時重算金額（僅有檢視單價權限者可見）
Currency Amount Without Tax（原幣未稅） 自動 ＝單價 × 申請量（四捨五入 2 位），唯讀
Destination Bin（轉入倉儲） — 儲位搜尋，只列出隸屬倉庫底下的儲位
Processing Code（工程代號） — 工程／製程代號搜尋
Moved Quantity（核發量） 唯讀 後續實際核發的數量
Reason（備註） — 明細備註，最長 120 字

下列明細欄位來自舊版佈局，現行沒有對應的後端欄位

格線中的 Free Sample、Pending、Restocked、Billed 欄位綁定到目前明細資料來源不存在的屬性，因此恆為空白、不參與金額計算，輸入後也不會被保存。請以實際核發流程（核發量）為準。

欄位連動與附加功能

這一節把「輸入某欄位 / 按某動作後，系統實際會做什麼」逐條列出，全部來自程式碼。

新增時的預設值（AfterAddNew）

當你按 新增，系統會對主檔自動帶入：

  • 公司代碼＝1
  • Apply Date（申請日期）＝今天（系統短日期格式）
  • Applicant（申請人員）＝登入者代號、姓名＝登入者姓名
  • 匯率＝1、幣別＝本位幣（Context.Env.LocalCurrency）
  • Prefix（序號前置碼）＝前置碼清單的第一筆

明細自動繼承主檔幣別／匯率

  • 新增一筆明細列時，系統把該列關聯到主檔，並把主檔的幣別、匯率帶進這列（作為金額換算基礎）。
  • 之後若你改主檔的幣別，所有明細列的幣別會同步更新；改主檔的匯率，所有明細列的匯率也同步更新。
  • 切換主檔記錄（上一筆／下一筆）時，明細列會重新指向目前主檔。

輸入品號自動帶品名

  • 在明細 SKU（品號） 欄輸入或選取品號後，系統即時查品號主檔，把 SKU Description（品名） 帶進該列。

數量／單價自動算金額（SetAmount）

當你改明細的 Quantity（申請量） 或 Unit Price（單價） 時，系統會：

  1. 原幣未稅＝單價 × 申請量（四捨五入到小數 2 位）。
  2. 本幣未稅＝原幣未稅 × 匯率（四捨五入到本幣小數位數）。
  3. 同步更新畫面合計：
    • 總數量（TotalQuantity）＝所有明細申請量加總
    • 總金額（TotalAmount）＝所有明細原幣未稅加總

隸屬倉庫連動明細儲位（Destination Bin）

  • 明細的 Destination Bin（轉入倉儲） 搜尋會以主檔的 From Warehouse（隸屬倉庫） 為條件過濾——只列出該倉庫底下的儲位。換言之，要先選好隸屬倉庫，明細的儲位選擇才正確。

空白明細自動刪除（存檔前）

  • 存檔時，系統會把品號為空白的明細列自動標記為刪除，不會把空列寫進資料庫。

存檔檢核（AllowSave）

按 儲存 時，依序檢查並在不通過時擋下、提示對應欄位：

  1. Apply Date（申請日期） 不可空白。
  2. Applicant（申請人員） 不可空白。
  3. From Warehouse（隸屬倉庫） 不可空白。
  4. Prefix（序號前置碼） 不可空白。
  5. Department（申請部門） 不可空白。
  6. 申請部門不得等於隸屬倉庫（兩者相同時提示「請輸入正確資料」並指出衝突欄位）。

修改檢核（AllowEdit）

  • 進入 修改 時，若該單的 Turn Out Note（轉出備註） 已有內容，視為已轉出至下游單據，系統擋下修改並提示「已轉檔至其他單據不可修改」。

Application Query 連動

  • 切換明細選取列時，下方 Application Query 面板自動以該列 pkid 重新查詢，顯示這筆申請後續的領用／交易紀錄（見操作步驟）。

庫存查詢（Stock Query）

  • 本表單實作了庫存查詢介面（IStockQuery），由系統框架據此提供庫存查詢能力，可在操作時作為決定申請量的參考。

尚未提供（規劃中，現行不會保存）

下列畫面元素目前沒有對應的後端欄位，輸入後不會被儲存，請暫時不要依賴它們：

  • Order Type（CUSTCATG）、Purpose（ApplyType）、Free Sample（IsFree）、To Warehouse（Warehouse）
  • 右側客戶聯絡區：Contact、Email、Fax、Ship To No、Address／Address 1、City、State、ZIPCode、Country、Attention、Instruction

另外，輸入 Customer（廠商代號）目前不會自動帶出客戶的地址、聯絡人、Email、傳真（這段帶值邏輯在程式中尚未啟用）。需要這些資料時請改在客戶主檔維護或人工填寫其他單據。

常見問題

按儲存時提示某欄位「請輸入」，存不了？

請檢查五個必填主檔欄位：Apply Date（申請日期）、Applicant（申請人員）、From Warehouse（隸屬倉庫）、Prefix（序號前置碼）、Department（申請部門） 是否都有值。完整檢核清單見存檔檢核。

提示「申請部門 = 隸屬倉庫」不給存？

系統不允許申請部門與隸屬倉庫填成同一個代號。請改填正確的申請部門（領用單位）與來源倉庫。

點修改卻被擋，說「已轉檔至其他單據」？

代表該單的 Turn Out Note（轉出備註） 已有內容，表示它已被後續領料／轉出流程處理過，為避免破壞下游資料而鎖定。請改從下游單據調整，或新開一張申請。

明細金額（原幣未稅）一直是 0？

金額＝單價 × 申請量。請確認該列有填 Quantity（申請量）；若需要金額，Unit Price（單價） 也要填。改完數量或單價系統會即時重算。若你看不到單價／金額欄，可能是你沒有檢視單價的權限。

輸入 SKU 沒帶出品名？

品名是即時查品號主檔帶出的。請確認輸入的是有效且存在於品號主檔的品號（用搜尋鈕挑選最保險）。

Destination Bin 選不到我要的儲位？

明細儲位清單會以主檔 From Warehouse（隸屬倉庫） 過濾。請先選好隸屬倉庫，再回到明細選儲位。

我填了連絡人／地址／Order Type／Free Sample，存檔後不見了？

這些欄位在目前版本尚未接上後端（見尚未提供），輸入不會被保存。請暫時改用其他方式記錄。

相關功能

需補截圖清單

以下截圖待功能 runtime 驗收後補拍（放 docs/H-Inventory/images/）：

  1. trinout-step1.png — 新增出入庫申請的主檔＋明細全貌（含必填欄位）
  2. trinout-step2.png — 明細格線輸入 SKU／數量後即時帶出品名與金額合計
  3. trinout-step3.png — 下方 Application Query 面板隨選取明細列顯示領用紀錄