BUD AN 相关接口
以下接口适用于 ULLO AN 数据集成 API，对接前请了解 API 接入流程
Request Booking
请求地址
| 环境 | URL |
|---|---|
| 测试 | https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/an/bud/create |
| 正式 | https://api-cn.lenovo.com/v1.0/supply_chain/scc/an/bud/create |
请求参数
Method: POST
Content-Type: multipart/form-data
| 参数 | key | 类型 | 必填 | 长度 | 描述 | 示例 |
|---|---|---|---|---|---|---|
| cdaNo | Y | String | Y | 30 | CDA编号 | CDA2023071800001 |
| truckLicense | String | 50 | 车牌 | xxxxx | ||
| reqDate | Date | Y | - | 预约时间(UTC时间) | 2023-06-16T16:30:46Z | |
| reqReason | String | Y | 200 | 预约原因 | test | |
| remark | String | 500 | 备注 | - | ||
| String | 100 | 收件人邮箱 | xxx@xx.com | |||
| attachmentList | File | - | 附件集合 | - |
响应参数
| 参数 | 类型 | 是否必填 | 长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| code | String | Y | 10 | 回执 code | "0" |
| msg | String | Y | 10 | 回执信息 | "ok"/"error" |
| result | Object | N | 回执示例 | 见响应示例 |
请求示例
json
anCreateDto:{
"receiverList": [
{
"email": "zhaizg1@lenovo.com"
}
],
"anCreateItemList": [
{
"cdaNo": "CDA2023070500001",
"truckLicense": "11",
"reqDate": "2023-09-12T10:23:49Z",
"reqReason": "22",
"remark": "xxx"
}
]
}
attachmentList: [
file01,file02...
]响应示例
JSON
{
"code": "0",
"msg": "ok"
}异常示例
JSON
{
"code": "-1",
"msg": "Data already exists,please check!(数据已存在,请检查)"
}业务错误码
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| -1 | 回执 code | 请根据 msg提示处理 |
| 500 | 接口系统错误 | 请提供具体错误报文以及触发时间给 IT |
Query AN
请求地址
| 环境 | URL |
|---|---|
| 测试 | https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/an/bud/query |
| 正式 | https://api-cn.lenovo.com/v1.0/supply_chain/scc/an/bud/query |
Method: POST
Content-Type: application/json
请求参数
| 参数 | 类型 | 必填 | 长度 | 描述 | 示例 |
|---|---|---|---|---|---|
| pageNum | Number | Y | 10 | 页码 | 1 |
| pageSize | Number | Y | 4 | 每页数据 | 20 |
| status | String | 20 | 状态 | Confirm booking | |
| deliveryNote | String | 40 | 交货单 | SM10N01540 | |
| po | String | 40 | 采购单号 | 6500372676 | |
| lenovoPn | String | 40 | 联想料号 | SSS7A23384 | |
| anNo | String | 40 | 到货单号 | AN2023082400003 | |
| cdaNo | String | 20 | 报关单号 | CDA2023082100007 | |
| asnNo | String | 20 | 发货单号 | DN2023072720230727 | |
| startDate | Date | - | 创建开始时间 | 2023-08-15T00:00:01Z | |
| endDate | Date | - | 创建结束时间 | 2023-08-18T01:00:01Z |
响应参数
| 参数 | 类型 | 是否必填 | 长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| code | String | Y | 10 | 回执 code | "0" |
| msg | String | Y | 10 | 回执信息 | "ok"/"error" |
| result | Object | N | 回执示例 | 见响应示例 |
请求示例
json
{
"pageNum": 1,
"pageSize": 20,
"lenovoPn": "SM17A98404"
}响应示例
JSON
{
"code": "0",
"msg": "ok",
"result": {
"total": 2,
"pageNum": 1,
"pageSize": 20,
"list": [
{
"status": "Close",
"anNo": "AN2023091200001",
"deliveryNote": "LY1234567-23",
"truckLicense": "11",
"reqDate": "2023-09-12T10:23:49Z",
"reqReason": "22",
"itemStatus": "Close",
"anType": "LOI",
"vendorCode": "1000235334",
"vendorName": "LONGWELL COMPANY",
"shipCountry": "CHN China",
"carrierId": "CEVA",
"trackingId": "CV2300144857",
"invoice": "LY1234567-23",
"containerNo": "ABC0001",
"mot": "Sea1",
"shipToPlant": "E070",
"anLine": 1,
"asnNo": "LY1234567-2320230619",
"asnLine": 1,
"cdaNo": "CDA2023070500001",
"po": "6500374300",
"poLine": "00010",
"lenovoPn": "0000039M5374",
"partDescription": "LINECORD Cord - 1M",
"qty": "200",
"etaStatus": "Delay",
"orderType": "MB",
"bu": "IDG",
"site": "ULLO",
"hawb": "CV2300144857",
"cartons": "10",
"grossWeight": "100",
"shippingLine": "test",
"coo": "LINECORD Cord - 1M",
"brand": "LINECORD Cord - 1M",
"containerSize": "40HQ",
"pallets": "1",
"incoterm": "FOB",
"incotermslocation": "HK",
"currency": "USD",
"portOfDischarge": "BUDAPEST",
"remark": "ETA 14 days due but without GR",
"creator": "zhaizg1",
"creationDate": "2023-09-12T10:25:31Z",
"modifier": "SYSTEM",
"modifiedDate": "2023-09-12T10:30:00Z"
},
...
]
}
}异常示例
JSON
{
"code": "-1",
"msg": "creationDate格式化异常！"
}业务错误码
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| -1 | 回执 code | 请根据 msg提示处理 |
| 500 | 接口系统错误 | 请提供具体错误报文以及触发时间给 IT |