编辑 | blame | 历史 | 原始文档

扫码事件同时展示托盘码与批次码 - 前端联调方案

涉及页面

  • MES / 一袋一码管理 / 生产线扫码入库(/bagcode/scan-in)
  • MES / 扫码事件查询页(如展示扫码事件列表,可选同步)

业务说明

扫码事件的「追溯码」是实际扫描到的码值,按扫码类型不同可能是袋码、托盘码或批次码,单看该列无法区分托盘与批次。本次在响应中补充托盘码,使列表可以同时展示「托盘码」与「批次码」。

扫码类型 追溯码(bagCode) 托盘码(palletCode) 批次码(batchCode)
袋码 BAG 扫描的袋码/业务码 该袋所属托盘码 袋所属批次号
托盘码 PALLET 扫描的托盘码/业务码/临时码 托盘正式码(无正式码时回退临时码) 托盘所属批次号
批次码 BATCH 扫描的批次码 空(整批可能跨多个托盘,不归属单一托盘) 批次号

托盘码为读取时实时反查得出:

  • 托盘码事件按扫码内容反查托盘(兼容业务码、正式托盘码、临时托盘码);
  • 袋码事件按袋码编号或码值反查袋码,再取其所属托盘;
  • 因此历史扫码事件同样能展示托盘码,无需数据迁移。

API

1. 扫码事件分页

方法 路径 说明
GET /mes/pro/scan-in/page 扫码事件分页(权限 mes:pro-scan-in:query)

响应字段新增(data.list[]):

字段 类型 说明
palletId Long 托盘编号,无法归属托盘时为空
palletCode String 托盘码,无法归属托盘时为空(批次扫码固定为空)

响应示例:

{
  "code": 0,
  "data": {
    "list": [
      {
        "id": 20,
        "bagCode": "3508118133307512",
        "scanType": "PALLET",
        "palletId": 13708,
        "palletCode": "3508118133307512",
        "batchCode": "2026002",
        "status": "SUCCESS"
      }
    ],
    "total": 1
  }
}

2. 最新扫码事件 / 看板

方法 路径 说明
GET /mes/pro/scan-in/latest 最新扫码事件(权限 mes:pro-scan-in:query)
GET /mes/pro/scan-in/dashboard 扫码看板(data.latest 同样包含新字段)

3. 其他返回扫码事件的接口

/mes/pro/scan-in/my-page、/mes/pro/scan-in/my-event、/mes/pro/scan-in/inbound 返回结构一致,均包含 palletId、palletCode。

字段展示规则

字段 展示位置 说明
bagCode 列表 保留原有「追溯码」列,展示实际扫描码值
palletCode 列表 新增「托盘码」列,空值显示 -
batchCode 列表 列名由「生产批次」调整为「批次码」,空值显示 -

注意事项

  • 批次码扫码事件不归属单一托盘,palletCode 为空属正常现象,前端显示 - 即可。
  • 托盘码为实时反查结果,若托盘被逻辑删除,历史事件可能展示为空。
  • 本改动不涉及数据库表结构变更,无需执行 SQL 脚本。