库存事务流水 - 前端联调方案

涉及页面

库存事务流水列表页面（新增）

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	否	业务类型（126-自定义入库 127-自定义出库等）
bizCode	String	否	业务单号，模糊匹配
materialStockId	Long	否	库存记录ID
startTime	LocalDateTime	否	开始时间
endTime	LocalDateTime	否	结束时间
pageNo	Integer	是	页码（继承自 PageParam）
pageSize	Integer	是	每页条数（继承自 PageParam）

响应字段

字段	类型	说明
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	LocalDateTime	事务发生时间
createTime	LocalDateTime	创建时间

响应示例

{
  "code": 0,
  "data": {
    "total": 100,
    "list": [
      {
        "id": 1,
        "type": 1,
        "typeName": "入库",
        "bizType": 126,
        "bizTypeName": "自定义入库",
        "bizCode": "STOCK_ADJUST_6",
        "itemId": 2,
        "itemCode": "ITEM001",
        "itemName": "螺丝",
        "quantity": 100,
        "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": "操作成功"
}

字段展示规则

字段	展示位置	说明
typeName	列表、详情	事务类型名称，使用标签展示（入库=绿色，出库=红色）
bizTypeName	列表、详情	业务类型名称
bizCode	列表、详情	业务单号，可点击跳转到对应业务单据
itemCode	列表	物料编码
itemName	列表	物料名称
quantity	列表	变动数量，正数显示绿色，负数显示红色
batchCode	列表	批次号
warehouseName	列表	仓库名称
locationName	列表	库区名称
areaName	列表	库位名称
transactionTime	列表	事务发生时间，作为默认排序字段

搜索条件

条件	组件	说明
物料	物料选择器	选择物料后查询
批次号	Input	模糊匹配
仓库	下拉选择	选择仓库
库区	下拉选择	根据仓库联动
库位	下拉选择	根据库区联动
事务类型	下拉选择	入库/出库
业务类型	下拉选择	自定义入库/自定义出库等
业务单号	Input	模糊匹配
时间范围	DatePicker	事务发生时间范围

业务规则说明

场景	规则
数据来源	库存事务流水由系统自动生成，不可人工创建、修改、删除
排序	默认按事务发生时间倒序排列
权限	需要 `mes:wm-transaction:query` 权限

注意事项

流水记录只读，不允许新增、修改、删除
quantity 字段正数表示入库，负数表示出库，前端展示时可根据符号显示不同颜色
bizCode 可作为跳转链接，点击后跳转到对应的业务单据详情页
业务类型较多，下拉选择框建议按使用频率排序（自定义入库、自定义出库放前面）