| | |
|---|
| | | | 方法 | 路径 | 说明 | |
|---|
| | | |------|------|------| |
|---|
| | | | GET | /mes/wm/transaction/page | 分页查询库存事务流水 | |
|---|
| | | | GET | /mes/pro/batch/get-by-code | 点击批次号查询生产批次、托盘及袋码信息 | |
|---|
| | | |
|---|
| | | ### 请求参数 |
|---|
| | | |
|---|
| | |
|---|
| | | | bizType | Integer | 否 | 业务类型 | |
|---|
| | | | bizCode | String | 否 | 业务单号，模糊匹配 | |
|---|
| | | | materialStockId | Long | 否 | 库存记录ID | |
|---|
| | | | bagCode | String | 否 | 袋码，模糊匹配（质检、销售出库等袋码级流水） | |
|---|
| | | | startTime | String | 否 | 开始时间（格式：yyyy-MM-dd HH:mm:ss） | |
|---|
| | | | endTime | String | 否 | 结束时间（格式：yyyy-MM-dd HH:mm:ss） | |
|---|
| | | | pageNo | Integer | 是 | 页码，默认1 | |
|---|
| | | | pageSize | Integer | 是 | 每页条数，默认10 | |
|---|
| | | |
|---|
| | | ### 批次追溯查询 |
|---|
| | | |
|---|
| | | 点击流水列表中的批次号时，使用当前行的 `batchCode` 调用以下接口： |
|---|
| | | |
|---|
| | | | 参数 | 类型 | 必填 | 说明 | |
|---|
| | | |------|------|------|------| |
|---|
| | | | code | String | 是 | 批次号或批次二维码内容 | |
|---|
| | | |
|---|
| | | 请求示例：`GET /mes/pro/batch/get-by-code?code={batchCode}` |
|---|
| | | |
|---|
| | | 接口返回的重点字段： |
|---|
| | | |
|---|
| | | | 字段 | 类型 | 说明 | |
|---|
| | | |------|------|------| |
|---|
| | | | id | Long | 生产批次ID | |
|---|
| | | | code | String | 正式批次号 | |
|---|
| | | | tempCode | String | 临时批次码 | |
|---|
| | | | itemCode | String | 物料编码 | |
|---|
| | | | itemName | String | 物料名称 | |
|---|
| | | | workers | Array | 批次人员配置 | |
|---|
| | | | pallets | Array | 批次下的托盘列表 | |
|---|
| | | | bagTotal | Integer | 袋码总数 | |
|---|
| | | | bags | Array | 批次下的袋码列表 | |
|---|
| | | |
|---|
| | | 该接口同时支持正式批次号和临时批次码。若批次号为空，不显示点击入口；若查询不到生产批次，按接口返回的业务错误提示用户。 |
|---|
| | | |
|---|
| | | ### 响应字段 |
|---|
| | | |
|---|
| | |
|---|
| | | | quantity | BigDecimal | 变动数量（正数=入库，负数=出库） | |
|---|
| | | | batchId | Long | 批次ID | |
|---|
| | | | batchCode | String | 批次号 | |
|---|
| | | | bagCodeId | Long | 袋码ID（袋码级流水非空） | |
|---|
| | | | bagCode | String | 袋码（袋码级流水非空，如质检、销售出库、移库） | |
|---|
| | | | warehouseId | Long | 仓库ID | |
|---|
| | | | warehouseName | String | 仓库名称 | |
|---|
| | | | locationId | Long | 库区ID | |
|---|
| | |
|---|
| | | | 121 | 外协发料 | 外协发料 | |
|---|
| | | | 122 | 外协入库 | 外协入库 | |
|---|
| | | |
|---|
| | | ## 调用时序 |
|---|
| | | |
|---|
| | | 1. 进入库存事务流水页面时，调用 `/mes/wm/transaction/page` 获取流水列表。 |
|---|
| | | 2. 列表中展示 `batchCode`；批次号非空时允许点击。 |
|---|
| | | 3. 点击批次号后，将当前行的 `batchCode` 作为 `code` 调用 `/mes/pro/batch/get-by-code`。 |
|---|
| | | 4. 根据返回结果展示生产批次信息、托盘列表和袋码列表；`bagTotal` 用于显示袋码总数，`bags` 用于展示袋码明细。 |
|---|
| | | |
|---|
| | | ## 字段展示规则 |
|---|
| | | |
|---|
| | | | 字段 | 展示位置 | 说明 | |
|---|
| | | |------|----------|------| |
|---|
| | | | batchCode | 库存流水列表 | 批次号非空时作为可点击入口 | |
|---|
| | | | code | 批次详情 | 正式批次号 | |
|---|
| | | | tempCode | 批次详情 | 临时批次码，有值时展示 | |
|---|
| | | | bagTotal | 批次详情 | 展示该批次袋码总数 | |
|---|
| | | | bags[].code | 批次详情 | 展示袋码明细 | |
|---|
| | | | pallets | 批次详情 | 展示该批次关联的托盘信息 | |
|---|
| | | |
|---|
| | | ## 搜索条件 |
|---|
| | | |
|---|
| | | | 条件字段 | 组件类型 | 说明 | |
|---|
| | |
|---|
| | | | 库区 | locationName | 100 | - | |
|---|
| | | | 库位 | areaName | 100 | - | |
|---|
| | | | 事务时间 | transactionTime | 160 | 格式：yyyy-MM-dd HH:mm:ss | |
|---|
| | | | 袋码 | bagCode | 150 | 袋码级流水的袋码；批次/袋码可继续追溯 | |
|---|
| | | |
|---|
| | | ## 业务规则说明 |
|---|
| | | |
|---|
| | |
|---|
| | | | 数量显示 | quantity > 0 显示绿色，quantity < 0 显示红色 | |
|---|
| | | | 类型标签 | 入库显示绿色 success 标签，出库显示红色 danger 标签 | |
|---|
| | | | 业务单号跳转 | 点击 bizCode 可跳转到对应业务单据详情页 | |
|---|
| | | | 袋码筛选 | 传 bagCode 可查看指定袋码的完整流转（质检暂存出库/合格入库/销售出库等） | |
|---|
| | | |
|---|
| | | ## 权限配置 |
|---|
| | | |
|---|
