Purchase

The following interfaces apply to API Data Integration

Create Purchase

• URL: https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/master_data/purchase

• Request data description

Param	Type	Required	Length	Format	Description	Example

• 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 smaple

{
  "lenovoPn": "",
  "plant": "",
  "vendorCode": "",
  "vendorName": "",
  "tier2VendorCode": "",
  "tier2VendorName": "",
  "tier2VendorEmail": "",
  "lnvPnDescription": "",
  "vendorPn": "",
  "alternativePn": "",
  "warranty": "",
  "whereUse": "",
  "moq": 0,
  "mpq": 0,
  "cycleTime": 0,
  "procurementMode": "",
  "purchaseLeadtime": 0,
  "orderAddressCodeOa": "",
  "paymentInformationCodePi": "",
  "paymentCurrency": "",
  "rmaType": "",
  "returnMode": "",
  "returnFrequency": "",
  "returnServiceProvider": "",
  "lenovoBuyerEmail": "",
  "lenovoGsmEmail": "",
  "lenovoGcmEmail": "",
  "supplierSalesContact": "",
  "supplierContactsTakeOrders": "",
  "supplierContactsShipping": "",
  "logisticsProviderContact": "",
  "customsBrokerContact": "",
  "supplierContactInvoice": "",
  "supplierContactAfterSales": "",
  "dockingSystemAccount": "",
  "poCollaborationMethod": "",
  "asnCreationMethod": "",
  "cdaCreationMethod": "",
  "svCreationMethod": "",
  "carPooling": ""
}

• Successful response sample

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

• Failed response sample

{
}

• 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

Customs

• URL: https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/master_data/customs

• Request data description

Param	Type	Required	Length	Format	Description	Example

• 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

{
  "lenovoPn": "",
  "vendorCode": "",
  "inhouseSite": "",
  "countryIsoCode": "",
  "finishedGoods": "",
  "bonded": "",
  "hsCode": "",
  "commodityNameInChinese": "",
  "partEnglishDescription": "",
  "brand": "",
  "declareElements": "",
  "conversionRatioPerUnit": 0,
  "netWeightKgs": 0.0,
  "unitPrice": 0.0,
  "currency": "",
  "photos": "",
  "supervisionRequirements": "",
  "certificate": "",
  "certificateNo": "",
  "expiryDate": "",
  "additionalInformation": "",
  "eccnCode": ""
}

• Successful response sample

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

• Failed response sample

{
}

• 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

Logistics

• URL: https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/master_data/logistics

• Request data description

Param	Type	Required	Length	Format	Description	Example

• 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

{
  "rid": "",
  "vendorCode": "",
  "lenovoPn": "",
  "plant": "",
  "bonded": "",
  "mot": "",
  "deliveryRoute1": "",
  "deliveryRoute2": "",
  "deliveryRoute3": "",
  "deliveryRoute4": "",
  "deliveryRoute5": "",
  "fullBoxQty": 0,
  "boxQtyPerPallet": 0,
  "fullPalletQty": 0,
  "grossWeightPerUnit": 0.00,
  "netWeightPerUnit": 0.00,
  "volumePerUnit": 0.00,
  "serialNumberControl": "",
  "batteryInside": "",
  "piValue": "",
  "magneticOrNot": "",
  "anyHeavyMetal": "",
  "eccnControl": ""
}

• Successful response sample

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

• Failed response sample

Vendor

• URL: https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/master_data/vendor

• Request data description

Param	Type	Required	Length	Format	Description	Example

• 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

{
  "vendorCode": "",
  "vendorName": "",
  "forwarderName": "",
  "forwarderEmail": "",
  "customsBrokerName": "",
  "customsBrokerEmail": ""
}

• Successful response sample

• Failed response sample