ASN 相关接口
以下接口适用于 ASN 数据集成 API，对接前请了解 API 接入流程 目前支持 PRC、BUD 场景
Create ASN
- 请求地址
| 环境 | URL |
|---|---|
| 测试 | https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/asn/create |
| 正式 | https://api-cn.lenovo.com/v1.0/supply_chain/scc/asn/create |
Method: POST
Content-Type: application/json
请求参数
| 参数 | key | 类型 | 必填 | 长度 | 格式 | 描述 | 示例 |
|---|---|---|---|---|---|---|---|
| deliveryNo | Y | string | Y | 16 | 供应商发货单号 | ||
| packCount | number | N | 100 | 总箱数 | |||
| totalWeight | number | N | 100 | 总毛重 | |||
| totalVolume | number | N | 100 | 总体积 | |||
| shipFromCity | string | N | 40 | 发货城市 | |||
| shipFromCountry | string | N | 30 | 发货国家 | |||
| mot | string | Y | 10 | 运输方式 | Truck, Mail, Train, Sea, Air, Sea-Air | ||
| carrierId | string | N | 50 | 承运人 ID | |||
| shipDate | date | Y | 10 | 发货日期(yyyy/MM/dd或yyyy-MM-dd) | |||
| eta | date | Y | 10 | 预到货时间(yyyy/MM/dd或yyyy-MM-dd) | |||
| tmsTrafNO | String | N | 50 | TMS运单号 | |||
| - | - | - | - | - | - | - | - |
| deliveryLine | Y | string | N | 6 | 供应商发货单号行号 | ||
| po | string | Y | 10 | PO | |||
| poLine | string | Y | 5 | PO Line | |||
| lenovoPn | string | Y | 18 | 联想料号 | |||
| trackingId | string | Y | 35 | 物流单号 | |||
| shippingLine | string | N | 30 | ||||
| containerNo | string | N | 30 | 集装箱编号 | |||
| tier2VendorName | String | N | 100 | 二级供应商名称 | |||
| - | - | - | - | - | - | - | - |
| coo | string | N | 10 | 原产国 | CN，US等，详情见附件码表 | ||
| brand | string | N | 20 | 品牌 | 填写物料品牌 | ||
| deliveryQty | number | Y | 100 | 数量 |
- 响应参数
| 参数 | 类型 | 是否必填 | 长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| code | String | Y | 10 | 回执 code | "0" |
| msg | String | Y | 10 | 回执信息 | "ok"/"error" |
| result | Object | N | 回执示例 | 见响应示例 |
- 请求示例
json
{
"deliveryNo": "DN20250312",
"packCount": 10.0,
"totalWeight": 1,
"totalVolume": 100,
"shipFromCity": "beijing",
"shipFromCountry": "China",
"mot": "Air",
"carrierId": "DN20250312",
"shipDate": "2022-08-01",
"eta": "2022-08-01",
"tmsTrafNO": "TMS2023021000001",
"asnItemList": [
{
"deliveryLine": "1",
"po": "4000123096",
"poLine": "00010",
"lenovoPn": "4XH0R55468",
"trackingId": "DN20250312",
"shippingLine": "1111",
"containerNo": "UPS11111",
"tier2VendorName": "1000140",
"asnDeliveryList": [
{
"coo": "CN",
"brand": "Lenovo",
"deliveryQty": 100
}
]
}
]
}- 响应示例
json
{
"code": "0",
"msg": "ok",
"result": {
"asnNo": "TESTAPI00120230906",
"asnItemList": [
{
"asnItemNo": "1",
"deliveryLineNoList": [
"1"
]
}
]
}
}- 异常示例
json
{
"code": "-1",
"msg": "error",
"result": [
{
"key": "DNTST202208022",
"errors": [
{
"field": "deliveryNo",
"message": [
{
"value": "DNTST202208022",
"error": "存在重复数据"
}
]
}
]
}
]
}- 业务错误码
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| -1 | 回执 code | 请根据 result 回执修改具体字段的值 |
| 500 | 接口系统错误 | 请提供具体错误报文以及触发时间给 IT |
Update ASN
- 请求地址
| 环境 | URL |
|---|---|
| 测试 | https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/asn/update |
| 正式 | https://api-cn.lenovo.com/v1.0/supply_chain/scc/asn/update |
Method: POST
Content-Type: application/json
请求参数
| 参数 | key | 类型 | 必填 | 长度 | 格式 | 描述 | 示例 |
|---|---|---|---|---|---|---|---|
| asnNo | Y | string | Y | 16 | 联想预发货单号 | ||
| asnLine | Y | string | Y | 4 | 联想预发货行号 | ||
| po | Y | string | Y | 10 | PO | ||
| poLine | Y | string | Y | 10 | PO Line | ||
| trackingId | string | 35 | 运单号 | ||||
| carrierId | string | 50 | 承运商/货代 | ||||
| shippingLine | string | 30 | 船公司 SCAC | ||||
| containerNo | string | 35 | 集装箱号 | ||||
| mot | string | 30 | 承运方式 | Truck, Mail, Train, Sea, Air, Sea-Air | |||
| updateEta | date | 修改预发货时间 |
- 响应参数
| 参数 | 类型 | 是否必填 | 长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| code | String | Y | 10 | 回执 code | "0" |
| msg | String | Y | 10 | 回执信息 | "ok"/"error" |
| result | Object | N | 回执示例 | 见响应示例 |
- 请求示例
json
{
"asnNo": "227003919520250310",
"asnLine": "1",
"po": "4000123096",
"poLine": "00010",
"trackingId": "227003919520250310",
"carrierId": "227003919520250310",
"shippingLine": "11111",
"mot": "Air",
"containerNo": "227003919520250310",
"updateEta": "2016-06-27"
}- 响应示例
json
{
"code": "0",
"msg": "ok"
}- 异常示例
json
{
"code": "-1",
"msg": "error",
"result": [
{
"key": "TEST2022071320220713",
"errors": [
{
"field": "asnNo",
"message": [
{
"value": "TEST2022071320220713",
"error": "ASN不存在"
}
]
}
]
}
]
}- 业务错误码
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| -1 | 回执 code | 请根据 result 回执修改具体字段的值 |
| 500 | 接口系统错误 | 请提供具体错误报文以及触发时间给 IT |
Delete ASN
- 请求地址
| 环境 | URL |
|---|---|
| 测试 | https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/asn/delete |
| 正式 | https://api-cn.lenovo.com/v1.0/supply_chain/scc/asn/delete |
Method: Delete
Content-Type: application/json
请求参数
| 参数 | 类型 | 必填 | 长度 | 格式 | 描述 | 示例 |
|---|---|---|---|---|---|---|
| asnNo | string | Y | 24 | 联想预发货单号 | ||
| site | string | Y | 4 | 工厂site |
- 响应参数
| 参数 | 类型 | 是否必填 | 长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| code | String | Y | 10 | 回执 code | "0" |
| msg | String | Y | 10 | 回执信息 | "ok"/"error" |
| result | Object | N | 回执示例 | 见响应示例 |
- 请求示例
json
[{
"asnNo": "227003919520250310",
"site": "LSSC"
}]- 响应示例
json
{
"code": "0",
"msg": "ok"
}- 异常示例
json
{
"code": "-1",
"msg": "error",
"result": [
{
"key": "TEST2022071320220713",
"errors": [
{
"field": "asnNo",
"message": [
{
"value": "TEST2022071320220713",
"error": "ASN不存在"
}
]
}
]
}
]
}- 业务错误码
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| -1 | 回执 code | 请根据 result 回执修改具体字段的值 |
| 500 | 接口系统错误 | 请提供具体错误报文以及触发时间给 IT |
Query ASN
- 请求地址
| 环境 | URL |
|---|---|
| 测试 | https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/asn/query |
| 正式 | https://api-cn.lenovo.com/v1.0/supply_chain/scc/asn/query |
Method: POST
Content-Type: application/json
请求参数
| 参数 | 类型 | 必填 | 长度 | 格式 | 描述 | 示例 |
|---|---|---|---|---|---|---|
| asnNoList | list | Y | 联想预发货单号集合 | |||
| deliveryNoList | list | 供应商发货单号集合 | ||||
| poList | list | PO 集合 | ||||
| lenovoPnList | list | 物料号集合 |
- 响应参数
| 参数 | 类型 | 是否必填 | 长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| code | String | Y | 10 | 回执 code | "0" |
| msg | String | Y | 10 | 回执信息 | "ok"/"error" |
| result | Object | N | 回执示例 | 见响应示例 |
- 请求示例
json
{
"asnNoList": ["DNTST20220802220220802", "DNTST2022080220220802"]
}- 响应示例
json
{
"code": "0",
"msg": "ok",
"result": [
{
"orderType": "RT",
"procurementMode": "LOI",
"sysModifyBy": "wanghh25",
"deliveryQtyUom": "EA",
"poLine": "00020",
"rid": "111202309061",
"lenovoPn": "SSS7A43166",
"vendorCode": "1000025686",
"asnNo": "11120230906",
"sysCreatedBy": "wanghh25",
"bu": "ISG",
"mot": "Sea",
"eta": "2023-09-30",
"updateEta": "2023-09-30",
"incotermLoc": "DDU",
"currency": "USD",
"id": "ASN202309060001",
"trackingId": "1111",
"traceId": "Can not find PO",
"isClose": "true",
"shipToPlant": "L270",
"sysCreatedDate": "2023-09-06 14:30:00",
"deliveryQty": 75,
"business": "PRC",
"oseq": 1,
"deliveryNo": "111",
"vendorName": "FF tttth ddd iiiiiiates PP",
"shipDate": "2023-09-06",
"orderTypeDesc": "RT PO",
"partDesc": "SSD PM1643a/45a 7.68/6.4TB SSD",
"isUpdateLocation": "true",
"site": "LSSC",
"incoterm": "DDU",
"isEdit": "true",
"lnvStorageLoc": "VBRM",
"purchaseGroup": "L9O",
"asnItemStatus": "Open",
"sysModifyDate": "2023-09-06 14:30:00",
"asnLine": 1,
"dataSource": "SCC",
"status": "Open",
"po": "3800001628"
}
]
}- 异常示例
json
- 业务错误码
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| -1 | 回执 code | 请根据 result 回执修改具体字段的值 |
| 500 | 接口系统错误 | 请提供具体错误报文以及触发时间给 IT |