库存事务流水查询 - 前端联调方案
涉及页面
- 库存事务流水列表页（新增页面，菜单路径：仓储物流 > 库存事务流水）
API
| 方法 |
路径 |
说明 |
| GET |
/mes/wm/transaction/page |
分页查询库存事务流水 |
请求参数
| 参数 |
类型 |
必填 |
说明 |
| itemId |
Long |
否 |
物料ID |
| batchCode |
String |
否 |
批次号，模糊匹配 |
| warehouseId |
Long |
否 |
仓库ID |
| locationId |
Long |
否 |
库区ID |
| areaId |
Long |
否 |
库位ID |
| type |
Integer |
否 |
事务类型（1-入库 2-出库） |
| bizType |
Integer |
否 |
业务类型 |
| bizCode |
String |
否 |
业务单号，模糊匹配 |
| materialStockId |
Long |
否 |
库存记录ID |
| startTime |
String |
否 |
开始时间（格式：yyyy-MM-dd HH:mm:ss） |
| endTime |
String |
否 |
结束时间（格式：yyyy-MM-dd HH:mm:ss） |
| pageNo |
Integer |
是 |
页码，默认1 |
| pageSize |
Integer |
是 |
每页条数，默认10 |
响应字段
| 字段 |
类型 |
说明 |
| id |
Long |
编号 |
| type |
Integer |
事务类型（1-入库 2-出库） |
| typeName |
String |
事务类型名称（入库/出库） |
| bizType |
Integer |
业务类型编码 |
| bizTypeName |
String |
业务类型名称 |
| bizCode |
String |
业务单号 |
| itemId |
Long |
物料ID |
| itemCode |
String |
物料编码 |
| itemName |
String |
物料名称 |
| quantity |
BigDecimal |
变动数量（正数=入库，负数=出库） |
| batchId |
Long |
批次ID |
| batchCode |
String |
批次号 |
| warehouseId |
Long |
仓库ID |
| warehouseName |
String |
仓库名称 |
| locationId |
Long |
库区ID |
| locationName |
String |
库区名称 |
| areaId |
Long |
库位ID |
| areaName |
String |
库位名称 |
| transactionTime |
String |
事务发生时间 |
| createTime |
String |
创建时间 |
响应示例
{
"code": 0,
"data": {
"total": 50,
"list": [
{
"id": 1,
"type": 1,
"typeName": "入库",
"bizType": 126,
"bizTypeName": "自定义入库",
"bizCode": "STOCK_ADJUST_6",
"itemId": 2,
"itemCode": "M001",
"itemName": "螺丝",
"quantity": 100.00,
"batchId": 7,
"batchCode": "T8811",
"warehouseId": 1,
"warehouseName": "成品仓",
"locationId": 1,
"locationName": "A区",
"areaId": 1,
"areaName": "A-01-01",
"transactionTime": "2025-07-15 10:30:00",
"createTime": "2025-07-15 10:30:00"
}
]
},
"msg": "操作成功"
}
业务类型说明
| bizType |
bizTypeName |
说明 |
| 126 |
自定义入库 |
库存调整入库 |
| 127 |
自定义出库 |
库存调整出库 |
| 110 |
采购入库 |
采购入库单 |
| 119 |
销售出库 |
销售出库单 |
| 112 |
调拨出库 |
库存调拨出库 |
| 113 |
调拨入库 |
库存调拨入库 |
| 115 |
其他入库 |
其他入库单 |
| 114 |
其他出库 |
其他出库单 |
| 116 |
生产领料 |
生产领料单 |
| 117 |
生产退料 |
生产退料单 |
| 118 |
生产入库 |
生产入库单 |
| 123 |
生产消耗 |
生产报工消耗 |
| 124 |
产品产出 |
生产报工产出 |
| 125 |
供应商退货 |
供应商退货出库 |
| 120 |
销售退货 |
销售退货入库 |
| 121 |
外协发料 |
外协发料 |
| 122 |
外协入库 |
外协入库 |
搜索条件
| 条件字段 |
组件类型 |
说明 |
| 物料 |
物料选择弹窗 |
选择物料后带出 itemId |
| 批次号 |
Input 输入框 |
支持模糊搜索 |
| 仓库 |
下拉选择 |
选择仓库 |
| 库区 |
下拉选择 |
根据仓库联动加载 |
| 库位 |
下拉选择 |
根据库区联动加载 |
| 事务类型 |
下拉选择 |
选项：入库、出库 |
| 业务类型 |
下拉选择 |
选项见上表业务类型说明 |
| 业务单号 |
Input 输入框 |
支持模糊搜索 |
| 时间范围 |
DatePicker 日期范围 |
选择事务发生时间范围 |
列表字段展示
| 列名 |
字段 |
宽度 |
说明 |
| 事务类型 |
typeName |
80 |
入库显示绿色标签，出库显示红色标签 |
| 业务类型 |
bizTypeName |
100 |
业务类型名称 |
| 业务单号 |
bizCode |
150 |
可点击跳转到对应业务单据 |
| 物料编码 | itemCode | 120 | - |
| 物料名称 | itemName | 150 | - |
| 批次号 | batchCode | 120 | 无批次时显示空 |
| 数量 | quantity | 100 | 正数显示绿色，负数显示红色 |
| 仓库 | warehouseName | 100 | - |
| 库区 | locationName | 100 | - |
| 库位 | areaName | 100 | - |
| 事务时间 | transactionTime | 160 | 格式：yyyy-MM-dd HH:mm:ss |
业务规则说明
| 场景 |
规则 |
| 数据只读 |
流水记录由系统自动生成，不可人工新增、修改、删除 |
| 默认排序 |
按事务时间倒序排列 |
| 数量显示 |
quantity > 0 显示绿色，quantity < 0 显示红色 |
| 类型标签 |
入库显示绿色 success 标签，出库显示红色 danger 标签 |
| 业务单号跳转 |
点击 bizCode 可跳转到对应业务单据详情页 |
权限配置
| 权限标识 |
说明 |
| mes:wm-transaction:query |
查询库存事务流水 |
注意事项
- 流水记录为系统自动生成，页面不提供新增、编辑、删除按钮
- 业务单号（bizCode）可作为跳转链接，点击跳转到对应业务单据
- 搜索条件中的仓库、库区、库位存在联动关系：
- 选择仓库后，库区下拉只显示该仓库下的库区
- 选择库区后，库位下拉只显示该库区下的库位
- 时间范围搜索默认可查询最近30天数据
