# 库存现有量/库存事务流水 规格与类别字段 - 前端联调方案 ## 涉及页面 - 库存现有量(`src/views/wls/materialstock`) - 库存现有量选择弹窗(物料库存选择,`useSelectGridColumns`) - 库存事务流水(`src/views/wls/transaction`) ## 业务流程与数据带入 1. 库存现有量列表:物料主数据的 `specification`(规格型号)展示为“规格”列;物料所属 MDM 分类名称展示为“类别”列。 2. 库存事务流水列表:在原有物料编码、物料名称之后,补充“规格”和“类别”两列,数据同样来自物料主数据。 ## API | 方法 | 路径 | 说明 | |------|------|------| | GET | /mes/wm/material-stock/page | 库存现有量分页 | | GET | /mes/wm/material-stock/get | 库存现有量详情 | | GET | /mes/wm/material-stock/picking-list | 销售出库按行查询合格库存 | | GET | /mes/wm/transaction/page | 库存事务流水分页 | ### 响应字段新增 **`MesWmMaterialStockRespVO`:** | 字段 | 类型 | 说明 | |------|------|------| | itemTypeName | String | 物料类别名称(MDM 物料分类名称) | 原字段 `specification`(规格型号)继续保留,由前端用于“规格”列展示。 **`MesWmTransactionRespVO`:** | 字段 | 类型 | 说明 | |------|------|------| | specification | String | 规格型号(品种未维护时回退 MES 物料规格型号) | | itemTypeName | String | 物料类别名称(优先 MDM 物料分类,其次 MES 物料分类) | | palletCode | String | 托盘码(销售出库取销售明细托盘,其余流水回退取袋码当前绑定托盘) | | shipmentId | Number | 发货单编号 | **响应示例:** ```json { "code": 0, "data": { "itemCode": "M001", "itemName": "钢板", "specification": "10mm*100mm", "itemTypeName": "五金配件" } } ``` ## 字段展示规则 | 字段 | 展示位置 | 说明 | |------|----------|------| | itemTypeName | 库存现有量列表、选择弹窗、事务流水列表 | 列名“类别” | | specification | 库存现有量列表、选择弹窗、事务流水列表 | 列名“规格” | | palletCode | 事务流水列表 | 列名“托盘码” | **列顺序:** - 库存事务流水:事务类型 → 业务类型 → 物料编码 → 物料名称 → 规格 → 类别 → 业务单号 → 批次号 → 托盘码 → 袋码 → 数量 → 仓库 → 事务时间。 - 库存现有量:产品物料编码 → 产品物料名称 → 规格 → 类别 → 库存状态 → 数量列… - 库存现有量选择弹窗:产品物料编码 → 产品物料名称 → 规格 → 类别 → 入库批次号… ## 业务规则说明 | 场景 | 规则 | |------|------| | 类别名称来源 | 优先按物料主数据的 `categoryId` 查询 MDM 物料分类;未维护分类时回退查 MES 物料(`mes_md_item.mdm_item_id`)的物料分类(`mes_md_item_type.name`) | | 规格来源 | 优先取物料主数据的 `specification`;为空时回退取 MES 物料的 `specification` | | 托盘码来源 | 销售出库流水按“销售单+袋码+发货单”匹配销售明细中的托盘;其他流水(质检、生产入库等)取袋码当前绑定的托盘码 | | 物料缺失 | 物料信息不存在时,规格与类别返回空 | | 分类缺失 | 物料未维护分类或分类已删除时,类别返回空 | | 数据维护入口 | 规格型号在“品种管理”或“MES 物料”维护;MDM 分类需在 `/mdm/category` 维护,MES 物料分类在“MES 物料分类”维护 | ## 注意事项 - 库存现有量页面原有的“单位”列已替换为“规格”,“规格型号”列已替换为“类别”,不再展示计量单位。 - 物料名称、规格、类别三列需相邻展示,并整体前移;库存事务流水前移到业务单号之前,库存现有量前移到库存状态之前。 - Excel 导出中新增“类别”列,原有“规格型号”“计量单位”列保持不变。