UCC 标签模板：创建与预览 UCC 发货标签

把每个零售商的 SSCC 托盘/纸箱标签版式做成 ZPL 模板集中放在一个库里：按约定命名、编辑时实时预览、用样例数据试渲染，打印时按零售商和标签类型自动匹配模板。

零售商不接受「差不多」的发货标签：每家的 SSCC 托盘标签和纸箱标签都有自己的版式要求。Docklify 把这些版式做成模板，集中放在 WMS → 设置 → 打印模板（/wms/templates）。一个模板就是一段 ZPL（标签打印机的语言），真实值的位置用 [[SSCC]] 这类占位符留着；打印时 Docklify 从单据里取值填进去，并自动挑对模板。同一个库里还管 Packing List 模板——用页面顶部的标签页在「UCC 标签 / Packing List」之间切换。

命名与自动匹配约定（先看这一节）#

• 命名格式：retailer-size-kind-Vn——例如 walmart-4x6-pallet-V1；Packing List 例如 default-8.5x11-V1。名字只能用小写字母、数字和连字符，且全局唯一。
• 打印时自动匹配：按「零售商 + 标签类型（托盘/纸箱）」查启用的 UCC 模板；同组有多个时取版本最大的。没有零售商的订单（B2C）不走 UCC 标签。
• [[SSCC]] 这类占位符在打印时替换成真实值。修改模板的 ZPL 并保存，版本会自动 +1。
• Amazon FBA 没有 UCC 要求——它用自有标签体系——不要给它建 UCC 模板；有要求的是 Amazon Vendor/DC。在表单里选到无 UCC 要求的零售商时，页面会当场提醒您。

第一步：新建模板#

1. 打开 WMS → UCC 标签模板，点「新建模板」。
2. 选模板类别：UCC 标签或 Packing List。
3. 选择这个模板属于哪个零售商，填尺寸（如 4x6）；UCC 模板还要选标签类型：托盘或纸箱（必填）。
4. 模板名让它自己拼：您在选零售商、尺寸和类型时，表单会按约定自动拼出名字（retailer-size-kind-V1）。保存前也可以手改，但要保持这个格式。
5. 在编辑器里编写或粘贴 ZPL 源码，每张标签会变的值用占位符（见下方清单）。保持「启用」勾选，打印时才能匹配到这个模板；最后点「保存」。

输入的同时，编辑器下方的实时预览会用样例值把占位符填上并渲染出标签效果——改一处、看一处，不用真打印一张测试标签。编辑器加实时预览的这个独立页面，是在 WMS → UCC 标签模板里把字段位置调准的最快办法。

ZPL 里可以用的占位符#

• [[SSCC]]——SSCC-18 编码，含 GS1 校验位。
• 单据与目的地：[[ORDER_NO]] 出库单号、[[PO_NO]] 零售商 PO 号、[[RETAILER]] 零售商名称、[[CARRIER]] 承运商、[[SHIP_DATE]] 发货日期。
• 收货地址：[[SHIP_TO_NAME]]、[[SHIP_TO_ADDRESS]]、[[SHIP_TO_CITY]]、[[SHIP_TO_STATE]]、[[SHIP_TO_ZIP]]。
• 内容与序号：[[ITEM_SKU]]、[[ITEM_NAME]]、[[QTY]]，以及纸箱序号 [[CARTON_SEQ]] 和托盘序号 [[PALLET_SEQ]]。

第二步：正式打印前先用样例数据预览#

1. 在模板列表里点开模板（每个模板有自己的页面），找到「样例数据预览」区。
2. 预览面板会把 ZPL 里找到的每个占位符列成一个输入框，并预填好样例值（包括校验位正确的样例 SSCC）。想测哪个值就改哪个。
3. 点「渲染预览」。您会看到按模板尺寸渲染出的标签图、仍然没被替换的占位符清单，以及「替换后 ZPL」里替换完成的完整源码——打印机实际会收到什么，一清二楚。

如果未替换清单不为空，说明 ZPL 里有个占位符没有值可填——先把名字改对（占位符是精确匹配、含双括号），或确认打印流程会提供这个字段，再让模板给真实订单用。

第三步：维护模板库——克隆、停用、重新启用#

• 克隆（在模板页点「克隆」）：打开新建页并把整个模板复制进去（名字加「-copy」后缀，版本从 1 重新开始）。零售商要变体版式时用克隆——正在用的原件不要动。
• 内置模板是只读的：可以预览和克隆，不能编辑也不能停用。想改内置版式，就克隆一份再改副本。
• 在模板页点「停用」，模板不再被打印匹配到，但不删除；点「启用」即可恢复。勾上「显示停用」，再配合零售商/标签类型筛选和模板名搜索，模板多了也管得过来。
• 列表显示每个模板的名字、零售商、类型、尺寸、版本、状态和更新时间——整理时盯住版本：同一「零售商 + 类型」组里，打印时只用启用的最高版本。
• 版本历史：每次保存都会在模板页留一份快照——打开「版本历史」可查看任一历史版本当时的样子；改坏了想回退，就把某个历史版本克隆成新模板。

查看每个 Retailer 实际会用哪张模板#

不用在模板库里猜某个 Retailer 最后会用哪张模板。打开 WMS → 零售商：列表里有两列状态（UCC 模板 / Packing List 模板），把每个零售商标为「专属 / 默认标准 / 无 / 无要求」。打开某个零售商的编辑页，「关联模板」区会展示三个槽位——UCC 托盘、UCC 纸箱和 Packing List——每张都用同一套样例数据渲染出来，实际会打印的标签长什么样一目了然。维护零售商档案时，Docklify 就在同一页把关联模板摆给您看。

• 标为「默认（标准模板）」的槽位表示该零售商没有专属模板，打印时回落到共用的标准版；在同一张卡上就能新建专属模板，或把标准版克隆为专属。
• 槽位显示「暂无可用模板」时，要看槽位类型：Packing List 在建好模板之前无法打印；UCC 标签会回落到系统内置版式——两种情况卡上都有直达新建的入口。没有 UCC 要求的零售商（如 Amazon FBA）的 UCC 槽位显示「无 UCC 要求」，不渲染预览。
• 零售商页面只做展示和跳转——改模板内容、改模板归属，永远在模板自己的页面上做，保证只有一个改动入口。

本文用到的 Docklify 功能#

• WMS → UCC 标签模板（/wms/templates）：模板库，含 UCC/Packing List 标签页、零售商与标签类型筛选、模板名搜索和显示停用开关
• ZPL 编辑器 + 实时预览：改源码的同时看标签用样例值渲染的效果
• 样例数据预览：渲染模板、列出未替换占位符、查看替换后 ZPL，确认无误再打印
• 打印时自动匹配：按零售商 + 标签类型匹配启用的 UCC 模板，同组取最高版本
• 克隆 / 停用 / 重新启用：做变体与管理模板生命周期，不用删模板
• Retailer 关联模板：零售商列表的状态列与每个零售商编辑页的预览卡，全部深链到模板自己的页面
• 版本历史：每次保存留一份快照，可在模板页查看与克隆