進口作業教學
已完成
第零章 系統概覽與端到端流程
本系統把「代理進口一票貨」從下單採購到放行入庫、食品合規的完整生命週期，
收攏在一張進口作業單（IMP）上。採購、船務、報關、倉庫、品保、會計都看同一張單子的不同區塊，
避免資訊分散。本章先給你「全景地圖」與幾個裝好系統後一定要先設定、否則整段自動化會靜默失效的關鍵，
再逐章教操作。
0-1 三種角色，看同一張單的不同面向
採購發動流程
建立詢價單/採購單、綁進口作業單
建立詢價單/採購單、綁進口作業單
→
船務掌握在途
填 ATD/ATA、貨櫃、分提單
填 ATD/ATA、貨櫃、分提單
→
報關通關放行
報單、邊境報驗、放行閘門
報單、邊境報驗、放行閘門
→
倉庫收貨入庫
批號、效期、FEFO
批號、效期、FEFO
→
會計帳與付款
供應商帳單、付款到期、到岸成本
供應商帳單、付款到期、到岸成本
核心精神：發動＝採購；「效期」貫串全程；批號為追溯中心；一張作業單可掛多張採購單（拼櫃）。
0-2 端到端流程（12 主狀態 → 5 里程碑）
一張進口作業單從建立到結案，會依「事件驅動」自動往前推進主狀態（只向前、不回退、不會自動跳過放行閘門）。 完整版看得到 12 格細狀態；跨部門追蹤則收斂成 5 個里程碑（第六章的「進口訂單排程」看板即用此 5 格）。
①下單備貨
草稿→已確認→備貨中
草稿→已確認→備貨中
→
②在途
待出貨→海上
待出貨→海上
→
③到港通關
到港→報關中→已放行→配送中
到港→報關中→已放行→配送中
→
④已入庫
stored
stored
→
⑤結案
done
done
上排 5 格為「排程里程碑（schedule_stage）」；下方完整狀態機表列出對應的 12 主狀態與觸發動作。
完整狀態機（trade.import.case，經 RPC/原始碼查證）
| 主狀態 | 對應里程碑 | 代表意義 | 由誰／什麼動作進入下一格 |
|---|---|---|---|
| 草稿 draft | ①下單備貨 | 作業單剛建立、尚未確認 | 買手按「確認」，或關聯採購單被確認 |
| 已確認 confirmed | ①下單備貨 | 採購已成立、等待供應商備貨 | 採購單 button_confirm 自動推進；或手動「備貨」 |
| 備貨中 production | ①下單備貨 | 供應商生產／備貨中 | 填船務並標示可出貨 → 待出貨 |
| 待出貨 ready | ②在途 | 備妥待裝船 | 船務填入 ATD（開航）→ 海上 |
| 海上 in_transit | ②在途 | 貨在海上運送中 | 抵港（ATA）→ 到港 |
| 到港 arrived | ③到港通關 | 貨櫃已到目的港 | 建立報單、送報關 → 報關中 |
| 報關中 customs | ③到港通關 | 海關申報／查驗中 | 報單全部放行且通過放行閘門 → 已放行 |
| 已放行 released | ③到港通關 | 海關放行、可提貨 | 收貨單備妥（貨運往倉庫）→ 配送中 |
| 配送中 delivering | ③到港通關 | 提貨運往倉庫途中 | 收貨單完成 → 已入庫 |
| 已入庫 stored | ④已入庫 | 貨已收進倉庫、批號效期建檔 | 單據結清、人工「結案」 |
| 結案 done | ⑤結案 | 整票貨作業完成、歸檔 | （終點） |
| 取消 cancel | 取消 | 作廢此作業單 | （終點，可再轉回草稿） |
0-3 三色標注圖例（全手冊統一）
本手冊每一張截圖上的彩色框都遵循同一套語意，圖下方一定附「編號對照表」：
紅色實線＝請在此點擊／操作（按鈕、要點的下拉或儲存格）
橘色虛線＝必填欄位（你要自己打字或選的欄位）
藍色實線＝系統自動產生／請記下的編號（單號、批號、發票號）
0-4 ⚠️ 裝好系統「第一次用之前」一定要先設定的預設策略
畫面上沒有紅色星號（★）不代表可以留空。本系統有幾個「軟性必填」——它們藏在程式邏輯裡， 沒設好會讓某一段自動化靜默地不發生，而且不會跳任何錯誤訊息。以下三項務必在導入初期先設定：
⛔ 軟性必填 1：進口歸併策略（最容易踩的重點）
採購單「確認」時，系統會依供應商 → 公司預設的順序找「進口歸併策略」，兩者都沒設定就等於 manual（人工），
此時確認採購單不會自動建立／關聯進口作業單（程式碼 mode = policy.mode if policy else 'manual'，manual 直接跳過）。
- manual｜人工建立 / 人工關聯：確認採購單不自動建案，由買手自己先建作業單再關聯（本手冊示範採此法，流程最清楚）。
- one_po_one_case｜一張採購單一作業單：每張採購單各自建一張作業單。
- by_supplier_month｜同供應商同下單月併單（拼櫃）：同一供應商、同一下單月份的採購單自動併進同一張作業單。
設定位置：進口作業 → 配置 → 進口歸併策略，建立策略後掛到供應商或公司預設。若你發現「確認採購單後找不到作業單」， 十之八九就是這裡沒設。
⚠️ 軟性必填 2 & 3：供應商進口預設、單號前綴
- 供應商進口預設（貨代／報關行／貿易條件／付款基準／付款天數／流程模式）：設在供應商上， 之後建作業單或採購單時自動帶入；沒設就每次手動填，容易漏。（第二章教）
- 作業單單號前綴：預設取「委託客戶」的客戶代碼當前綴（本示範客戶代碼
DMO→ 單號DMO-202607-0002）； 公司層若沒設case_default_prefix也沒有委託客戶代碼，才退回硬預設IMP。
0-5 登入
0登入系統
開啟系統網址後，於登入頁輸入帳號與密碼（示範環境為
admin／admin），按「登入」。
登入後左上角可切換各大選單：採購、訂單、產品、進口待辦、進口作業、食品合規、配置。ℹ️ 本章重點回顧
①一張進口作業單串起採購→船務→報關→倉庫→會計；②主狀態只向前推進、不自動跨放行閘門；③導入初期先設好「進口歸併策略」與「供應商進口預設」，否則自動化不會發生。