FPSMS-backend/docs/user-guides/MTMS_送貨訂單與出貨_使用說明.md

MTMS 使用說明：送貨訂單 → 放單 → 成品出倉

本手冊依目前前端畫面與繁中文案整理，按鈕／選單名稱以畫面上「」內文字為準。
適用範圍：側欄「送貨訂單」、倉庫「成品出倉」（撳單／掃碼出倉／列印標籤）、加單與車線-X。
「一附」章節使用本機資料庫 fpsmsdb 的真實例子（查詢當下快照）。
產生日期：依原始碼現況（若畫面改版，請以實際 UI 為準）。

---

這份手冊怎麼用

符號	意思
「……」	畫面上看得到的按鈕、選單、標題
→	下一步操作

角色分工（白話）：

角色動作	主要畫面
看單、放單、加單、補貨	「送貨訂單」/do
撳單、掃碼提貨、列印 DN／標籤	「成品出倉」/doworkbench
調整提料順序等（ADMIN）	「成品出倉管理」

「放單」≠「撳單」：放單＝由送貨訂單產生提料票；撳單＝倉庫領取該票開始出倉。

建議閱讀順序：送貨訂單篩選 → 放單 → 撳單 → 掃碼出倉 → 填箱數列印。

---

一、整體流程

【送貨訂單 /do】篩選「2/F」「4/F」「車線-X」「加單」
    ↓ 「批量放單」或詳情「放單」
【產生提料單／提票】狀態進入待撳單
    ↓
【成品出倉 /doworkbench】「撳單/提料單詳情」
    ↓ 選日期／批量|單量／樓層票 → 點車線「確認分配」
【掃碼提料】「開始QR掃描」→「提交所有已掃描項目」
    ↓
【成品提貨記錄】輸入「箱數」→「列印送貨單標籤」等
    ↓
【查看提貨情況】核對「已完成」

---

一附、本地資料庫實例

DO「來貨狀態」：pending→「待處理」、receiving→「接收中」、completed→「已完成」。
提票在「查看提貨情況」：pending→「待撳單」、released→「提貨中」、completed→「已完成」。

例 A：待放單／待出貨的送貨訂單（2026-07-30）

本機「預計送貨日期」2026-07-30 仍有多張「待處理」，例如：

「門店訂單編號」	「來貨狀態」	店鋪
TOUR03PO26070304	待處理	UR03
TOCF28PO26070199	待處理	CF28
TOCF28PO26070200	待處理	CF28
TOCF02PO26070176	待處理	CF02
TOCF18PO26070194	待處理	CF18

怎麼練：

1. 「送貨訂單」→ 選樓層分頁 →「預計送貨日期」填 2026-07-30 → 搜索。
2. 找上表編號點「詳情」看行項與「庫存可用」。
3. 測試庫才建議真的「放單」／「批量放單」（會產生提料票）。

例 B：近一週 DO 狀態量級（本機 2026-07-28～08-05）

「來貨狀態」	約筆數	使用者常做
待處理	1,425	篩選後「批量放單」
已完成	1,059	查歷史／補貨原單
接收中	96	出倉進行中對應

例 C：提料票（撳單前「待撳單」風格樣本）

本機較早提票例（do_pick_order，狀態 pending≈待撳／待處理）：

「提票號碼」	車線資訊	店鋪	「需求日期」	放單類型
TI-S-20260504-4F-001	P06B_Sat_區1_港島東	MC49	2026-05-04	single（單量）
TI-S-20260504-2F-001	車線-F1	MC49	2026-05-04	single
TI-S-20260504-2F-001	車線-X	HP65	2026-05-04	single
TI-S-20260505-4F-002	P06B_Tue_區5_九龍中	HP15	2026-05-05	single

怎麼練：「成品出倉」→「撳單/提料單詳情」→ 日期選對應「是日／翌日…」；或「成品提貨記錄（全部）」用「提票號碼」搜索。注意「車線-X」會獨立分組。

自行查核用 SQL（選用）

SELECT d.code, d.status, DATE(d.estimatedArrivalDate) AS eta, s.code AS shop
FROM delivery_order d
LEFT JOIN shop s ON s.id = d.shopId
WHERE d.deleted = 0 AND DATE(d.estimatedArrivalDate) = '2026-07-30'
ORDER BY d.id DESC
LIMIT 20;

SELECT ticket_no, TruckLanceCode, ticket_status, ShopCode,
       DATE(RequiredDeliveryDate) AS req_date, release_type
FROM do_pick_order
WHERE deleted = 0 AND RequiredDeliveryDate >= '2026-05-01'
ORDER BY id DESC
LIMIT 20;

---

二、送貨訂單（/do）

2.1 入口與分頁

• 側欄 「送貨訂單」。

分頁	用途
「2/F」「4/F」	依樓層票別看／放單
「車線-X」	無匹配車線或歸入 X 的訂單
「加單」	isExtra 加單；批量放單可合併
「補貨」	已完成原單補到目標單

2.2 搜索欄

• 「門店訂單編號」「店鋪名稱」「車線號碼」「預計送貨日期」「來貨狀態」
• 狀態選項：「待處理」「接收中」「已完成」（及「全部」）
• 注意：「已填寫車線號碼時，請一併選擇預計送貨日期後再搜索。」／「需選擇預計送貨日期」

2.3 結果表常見欄

「詳情」「門店訂單編號」「店鋪名稱」「供應商名稱」「車線號碼」「訂單日期」「預計送貨日期」「來貨狀態」。

2.4 詳情頁（/do/edit?id=）

• 標題：「編輯送貨訂單詳情」
• 動作：「放單」「提料單分配」「分配2/F」「分配4/F」「放單2/F」「放單4/F」「返回」
• 行表：「商品編號」「貨品名稱」「數量」「庫存可用」「庫存狀態」
• 單張成功提示：「送貨訂單放單成功！提料單已建立。」

---

三、放單詳解

3.1 批量放單（常用）

1. 在「送貨訂單」搜出目標日／樓層的列，勾選需要的店（可取消勾選排除）。
2. 點 「批量放單」。
3. 對話框顯示「已選擇店舖數量: N」；「確認」執行。
4. 「加單」分頁額外選項：
   • 「確認合併放單」（合併同車線 → TI-M- 合併票；文案含「合併同車線送貨訂單（TI-M- 合併票）」）
   • 「確認不放合併放單」
5. 成功：「已完成批量放單」。

Workbench 路徑按鈕亦可能顯示為「批量放單」（鍵名 Workbench Batch Release）。

3.2 單張放單

詳情頁「放單」，或先「分配2/F／4/F」再「放單2/F／4/F」。

3.3 放單前／失敗常見提示

提示	處理
「沒有選擇送貨訂單進行批量放單…」	先勾選列
「車線可用性警告」「問題送貨訂單」	核對目標日是否有車線；或走「車線-X」
「放單提料單失敗，請稍後再試。」	稍後重試；查該店是否已放過

---

四、成品出倉（/doworkbench）— 主路徑

4.1 入口

• 「倉庫管理」→ 「成品出倉」（現行主選單指向 /doworkbench）。
• 舊頁 /finishedGood 標題同為「成品出倉」，一般以 Workbench 為準。

4.2 頁頂打印機

• 「A4 打印機」「標籤打印機」「列印全部草稿 (N)」
• 未選機：「請先選擇打印機」／「請先選擇標籤打印機」

4.3 分頁一覽

tab	標籤
0	「撳單/提料單詳情」
1	「加單」（徽章：當日未完成加單票數）
2	「成品提貨記錄」
3	「成品提貨記錄（全部）」
4	「查看提貨情況」
5	「成品出倉出箱數量」
6	「送貨路線摘要」

---

五、撳單（領票）

5.1 條件列

• 「請選擇日期」：「是日」「翌日」「後日」
• 「放單類型」：「批量」「單量」
• 「票別（樓層）」：「2/F 票」「4/F 票」

5.2 車線面板

1. 車線按鈕顯示「(未撳數/總單數)」、裝載序／出發時間等。
2. 點車線 →「確認分配」（含「位置」「車線號碼」「裝載順序」「出發時間」「所需日期」「可用訂單」）→「確認」。
3. 成功後進入提料明細掃碼。
4. 無單時：「該樓層未有需處理訂單」／「此樓層沒有可用的提料單」。
5. 「未完成提料單」可搜商店／車線／送貨單編號再「選擇」。
6. 限制：「請先完成目前的提料單，再提取下一張」。

5.3 「車線-X」

• DO 與出倉皆有獨立「車線-X」區塊；無匹配車線時顯示「車線-X」。
• 「以前」：今日前未完成的車線-X。
• 出箱儀表會統計「車線-X 出箱數」。

---

六、掃碼出倉（提料執行）

1. 在已撳單的明細中看「所有提料單批號」「進度」。
2. 「開始QR掃描」／「停止QR掃描」；「掃描結果」正確時「二維碼驗證成功。」
3. 可「改數」「提交數量」；問題回報含不良／遺失等。
4. 「提交所有已掃描項目」；可選「列印空白頁數標籤」。
5. 無掃碼可直接完成的列可用「已完成」(Just Completed)。
6. 全部完成後通常導向「成品提貨記錄」（帶提票號）。

掃碼常見錯誤

提示	處理
「二維碼不符合當前訂單中的任何貨品。」	確認掃的是本票貨品
「此批號不可用…」「此批次尚未上架」	換批或先完成上架
「此批號單位不符…」「此批號已提貨…」	換批
「掃描批號已過期…」	換未過期批
「此批次貨品已被其他送貨單留起…」	換批或協調留貨
換批雙掃說明	依畫面再掃一次確認

---

七、加單專章

7.1 在「送貨訂單」

• 開「加單」分頁搜索與「批量放單」。
• 合併選項見 §3.1（TI-M- 合併票）。

7.2 在「成品出倉」

1. Tab「加單」；進入前確認：「進入加單檢視？」
2. 說明：「加單檢視會依選定日期，將 isExtra 票依店鋪與車線顯示。」
3. 「目前是加單票，顯示與操作已切換為加單模式。」／「離開加單檢視」「返回一般指派分頁」。
4. 「合併加單提料單」：僅「未分配」且同店鋪、樓層（2/F、4/F 或車線-X）、車線、出發時間可合併。
5. 類型顯示可能為「合拼單」「加單」「批量」「單量」。

---

八、補貨（「送貨訂單」→「補貨」）

1. 「補貨填表」「對單」→「待提交列表」→「提交」／「清空」。
2. 「送貨單號末四位」「原送貨單」「目標送貨單」「補貨數量」「原出貨數」「車線」。
3. 無車線時畫面可能顯示「車線-X」。
4. 「補貨進度追蹤」：待處理／處理中／已完成。
5. 限制例：「只有已送貨（completed）的送貨單可作為原送貨單。」「補貨數量必須大於零」。

---

九、箱數與列印

9.1 草稿／空白

• 「列印全部草稿 (N)」→ 確認「確認列印全部草稿？（總數量：N份）」→「成功列印」。
• 提料中：「列印空白頁數標籤」→「請輸入要列印的標籤數量：」。

9.2 完成後正式列印（「成品提貨記錄」）

1. 「查看詳情」或列表動作。
2. 「列印提料單」「列印送貨單標籤」「列印提料單和送貨單標籤」「補印標籤」。
3. 彈窗「請輸入總箱數」，欄位「箱數」（≥1）。
4. 成功：「成功列印」。

9.3 補印

• 「補印送貨單標籤」：「起始箱號」「結束箱號」「總箱數」
• 校驗：起始≥1、結束≥起始、結束≤總箱數等。

9.4 送貨路線摘要

• Tab「送貨路線摘要」→ 選「車線」→「下載報告 (PDF)」。
• 若未執完：「此車線仍有 N 張訂單未執拾。是否仍要列印 / 下載送貨路線摘要？」

9.5 出箱數量

• Tab「成品出倉出箱數量」：按日「2/F 出箱數」「4/F 出箱數」「車線-X 出箱數」「總出箱數」（來自完成時填的箱數）。

---

十、查看提貨情況與管理動作

10.1 查詢

• 「目標日期」「重新載入」「樓層」「狀態」（「待撳單」「提貨中」「已完成」）。
• 欄含貨車／車線／裝載順序／提票號碼／負責員工／訂單項目數量等。

10.2 管理（常需 ADMIN）

動作	意義（畫面說明意涵）
「撤銷領取」	清空負責人，單據回待分配，他人可再領
「強制完成提貨單」	標完成並歸檔，不改已揀數量；適用已全部提交但系統未結案

未授權：「僅管理員（ADMIN 權限）可使用」。

---

十一、狀態對照（避免搞混三套名稱）

11.1 送貨訂單「來貨狀態」

鍵	畫面
pending	「待處理」
receiving	「接收中」
completed	「已完成」
（部分流程）released / picking	「已放單」／「提料中」

11.2 「查看提貨情況」提票狀態

鍵	畫面	白話
pending	「待撳單」	已放單、尚未領取
released	「提貨中」	已撳單／出倉中
completed	「已完成」	提貨完成

11.3 提料單通用（pickOrder）

「待處理」「已放單」「提料中」「已完成」——與上表用詞接近但場景不同；操作時以目前所在分頁的 Chip 文案為準。

---

十二、成品出倉管理（ADMIN）

• 「倉庫管理」→「成品出倉管理」（/finishedGood/management）。
• 「提料順序」：上移／下移／置頂／置底、「新增物品」「儲存」「重新載入」。
• 「出貨倉位」「入貨倉位」等主檔維護。

---

十三、路徑速查

畫面	路徑
送貨訂單	/do
DO 詳情／放單	/do/edit?id=
成品出倉（主）	/doworkbench
成品出倉管理	/finishedGood/management
舊成品出倉	/finishedGood（附錄對照用）

---

十四、常見問題速查

情況	建議
批量放單後倉庫看不到票	核對日期「是日／翌日」、樓層票別、批量／單量、是否加單檢視
車線按鈕 0 單	換日期／樓層；查「車線-X」「未完成提料單」
掃碼一直失敗	批號是否上架、是否被留貨／過期／單位不符
印不出標籤	先選 A4／標籤打印機；完成後記得填「箱數」
加單與正單混在一起	明確進／出「加單」檢視；合併規則要同店同線同時段
畫面突然英文	少數錯誤字串尚未進 zh，以實機為準並回報補譯