32 lines
2.1 KiB
Markdown
32 lines
2.1 KiB
Markdown
# T04 一件代发国内托盘标
|
||
|
||
## 已确认口径
|
||
|
||
2026-09-20 用户确认：除箱唛使用 `100×100 mm` 外，托盘标均使用 A4；一件代发国内托盘标按参考样张使用 A4 纵向。
|
||
|
||
参考原稿：[一件代发国内托盘标.pdf](一件代发国内托盘标.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 打印比例与条码扫描仍待人工确认。
|