docs/打印标签维护/T04-一件代发国内托盘标.md

T04 一件代发国内托盘标

已确认口径

2026-09-20 用户确认：除箱唛使用 100×100 mm 外，托盘标均使用 A4；一件代发国内托盘标按参考样张使用 A4 纵向。

参考原稿：一件代发国内托盘标.pdf。

项目	实现口径
纸张	210×297 mm，A4 纵向，黑白
打印对象	一件代发已预生成的真实托盘；不临时生成或改写托盘码
托盘身份	完整托盘码同时作为 Code 128 内容和可见文字
明细	展示当前托盘关联的入仓码、客户、箱数、件数及 SKU 汇总
打印入口	Admin 入库单托盘打印页签支持整票打印；单托支持补打
多页规则	单托超过 10 行入仓码或 34 行 SKU 时自动续页；每页重复完整托盘码、条码和目的仓，不因明细超量阻断打印
箱唛边界	一件代发箱唛仍使用独立 100×100 mm 箱唛模板，且不展示 SKU；不得复用托盘 A4 模板

实现范围

• Firstleg 按真实托盘归属组装 DROPSHIP_PALLET_A4_V2 数据；整票打印输出一个多页 PDF。
• Print 保持每个文档一张 A4；Firstleg 在调用前按模板容量拆页，避免超过单页容量时整次打印失败。
• 续页保留入仓码上下文。若 SKU 页数多于入仓码页数，续页重复首批入仓码摘要，确保 Print 契约要求的入仓信息不为空。
• Print 请求体大小保护覆盖一件代发托盘 A4 内部接口。
• 当前客户列沿用系统客户昵称。参考样张中的“客户编号”尚未确认权威字段，不使用数据库 ID 回填。

验证与部署

• Firstleg InboundCartonLabelPrintServiceTest 9 项通过，覆盖单托、整票和 35 行 SKU 自动拆成两页。
• Print InternalPdfControllerTest、PrintRequestSizeFilterTest、DropshipPalletA4PdfServiceGenerationTest 共 19 项通过，覆盖 A4 尺寸、PDF 响应和请求大小门禁。
• 待发布 firstleg-service 与 print-service 后，从真实 Admin 页面分别验证整票打印和单托补打；实际 A4 打印比例与条码扫描仍待人工确认。