MES 托盘码自动生成 - 前端联调方案

涉及页面

• 生产批次管理：新增/编辑批次时选择包装袋型。
• 袋码管理：生成袋码成功后接收自动托盘标签数据。
• 托盘码管理：查看自动生成托盘及其绑定袋数。
• 二维码打印区域：根据标签数据一次渲染同一托盘的 3 份标签并触发一次浏览器打印。

业务流程与数据带入

1. 创建或编辑批次时，必须选择包装袋型：小袋（值 10）或大袋（值 20）。小袋自动托盘阈值为 100 袋，大袋自动托盘阈值为 48 袋。
2. 批次进入生产中后，调用生成袋码接口。袋码的批次号、品种、产线、生产日期和责任人由批次自动带入。
3. 后端在同一事务中统计该批次有效袋码：未逻辑删除且状态不是已作废，并按袋序号升序取完整阈值组。
4. 每个完整阈值组自动创建一个托盘码，并将组内全部袋码写入同一托盘的托盘编号和托盘码。未达到完整阈值的余数袋码保持未绑定。
5. 自动托盘生成后，生成袋码接口响应中的 autoPallets 返回本次新建托盘标签数据。每个标签的 copies 固定为 3，表示同一托盘二维码打印 3 份，不是生成 3 个托盘。
6. 前端收到 autoPallets 后，为每个托盘标签渲染 3 个打印副本，并只调用一次浏览器打印。普通网页打印会打开浏览器打印流程，后端不返回静默打印成功状态。

API

1. 批次创建/更新

请求参数新增：

响应字段新增：

2. 生成袋码并自动生成托盘

请求参数：

响应 data：

autoPallets 字段：

响应示例：

{
  "code": 0,
  "data": {
    "uuid": "生成组UUID",
    "autoPallets": [
      {
        "id": 1001,
        "code": "PC20260821L01A001-P01",
        "batchId": 1024,
        "batchCode": "PC20260821L01A001",
        "palletNo": 1,
        "capacity": 100,
        "bagCount": 100,
        "copies": 3,
        "itemId": 2001,
        "itemCode": "ITEM001",
        "itemName": "产品A",
        "itemSpecification": "规格A",
        "lineCode": "L01",
        "lineName": "包装一线",
        "produceDate": "2026-08-21 08:00:00",
        "ownerUserId": 1,
        "ownerUserName": "张三"
      }
    ]
  }
}

字段展示规则

业务规则说明

注意事项

• 历史批次的 bagType 需要在启用自动托盘前补齐，不能由后端猜测。
• 只有生产中批次允许生成袋码和自动托盘。
• 普通浏览器无法绕过系统打印对话框；若要求无人值守打印，需要另行接入本地打印代理或打印控件。
• 不要把 ZIP 下载响应当作自动打印结果；现有 ZIP 接口继续用于批量导出。
• 自动托盘中的袋码完整关联以袋码记录的 palletId、palletCode 和托盘的 bagCount 为准。