配送路線（Delivery Runs）使用說明書

本說明書對象：派車 / 調度、司機、營運、客服
系統位置：Dawu → 物流配送 → 配送路線
需要權限：管理配送路線（派車）/ 執行配送路線（司機）
更新日期：2026-06-08
目錄 一、配送路線是什麼 二、兩種角色與進入路徑 三、前置設定（兩件事） 四、建立配送路線（派車） 五、停靠順序與最佳化 六、發布給司機 七、司機執行（停靠點） 八、狀態說明 九、權限說明 十、常見問題

一、配送路線是什麼

一張「配送路線」就是一個配送日期 ＋ 一條路線代碼。系統會把那天、那條路線上還沒出貨的銷貨單和銷貨退回抓出來，幫你排成一份依序排好的停靠點清單，指派給一位司機，讓他在手機上一站一站去跑。

名詞區分：本說明書講的「配送路線」，是一天一條路線的派工單（系統內部叫 delivery run）。另外，每個客戶身上也會綁一個「路線代碼」（例如 A、PH、K1…），用來標示「這個客戶歸哪條路線跑」。兩個都叫「路線」，但意思不一樣，請別搞混。

幾個重要觀念

二、兩種角色與進入路徑

角色做什麼進入路徑
派車 / 調度建立路線、排停靠順序、跑最佳化、發布給司機/delivery-runs
司機跑被指派給自己的路線/work/delivery-runs（我的配送路線）
選單都在「物流配送 → 配送路線」。同一個入口，派車人員點進去看到的是調度清單，司機點進去看到的則是「我的配送路線」。

三、前置設定（兩件事）

要讓配送路線好用，尤其是想用「最佳化」的話，有兩件前置設定要先做好。

設定一：客戶綁路線 + 座標 + 配送時段

這些都在配送地點（客戶）的新增 / 編輯頁設定：/locations/new、/locations/{id}/edit

欄位說明
Dawu 路線單選下拉，只能從固定清單裡挑（A、A-1、A-PH、A-PK、A-PN、A-PS、A-PX、A-PT-1、A-PT-2、K1、K2、K3、PH、PH01、PH02、PK、PS、PT、SB、SP、XX）。一個客戶只能綁一條路線。
配送路線（routing code）自由填寫的文字（最多 50 字），系統會拿它來決定停靠點的先後順序
可接受配送時段填星期幾，加上開始 / 結束時間（24 小時制）。結束要晚於開始，同一天的時段也不能互相重疊
緯度 / 經度客戶的座標，要跑最佳化一定要填。兩個欄位要嘛都填、要嘛都留空，不能只填一個
A-PT-1 / A-PT-2 其實是同一條 A-PT 路線，只是拆成上午 / 下午兩班，會對應寫回 ERP 的特殊註記（1＝上午、2＝下午）。所以同一條實體路線，在系統裡你會看到兩個代碼，這是正常的。

設定二：路線最佳化設定

進入路徑：物流配送 → 設定 → 路線最佳化 → /config/route-optimization/routes

這個頁面會把目前所有使用中的路線代碼（從客戶資料整理出來的）列出來，並逐一標示「已設定」或「尚未設定」。每條路線都要設好下面這些：

欄位預設 / 說明
路線代碼編輯時不能改（唯讀）
出發倉緯度 / 經度配送車一開始出發的地點座標（通常是倉庫）
返回倉緯度 / 經度配送跑完後車輛要回到的地點座標（通常也是倉庫）
工作開始 / 工作結束預設 08:00 / 17:00
預設停靠服務分鐘預設 10，也就是估計每一站大概停留多久
啟用路線最佳化要勾起來這條路線才會啟用（新增時系統會預設幫你勾好）
儲存前系統會檢查：出發倉 / 返回倉的座標都要是有效的緯經度；工作開始和結束時間也要填對，而且開始一定要早於結束，不然存不進去。
只要這條路線沒設定、或設了卻沒「啟用」，就沒辦法用「最佳化」。

四、建立配送路線（派車）

進入路徑： /delivery-runs → 點「新增」 → /delivery-runs/new

  1. 填配送日期、選路線、填司機 Email（司機這欄可以晚點再補）
  2. 點「預覽」，系統就會去抓那天那條路線「未出貨」的銷貨單和銷貨退回
  3. 看一下「路線預覽」的停靠點摘要卡，確認內容對不對
  4. 確認沒問題後，點「建立草稿路線」

停靠點怎麼來、怎麼排：

如果預覽出現「此日期與路線沒有符合條件的未出貨銷貨單或銷貨退回」，就表示那天那條路線沒有可以建的未出貨訂單 / 退貨。請先確認日期、路線有沒有選錯，或是 ERP 上那些單是不是已經出貨了。
（技術前提：系統要連得到 ERP 資料來源才行；如果連線還沒設好，畫面會提示抓不到資料，這時請通知工程。）

五、停靠順序與最佳化

只有在「草稿」狀態下，配送路線的順序才能調。進到路線詳情頁（/delivery-runs/{id}）後，有兩種排法可以用。

方法 A：手動拖曳

  1. 在詳情頁的「停靠順序」區，直接用拖曳的方式把停靠點排成你要的配送順序
  2. 排好之後，記得點「儲存順序」

方法 B：路線最佳化（自動建議）

最佳化會把停靠點送到外部的最佳化服務（一個專門算路線的線上服務，系統會自動串接，你不用自己操作），由它根據座標、配送時段和工作時間，幫你算出建議的順序和每站的到達時間。這要你自己手動按，系統不會自動跑。

  1. 在草稿的詳情頁點「最佳化」
  2. 系統會開一個「路線最佳化預覽」頁，上面會給你看：
  3. 如果結果是「最佳解 / 可行解」，點「套用最佳化順序」，系統就會照建議幫你重排
最佳化按不動 / 報錯，通常是這幾個原因：
套用時如果提示「不符 / 已失效」：代表你在算出建議之後，又動過停靠點（拖曳過、或內容有變），這份建議已經跟現在的草稿對不上了。請重新跑一次最佳化，再套用新的結果。

六、發布給司機

  1. 先確認停靠順序和司機 Email 都填對了
  2. 在草稿的詳情頁點「發布」
  3. 狀態變成「已發布」之後，司機才會在「我的配送路線」裡看到這條路線
司機只看得到已發布（包含進行中 / 已完成）、而且指派給「自己 Email」的路線。草稿不會出現在司機那邊；沒填司機 Email 的路線，也不會出現在任何司機的清單裡。

七、司機執行（停靠點）

司機先從「我的配送路線」點開一條路線，再點進去某個停靠點，就會進到「停靠點」頁。每一張卡上會顯示客戶名稱、客戶代碼、配送路線（routing code）和地址，另外還有三個數字卡：訂單、退貨、收款（收款這項僅供司機記錄意圖）。

停靠點可做的事

功能說明
銷貨單清單看這一站要送的訂單有哪些
銷貨退回一筆一筆「確認退貨 / 更新退貨確認」，需要的話可以加備註
記錄收款意圖可選現金 / 信用卡 / 支票；金額一定要大於 0；收支票要填支票號碼（也可一併填「支票到期日」，選填）；款項可以分配到各筆訂單；如果還有沒分配掉的餘額，就要寫備註（幣別固定是 TWD）
客戶互動把配送途中跟客戶的一次互動記下來（會連到 CRM）
佐證（照片）上傳現場拍的照片
配送途中見聞記下競業情報，例如路上看到的競品或競業車輛等
完成停靠點這一站做完就按，把它標記成已完成
收款只是「記錄意圖」，不會回寫 ERP。真正的帳務還是要走公司原本的對帳流程處理。

八、狀態說明

配送路線狀態

狀態意思
草稿剛建好，這時候可以排序、最佳化、發布
已發布已經派給司機，司機看得到了
進行中司機已經開始跑這條路線
已完成所有停靠點都已完成或略過
已取消這條路線已被取消

停靠點狀態

狀態意思
待處理這一站還沒開始
進行中這一站已經做過收款、確認退貨或拍照等動作
已完成司機按了「完成停靠點」
已略過這一站被跳過、沒有配送
狀態會自己往前推進：路線發布之後，只要任一個停靠點有了動作，那個停靠點就會轉成「進行中」，整條路線也跟著轉成「進行中」；等到所有停靠點都變成「已完成 / 已略過」，路線就會自動變成「已完成」。至於草稿和已取消，則不會自動推進。
目前畫面上還沒有「略過停靠點」「取消路線」這兩個按鈕（這兩個狀態系統內部是有的，但還沒有對應的操作可以按）。畫面也沒有地圖可以看，最佳化的結果是用文字清單呈現（會附上每站的到達 / 離開時間）。

九、權限說明

權限能做什麼
管理配送路線（派車）可以看列表、建立路線、預覽、排序、跑最佳化、發布
執行配送路線（配送）可以看「我的配送路線」、記收款、確認退貨、記互動、拍照、完成停靠點
角色派車配送
營運 / 管理角色有—
調撥單管理員有—
司機（Driver）—有
司機只能打開已發布、而且指派給自己的路線；要是去開別的，系統會把你擋下來（403）。

十、常見問題

Q1：預覽說「沒有符合條件的未出貨銷貨單或銷貨退回」？

表示那天那條路線沒有未出貨（confirmed_code = N）的訂單或退貨。請確認日期、路線有沒有選錯，或是 ERP 上那些單是不是已經出貨了。

Q2：建好之後 ERP 又改了訂單，配送路線會更新嗎？

不會。配送路線是建立當下抓的快照，之後 ERP 那邊改了，這份不會跟著更新。如果需要最新的內容，請重新建立一張。

Q3：「最佳化」按不下去 / 沒反應 / 報錯？

可以對照第五章的警示框檢查這幾點：路線必須是草稿狀態、這條路線要在「路線最佳化設定」裡建好而且「啟用」、每個停靠點都要有座標、如果客戶有設配送時段那天的星期幾要有可用時段、系統也要設好最佳化服務的位址。

Q4：套用最佳化順序時說「不符 / 已失效」？

因為你在算出建議之後，又動過停靠點（拖曳過、或內容有變），建議已經跟現在的草稿對不上了。請重新跑一次最佳化，再套用新的結果。

Q5：司機看不到指派給他的路線？

要兩個條件同時成立才看得到：(1) 路線已發布、(2) 司機 Email 填的是他本人（系統比對時會把 Email 轉成小寫）。草稿不會出現；Email 沒填或填錯，他一樣看不到。

Q6：一個客戶可以綁多條路線嗎？

不行。「Dawu 路線」是單選的，一個客戶只能綁一條路線。

Q7：為什麼同一條路線有 A-PT-1 / A-PT-2 兩個代碼？

那其實是同一條 A-PT 路線，只是拆成上午 / 下午兩班來跑，會對應到 ERP 的特殊註記。

Q8：收款會自動入帳 / 回寫 ERP 嗎？

不會。畫面上就寫明「僅供司機記錄意圖」，真正的帳務還是走公司原本的對帳流程。

Q9：有地圖可以看路線嗎？

目前沒有地圖。最佳化的結果是用文字清單呈現的，上面會附上每一站的到達 / 離開時間。

Q10：可以略過某個停靠點，或取消整條路線嗎？

目前畫面上沒有「略過 / 取消」的按鈕。如果你有這個需求，請回報給工程評估。

需要協助？
系統故障 / 最佳化服務異常 → 工程值班（Google Chat）
流程疑問 → 陳梓維（chenziwei@hisunfoods.com）
派車決策 → 直接主管

本說明書會隨系統更新而修改。最新版本請以 Dawu 系統內公告為準。
最後更新：2026-06-08