部件箱包/SN库存查询
由Lenovo主动发起请求，调用ODM接口，查询部件箱包/SN库存信息。
请求地址
- API
| 环境 | URL |
|---|---|
| 测试 | 对接方提供 |
| 正式 | 对接方提供 |
请求参数
| 字段 | 类型 | 必填 | 长度 | 示例 | 描述 |
|---|---|---|---|---|---|
| pageNo | Integer | Y | 2 | 1 | 页码 |
| pageSize | Integer | Y | 4 | 500 | 每页条数 |
响应参数
| 参数 | 必填 | 类型 | 定义 | 描述 |
|---|---|---|---|---|
| code | Y | String | 状态码 | "0"代表成功,其他失败可参考返回码 |
| msg | N | String | 提示消息 | 非"0"时,会提示错误消息 |
| result | N | object | 数据体 | 请参照响应示例 |
部件箱包/SN库存结构
| 字段 | 类型 | 必填 | 长度 | 示例 | 描述 |
|---|---|---|---|---|---|
| inventory_type | String | Y | 1 | 1 | 库存类型：(0：部件良品库；1：成品库；2：备件；3：在途已发；4：在制；5：部件不良品库；6：在途未发；7:中转仓；8:整机不良品库；9:Buffer库；10:待质量判定库) |
| inventory_directive | String | Y | 32 | XXX-20180613202531469-0801054668 | 库存反馈指令（若⼚家主动反馈，⽣成规则CODE+编码；CODE:英⽂品牌的⼤写前三个字⺟；编码为时间格式（yyyyMMddHHmmssSSS)+⼗位随机数字字符串） |
| machine_brand | String | Y | 50 | 品牌code | 整机品牌 |
| factory_code | String | Y | 32 | ⼯⼚编码 North-001 | ⼯⼚编码 |
| version_seq_no | String | Y | 13 | 1531317939902 | 版本号（计算数据时刻的时间戳） |
| customer_inventory_list | Array | Y | CustomerInventoryDetailLineDTO | 客户库存⾏明细(箱包/SN)JSON数组，建议单次调⽤不超过1000条 | |
| remark | String | N | 100 | 供应商选填 | 备注 |
| inventory_part_belonging | String | N | 20 | ODM/S54/AQ7/Z97 | 物料⼦库的归属(特定⼚商必传)-20221128 |
CustomerInventoryDetailLineDTO 结构
| 字段 | 类型 | 必填 | 长度 | 示例 | 描述 |
|---|---|---|---|---|---|
| customer_inventory_line_number | String | Y | 10 | 1 | 客户库存⾏，从1开始递增 |
| config_model | String | N | 50 | N58.2B.C3V1P0U2 | 三段机型即ALIBom |
| mpn | String | Y | 20 | ⼚商bom名称 | |
| locator_type | Number | Y | 1 | 0:原箱区；1:混箱区 | |
| inventory_batch | String | N | 20 | 20180701 | 阿⾥批次 |
| carton_id | String | Y（物料类型为箱包时必填） | 200 | 箱包号 | |
| vendor_carton_quantity | Number | Y（物料类型为箱包时必填） | 200 | ⼚家箱包剩余数量 | |
| sn | String | Y（物料类型为SN时必填） | 200 | sn | |
| item_type | Number | Y | 1 | 物料类型 0:箱包；1:SN |
请求示例
json
{
"pageNo" : 1,
"pageSize": 500
}响应示例
json
{
"code": "0",
"msg": "request success",
"result": {
"total": 1,
"pageNo": 1,
"pageSize": 1,
"data": [
{
"type" : "FINISH GOOD",
"inventory_type": "1",
"inventory_directive": "XXX-20180613202531469-0801054668",
"machine_brand": "Think",
"factory_code": "North-001",
"version_seq_no": "1531317939902",
"customer_inventory_list": [
{
"customer_inventory_line_number": "1",
"config_model": "N58.2B.C3V1P0U2",
"mpn": "123456",
"locator_type": "1",
"inventory_batch": "20180701",
"carton_id": "123456",
"vendor_carton_quantity": "200",
"sn": "123456",
"item_type": "0"
}
],
"remark": "remark",
"inventory_part_belonging": "ODM"
}
]
}
}