ASN

The following interfaces apply to General Data Query

Create ASN

• Request Info

environment	URL
dev	https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/asn/create
prd	https://api-cn.lenovo.com/v1.0/supply_chain/scc/asn/create

• Method: POST

• Content-Type: application/json

• Param Description

field	key	type	Is it mandatory to fill in	length	format	description	example
deliveryNo	Y	string	Y	16		Supplier delivery note number
packCount		number	N	100		Total number of boxes
totalWeight		number	N	100		GROSS WEIGHT
totalVolume		number	N	100		Total Volume
shipFromCity		string	N	40		Shipping City
shipFromCountry		string	N	30		Shipping country
mot		string	Y	10		mode of transport	Truck, Mail, Train, Sea, Air, Sea-Air
carrierId		string	N	50		Carrier ID
shipDate		date	Y	10		the date of issuance(yyyy/MM/dd or yyyy-MM-dd)
eta		date	Y	10		Expected delivery time(yyyy/MM/dd or yyyy-MM-dd)
tmsTrafNO		String	N	50		TMS waybill number
-	-	-	-	-	-	-	-
deliveryLine	Y	string	N	6		Supplier shipping order number line number
po		string	Y	10		PO
poLine		string	Y	5		PO Line
lenovoPn		string	Y	18		Lenovo part number
trackingId		string	Y	35		Logistics tracking number
shippingLine		string	N	30
containerNo		string	N	30		CONTAINER NUMBER
tier2VendorName		String	N	100		Second tier supplier name
-	-	-	-	-	-	-	-
coo		string	N	10		country of origin	CN ，US 等，详情见附件码表
brand		string	N	20		brand	填写物料品牌
deliveryQty		number	Y	100		quantity

• response

field	type	length	description	example
code	String	10	code	"0"
msg	String	10	message	"ok"/"error"
result	Object		result

• Request Example

{
  "deliveryNo": "DN****",
  "packCount": 10.0,
  "totalWeight": 1,
  "totalVolume": 100,
  "shipFromCity": "beijing",
  "shipFromCountry": "China",
  "mot": "Air", 
  "carrierId": "*****",
  "shipDate": "2022-08-01",
  "eta": "2022-08-01",
  "tmsTrafNO": "****",
  "asnItemList": [
    {
      "deliveryLine": "1",
      "po": "*****",
      "poLine": "00010",
      "lenovoPn": "*****",
      "trackingId": "DN******",
      "shippingLine": "1111",
      "containerNo": "*****",
      "tier2VendorName": "*****",
      "asnDeliveryList": [
        {
          "coo": "CN",
          "brand": "Lenovo",
          "deliveryQty": 100
        }
      ]
    }
  ]
}

• Response Example

{
  "code": "0",
  "msg": "ok",
  "result": {
    "asnNo": "TESTAPI00120230906",
    "asnItemList": [
      {
        "asnItemNo": "1",
        "deliveryLineNoList": [
          "1"
        ]
      }
    ]
  }
}

• Error Example

{
  "code": "-1",
  "msg": "error",
  "result": [
    {
      "key": "DNTST202208022",
      "errors": [
        {
          "field": "deliveryNo",
          "message": [
            {
              "value": "DNTST202208022",
              "error": "存在重复数据"
            }
          ]
        }
      ]
    }
  ]
}

Update ASN

• Request Info

environment	URL
dev	https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/asn/update
prd	https://api-cn.lenovo.com/v1.0/supply_chain/scc/asn/update

• Method: POST

• Content-Type: application/json

• Param Description

field	key	type	Is it mandatory to fill in	length	format	description	example
asnNo	Y	string	Y	16		Lenovo Pre shipment Number
asnLine	Y	string	Y	4		Lenovo Pre shipment Line Number
po	Y	string	Y	10		PO
poLine	Y	string	Y	10		PO Line
trackingId		string		35		Waybill number
carrierId		string		50		Carrier/freight forwarder
shippingLine		string		30		Shipping company SCAC
containerNo		string		35		container no	Truck, Mail, Train, Sea, Air, Sea-Air
mot		string		30		Transport method
updateEta		date				Modify pre shipment time

• response

field	type	Is it mandatory to fill in	length	description	example
code	String	Y	10	code	"0"
msg	String	Y	10	message	"ok"/"error"
result	Object	N		result

• Request Example

{
  "asnNo": "*****",
  "asnLine": "1",
  "po": "*****",
  "poLine": "00010",
  "trackingId": "*****",
  "carrierId": "*****",
  "shippingLine": "11111",
  "mot": "Air",
  "containerNo": "*****",
  "updateEta": "2016-06-27"
}

• Response Example

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

• Error Example

{
  "code": "-1",
  "msg": "error",
  "result": [
    {
      "key": "TEST2022071320220713",
      "errors": [
        {
          "field": "asnNo",
          "message": [
            {
              "value": "TEST2022071320220713",
              "error": "ASN不存在"
            }
          ]
        }
      ]
    }
  ]
}

Delete ASN

• Request Info

environment	URL
dev	https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/asn/delete
prd	https://api-cn.lenovo.com/v1.0/supply_chain/scc/asn/delete

• Method: Delete

• Content-Type: application/json

• Param Description

field	type	Is it mandatory to fill in	length	format	description	example
asnNo	string	Y	24		Lenovo Pre shipment Number
site	string	Y	4		site

• response

field	type	Is it mandatory to fill in	length	description	example
code	String	Y	10	code	"0"
msg	String	Y	10	message	"ok"/"error"
result	Object	N		result

• Request Example

[{
  "asnNo": "*****",
  "site": "code**"
}]

• Response Example

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

• Error Example

{
  "code": "-1",
  "msg": "error",
  "result": [
    {
      "key": "TEST2022071320220713",
      "errors": [
        {
          "field": "asnNo",
          "message": [
            {
              "value": "TEST2022071320220713",
              "error": "ASN不存在"
            }
          ]
        }
      ]
    }
  ]
}

Query ASN

• Request Info

environment	URL
dev	https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/asn/query
prd	https://api-cn.lenovo.com/v1.0/supply_chain/scc/asn/query

• Method: POST

• Content-Type: application/json

• Param Description

field	type	Is it mandatory to fill in	length	format	description	example
asnNoList	list	Y			Lenovo Pre shipment Number Collection
deliveryNoList	list				Supplier shipment number set
poList	list				PO collection
lenovoPnList	list				lenovo part number collection

• response

field	type	Is it mandatory to fill in	length	description	example
code	String	Y	10	code	"0"
msg	String	Y	10	message	"ok"/"error"
result	Object	N		result

• Request Example

{
  "asnNoList": ["DNTST20220802220220802", "DNTST2022080220220802"]
}

• Response Example

{
  "code": "0",
  "msg": "ok",
  "result": [
    {
      "orderType": "RT",
      "procurementMode": "LOI",
      "sysModifyBy": "*****",
      "deliveryQtyUom": "EA",
      "poLine": "*****",
      "rid": "*****",
      "lenovoPn": "*****",
      "vendorCode": "*****",
      "asnNo": "*****",
      "sysCreatedBy": "*****",
      "bu": "ISG",
      "mot": "Sea",
      "eta": "2023-09-30",
      "updateEta": "2023-09-30",
      "incotermLoc": "DDU",
      "currency": "USD",
      "id": "*****",
      "trackingId": "1111",
      "traceId": "Can not find PO",
      "isClose": "true",
      "shipToPlant": "shopto",
      "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 *****SSD",
      "isUpdateLocation": "true",
      "site": "code**",
      "incoterm": "DDU",
      "isEdit": "true",
      "lnvStorageLoc": "VBRM",
      "purchaseGroup": "L9O",
      "asnItemStatus": "Open",
      "sysModifyDate": "2023-09-06 14:30:00",
      "asnLine": 1,
      "dataSource": "SCC",
      "status": "Open",
      "po": "*****"
    }
  ]
}

• Error Example