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

## 涉及页面

- 库存事务流水列表页（新增页面，菜单路径：仓储物流 > 库存事务流水）

## 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 | 创建时间 |

### 响应示例

```json
{
  "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 | 查询库存事务流水 |

## 注意事项

1. 流水记录为系统自动生成，页面不提供新增、编辑、删除按钮
2. 业务单号（bizCode）可作为跳转链接，点击跳转到对应业务单据
3. 搜索条件中的仓库、库区、库位存在联动关系：
   - 选择仓库后，库区下拉只显示该仓库下的库区
   - 选择库区后，库位下拉只显示该库区下的库位
4. 时间范围搜索默认可查询最近30天数据