Inventory 数据
以下接口适用于 通用数据集成
请求地址
- API
| 环境 | URL |
|---|---|
| 测试 | https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/open_platform/data/sync/odm/inventory |
| 正式 | https://api-cn.lenovo.com/v1.0/supply_chain/scc/open_platform/data/sync/odm/inventory |
- FTP
| 环境 | 合作伙伴 文件目录 | Lenovo 文件目录 | 文件名 |
|---|---|---|---|
| 测试 | /Planning/SCC/{appName}/odm/inventory/ | /Planning/SCC/{appName}/odm/inventory/feedback/ | inventory_{crud}_{yyyyMMddHHmmss}_ |
| 正式 | /Planning/SCC/{appName}/odm/inventory/ | /Planning/SCC/{appName}/odm/inventory/feedback/ | inventory_{crud}_{yyyyMMddHHmmss}_ |
例子：/Planning/SCC/LCFC/odm/inventory/inventory_update_20220928123000_001
| 频率 | 时间 | 传输方式 |
|---|---|---|
| Daily or Real time | 0:00:00 | Daily version of data (full amount) |
请求参数
TIP
注意BU不同时，请参考对应列
| 参数 | key | 类型 | default 必填 | PCG-NB 必填 | MBG-Mobile 必填 | MDSC-TB 必填 | PCG-DT 必填 | PCG-Docking 必填 | Smart Device 必填 | 长度 | 描述 | 示例 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| uid | String | 32 | 数据行唯一标识，存在按 uid 变更，不存在按 业务 key 变更 | |||||||||
| bu | Y | String | Y | Y | Y | Y | Y | Y | Y | 50 | BU 取固定值字段，多个 BU Common 就显示所有 BU 用"/"连接 | MDSC-TB |
| odm | Y | String | Y | Y | Y | Y | Y | Y | Y | 40 | ODM 名称 | WINGTECH |
| odm_pn | Y | String | Y | Y | Y | Y | Y | Y | Y | 20 | ODM 的料号 | BLXSD68C54106 |
| lenovo_pn | String | Y | Y | Y | Y | Y | 18 | 联想料号(当 Material Type 是 DS or BS 时，必填) | SD68C54106 | |||
| material_type | String | Y | Y | Y | Y | Y | 10 | 物料类型：DB/DS/BS | DS | |||
| location | Y | String | Y | Y | Y | Y | Y | Y | 50 | 储位库位，LCFC 通过库位分辨库存的 Status | 1005_HG66 | |
| location_desc | String | Y | Y | Y | Y | Y | 100 | 如果 ODM 同一个 location 有不同 type(L/M/N) 如果 ODM 同一个 location 没有有不同 type（L/M/N） | 海格平板整机原材不良仓 | |||
| odm_qty | Number | Y | Y | Y | Y | Y | Y | Y | 10,6 | I=L+M+N 按照系统实际数字摆放 | 5 | |
| odm_hub_qty | Number | Y | 10,6 | HUB 库存 | 2 | |||||||
| po | Y | Integer | Y | Y | Y | Y | Y | Y | Y | 10 | Y for FG,others No must | |
| unrestricted_qty | Number | Y | Y | 10,6 | 按照系统实际数字摆放零 | 2 | ||||||
| inspection_qty | Number | Y | Y | 10,6 | 按照系统实际数字摆放零 | |||||||
| remark | String | 200 | 按照系统实际数字摆放零 | 2 | ||||||||
| block_qty | Number | 10,6 | No must(根据 ODM SAP 设置储位匹配状况选择填或者不填 | |||||||||
| version | Y | String | Y | Y | Y | Y | Y | Y | 14 | 数据抓取时间 yyyyMMddHHmmss | 20220915080100 | |
| comment1 | String | 100 | 预留字段，以备之后使用 | |||||||||
| comment2 | String | 100 | 预留字段，以备之后使用 |
响应参数
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| code | String | Y | 0 成功其它失败 |
| msg | String | Y | 响应具体信息 |
请求示例
json
{
"batch_id": "10097",
"batch_size": 1,
"seq_id": "1",
"seq_size": 1,
"data": [
{
"bu": "ThinkNB",
"odm": "LCFC",
"odm_pn": "45109112310",
"lenovo_pn": "45109112310",
"material_type": "DS",
"location": "1234",
"location_desc": "12312312",
"odm_qty": "104",
"odm_hub_qty": "20",
"po": "",
"unrestricted_qty": "2",
"inspection_qty": "2",
"remark": "",
"block_qty": "",
"version": "20220915020433",
"comment1": "",
"comment2": ""
}
]
}响应示例
json
{
"code": "0",
"msg": "request success"
}异常示例
json
{
"code": "E00V00",
"msg": "data verification failed！",
"result": [{
"row": {
"odm": "LCFC",
...
},
"verify": [{
"type": "value length exceed",
"fields": "version"
}]
}]
}业务错误码
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|