编辑 | blame | 历史 | 原始文档

生成退料请求单接口

接口信息

  • 接口地址: /api/MesInvItemStocks/CreateReturnMaterialRequest
  • 请求方式: POST
  • 接口说明: 根据物料条码生成退料请求单,调用立库系统取料任务接口

请求参数

Content-Type: application/json

请求体结构:
json { "userCode": "string", "itemBarcodes": ["string"] }

参数说明:
| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| userCode | string | 是 | 用户编码 |
| itemBarcodes | array[string] | 是 | 物料条码集合 |

请求示例

{
  "userCode": "USER001",
  "itemBarcodes": ["BC20231121001", "BC20231121002"]
}

响应参数

响应体结构:
json { "status": 0, "message": "string", "data": null }

参数说明:
| 参数名 | 类型 | 说明 |
|--------|------|------|
| status | int | 状态码:0-成功,1-失败 |
| message | string | 响应消息 |
| data | object | 响应数据(此接口为null) |

响应示例

成功响应:
json { "status": 0, "message": "退料请求单生成成功", "data": null }

失败响应:
json { "status": 1, "message": "退料请求单生成失败", "data": null }

异常响应:
json { "status": -1, "message": "具体错误信息", "data": null }

业务逻辑说明

  1. 系统会根据传入的条码查询对应的库存信息
  2. 按物料和批号汇总数量
  3. 生成任务号(立库入库单号)
  4. 调用立库系统取料接口:http://172.20.5.5:50080/Services/Wmcs/RetrieveTask
  5. 根据立库接口响应记录任务日志到系统
  6. 立库接口返回Code=200时为成功,其他为失败

注意事项

  • 条码必须存在于库存中且数量大于0
  • 每个条码单独生成一个取料任务
  • 如果某个条码没有库存,会跳过该条码继续处理其他条码
  • 立库接口调用失败会抛出异常,前端需要处理错误提示