BUD AN

The following interfaces apply to ULLO AN Integration, refer to API Data Integration first

Request Booking

Request address

Environment	URL
Test	https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/an/bud/create
Prod	https://api-cn.lenovo.com/v1.0/supply_chain/scc/an/bud/create

Request description

• Method: POST

• Content-Type: multipart/form-data

Param	key	Type	Required	Length	Description	Example
cdaNo	Y	String	Y	30	CDA number	CDA2023071800001
truckLicense		String		50	truck license	xxxxx
reqDate		Date	Y	-	req date(UTC time)	2023-06-16T16:30:46Z
reqReason		String	Y	200	req reason	test
remark		String		500	remark	-
email		String		100	email	xxx@xx.com
attachmentList		File		-	collection of attachment	-

• Response data description

Param	Type	Required	Length	Description	Example
code	String	Y	10	response code	"0"
msg	String	Y	10	response message	"ok"/"error"
result	Object	N		response payload	refer to response sample

Request sample

anCreateDto:{
    "receiverList": [
        {
            "email": "zhaizg1@lenovo.com"
        }
    ],
    "anCreateItemList": [
        {
            "cdaNo": "CDA2023070500001",
            "truckLicense": "11",
            "reqDate": "2023-09-12T10:23:49Z",
            "reqReason": "22",
            "remark": "xxx"
        }
    ]
}
attachmentList: [
    file01,file02...
]

Successful response sample

{
	"code": "0",
	"msg": "ok"
}

Failed response sample

{
	"code": "-1",
	"msg": "Data already exists,please check!(数据已存在,请检查)"
}

• Business error code

Error code	Error description	Resolution
-1	result code	revise field value according to result message
500	server error	please contact IT with detail error message

Query AN

Request address

Environment	URL
Test	https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/an/bud/query
Prod	https://api-cn.lenovo.com/v1.0/supply_chain/scc/an/bud/query

• Method: POST

• Content-Type: application/json

Request data description

Param	Type	Required	Length	Description	Example
pageNum	Number	Y	10	page number	1
pageSize	Number	Y	4	page size	20
status	String		20	status	Confirm booking
deliveryNote	String		40	delivery note	SM10N01540
po	String		40	purchase order	6500372676
lenovoPn	String		40	lenovo part no	SSS7A23384
anNo	String		40	arrival note	AN2023082400003
cdaNo	String		20	customer declaration number	CDA2023082100007
asnNo	String		20	advanced ship notice	DN2023072720230727
startDate	Date		-	start date	2023-08-15T00:00:01Z
endDate	Date		-	end date	2023-08-18T01:00:01Z

• Response data description

Param	Type	Required	Length	Description	Example
code	String	Y	10	response code	"0"
msg	String	Y	10	response message	"ok"/"error"
result	Object	N		response payload	refer to response sample

Request sample

{
	"pageNum": 1,
    "pageSize": 20,
    "lenovoPn": "SM17A98404"
}

Successful response sample

{
    "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"
            },
            ...
        ]
    }
}

Failed response sample

{
    "code": "-1",
    "msg": "creationDate format exception！"
}

• Business error code

Error code	Error description	Resolution
-1	result code	revise field value according to result message
500	server error	please contact IT with detail error message