ASN 数据
以下接口适用于 通用数据集成
请求地址
- API
| 环境 | URL |
|---|---|
| 测试 | https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/open_platform/data/sync/odm/asn |
| 正式 | https://api-cn.lenovo.com/v1.0/supply_chain/scc/open_platform/data/sync/odm/asn |
- FTP
| 环境 | 合作伙伴 文件目录 | Lenovo 文件目录 | 文件名 |
|---|---|---|---|
| 测试 | /Planning/SCC/{appName}/odm/asn/ | /Planning/SCC/{appName}/odm/asn/feedback/ | asn_{crud}_{yyyyMMddHHmmss}_ |
| 正式 | /Planning/SCC/{appName}/odm/asn/ | /Planning/SCC/{appName}/odm/asn/feedback/ | asn_{crud}_{yyyyMMddHHmmss}_ |
例子：/Planning/SCC/LCFC/odm/asn/asn_update_20220928123000_001
| 频率 | 时间 | 传输方式 |
|---|---|---|
| Real Time | 0.00 | Daily |
备注：Scope ODM 的供应商出货给 ODM 的 DBDS 物料 ASN 信息
ODM 作为 Lenovo in house 工厂和 Remote site 的供应商需要提供的出货 ASN 参考 T-1 SANV scope 中 BSR
请求参数
TIP
注意BU不同时，请参考对应列
| 参数 | key | 类型 | default 必填 | PCG-NB 必填 | ISG 必填 | 长度 | 描述 | 示例 | VN项目intransit示例 |
|---|---|---|---|---|---|---|---|---|---|
| uid | String | 32 | 数据行唯一标识，存在按 uid 变更，不存在按 业务 key 变更 | ||||||
| asn | Y | String | Y | Y | Y | 20 | ASN 号 | 80989*****20600 | 对于intransit没有ASN的化，可以给一个dummy的号 |
| asn_line | Y | String | Y | Y | Y | 10 | ASN item Line | 对于intransit没有ASN的化，可以给一个dummy的号 | |
| bu | String | Y | Y | Y | 50 | 固定值 | |||
| odm | Y | String | Y | Y | Y | 40 | 固定值 | LCFC | 收货方 |
| po | String | Y | Y | Y | 10 | 订单号 | 7520*****95 | ODM家的PO | |
| po_line | String | Y | Y | Y | 6 | 订单 Line | 1 | ODM家的PO line | |
| odm_pn | String | Y | Y | Y | 20 | ODM 料号 | |||
| odm_pn_desc | String | Y | 240 | ODM 料号描述 | |||||
| mfg_pn | String | Y | Y | Y | 200 | 原厂料号 | |||
| lenovo_pn | String | Y | Y | Y | 18 | 联想料号(当 Material Type 是 DS or BS 时，必填) | |||
| material_type | String | Y | Y | Y | 10 | BS/DS/DB | 对于VN到CN的MB，为SFG； | ||
| procurement_mode | String | Y | Y | Y | 10 | VMI/Ship to ODM | ODM Internal Rebalance | ||
| status | String | Y | Y | Y | 10 | Closed/Open/Cancel/Delete | Open | 需要传最新的状态 | |
| delivery_note | Y | String | Y | Y | Y | 100 | Delivery note number | **** | 如果在ODM没有DN，可以给一个dummy的号 |
| delivery_line | Y | String | Y | Y | Y | 50 | Delivery line number | 10 | 如果在ODM没有DN，可以给一个dummy的号 |
| delivery_qty | Integer | Y | Y | Y | 10 | 出货数量 | 6000 | ||
| updated_eta | Date | Y | Y | Y | 更新的预计到货日期 | 2022-06-24 | 1.Intransit更新后的预计到货日期； 2.对于close的ASN，放close date | ||
| eta | Date | Y | Y | Y | 原始预计到货日期 | 2022-06-24 | Intransit原始预计到货日期 | ||
| ship_date | Date | Y | Y | Y | 出货日期 | 2022-06-24 | ODM 发货日期1 | ||
| version | String | Y | Y | Y | 14 | 日期+时间 yyyyMMddHHmmss | 20220809070600 | ||
| comment1 | String | 100 | 预留字段，以备之后使用 | ||||||
| comment2 | String | 100 | 预留字段，以备之后使用 |
响应参数
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| code | String | Y | 0 成功其它失败 |
| msg | String | Y | 响应具体信息 |
请求示例
json
{
"batch_id": "90397",
"batch_size": 1,
"seq_id": "1",
"seq_size": 1,
"data": [
{
"asn": "8098*****622",
"asn_line": "1",
"bu": "ThinkNB",
"odm": "*****",
"po": "75*****895",
"po_line": "1",
"odm_pn": "****",
"odm_pn_desc": "odm_pn_desc述",
"mfg_pn": "mfgpn",
"lenovo_pn": "****",
"material_type": "DS",
"procurement_mode": "VMI",
"status": "Open",
"delivery_note": "809*****801",
"delivery_line": "1",
"delivery_qty": "0",
"updated_eta": "2022-06-24",
"eta": "2022-06-24",
"ship_date": "2022-06-22",
"version": "20220809070600",
"comment1": "20220809070600",
"comment2": "20220809070600"
}
]
}响应示例
json
{
"code": "0",
"msg": "request success"
}异常示例
json
{
"code": "E00V00",
"msg": "data verification failed！",
"result": [{
"row": {
"odm": "LCFC",
...
},
"verify": [{
"type": "value length exceed",
"fields": "version"
}]
}]
}业务错误码
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|