Tier1 FULL BOM 数据
以下接口适用于 通用数据集成
请求地址
- API
| 环境 | URL |
|---|---|
| 测试 | https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/open_platform/data/sync/t1/bom |
| 正式 | https://api-cn.lenovo.com/v1.0/supply_chain/scc/open_platform/data/sync/t1/bom |
- FTP
| 环境 | 合作伙伴 文件目录 | Lenovo 文件目录 | 文件名 |
|---|---|---|---|
| 测试 | /Planning/SCC/{appName}/t1/bom/ | /Planning/SCC/{appName}/t1/bom/feedback/ | bom_{crud}_{yyyyMMddHHmmss}_ |
| 正式 | /Planning/SCC/{appName}/t1/bom/ | /Planning/SCC/{appName}/t1/bom/feedback/ | bom_{crud}_{yyyyMMddHHmmss}_ |
示例 ：/Planning/SCC/LCFC/t1/bom/bom_update_20220928123000_001
| 频率 | 时间 | 传输方式 | 数据主键 | Remark |
|---|---|---|---|---|
| Daily | 00:10:00 | API,FTP,UI(upload) | vendor_code + vendor _father_item + father_item + vendor_child_item + version | 若不要求供应商提供下层节点料号则 vendor_child_item 填写 N/A |
请求参数
| 参数 | Key | 类型 | 必填 | 长度 | 描述 | 示例 |
|---|---|---|---|---|---|---|
| uid | String | 32 | 数据行唯一标识，存在按 uid 变更，不存在按 业务 key 变更 | |||
| bu | String | 50 | ThinkNB,IdeaNB,ThinkOption,ThinkDT,IdeaOption,IdeaDT,WS,Smart Device,ISG,Mobile Phone,Mobile Tablet | ThinkNB | ||
| vendor_code | Y | String | Y | 30 | 供应商编码 | 2022012 |
| vendor_name | String | option | 500 | 供应商名称,Lenovo 根据 Vendor Code 自行 mapping | ||
| vendor_father_item | Y | String | Y | 30 | 供应商上层节点料号 | |
| vendor_parent_item | Y | String | Y | 30 | 供应商父级节点料号,没有则填NA | |
| father_item | Y | String | Y | 30 | 联想上层节点料号 | |
| vendor_child_item | Y | String | Y | 30 | 供应商下层节点料号 ps: 若不要求供应商提供下层节点料号则 vendor_child_item 填写 N/A | |
| child_item | String | Y | 30 | 联想下层节点料号 | ||
| quantity_per | Number | Y | 13,3 | 在上层中使用的数量 | ||
| effective_start_date | Date | Y | BOM 生效时间 | yyyy-mm-dd | ||
| effective_end_date | Date | Y | BOM 失效时间 | yyyy-mm-dd | ||
| priority | String | Y | 13,3 | 替代物料优先级,对于不需要提供 priority 的 commodity 要求供应商填 N/A | ||
| alternate_item_group | String | option | 50 | 替代组，Lenovo 系统自动 mapping | ||
| split | Number | Y | 4,2 | 在 BOM 下的百分比，eg:0.21 | ||
| version | Y | String | Y | 16 | 版本号(yyyyMMddHHmmss) | 20211012000000 |
| owner | String | option | 50 | 物料负责人 | ||
| vendor_child_item_desc | String | option | 200 | 供应商下层节点料号描述 |
响应参数
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| code | String | Y | 0 成功其它失败 |
| msg | String | Y | 响应具体信息 |
请求示例
json
{
"batch_id": "100055",
"batch_size": 1,
"seq_id": "1",
"seq_size": 1,
"data": [
{
"child_item": "123",
"effective_end_date": "2022-09-14",
"effective_start_date": "2022-09-14",
"father_item": "213",
"priority": 10.2,
"quantity_per": 10.1,
"split": 0.28,
"vendor_child_item": "eee",
"vendor_code": "eee",
"vendor_father_item": "ee",
"version": "20220914"
}
]
}响应示例
json
{
"code": "0",
"msg": "request success"
}异常示例
json
{
"code": "E00V00",
"msg": "data verification failed！",
"result": [{
"row": {
"effective_end_date": "xxxxxxxxxxxx",
...
},
"verify": [{
"type": "value length exceed",
"fields": "effective_end_date"
}]
}]
}业务错误码
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|