Tier1 Inventory 数据
以下接口适用于 通用数据集成
请求地址
- API
| 环境 | URL |
|---|---|
| 测试 | https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/open_platform/data/sync/t1/inventory |
| 正式 | https://api-cn.lenovo.com/v1.0/supply_chain/scc/open_platform/data/sync/t1/inventory |
- FTP
| 环境 | 合作伙伴 文件目录 | Lenovo 文件目录 | 文件名 |
|---|---|---|---|
| 测试 | /Planning/SCC/{appName}/t1/inventory/ | /Planning/SCC/{appName}/t1/inventory/feedback/ | inventory_{crud}_{yyyyMMddHHmmss}_ |
| 正式 | /Planning/SCC/{appName}/t1/inventory/ | /Planning/SCC/{appName}/t1/inventory/feedback/ | inventory_{crud}_{yyyyMMddHHmmss}_ |
示例 ：/Planning/SCC/LCFC/t1/inventory/inventory_update_20220928123000_001
| 频率 | 时间 | 传输方式 |
|---|---|---|
| Daily or Real time | 0:00:00 | Daily version of data (full amount) |
| 频率 | 时间 | 传输方式 | 数据主键 |
|---|---|---|---|
| Weekly Monday | 00:10:00 | API,FTP,UI(upload) | bu + vendor_code + vendor_pn |
请求参数
| 参数 | key | 类型 | 必填 | 长度 | 描述 | 示例 |
|---|---|---|---|---|---|---|
| uid | String | 32 | 数据行唯一标识，存在按 uid 变更，不存在按 业务 key 变更 | |||
| bu | Y | String | Y | 50 | 枚举值：ThinkNB,IdeaNB,ThinkOption,ThinkDT,IdeaOption,IdeaDT,WS,Smart Device,ISG,Mobile Phone,Mobile Tablet | ThinkNB |
| vendor_code | Y | String | Y | 30 | 供应商编码 | |
| vendor_name | String | option | 500 | 供应商名称，根据 vendor code 联想自己 mapping | ||
| vendor_pn | Y | String | Y | 200 | 供应商料号 | |
| lenovo_pn | String | option | 200 | 联想料号 | ||
| location | String | option | 200 | 储位库位 | ||
| location_desc | String | option | 100 | 储位描述 | ||
| vendor_qty | Integer | Y | 10 | 供应商库存数量 | ME-D Cover | |
| vendor_hub_qty | Integer | Y | 10 | 供应商 hub 库存数量 | 1 | |
| lenovo_vmi_inventory | Integer | 10 | 联想vmi库存 | |||
| po | Integer | option | 10 | PO | ||
| unrestricted_qty | Integer | option | 10 | Valuated Unrestricted-Use Stock（可用库存） | 1 | |
| inspection_qty | Integer | option | 10 | inspection qty 待检验库存 | 1 | |
| block_qty | Integer | option | 10 | 锁定库存数量 | 1 | |
| open_po_qty | Integer | option | 10 | OPEN PO 数量 | 1 | |
| available_to_allocate | Integer | option | 10 | 可调拨库存数量 | 1 | |
| wip_qty | Integer | option | 10 | 半成品数量 | 40 | |
| version | Y | String | Y | 8 | 版本号，eg：20211012 | 20211012 |
| owner | String | option | 50 | 物料负责人 |
响应参数
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| code | String | Y | 0 成功其它失败 |
| msg | String | Y | 响应具体信息 |
请求示例
json
{
"batch_id": "100012",
"batch_size": 1,
"seq_id": "1",
"seq_size": 1,
"data": [
{
"version":"20230315",
"bu": "ThinkNB",
"vendor_code": "xxx123",
"vendor_pn": "ln1234",
"vendor_hub_qty": 10,
"po": 123321
}
]
}响应示例
json
{
"code": "0",
"msg": "request success"
}异常示例
json
{
"code": "E00V00",
"msg": "data verification failed！",
"result": [{
"row": {
"bu": "xxxxxxxxxxxx",
...
},
"verify": [{
"type": "value length exceed",
"fields": "bu"
}]
}]
}业务错误码
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|