新增自定義樣板
目錄
一、功能介紹
需要一份新的出貨單列印版面時，在這裡建立。新增分成兩步：先填模板名稱、選好適用通路與紙張尺寸，再編輯版面內容——可以用「GoBot」以對話方式調整版面，頁面右側隨時顯示即時預覽，儲存前就能確認列印長相。建好後，綁定通路的訂單列印時就會套用這份版面。
進入頁面後需先選擇貨主，適用通路只會列出該貨主底下的通路。
1.1 步驟一：基本資訊
標示 * 的欄位為必填項目
| 欄位名稱 | 如何填寫 | 注意事項 |
|---|---|---|
| *模板名稱 | 輸入容易辨識的名稱 | 建議帶上通路名稱，例如「蝦皮出貨單」，方便日後在列表辨認 |
| *適用通路 | 從清單選擇此版面要套用的通路，可多選 | 找不到通路請先確認上方已選對貨主；一個通路同時只能套用一份樣板，選了已綁其他樣板的通路會改綁到這份 |
| *紙張尺寸 | 選擇 A4 (210 x 297 mm)、A5 (148 x 210 mm)，或選自訂尺寸 | 選自訂尺寸時要另外填紙張寬度 (mm)和紙張高度 (mm) |
填完點擊「下一步」進入內容編輯。
1.2 步驟二：編輯內容
進入第二步後，系統已帶入一份內建的預設版面，您可以直接調整。頁面提供三個工具：
| 工具 | 用途 |
|---|---|
| GoBot | 以對話方式描述需求調整版面，例如「把收件人電話隱藏中間四碼」「新增商品總數欄位」「調整商品列表的字體大小」 |
| 編輯 HTML | 直接編輯版面的原始內容，適合需要精細調整時使用 |
| 變數說明 | 查看所有可放進版面的變數清單（訂單資訊、貨主、通路、物流、商品品項等），可搜尋並複製 |
此外可填寫描述備註版面用途。完成後點擊「儲存」；需要連續建立多份時，可點擊「儲存並新增下一筆」，儲存後表單會清空回到第一步，方便接著建立下一份。
1.3 即時預覽
頁面右側固定顯示「模板預覽」，以範例訂單資料即時呈現排版效果，編輯內容後立即更新。實際列印時會把範例資料替換成真實訂單資料，版面與樣式維持一致，因此儲存前看到的就是日後列印的長相。
二、常見問題
2.1 FAQ
▪ 版面內容是怎麼顯示訂單資料的？
版面用變數來代表訂單資料。在「變數說明」可以查到可用的變數，把變數放進版面後，列印時系統會自動替換成實際的訂單資料。
▪ 出貨單想印出平台賣場上的品名，怎麼設定？
點「變數說明」，在「訂單品項」分類可以看到「平台賣場品名」的說明。實際套用時，把版面內容中商品明細迴圈裡原本的 item.product.name 改成 item.platform_product_name。由電商平台自動帶入的訂單，就會印出賣場上的商品名稱；平台沒有提供品名，或是手動建立、匯入、移倉單與生產任務產生的出貨單，同一個欄位會自動改印商品主檔的名稱，不會留白。組合商品與彈性商品拆解後的子品項沒有各自的賣場品名，同樣會印商品主檔的名稱。既有樣板不會自動更新，沒有加上這個欄位的樣板列印結果維持不變。
▪ 超商取貨的訂單想在出貨明細印門市代號，怎麼設定？
點「變數說明」，在「訂單基本資訊」分類搜尋「超商」可以找到「超商取貨門市代號」，用卡片上的複製功能把語法貼進版面內容即可（變數為 order.convenience_store_code）。超商取貨的訂單會印出訂單上的門市店號，與訂單詳情頁顯示的相同；部分平台帶回的是門市名稱而非店號，列印內容以訂單上實際儲存的值為準。宅配等非超商取貨的訂單、平台沒有提供代號的訂單，以及移倉單與生產任務產生的出貨單，這個位置會是空白，不影響列印。合併出貨時 order.convenience_store_code 印的是下單時間最早那張訂單的代號；要逐張印出各訂單的代號，請改在 fulfillment.orders 迴圈內用迴圈變數取（例如 o.convenience_store_code）。
▪ 出貨明細想印整張單的總重量與總材積，怎麼設定？
點「變數說明」，在「出貨單資訊」分類搜尋「重量」或「材積」，可以找到「出貨單總重量」與「出貨單總材積」，用卡片上的複製功能把語法貼進版面內容即可（變數為 fulfillment.total_weight、fulfillment.total_volume）。這兩個數字是這張出貨單自身的合計：合併出貨時為單上全部訂單的合計，移倉單與生產任務產生的出貨單也會印出單上商品的合計。重量單位固定為公斤；材積單位依系統的「體積單位」設定，可能是「立方公尺 (CBM)」或「材 (CUFT)」（30×30×30 cm ＝ 1 材），要把單位一起印在數字旁邊請再加上 fulfillment.total_volume_unit，它印出的 CBM／CUFT 與 fulfillment.total_volume 的數值一定一致。既有樣板不會自動更新，沒有加上這些欄位的樣板列印結果維持不變。
▪ 總重量或總材積印出來是 0，怎麼辦？
總重量是商品主檔的單品重乘以出貨數量後累加，總材積是單品長寬高乘以出貨數量後累加，沒填的欄位一律以 0 計入，所以第一步是回商品主檔確認單品重與單品長寬高有沒有填。材積另外要看系統目前的「體積單位」設為哪一種：設為「材 (CUFT)」時，商品即使沒填單品長寬高，只要填了大單位（箱）長寬高與大單位入數，系統就會用「大單位材積 ÷ 大單位入數」推算出單品材積，不會是 0；設為「立方公尺 (CBM)」時沒有這個推算，單品長寬高一旦沒填就是 0。主檔都填了卻仍印 0，代表這張單的合計本身低於輸出精度，不是主檔缺值：總材積保留到小數點後 5 位、總重量保留到小數點後 3 位，而且取整是在整張單合計之後才做，門檻因此看整張單的總量而不是單品。以「立方公尺 (CBM)」計的單，整張單總體積不到 5 立方公分就印 0（例如只出 1 顆 2×2×1 cm 的螺絲）；以「材 (CUFT)」計的單門檻是 0.135 立方公分（例如只出 1 顆 0.5×0.5×0.5 cm 的珠子）。總重量的門檻是 0.5 公克：單品重 0.0002 公斤的貨出 1 件印 0.0，出到 3 件就印 0.001。同一項商品出得夠多數字就會浮現，飾品、電子零件這類極輕小件在小量單上印 0 屬正常。缺值與數字過小都只會以 0 計入合計，不會中斷列印。
▪ 一定要選通路才能儲存嗎？
是的，適用通路為必填，至少要選一個通路才能儲存。儲存後這些通路的訂單列印時就會套用此版面。
▪ 「GoBot」可以幫我做什麼？
可以用對話方式調整版面，例如調整欄位排列、新增或移除欄位、修改字體與間距、調整表格格式等。描述需求後它會直接改好版面，右側預覽同步更新。
▪ 預覽和實際列印會一樣嗎？
排版與樣式相同。預覽用的是範例訂單資料，實際列印會替換成真實訂單資訊，版面長相一致。
▪ 「自訂尺寸」要怎麼設定？
在紙張尺寸選自訂尺寸後，會多出紙張寬度 (mm)與紙張高度 (mm)兩欄，自行輸入毫米數值即可。
▪ 儲存後可以再修改嗎？
可以。儲存後會進入該樣板的詳情頁，點擊編輯即可再次調整版面或重新綁定通路。
2.2 注意事項
⚠️ 重要提醒
- 版面內容必須保留條碼區域的保留變數，少了它會無法儲存；用「GoBot」調整時系統會自動保留，手動編輯 HTML 時請勿刪除。
- 選了已綁定其他樣板的通路，該通路會改綁到這份新樣板，原樣板不再套用於該通路。
💡 提示：建議先用「GoBot」在預設版面上微調，邊改邊看右側預覽，確認無誤再儲存。
三、相關功能
| 功能 | 說明 | 連結 |
|---|---|---|
| 自定義樣板 | 管理所有出貨單列印版面 | 前往 |
| 訂單列表 | 查看與列印訂單 | 前往 |