# 生成退料请求单接口

## 接口信息
- **接口地址**: `/api/MesInvItemStocks/CreateReturnMaterialRequest`
- **请求方式**: `POST`
- **接口说明**: 根据物料条码生成退料请求单，调用立库系统取料任务接口

## 请求参数

**Content-Type**: `application/json`

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

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

## 请求示例
```json
{
  "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
- 每个条码单独生成一个取料任务
- 如果某个条码没有库存，会跳过该条码继续处理其他条码
- 立库接口调用失败会抛出异常，前端需要处理错误提示