BOM 数据
以下接口适用于 通用数据集成
备注：Bom 涵盖范围为 ODM 所有业务内容，ODM 自己 build 整机/半机 、半成品各阶 for all Lenovo site ,且此 Scope 仅 for DBDS 取用，与 ODM 目前传输的 BS bom 不做干涉，互为单独两份 bom 数据
| 频率 | 时间 | 传输方式 |
|---|---|---|
| Daily | 0:00:00 | Incremental/full |
请求地址
- API
| 环境 | URL |
|---|---|
| 测试 | https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/open_platform/data/sync/odm/bom |
| 正式 | https://api-cn.lenovo.com/v1.0/supply_chain/scc/open_platform/data/sync/odm/bom |
- FTP
| 环境 | 合作伙伴 文件目录 | Lenovo 文件目录 | 文件名 |
|---|---|---|---|
| 测试 | /Planning/SCC/{appName}/odm/bom/ | /Planning/SCC/{appName}/odm/bom/feedback/ | bom_{crud}_{yyyyMMddHHmmss}_ |
| 正式 | /Planning/SCC/{appName}/odm/bom/ | /Planning/SCC/{appName}/odm/bom/feedback/ | bom_{crud}_{yyyyMMddHHmmss}_ |
例子：/Planning/SCC/LCFC/odm/bom/bom_update_20220928123000_001
请求参数
| 参数 | key | 类型 | 长度 | 必填 | PCG-NB | ISG | MBG-Moblie | MDSC-TB | PCG-Smart Device | PCG-Docking | PCG-DT | 描述 | 示例 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| uid | String | 32 | 数据行唯一标识，存在按 uid 变更，不存在按 业务 key 变更 | ||||||||||
| bu | Y | String | 50 | Y | Y | Y | Y | Y | Y | Y | Y | ThinkNB/IdeaNB/ThinkDT/IdeaDT | ThinkNB |
| odm | Y | String | 100 | Y | Y | Y | Y | Y | Y | Y | Y | ODM 名称 | LCFC |
| odm_father_item | Y | String | 20 | Y | Y | Y | Y | Y | Y | Y | Y | ODM 上层节点料号 | 712801000000 |
| father_item | String | 50 | Y | Y | Y | Y | Y | Y | Y | Y | 联想成层节点料号 | SA78D09909 | |
| odm_child_item | Y | String | 20 | Y | Y | Y | Y | Y | Y | Y | Y | ODM 下层节点料号 | BLXSC28C60966 |
| child_item | String | 50 | 联想下层节点料号 | SC28C60966 | |||||||||
| quantity_per | Number | 10.6 | Y | Y | Y | Y | Y | Y | Y | Y | 在上层中使用的数量:即 Usage | 100 | |
| effective_start_date | Date | Y | Y | Y | Y | Y | Y | Y | Y | BOM 生效时间 | 2000-08-01 | ||
| effective_end_date | Date | Y | Y | Y | Y | Y | Y | Y | Y | BOM 失效时间 | 2000-08-01 | ||
| priority | Integer | 3 | Y | Y | Y | Y | Y | Y | Y | Y | 替代物料的优先级 | 2 | |
| alternative_code | Y | String | 50 | Y | Y | Y | Y | Y | Y | Y | Y | 替代物料组名称/编码 | 34 |
| split | Number | 1.2 | 在 BOM 下的百分比 | 0.2 | |||||||||
| version | String | 14 | Y | Y | Y | Y | Y | Y | Y | Y | 版本号 yyyyMMddHHmmss | 20220801152347 | |
| remark | String | 200 | 自定义 | ||||||||||
| comment1 | String | 100 | 预留字段，以备之后使用 | ||||||||||
| comment2 | String | 100 | 预留字段，以备之后使用 |
响应参数
| 参数 | 必填 | 类型 | 定义 | 描述 |
|---|---|---|---|---|
| code | Y | String | 状态码 | "0"代表成功,其他失败可参考返回码 |
| msg | N | String | 提示消息 | 非"0"时,会提示错误消息 |
| result | N | object/array | 数据体 |
请求示例
json
{
"batch_id": "10197",
"batch_size": 1,
"seq_id": "1",
"seq_size": 1,
"data": [
{
"bu": "ThinkNB",
"odm": "LCFC",
"odm_father_item": "712801000000",
"father_item": "SA78D09909",
"odm_child_item": "BLXSC28C60966",
"child_item": "SC28C60966",
"quantity_per": "100",
"effective_start_date": "2022-08-01",
"effective_end_date": "2022-08-01",
"priority": "2",
"alternative_code": "34",
"split": "0.2",
"version": "20220801152347",
"remark": "self input",
"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"
}]
}]
}业务错误码
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| -1 | 数据验证失败 | 请根据 msg 调整 |