程式資訊

程式 ID：DIORDER
所屬子系統：G.採購付款
狀態：stable

DI 訂單轉請購¶

功能簡介¶

「DI 訂單轉請購」是一支轉檔（轉單）工具，把DI 倉裡尚未轉過請購的銷售訂單整批轉成請購單（Ppurch）（寫入 Ppurma／Ppurde）。適合採購／生管人員針對 DI 倉的客戶訂單一次勾選、一次轉檔，省去逐筆手key請購。

查詢來源限定在符合下列三個條件的訂單：

倉庫＝DI
訂單類別＝O（一般訂單）
REQUESTNO（請購單號）為空——也就是還沒被轉過請購的訂單。

畫面分兩個頁籤：

DI Order Interface（DI 訂單轉檔）：依客戶查出待轉訂單，勾選後轉成請購單。
Export Tools（匯出工具）：針對 Costco USA／Costco Canada 兩個通路，依訂購日期匯出特定格式的 Excel 出貨清單。

本支多項功能尚在規劃中

本頁對應的程式碼中，實際寫入請購單的轉檔邏輯與Costco Excel 匯出邏輯目前都被註解保留、尚未啟用：

轉檔的明細組裝（SetUpdateSource）目前不會產生任何請購主檔／明細列，因此按儲存（轉檔）暫時不會真的寫出請購單。
Export Tools 頁的兩個 Export 按鈕目前不會真的產生 Excel 檔。

查詢、勾選、客戶帶名稱等操作可正常使用；但「轉出請購單」「Costco 匯出」屬規劃中、尚未提供。下文凡涉及這兩段，皆以 !!! note 標明。

前置需求¶

權限：G.採購 → DI 訂單轉請購 的瀏覽（查詢）權限；要轉檔另需新增（轉檔）權限。
基礎資料：查得到、轉得出的前提取決於下列資料——

資料	影響什麼
客戶主檔	查詢條件的客戶代號；查得到才會帶出客戶簡稱
DI 倉的銷售訂單（訂單類別 O、未轉請購）	主檔清單能不能查出資料；轉檔的來源
訂單明細（品號、數量、單位、交期、客戶品號）	下方明細格線內容、轉出請購單明細的依據
請購部門參數（`_prgpar` 6009）	轉檔時帶入請購單的請購部門（規劃中的轉檔邏輯會用到）
Costco 成本暫存檔 `C:\TEMPS\TMP\LGS_COST.CSV`	勾選 `Verify Excel Sheet` 時的對帳依據（規劃中）

操作步驟¶

一、查詢待轉訂單（DI Order Interface 頁）¶

在 Cust No（客戶代號） 欄輸入或查詢客戶代號；輸入後右側唯讀欄會帶出客戶名稱。
按 Query（查詢）。系統以「倉庫＝DI、訂單類別＝O、尚未轉請購、客戶代號＝你輸入的客戶」為條件，列出該客戶的待轉訂單。
- 查無資料時會跳「無資料」提示。
- 查到資料後，主檔清單第一列會自動被選取，下方明細格線同步顯示該訂單的品號明細。
點主檔任一列，下方 明細格線 即切換顯示該訂單的逐項明細（品號、數量、單價、交期等）。

二、勾選要轉檔的訂單¶

在主檔每列最左的 Selected（勾選） 欄逐筆打勾，挑出要轉的訂單。
想全選或全不選時，用左下角的按鈕：
- All：把目前清單全部勾選。
- None：把目前清單全部取消勾選。
視需要勾選右下角的 Verify Excel Sheet（核對 Excel 成本檔）：勾選後，轉檔時會比對 Costco 成本暫存檔（LGS_COST.CSV），只轉在成本檔中找得到對應客戶訂單號的資料。

三、轉出請購單¶

按頁面右下角轉檔列的 儲存，系統會把勾選的訂單轉成請購單（Ppurma／Ppurde）。
轉檔成功會跳「儲存成功」訊息並依系統設定關閉視窗；按 取消 放棄本次轉檔、離開 關閉本表單。

轉檔邏輯規劃中、尚未提供

目前程式內組裝請購主檔／明細的那段（把勾選訂單轉成 Ppurma／Ppurde 列）尚未啟用，因此按 儲存 不會真的寫出請購單。實際可用的轉檔請改用訂單轉請購（OrmastToPP）或直接於請購單（Ppurch）建立。

四、Costco 匯出（Export Tools 頁）¶

切到 Export Tools 頁（須先完成過一次查詢，此頁才會啟用）。
在 Costco USA 或 Costco Canada 區塊輸入 Order Date（訂購日期）（預設帶當天）。
按該區塊的 Export，依該通路與日期匯出 Excel 出貨清單。

Costco 匯出規劃中、尚未提供

Costco USA／Canada 的 Excel 產生邏輯目前在程式內被保留註解、尚未啟用，按 Export 不會真的產生檔案。此功能屬規劃中。

欄位說明¶

查詢條件¶

欄位	必填	說明／格式／預設
Cust No（客戶代號）	—	以客戶代號過濾待轉訂單；預設空字串（不限客戶，視 SP 行為）。輸入後右側唯讀欄帶出客戶名稱
Verify Excel Sheet（核對 Excel 成本檔）	—	勾選時轉檔會比對 `C:\TEMPS\TMP\LGS_COST.CSV`，只轉成本檔中找得到客戶訂單號的列；預設不勾

主檔清單（待轉訂單）¶

欄位	說明
Selected（勾選）	是否要轉此筆；預設未勾，可單筆勾或用 `All`／`None` 批次切換
Old Order No（舊系統訂單號）	舊系統的訂單編號（OldSystemOrder）
Order No（訂單編號）	銷售訂單編號（SalesOrderNo），與下方明細以此關聯
Cono（公司代號）	公司代號
Document Date（訂單日期）	訂單日期
Cust No／Cust Name（客戶代號／名稱）	客戶代號與簡稱
Cust PO（客戶訂單號）	客戶端的採購單號（CustomerOrderNo），核對成本檔時用此比對
Whse（倉別）	倉庫代號（此處固定為 DI 倉來源）
Currency／FxRate（幣別／匯率）	訂單幣別與外幣匯率
Shinstruc1～5（出貨指示）	出貨指示五段文字
Ship To Name／Address／City／Zip／State／Country	收貨人與地址資訊

明細格線（選定訂單的明細）¶

欄位	說明
Line（序號）	訂單明細行號
Cust Part No（客戶品號）	客戶端料號（CustomerSKU）
Part No（品號）／Item Name（品名）	我方品號與品名
Quantity（數量）／U.O.M（單位）	訂購數量與單位
Price（單價）／Amount（金額）	單價與原幣未稅金額（CurrencyAmountWithoutTax）
Sdelimdy（預訂交期 ETD）	預訂交貨日期

Export Tools（匯出工具）¶

欄位	必填	說明／預設
Costco USA — Order Date	—	匯出 USA 通路的訂購日期；預設當天
Costco Canada — Order Date	—	匯出 Canada 通路的訂購日期；預設當天

欄位連動與附加功能¶

這一節把「輸入某欄位／按某按鈕後系統會做什麼」逐條列出，全部以實際程式碼為準。

輸入 Cust No 後：右側唯讀欄會即時帶出該客戶的名稱（由客戶查詢控件提供的描述綁定），方便確認選對客戶。
按 Query（查詢）時：系統組出查詢條件 倉庫='DI' AND 訂單類別='O' AND REQUESTNO 長度為 0 AND 客戶代號=你輸入的客戶，呼叫轉單查詢 SP（PRIME_TUR_DIORDER）。
- 查到資料 → 主檔清單填入待轉訂單、第一列自動選取、下方明細同步顯示。
- 查無資料 → 跳「無資料」提示，清單維持空白。
選取主檔某列時：系統用該列的訂單編號（SalesOrderNo）去明細查表（lookup），把對應的明細列顯示在下方格線；若沒選任何列，明細格線清空。
按 All／None 時：一次把目前清單所有列的 Selected 勾選／取消，不影響已查出的資料。
勾選 Verify Excel Sheet 後按 儲存 時：轉檔會先讀取成本暫存檔 C:\TEMPS\TMP\LGS_COST.CSV，以「客戶訂單號＋客戶品號」為鍵建索引；只轉在成本檔中找得到對應客戶訂單號的訂單（其餘略過）。未勾選則所有已勾選的訂單都會納入轉檔。
按 儲存（轉檔）時：走轉單儲存流程——先讀勾選的訂單、（規劃中）組裝成請購主檔 Ppurma 與明細 Ppurde、套用新增旗標後上傳。轉檔目標程式為請購單（PPURCH）。
- 轉檔成功會記下回傳的請購單 Pkid，並依系統參數（_prgpar 24）決定是否自動關窗。
- 目前不會真的寫出請購單
  組裝 Ppurma／Ppurde 列的那段邏輯（含帶請購部門 _prgpar 6009、客戶代號、訂單號、品號數量交期、以及核對成本檔回填單價／廠商等）在程式內目前是保留註解、尚未啟用。因此按 儲存 雖會跑完流程，但實際上傳的請購資料為空。此段屬規劃中。
按 Costco 區塊的 Export 時：以該通路代碼（USA＝1、Canada＝2）與輸入的訂購日期呼叫匯出 SP（PRIME_GETDIORDER_COSTCO）取回資料，原規劃會排成固定欄位（Item number／Qty／Prime PO／Costco PO／Shipping Windows／Ship to address）的 Excel 並開啟。
- 匯出邏輯規劃中
  產生並開啟 Excel 的那段在程式內目前是保留註解、尚未啟用，按 Export 不會真的輸出檔案。
Export Tools 頁的啟用條件：此頁綁定查詢流程的退出狀態，需先在第一頁完成過一次查詢後才會啟用。

常見問題¶

按 Query 查不到任何待轉訂單？

本表單只查DI 倉、訂單類別＝O、且尚未轉過請購（REQUESTNO 為空）的訂單。請確認：該客戶在 DI 倉確實有此類訂單；若訂單先前已轉過請購（已有請購單號），就不會再出現在清單中。也請確認 Cust No 輸入正確。

按 儲存 後沒有產生請購單？

這是目前已知的功能缺口：實際組裝並上傳請購單（Ppurma／Ppurde）的那段邏輯尚未啟用（規劃中）。在補上之前，請改用訂單轉請購（OrmastToPP），或直接在請購單（Ppurch）建立。詳見欄位連動與附加功能。

勾了 Verify Excel Sheet 後，原本會轉的訂單卻被略過？

勾選此項時，轉檔會比對成本暫存檔 C:\TEMPS\TMP\LGS_COST.CSV，只轉成本檔中找得到對應客戶訂單號的訂單。若該訂單的客戶訂單號不在成本檔裡，就會被略過。請確認成本檔已放到該路徑、且內含對應的客戶訂單號；若不需對帳就取消勾選。

Export Tools 頁是灰的點不動？

此頁需先在第一頁（DI Order Interface）完成過一次查詢後才會啟用。請先輸入客戶並按 Query。

按 Costco 的 Export 沒有產生 Excel？

Costco USA／Canada 的 Excel 匯出邏輯目前尚未啟用（規劃中），按 Export 不會輸出檔案。詳見欄位連動與附加功能。