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	CDA202****0001
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": "xxx@xx.com"
        }
    ],
    "anCreateItemList": [
        {
            "cdaNo": "CDA202****0001",
            "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	SM1****40
po	String		40	purchase order	65****6
lenovoPn	String		40	lenovo part no	S****4
anNo	String		40	arrival note	AN1111111
cdaNo	String		20	customer declaration number	CDA111111
asnNo	String		20	advanced ship notice	DN1111111
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": "pn1"
}

Successful response sample

{
    "code": "0",
    "msg": "ok",
    "result": {
        "total": 2,
        "pageNum": 1,
        "pageSize": 20,
        "list": [
            {
	              "status": "Close",
                "anNo": "AN1111111111",
                "deliveryNote": "dn-23",
                "truckLicense": "11",
                "reqDate": "2023-09-12T10:23:49Z",
                "reqReason": "22",
                "itemStatus": "Close",
                "anType": "LOI",
                "vendorCode": "vendor1",
                "vendorName": "ABCD",
                "shipCountry": "CHN China",
                "carrierId": "11111",
                "trackingId": "1111",
                "invoice": "11111",
                "containerNo": "ABC0001",
                "mot": "Sea1",
                "shipToPlant": "1111",
                "anLine": 1,
                "asnNo": "ASN****",
                "asnLine": 1,
                "cdaNo": "CDA1111",
                "po": "po1",
                "poLine": "1",
                "lenovoPn": "pn1",
                "partDescription": "part description",
                "qty": "200",
                "etaStatus": "111",
                "orderType": "MB",
                "bu": "IDG",
                "site": "ULLO",
                "hawb": "CV111111",
                "cartons": "10",
                "grossWeight": "100",
                "shippingLine": "test",
                "coo": "coo1",
                "brand": "brand1",
                "containerSize": "22",
                "pallets": "1",
                "incoterm": "aaaa",
                "incotermslocation": "HK",
                "currency": "USD",
                "portOfDischarge": "BUDAPEST",
                "remark": "remark1",
                "creator": "abcd",
                "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