新增列印模板
目錄
一、功能介紹
新增模板分兩個步驟:先決定這張模板是什麼、屬於誰、印在多大的紙上,再編輯實際的版面內容。右側一直顯示預覽,改一行就看得到結果,不需要存檔後才印一張出來確認。內容不必從空白開始——系統會先帶入該類型的公版,您在上面改就好。

1.1 選擇模板類型
從清單頁點新增後,會先出現選擇模板類型。選定之後才會進入表單,因為不同類型可填的欄位不一樣,而且類型選定後就不能改——建錯類型只能刪掉重建。各類型的用途見 模板類型。
目前選定的倉庫使用虛擬儲位時,儲位標籤不會出現在可選清單裡。
兩種揀貨單類型(揀貨單(紙本)、揀貨單(App))分別對應紙本揀貨與 App 揀貨的列印明細,依您要自訂的揀貨方式選。紙本那一種一份模板同時涵蓋「逐儲位」與「逐商品」兩種明細列,由系統依這張單的狀態與走位能否還原自動決定,您無法指定、也不必預測,不會有選錯類型的問題;每種情況在什麼時候印、印什麼,見 揀貨單詳情。
1.2 步驟一:基本資訊
標示 * 的欄位為必填項目
| 欄位名稱 | 如何填寫 | 注意事項 |
|---|---|---|
| *模板名稱 | 取一個列印時挑得出來的名稱,例如「A 品牌出貨明細(官網)」 | 裝箱明細與兩種揀貨單類型最多 255 字;裝箱明細、儲位標籤、自訂託運單與兩種揀貨單類型同範圍內名稱不可重複 |
| 歸屬 | 選貨主層代表只給某一個貨主用,選組織層代表整個組織共用 | 只有裝箱明細與兩種揀貨單類型兩層都能選;其餘類型的歸屬固定,不會出現這個選項 |
| *所屬貨主 | 只有裝箱明細與兩種揀貨單類型選貨主層時出現,選擇這張模板服務哪一個貨主 | 只能選您被授權管理的貨主。其餘貨主層類型(出貨明細、商品標籤)不會出現這個欄位,歸屬直接等於您目前選定的貨主;尚未選定貨主時,這一頁會先要求您選一個才顯示表單 |
| 設為預設 | 打開代表這一層沒有指定模板的單據都用它 | 開關標題會依歸屬顯示成該貨主的預設或組織預設;出貨明細與自訂託運單沒有預設的概念,不會出現這個開關;兩種揀貨單類型沒有套用對象可指定,設為預設是它們唯一會被自動用到的方式 |
| 適用通路 | 選擇哪些通路的單據要用這張模板 | 選填。不選的話這張模板不會自動套用(這個欄位上方的生效摘要會提醒),可以之後再到編輯頁指定。出貨明細沒有預設可用,指定通路是它唯一的自動生效途徑;裝箱明細也可以改用預設生效。只有貨主層的模板綁得到通路,歸屬選組織層時這個欄位會收起來,已經選好的通路也會一併清空,切回貨主層要重新選。可選的通路只會是這張模板所屬貨主底下的通路 |
| 適用物流類型 | 選擇哪些自建物流類型的託運單要用這張模板 | 只有自訂託運單有這個欄位。選填,物流類型那一頁同樣能設定這份綁定 |
| *紙張尺寸 | 從常用紙張挑一個,或直接填寬與高的公釐數 | 選了紙張之後仍可以手改數字;寬高必須大於 0,輸入框最小填到 1 公釐。兩種揀貨單類型新增時帶入 A4(210×297 公釐),常用紙張只能挑 A4 或 A5。儲位標籤沒有常用紙張可挑,只能直接填數字,寬限 20–300 公釐、高限 15–300 公釐 |
| 內容超出紙張時 | 內容比紙張長時要怎麼處理:裁掉超出的部分(超出的部分不會印出來),或印到下一張(超出的部分接著印在下一張) | 位在紙張尺寸欄位下方,只有商品標籤、儲位標籤、自訂託運單有這個選項,商品標籤與儲位標籤預設為裁掉超出的部分,自訂託運單預設為印到下一張。儲位標籤的紙張尺寸是固定的:選印到下一張時,只印一個儲位才會乾淨地接著印在下一張;一次列印多個儲位時,超出的部分會疊印到下一張標籤上,整批都不能用。列印時選 A4 紙多個一張的排版,每一格的內容一律裁掉,不受這個選項影響。出貨明細、裝箱明細與兩種揀貨單類型是流式單據,內容比一頁長時本來就會接著印下去,所以沒有這個選項。右側預覽會跟著您選的方式提示 |
商品標籤不在這裡指定套用對象,而是到商品資料上逐一指定(見 編輯商品),所以這一頁只會顯示一行說明。兩種揀貨單類型沒有套用對象可指定,這一頁不會出現相關欄位。
兩種揀貨單類型每頁四邊固定留 10 公釐邊距,範本不能自己調整;範本裡自行寫的頁面邊距規則不會生效。右側預覽會在四周留出同樣的邊距,但預覽是一整條連續的畫面,看不到分頁處;實際列印時每一頁的四邊都有這段邊距。
欄位下方的提示會即時告訴您這張模板建好之後會在什麼情況下被用到。顯示「尚未設為預設,也未指定套用對象」的黃色提示時,代表建好之後不會自動生效。七種類型裡只有 商品標籤 與 儲位標籤 能在列印當下手動挑模板,其餘五種在這個狀態下永遠不會被印出來。
填完點下一步進入下一步;有必填欄位沒填會停在這一步並標出該欄位。
1.3 步驟二:版面內容
| 工具 | 用途 |
|---|---|
| 從內建版型開始 | 儲位標籤提供大字+條碼、大字+QR Code、詳細資訊、含商品資訊四種現成版型,選一個會直接覆蓋目前的內容與尺寸。其餘類型只有一種公版,不顯示這個選單 |
| 編輯 HTML | 打開編輯器修改版面。右側預覽會跟著更新 |
| 變數說明 | 查看這個類型可以用哪些欄位(例如訂單編號、收件人、商品名稱),以及正確的寫法 |
| GoBot | 用對話描述想要的版面,由系統改寫內容。只有出貨明細提供 |
| 載入商品資料 | 商品標籤專用:挑一個真實商品當預覽樣本,確認長名稱、長規格不會爆版。點重置為範例資料換回範例資料 |
| 描述 | 填寫用途備註,例如「官網通路專用,含退換貨說明」,方便日後在清單上分辨版面相近的模板 |
未選真實商品時,預覽使用系統提供的範例資料,不是真實訂單或商品。
揀貨單類型的變數
兩種揀貨單類型能用的變數不完全相同,以變數說明列出的為準。幾個容易混淆的地方:
- 狀態有兩個變數,用途不同:
picking_list.status是機器值,只會是processing(作業中)、done(已完成)、terminated(已終止),要依狀態切換內容就用它,例如{% if picking_list.status == "processing" %};picking_list.status_label是已依列印語系翻成的顯示文字,只拿來印出,不要拿它做條件比對,換個列印語系就會失效。欄位標題「狀態」用labels.status。兩種公版的抬頭都會印出狀態。 - 公版的勾選格只在「作業中」才印:公版用
picking_list.status == "processing"判斷;已完成或已終止的單不印勾選格,避免看起來像還沒做的工單。自訂模板要保留勾選格,請沿用同樣的判斷。 - 紙本一份模板涵蓋兩種明細列,用
picking_list.by_shelf分流:by_shelf為 true 時逐儲位一列,同一個商品分在兩個儲位會是兩列,各帶自己的儲位與數量(item.location、item.quantity),數量欄標題用labels.quantity(「數量」);為 false 時逐商品一列(不過濾,完全沒揀到的商品也在內),同時帶應揀量item.quantity與淨實揀量item.picked_quantity,沒有item.location、item.slot_allocations與箱數欄位;公版並列兩欄,標題用labels.required_quantity(「應揀數量」)與labels.picked_quantity(「已揀數量」)。哪一種會出現由系統決定(見 揀貨單詳情),所以自訂紙本模板要把兩種寫法都寫進去;只寫逐儲位那一種,遇到逐商品的單時儲位欄、數量欄都會是空白。揀貨單(App)沒有by_shelf,永遠逐商品一列、不拆儲位。總品項數與總揀貨數量都以商品為單位加總,不是明細列數;picking_list.total_quantity一律是應揀加總、picking_list.total_picked_quantity一律是實揀加總,兩者語意固定,不隨狀態或版面改變。 - 預覽可以切換範例資料的狀態:預覽區右上角的切換器預設是「作業中・逐儲位」(
status為processing、by_shelf為 true);揀貨單(紙本)還可切到「已完成・逐儲位」與「已完成・逐品項實揀」(by_shelf為 false),揀貨單(App)可切到「已完成」、「作業中・無自訂屬性」與「已完成・無自訂屬性」(後兩個是貨主沒有定義庫存自訂屬性、整個屬性欄收起來的樣子)。改了欄位或條件式後,每個選項都切過去看一遍,確認各分支都寫對、已完成單沒有勾選格的樣子也正確。 - 箱數變數只有揀貨單(紙本)有,而且只在逐儲位時有值:
product.small_quantity_per_large_unit(箱入數)、product.large_unit_name、product.small_unit_name、large_unit_quantity(整箱數)、remainder_small_unit_quantity(散件數);揀貨單(App)沒有這些變數。範本裡的寫法是item.product.large_unit_name、item.large_unit_quantity。依「這一列的數量」換算,所以同一個商品分在兩個儲位時各列分開算。商品沒填箱入數(或填 0)時,整箱數是空白、散件數是這一列的全部數量;數量不足一箱時整箱數是 0,會印出 0 而不是空白。要判斷「這個商品有沒有箱入數」請用整箱數(large_unit_quantity)有沒有值,不要用箱入數(product.small_quantity_per_large_unit)——箱入數存成 0 時它會原樣印出 0。單位名稱沒填時也是空白,系統不會代填「箱」「個」,需要時在範本裡自己補預設字。 - 公版不印箱數:系統內建的版面維持原樣,沒有箱數欄。要印的話,新增一張揀貨單(紙本)範本,在帶入的公版上把逐儲位那一支的數量欄改成印箱數;公版的數量欄上方有一段註解示範寫法。
- 揀貨序號只有揀貨單(紙本)的逐儲位才有:
item.slot_allocations是陣列,每項的slot_number是揀貨序號(出貨單在波次內的編號、分揀台車的格位),quantity是這一列放進該格的數量,依放貨順序排(先建立的需求在前,不是依序號大小),只合併前後相鄰的同一個序號,所以同一個序號可能出現兩次;寫法是{% for slot in item.slot_allocations %}{{ slot.slot_number }}: {{ slot.quantity }}{% endfor %},欄位標題用labels.slot(「揀貨序號」)。分法見 揀貨單詳情;已出貨的出貨單不列,所以加總可能小於這一列的數量。已完成的單由實際揀出紀錄還原的逐儲位列是空陣列;逐商品一列的版面與揀貨單(App)沒有這個變數。公版已在數量欄後面印這一欄;您先前建立的自訂模板不會自動多出這一欄,要印的話自己加上。 - 公版已在效期下方印製造日期:兩種公版在品項的效期那一行下面,多印一行製造日期,只有這批庫存有製造日期時才印。您先前建立的自訂模板不會自動多出這一行;要印的話自己加上,變數是
item.manufacturing_date(格式 YYYY-MM-DD,沒有時為空),標題文字用labels.manufacturing_date(「製造日期」)。新增範本時帶入的公版已經包含這一行。 - 條碼區:抬頭的條碼是所屬波次號(沒有掛波次時是揀貨單號),現場配貨掃描的就是它。
1.4 出貨明細:印出箱數
整箱出貨的貨主,只要商品資料填了「大單位入數(箱入數)」,出貨明細就能印出「幾箱幾個」,不必再逐一商品另外設定訂購單位。系統公版不會印箱數,要在自己的版面加上欄位:打開變數說明,在「訂單品項」找到下列欄位,複製寫法貼進版面。
| 欄位 | 內容 |
|---|---|
| 箱入數(product.small_quantity_per_large_unit)、大單位名稱(product.large_unit_name)、基本單位名稱(product.small_unit_name) | 商品資料上填的「大單位入數(箱入數)」「大單位名稱」「基本單位名稱」 |
| 整箱數(large_unit_quantity) | 本張出貨單的出貨數量裝得滿幾箱 |
| 散件數(remainder_small_unit_quantity) | 沒裝進整箱的基本單位數;沒填箱入數的商品則是全部出貨數量 |
箱入數 4 的商品:出貨 10 個印 2 箱 2 個;出貨 8 個印 2 箱 0 個;出貨 3 個印 0 箱 3 個。
- 以本張出貨單的數量換算:訂單拆成多張出貨單時,每張依自己的出貨數量各算各的;合併出貨時,每個品項依各自商品的箱入數換算。移倉單與生產任務產生的出貨單同樣適用。
- 讀商品「目前」的資料:商品之後改了箱入數,重印既有出貨單時箱數會跟著變。「訂購單位名稱」「訂購單位數量」則是下單當時的快照,不受影響,兩組欄位可以同時印。
- 沒填箱入數就全部算散件:商品的箱入數未填或為 0 時,整箱數印空白、散件數為全部出貨數量,其他欄位與整張出貨單照常產出。所以版面可以拿掉「數量」欄、只放整箱數與散件數,沒填箱入數的商品也不會整列空白。
- 要判斷商品有沒有箱入數:請用整箱數(large_unit_quantity)——沒填箱入數時它是空白;不要用 product.small_quantity_per_large_unit,箱入數存成 0 時那個欄位會原樣印出 0。
右側預覽的範例資料第一個品項會示範 2 箱 2 個,第二個品項示範未填箱入數的樣子(整箱數空白、散件數為全部出貨數量)。
1.5 儲存
點儲存並新增下一筆會存檔並清空表單,留在這一頁繼續建下一張,適合一次要建好幾張的情況。直接送出則會存檔並跳到該模板的詳情頁。
送出前系統會檢查版面內容:出貨明細必須保留揀貨條碼區變數,少了它倉庫掃不到條碼。所有類型的版面語法有誤時都會擋下並指出錯誤內容。兩種揀貨單類型只檢查語法,不檢查有沒有保留條碼區:拿掉它仍然存得下去,但現場拿紙本掃描會查無資料,改版時請保留。
二、常見問題
2.1 FAQ
▪ 選錯模板類型了,可以改嗎?
不行。類型決定可填欄位與可用的版面欄位,建立後不提供更改,請刪掉重建。
▪ 為什麼有些類型看不到歸屬或預設開關?
這兩項由模板類型決定。只有裝箱明細與兩種揀貨單類型可以選擇歸屬;出貨明細與自訂託運單沒有預設的概念,因此不顯示預設開關。各類型的差異見 模板類型。
▪ 已經選了適用通路,還能同時設為預設嗎?
不行。一張模板只會有一種生效方式,指定了套用對象就不能再設為預設,反之亦然。
▪ 紙張尺寸選了 A4,但我想要略窄一點?
紙張選單只是快速填入寬高,選完之後直接改數字即可,不需要切換到別的模式。清單頁的尺寸欄在數字剛好等於常用紙張時顯示紙張名稱,否則顯示公釐數。
▪ 預覽上出現「內容超出紙張尺寸」的黃色提示,是什麼意思?
代表版面內容比您設定的紙張還長,提示會告訴您超出約多少公釐,以及列印時的結果:選裁掉超出的部分時是「列印時會被裁掉」,選印到下一張時是「列印時會印到下一張」。儲位標籤的提示不一樣:它的紙張尺寸是固定的,提示會告訴您一次列印多個儲位時超出的部分會疊印到下一張標籤上。這是提醒,不會擋住存檔。要消除它可以調整版面或加大紙張,也可以改選另一種處理方式。出貨明細、裝箱明細與兩種揀貨單類型不會出現這則提示,內容跨頁對它們是正常的。
▪ 送出後顯示名稱已被使用?
裝箱明細、儲位標籤、自訂託運單與兩種揀貨單類型在同一個範圍內不允許同名,換一個名稱即可。
▪ 揀貨單模板可以自己調整邊距嗎?
不行。兩種揀貨單類型每頁四邊固定 10 公釐,範本裡自行寫的頁面邊距規則不會生效;範本內容本身要留的空白,另外用版面內的間距處理。
▪ 所屬貨主下拉找不到某個貨主?
只會列出您被授權管理的貨主。找不到請聯繫管理員確認授權範圍。
2.2 注意事項
⚠️ 重要提醒
- 模板類型建立後無法更改。
- 打開預設開關並存檔後,同範圍內原本的預設模板會立即被取消預設,該貨主接下來印出來的單據就會改用新版面。
- 從內建版型開始會直接覆蓋目前已編輯的內容與尺寸,改到一半再選會遺失手邊的修改。
💡 提示:商品標籤的版面最容易在長品名、長規格上爆版,存檔前用載入商品資料挑一個名稱最長的商品看過一次最保險。
三、相關功能
| 功能 | 說明 | 連結 |
|---|---|---|
| 列印模板 | 回到清單查看所有模板 | 前往 |
| 列印模板詳情 | 查看剛建好的模板版面 | 前往 |
| 編輯列印模板 | 修改既有模板 | 前往 |