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

涉及页面

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

API

请求参数

批次追溯查询

点击流水列表中的批次号时，使用当前行的 batchCode 调用以下接口：

请求示例：GET /mes/pro/batch/get-by-code?code={batchCode}

接口返回的重点字段：

该接口同时支持正式批次号和临时批次码。若批次号为空，不显示点击入口；若查询不到生产批次，按接口返回的业务错误提示用户。

响应字段

响应示例

{
  "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": "操作成功"
}

业务类型说明

调用时序

1. 进入库存事务流水页面时，调用 /mes/wm/transaction/page 获取流水列表。
2. 列表中展示 batchCode；批次号非空时允许点击。
3. 点击批次号后，将当前行的 batchCode 作为 code 调用 /mes/pro/batch/get-by-code。
4. 根据返回结果展示生产批次信息、托盘列表和袋码列表；bagTotal 用于显示袋码总数，bags 用于展示袋码明细。

字段展示规则

搜索条件

列表字段展示

| 物料编码 | itemCode | 120 | - |
| 物料名称 | itemName | 150 | - |
| 批次号 | batchCode | 120 | 无批次时显示空 |
| 数量 | quantity | 100 | 正数显示绿色，负数显示红色 |
| 仓库 | warehouseName | 100 | - |
| 库区 | locationName | 100 | - |
| 库位 | areaName | 100 | - |
| 事务时间 | transactionTime | 160 | 格式：yyyy-MM-dd HH:mm:ss |
| 袋码 | bagCode | 150 | 袋码级流水的袋码；批次/袋码可继续追溯 |

业务规则说明

权限配置

注意事项

1. 流水记录为系统自动生成，页面不提供新增、编辑、删除按钮
2. 业务单号（bizCode）可作为跳转链接，点击跳转到对应业务单据
3. 搜索条件中的仓库、库区、库位存在联动关系：

• 选择仓库后，库区下拉只显示该仓库下的库区
• 选择库区后，库位下拉只显示该库区下的库位

1. 时间范围搜索默认可查询最近30天数据