The Create Order Asynchronous POST

A purchase order represents the solution being ordered and some can be complex or rather simple. Most purchase orders comprise the basics of a PO#, a ship to address, a shipping method, and a list of items. There are several easily overlooked fields you will or may want to pass to ensure order accuracy and provide additional information to your ScanSource team. 

Let's begin with a basic order payload. Note the standard for passing state and country codes and the shipping method codes. 

{
"BusinessUnit": 1700,
"PONumber": "PONumber",
"ShippingInfo": {
"ShipMethodServiceLevelCode": "PGD",
"ShippingAddress": {
"Name": "Company Name",
"Street1": "Street1",
"Street2": "Street2",
"City": "Greenville",
"State": "SC",
"PostalCode": "29681",
"Country": "US"
}
},
"Lines": [{
"PartNumber": "string",
"PartType": 0,
"Quantity": 1,
}],
}

The addition of a few extra fields mapped from your system can greatly improve your order experience. Note the following additional fields and what they do: 

EndUserPO and Attn will print on the shipping label and assist your customer during receiving. 
EnteredByEmailAddress helps our sales team reach out to your buyer if the order requires intervention. 
Memo passes notes to the sales team and forces order intervention. This is useful for special pricing if you can not pass an intentional field like DealID. ]

The VRD Answers array is commonly passed to fulfill supplier vendor required data fields. They vary based on the requirements of each supplier represented by the items in your payload. View details about the VRD fields in the order documentation. 

{
"BusinessUnit": 1700,
"PONumber": "PONumber",
"EndUserPO": "ENDUSERPO",
"EnteredByEmailAddress": "buyer@yourdomain.com",
"Memo": "Notes passed to sales team that will stop order from immediately dropping to warehouse.",
"ShippingInfo": {
"ShipMethodServiceLevelCode": "PGD",
"ShippingAddress": {
"Name": "Company Name",
"Attn": "Appears on label",
"Street1": "Street1",
"Street2": "Street2",
"City": "Greenville",
"State": "SC",
"PostalCode": "29681",
"Country": "US"
}
},
"DealIds": [
"PC001"
],
"Lines": [{
"PartNumber": "string",
"PartType": 0,
"POLineNumber": 10,
"Quantity": 1,
"Price": 100,
"DealIDs": [
"PC001"
]
}],
"VRD": [{
"Key": "EU_NAME", "Value": "Company Name"
},
{
"Key": "EU_City", "Value": "Greenville"
},
{
"Key": "EU_STATE", "Value": "SC"
},
{
"Key": "EU_ZIP", "Value": "29615"
}
]
}

We can handle more complex orders such as rush shipping, 3rd party freight accounts, software subscriptions. service renewals and more. While onboarding, we can work with you and your sales team on your order types and help test all of the required fields are being mapped and passed into our ERP.