/bagcode/scan-in)扫码事件的「追溯码」是实际扫描到的码值,按扫码类型不同可能是袋码、托盘码或批次码,单看该列无法区分托盘与批次。本次在响应中补充托盘码,使列表可以同时展示「托盘码」与「批次码」。
| 扫码类型 | 追溯码(bagCode) | 托盘码(palletCode) | 批次码(batchCode) |
|---|---|---|---|
| 袋码 BAG | 扫描的袋码/业务码 | 该袋所属托盘码 | 袋所属批次号 |
| 托盘码 PALLET | 扫描的托盘码/业务码/临时码 | 托盘正式码(无正式码时回退临时码) | 托盘所属批次号 |
| 批次码 BATCH | 扫描的批次码 | 空(整批可能跨多个托盘,不归属单一托盘) | 批次号 |
托盘码为读取时实时反查得出:
| 方法 | 路径 | 说明 |
|---|---|---|
| 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
}
}
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /mes/pro/scan-in/latest |
最新扫码事件(权限 mes:pro-scan-in:query) |
| GET | /mes/pro/scan-in/dashboard |
扫码看板(data.latest 同样包含新字段) |
/mes/pro/scan-in/my-page、/mes/pro/scan-in/my-event、/mes/pro/scan-in/inbound 返回结构一致,均包含 palletId、palletCode。
| 字段 | 展示位置 | 说明 |
|---|---|---|
| bagCode | 列表 | 保留原有「追溯码」列,展示实际扫描码值 |
| palletCode | 列表 | 新增「托盘码」列,空值显示 - |
| batchCode | 列表 | 列名由「生产批次」调整为「批次码」,空值显示 - |
palletCode 为空属正常现象,前端显示 - 即可。