diff --git a/打印标签维护/README.md b/打印标签维护/README.md index 652d3d0..32b7022 100644 --- a/打印标签维护/README.md +++ b/打印标签维护/README.md @@ -6,6 +6,8 @@ ## 文档入口 +- [头程箱唛 SKU 展示修正](头程箱唛-SKU展示修正.md):普通及一件代发头程箱唛均不显示 SKU,一件代发 A4 保留 SKU 明细。 + - [现有打印清单与改版台账](现有打印清单与改版台账.md):现有能力、8 份目标样张、差异、建议顺序及逐项确认记录。 - [T01 亚马逊托盘标](T01-亚马逊托盘标.md):顶部 FBA 仓码、完整托盘内部编号、国内/海外统一横向 A4 打印口径及实现范围。 diff --git a/打印标签维护/头程箱唛-SKU展示修正.md b/打印标签维护/头程箱唛-SKU展示修正.md new file mode 100644 index 0000000..910092f --- /dev/null +++ b/打印标签维护/头程箱唛-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 扫码待确认。 diff --git a/打印标签维护/现有打印清单与改版台账.md b/打印标签维护/现有打印清单与改版台账.md index af59cae..6c65723 100644 --- a/打印标签维护/现有打印清单与改版台账.md +++ b/打印标签维护/现有打印清单与改版台账.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 实际分页。本文记录代码现状与样张差异,不代表真实环境打印验收通过。