Material Document 数据
以下接口适用于 通用数据集成
场景
- 在计算 ETA Accuracy 过程中，需要 ODM 库存转移，以及 ODM HUB 信息
- 如：不良品转良品 & ODM HUB GR 等
请求地址
- API
| 环境 | URL |
|---|---|
| 测试 | https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/open_platform/data/sync/odm/material_doc |
| 正式 | https://api-cn.lenovo.com/v1.0/supply_chain/scc/open_platform/data/sync/odm/material_doc |
- FTP
| 环境 | 合作伙伴 文件目录 | Lenovo 文件目录 | 文件名 |
|---|---|---|---|
| 测试 | /Planning/SCC/{appName}/odm/material_doc/ | /Planning/SCC/{appName}/odm/material_doc/feedback/ | material_doc_{crud}_{yyyyMMddHHmmss}_ |
| 正式 | /Planning/SCC/{appName}/odm/material_doc/ | /Planning/SCC/{appName}/odm/material_doc/feedback/ | material_doc_{crud}_{yyyyMMddHHmmss}_ |
例子：/Planning/SCC/LCFC/odm/material_doc/material_doc_update_20220928123000_001
| 频率 | 时间 | 传输方式 |
|---|---|---|
| Daily or Real time | 00:00:00 | Daily version of data(Incremental) |
请求参数
| 参数 | key | 类型 | 必填 | 长度 | 描述 | 示例 |
|---|---|---|---|---|---|---|
| uid | String | 32 | 数据行唯一标识，存在按 uid 变更，不存在按 业务 key 变更 | |||
| odm | Y | String | Y | 40 | ODM名称 | LCFC |
| bu | Y | String | Y | 50 | 固定值选项，参考附录 | ISG |
| moving_track_number | Y | String | Y | 50 | 移动流水单号，在ODM内唯一 | 6901027745 |
| odm_pn | String | Y | 1000 | ODM 料号 | BLXSB18C53808 | |
| odm_pn_desc | String | Y | 1000 | ODM 物料描述 | XXXX | |
| lenovo_pn | String | 100 | 联想料号，DS物料必填 | SB18C53808 | ||
| material_type | String | Y | 10 | DB/DS/BS/RB | DS | |
| mfg_pn | String | 1000 | 原厂料号，IC的物料必填 | XXX | ||
| qty | Number | Y | 13,3 | 移动数量 | 100 | |
| movement_date | Date | Y | 物料移动时间 | 2022-08-01 00:00:00 | ||
| movement_type | String | Y | 10 | 物料移动类型 ，固定值：BTG/HUB IN/HUB OUT/GTB/V_GTB/V_BTG/V_TSF_IN/V_TSF_OUT | ||
| commodity | String | Y | 50 | 物料类型 | ||
| odm_desc | String | 500 | ODM 供应商名称 | GOLD WIN TRADING (HK) LIMITED | ||
| version | String | Y | 14 | 资料抓取时间 yyyyMMddHHmmss | 20220809070623 | |
| comment1 | String | 100 | 预留字段 | |||
| comment2 | String | 100 | 预留字段 | |||
| comment3 | String | 100 | 预留字段 |
响应参数
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| code | String | Y | 0 成功其它失败 |
| msg | String | Y | 响应具体信息 |
请求示例
json
{
"batch_id": "90497",
"batch_size": 1,
"seq_id": "1",
"seq_size": 1,
"data": [
{
"odm": "odm_1",
"bu": "ISG",
"moving_track_number": "****",
"odm_pn": "****",
"odm_pn_desc": "ODM 物料描述",
"lenovo_pn": "****",
"material_type": "DB",
"mfg_pn": "****",
"qty": "10",
"movement_date": "2022-09-15",
"movement_type": "BTG",
"commodity": "commodity",
"odm_desc": "****LIMITED",
"version": "20220809070600",
"comment1": "",
"comment2": "",
"comment3": ""
}
]
}响应示例
json
{
"code": "0",
"msg": "request success"
}异常示例
json
{
"code": "E00V00",
"msg": "data verification failed！",
"result": [{
"row": {
"odm": "LCFC",
...
},
"verify": [{
"type": "value length exceed",
"fields": "version"
}]
}]
}业务错误码
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|