打印标签维护/README.md

@@ -6,6 +6,8 @@
 
 ## 文档入口
 
+- [头程箱唛 SKU 展示修正](头程箱唛-SKU展示修正.md)：普通及一件代发头程箱唛均不显示 SKU，一件代发 A4 保留 SKU 明细。
+
 - [现有打印清单与改版台账](现有打印清单与改版台账.md)：现有能力、8 份目标样张、差异、建议顺序及逐项确认记录。
 - [T01 亚马逊托盘标](T01-亚马逊托盘标.md)：顶部 FBA 仓码、完整托盘内部编号、国内/海外统一横向 A4 打印口径及实现范围。
 

打印标签维护/头程箱唛-SKU展示修正.md

@@ -0,0 +1,21 @@
+# 头程箱唛 SKU 展示修正
+
+2026-09-20 用户确认：头程箱唛没有 SKU，SKU 只在一件代发 A4 托盘信息单中展示。本次覆盖普通订单和一件代发订单的头程箱唛，退货标签按其独立业务记录处理。
+
+## 原因与修正
+
+旧箱唛模板 `INBOUND_MARK_V1` 在收到 `skuCode` 时额外绘制 SKU 行。该行位于距页面顶部约 55 mm，落在二维码约 48.7–84 mm 的区域内，造成截图中的文字与二维码重叠。
+
+- 删除箱唛 SKU 绘制逻辑，并从 Print 箱唛 DTO、校验及 OpenAPI 中删除 `skuCode`。
+- Firstleg 箱唛打印调用不再发送 SKU，后台、客户端、单票及批量打印共用这条映射。
+- 一件代发 A4 的 SKU 明细、箱内 SKU 快照和 PDA 清点/组托数据保持原有业务含义。
+- 箱唛继续为 100×100 mm，展示入仓码、仓库、箱序、线路、二维码、稳定箱码文字和产地；二维码内容不变。
+- 本次为去除错误展示与遮挡的修正，沿用现有箱唛接口和模板标识，没有新旧版并行。
+
+## 验证与发布
+
+回归覆盖：含 SKU 的业务标签不会把 SKU 发送至 Print；生成 PDF 不含 SKU；二维码反向解码、页数、尺寸、字体与页序；一件代发 A4 仍含 SKU 明细。
+
+2026-09-20 离线验证通过：Print 模块测试 63 项中 62 通过、1 项可选最大容量测试跳过；Firstleg 箱唛/一件代发打印定向测试 8 项通过；Mapper 合同、Gateway 路由合同（5 项）、AGENTS 索引合同（1071 项）均通过。已使用实际 Print 渲染代码生成脱敏箱唛并目检，SKU 消失且二维码无文字遮挡。样张为工作区 `output/pdf/carton-label-no-sku.pdf`，属于可重新生成的验收产物。
+
+发布单元：`print-service` 和 `firstleg-service`。无需改数据库、前端或 Gateway 路由。本轮只做本地修改和离线验证，不部署、不执行真实 HTTP。旧 PDF 不会自动更新，部署后需重新下载箱唛；人工实打及 PDA 扫码待确认。

打印标签维护/现有打印清单与改版台账.md

@@ -2,6 +2,8 @@
 
 盘点日期：2026-09-16。
 
+2026-09-20 修正：[头程箱唛 SKU 展示修正](头程箱唛-SKU展示修正.md)。所有头程箱唛均不显示 SKU，一件代发 A4 保留 SKU；下文盘点基线中关于箱唛展示 SKU 的描述已被该结论取代。
+
 后续变更：T01 已确认顶部 SCK8、托盘号保留 141 等内部业务编号、国内/海外统一打印，详见 [T01 亚马逊托盘标](T01-亚马逊托盘标.md)。下文“当前已有”及差异表保留改版前盘点基线；实施结论以该详细记录为准。
 
 证据范围：当前工作区代码、同目录 6 份 PDF 样张及 2 份 XLSX 样张。PDF 已提取尺寸与文字并渲染核对；XLSX 已读取工作表字段及打印设置，尚未核验 Excel 实际分页。本文记录代码现状与样张差异，不代表真实环境打印验收通过。