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

# 现有打印清单与改版台账

盘点日期：2026-09-16。

证据范围：当前工作区代码、同目录 6 份 PDF 样张及 2 份 XLSX 样张。PDF 已提取尺寸与文字并渲染核对；XLSX 已读取工作表字段及打印设置，尚未核验 Excel 实际分页。本文记录代码现状与样张差异，不代表真实环境打印验收通过。

## 一、当前已有的打印能力

按业务用途计，当前已确认 8 类系统生成标签或单据，另有 1 类报表页面打印。不同入口可能共用一个模板，不能用模板数量代替业务类型数量。

| 编号 | 当前类型 | 主要入口 | 当前尺寸与方式 | 当前内容与说明 |
| --- | --- | --- | --- | --- |
| C01 | 头程箱唛 | Admin 订单批量打印、入库单；Client 头程订单 | 100×100 mm PDF | 单箱身份、仓库、箱序、线路、箱码二维码；一件代发还显示 SKU。重复打印复用稳定箱码 |
| C02 | 散货装柜托盘标 | 货柜详情、预装/装柜清单 | 100×100 mm PDF | 托盘码、目的 FBA 仓、托盘序号、集装箱号、二维码；支持全部打印或按 FBA 仓补打 |
| C03 | 一件代发托盘信息单 | Admin 订单“托盘打印”页签、入库历史 | A4 纵向 PDF | 托盘 Code 128 条码、目的仓、入仓码/客户昵称、SKU 与箱数/件数汇总；支持整票和单托补打 |
| C04 | 海外实体托盘标 | 海外仓托盘管理每行“打印” | 100×100 mm PDF | 当前托盘真实编码、FBA 仓码、海外仓名称、二维码；单张输出 |
| C05 | 退货箱唛及合箱后的新箱标 | Admin/Client 退货库存与箱号页面 | 100×150 mm HTML，浏览器打印 | 实物箱号、Code 128 条码、来源退货单、签收批次、箱规、SKU 与数量；这是箱级标签 |
| C06 | 出口货物托运单 | 海运订舱列表/详情“打印单据” | A4 PDF | 使用当前已保存订舱资料 |
| C07 | 提单确认件 | 海运订舱列表/详情“打印单据” | A4 PDF | 海运提单内容确认；与海外排车 BOL 分属不同业务 |
| C08 | 海外排车 BOL | 海外仓排车列表“打印 BOL” | A4 PDF | 发货仓、承运商、预约、车辆、目的仓与货物明细；当前按目的 FBA 仓分组分页 |
| C09 | 应收款统计报表 | 财务应收款统计“打印” | 浏览器页面打印 | 打印当前统计页面，没有独立 PDF 模板 |

另有外部文件打印需求：换标箱唛、SKU 标签、总标签及明细标签 PDF，以及客户上传的快递面单 PDF/图片。海外 PDA 换标页提供“查看 / 打印”入口；快递面单有上传及要求仓库打印的选项。文件上传、下载和查看能力不等于系统已实现相应模板生成或设备直连打印。

### 模板与实现关系

| 实现 | 当前消费者 |
| --- | --- |
| `INBOUND_MARK_V1` | C01 头程箱唛、C02 散货装柜托盘标、C04 海外实体托盘标 |
| `DROPSHIP_PALLET_A4_V2` | C03 一件代发托盘信息单 |
| `SEA_FREIGHT_SHIPPING_INSTRUCTION_A4_V1` | C06 出口货物托运单 |
| `BILL_OF_LADING_CONFIRMATION_A4_V1` | C07 海运提单确认件 |
| `DISPATCH_BILL_OF_LADING_A4_V2` | C08 海外排车 BOL |
| Lastleg 生成 HTML 与 SVG 条码 | C05 退货箱唛 |
| 前端 `window.print()` | C09 应收款统计 |

Print 当前是无状态 PDF 渲染服务，业务服务组装数据后调用，不连接打印机。当前实际代码包含 5 个 PDF 模板编码；Print 的 AGENTS.md 职责摘要只列出 4 个，遗漏排车 BOL，后续涉及模板指引修改时应同步核对。

## 二、本次提供的 8 份目标样张

以下“对应关系”和“待确认项”是盘点结论及建议，尚未确认新模板编码、最终字段或实现范围。状态统一为“待逐项确认，未实施”。

| 编号 | 目标类型与参考文件 | 样张观察 | 当前对应关系及主要待确认项 |
| --- | --- | --- | --- |
| T01 | [亚马逊托盘标](亚马逊托盘标.pdf) | 约 A4 横向；目的仓编号、大幅一维条码、托盘号 | 优先核对 C02/C04 的 FBA 托盘场景。确认国内和海外是否使用同一版式；“目的仓编号”取 FBA 仓码还是主档内部业务编号；条码是否只编码托盘号 |
| T02 | [私人仓托盘标](私人仓托盘标.pdf) | 约 A4 横向；`Private warehouse`、客户编号、一维条码、托盘号 | 当前 C04 为通用标签，未确认已有私人仓专用模板。确认打印对象、私人仓识别条件、客户编号来源及混客托盘处理 |
| T03 | [海外仓仓储托盘标](海外仓-仓储托盘标.pdf) | 约 A4 横向；`warehouse-c`、客户编号、一维条码、托盘号 | 需确认“仓储”与 FBA/私人仓/一件代发业务的边界；`warehouse-c` 是固定文案、业务类别还是动态仓名；客户字段及混客规则待确认 |
| T04 | [一件代发国内托盘标](一件代发国内托盘标.pdf) | A4 纵向；托盘条码/号、“一件代发仓”、入仓码/客户编号/总箱数/总件数及 SKU 明细 | 对应 C03。现有客户列为“客户昵称”，样张为“客户编号”；标题、字段来源、行数、超长与溢出规则需逐项对齐 |
| T05 | [退货托盘标](退货托盘标.pdf) | A4 横向；客户昵称、总件数、SKU/箱数/件数、托盘条码/号、入仓时间 | 不能直接对应 C05，C05 是退货箱唛。需核对退货库存到托盘的真实归属、按托汇总口径、入仓时间取值及打印入口 |
| T06 | [暂扣 HOLD](暂扣HOLD.pdf) | 约 A4 横向；页面只有大字 `HOLD`，没有业务编号或条码 | 当前盘点未确认独立 HOLD 打印入口。需确认国内/海外适用范围、是否通用空白标识、扣货后是否提示打印、解除后如何处理现场标识 |
| T07 | [FBA 仓 BOL](FBA仓-BOL.xlsx) | 发货方、承运商、收货方、参考信息、柜号/托盘号/FBA 仓编号/入仓码/FBA 货件编号/跟踪编号/箱数及合计 | 对应 C08 的 FBA 场景。样张备注要求随派送方式取承运商，部分字段留空；这些是待确认的填表规则，不能直接覆盖现有实现 |
| T08 | [私人仓 BOL](私人仓-BOL.xlsx) | 与 FBA BOL 类似；收货方为私人仓地址/联系人/联系方式，多列标注留空 | 当前 C08 主要按 FBA 仓分组；需核对私人仓业务打印入口、收货地址来源、承运商/自提文案、派送时间与分组口径 |

尺寸说明：6 份 PDF 均为单页。一件代发样张约 210×297 mm；其余约 297×210 mm，部分页面存在约 0.1 mm 的导出误差。最终纸张、边距和实际打印比例仍须逐项确认。两份 XLSX 保存的纸张设置均为 Letter、纵向，未设置打印区域，不能直接宣称其目标纸张已经确认为 A4。

BOL 样张字段定位：两份工作簿均在 `BOL_完整一键复制版` 工作表，`A2:G7` 为主要抬头及列标题；`E3` 包含承运商和时间填写说明，`A5` 为收货方说明，`E5` 为参考字段说明。示例业务行仅用于版式参考，不作为验收数据或业务规则。

## 三、改版前需要明确的共用关系

1. **业务类型与打印入口分别确认。** 亚马逊托盘标可能同时用于国内预装、装柜及海外补打；同一标签不能仅因入口不同就生成不同托盘身份。
2. **托盘标与箱唛分别处理。** 当前 100×100 mm 模板同时服务箱唛和两类托盘标。不能直接把共用模板改为 A4 横向，导致头程箱唛被一起改版；具体模板拆分在 T01 确认后落地。
3. **版式调整不自动改变编号规则。** 条码制式、编码内容和展示文字分别确认，继续使用服务端真实业务编号；若业务要求改变编号，应另行明确影响范围。
4. **客户编号、昵称与内部 ID 区分。** 样张要求客户编号时，应定位正式业务编号，不能拿数据库 ID 填充；多客户同托时需明确展示规则。
5. **退货托盘标需要托盘级事实。** 退货箱级库存与合箱标签不能直接当作托盘汇总来源；缺少的关系和接口先核实，再确定是否涉及业务能力调整。
6. **HOLD 纸面标识与扣货状态分开。** 打印动作本身不代表已完成扣货，解除状态也不等于现场标识已移除；具体提示和操作流程待确认。
7. **FBA BOL 与私人仓 BOL 分别确认。** 共享边框和渲染能力不代表收货地址、分组、承运商与字段留空规则相同。

## 四、建议逐项处理顺序

此顺序为建议，尚未作为用户确认的实施排期。

| 顺序 | 项目 | 排序理由 |
| --- | --- | --- |
| 1 | T01 亚马逊托盘标 | 字段少，已有国内和海外打印链路；先确认横向纸张、一维条码、目的仓含义和跨端复用，并处理与箱唛共用模板的问题 |
| 2 | T02 私人仓托盘标 | 沿用已确认的基础排版和条码能力，补齐私人仓识别与客户业务编号 |
| 3 | T03 海外仓仓储托盘标 | 接着确认仓储类别、标题及客户展示，避免三种托盘标混用 |
| 4 | T04 一件代发国内托盘标 | 已有独立 A4 模板；重点对齐客户编号、汇总字段、明细容量及分页 |
| 5 | T05 退货托盘标 | 涉及退货库存与托盘归属、SKU 汇总和入仓时间，数据确认范围更大 |
| 6 | T06 暂扣 HOLD | 版式简单，但需先确定打印入口与扣货/解除业务关系；若确认只是通用静态提示纸，可提前处理 |
| 7 | T07 FBA 仓 BOL | 托盘展示规则稳定后，处理承运商、预约、明细分组、合计和分页 |
| 8 | T08 私人仓 BOL | 在 BOL 共用版式明确后，处理私人地址、自提、时间和留空规则 |

现有头程箱唛、退货箱唛、出口货物托运单、海运提单确认件、应收统计和上传文件打印继续保留在总盘点中。本轮没有对应的新样张或逐项结论，不自动视为取消，也不自动纳入上述 8 项的实现变更。

## 五、第一项：亚马逊托盘标确认单

参考：[亚马逊托盘标.pdf](亚马逊托盘标.pdf)。

| 确认点 | 当前证据 | 待确认结论 |
| --- | --- | --- |
| 适用对象 | 当前有散货 FBA 装柜托盘与海外实体托盘打印 | 是否只覆盖 FBA；国内打印与海外补打是否完全一致 |
| 纸张与方向 | 样张约 A4 横向，当前实现为 100×100 mm | 是否统一改为 A4 横向；边距与打印比例 |
| 顶部“目的仓编号” | 样张未给具体值；当前系统同时存在 FBA 仓码和地址内部业务编号 | 应展示哪个正式业务字段 |
| 条码 | 样张为一维条码，当前通用模板为二维码 | 是否采用 Code 128；内容是否为完整托盘号；是否保留二维码 |
| 托盘号 | 现有服务端已冻结或保存真实托盘码 | 样式变更是否保持现有编号规则；不默认按样张改号 |
| 其余文字 | 样张仅保留目的仓编号、条码及托盘号 | 是否取消现有柜号、PALLET 序号、仓库名称和产地等额外文字 |
| 批量与补打 | 国内支持全部或按仓前 N 张；海外支持当前托盘单张 | 是否沿用，还是需要指定任意托盘或打印份数 |
| 验收 | 尚未生成新版样张 | 使用脱敏真实结构数据，检查长编号、不裁切、条码解码及人工实打 |

## 六、每项实施时记录的内容

每项确认后在本目录增加对应类型的详细记录，并从 README 链接。至少记录：

- 用户确认日期、用途、适用业务和最终样张。
- 打印入口、资格、单张/批量/补打、打印份数。
- 字段清单、权威来源、必填与缺失处理；不能用内部 ID 回退。
- 纸张、方向、边距、黑白效果、字体、条码制式与内容、行数及分页。
- 新旧模板影响、调用端、业务服务、Print 或 HTML 渲染的变更范围。
- 定向测试、PDF 尺寸/页数/字体/条码检查、脱敏输出及人工验收结果。
- 尚未通过的检查、待部署单元和下一步；未人工打印前明确记录“待人工实打确认”。

本次仅建立盘点和建议顺序，没有修改业务代码、原始样张、接口或运行环境。

## 七、代码定位入口

以下路径均相对工作区根目录；进入代码前先读取目标应用/服务最近的 AGENTS.md。

| 范围 | 入口 |
| --- | --- |
| PDF 模板与渲染 | `baiyue-firstleg/print/src/main/java/com/baiyue/print/renderer/`、`controller/InternalPdfController.java`、`dto/`；契约 `baiyue-firstleg/print/src/main/resources/openapi/print-internal-v1.yaml` |
| 箱唛与一件代发托盘数据 | `baiyue-firstleg/firstleg/src/main/java/com/baiyue/firstleg/service/InboundCartonLabelPrintService.java` |
| 国内散货托盘打印 | 同服务 `service/LoadingPalletLabelService.java`；前端 `apps/admin-web/src/modules/loading-lists/components/PalletLabelPrintDialog.vue` |
| 一件代发托盘入口 | `apps/admin-web/src/modules/inbounds/core/DropshipPalletPrintPanel.vue` |
| 海外实体托盘打印 | `baiyue-firstleg/warehouse-overseas-service/src/main/java/com/baiyue/warehouse/service/PalletLabelPrintService.java`；前端 `apps/admin-web/src/modules/overseas-warehouse/pages/PalletsView.vue` |
| 海外排车 BOL | `baiyue-firstleg/lastleg-service/src/main/java/com/baiyue/lastleg/dispatch/service/DispatchBolPrintService.java`；前端 `apps/admin-web/src/modules/overseas-warehouse/pages/DispatchesView.vue` |
| 退货箱唛 HTML | 同 Lastleg 服务 `returnreceipt/service/ReturnInventoryService.java`、`ReturnCartonBarcode.java`；Admin `ReturnInventoryManagementView.vue`、Client `ReturnInventoryView.vue` |
| 海运订舱单据 | `baiyue-firstleg/firstleg/src/main/java/com/baiyue/firstleg/oceanbooking/service/OceanBookingPrintService.java`；前端 `apps/admin-web/src/modules/ocean-bookings/components/OceanBookingPrintDialog.vue` |
| 应收统计页面打印 | `apps/admin-web/src/modules/finance/pages/FinanceReceivableStatisticsView.vue` |