生产批次列表新增「托盘码」列 - 前端联调方案
涉及页面
- 批次生产管理 - 生产批次列表(
/mes/pro/batch)
API
| 方法 |
路径 |
说明 |
| GET |
/mes/pro/batch/page |
生产批次分页(响应新增托盘码列表) |
| GET |
/mes/pro/batch/get |
生产批次详情(响应同步新增托盘码列表) |
响应字段新增:
| 字段 |
类型 |
说明 |
| palletCodes |
String[] |
该批次下全部已生成的正式托盘码,按托盘序号升序;无托盘时为空数组 |
响应示例:
{
"code": 0,
"data": {
"list": [
{
"id": 1024,
"code": "2026001",
"itemName": "塔河4号",
"palletCodes": ["2026001-P001", "2026001-P002"]
}
],
"total": 1
}
}
字段展示规则
| 字段 |
展示位置 |
说明 |
| palletCodes |
生产批次列表 |
位于「批次号」列之后、「品种名称」列之前;多个托盘码用英文逗号连接展示,超长时悬浮提示完整内容 |
| palletCodes |
生产批次列表 |
无托盘码时展示 - |
业务规则说明
| 场景 |
规则 |
| 批次已绑定/生成托盘 |
返回该批次下所有正式托盘码(code 非空),按托盘序号升序 |
| 批次仅有临时托盘 |
临时托盘尚未生成正式托盘码,不返回 |
| 批次未绑定托盘(如吨袋批次) |
返回空数组,列表展示 - |
| 二维码预生成批次 |
未补录正式信息前无正式托盘码,返回空数组 |
注意事项
- 托盘码为批次下多值字段,前端以数组接收,展示层自行拼接,不要按单值处理。
- 查询为批量关联,列表分页每页仅增加一次托盘查询,无需前端额外请求。
- 详情接口返回的
palletCodes 与列表一致;完整的托盘信息仍通过详情中的 pallets 字段获取。
- Excel 导出未新增该列,若后续需要导出托盘码请另行确认格式。