How to place a Purchase Order for blank goods
Educational video from PromoStandards
Function SendPO
In order to send a purchase order for blank goods we need to use Purchase Order Service(PO). Our API allows easy access by a POST request to our purchase-orders endpoint.
You need to use authentication in order to use this service. More information on how to authenticate can be found here.
HTTP VERB: POST
URL: https://api.psrestful.com/v1.0.0/suppliers/{SUPPLIER_CODE}/purchase-orders/ (opens in a new tab)
Example Response:
This is the response from calling with:
SUPPLIER_CODE = HIT
Payload
{
"orderType": "Blank",
"orderNumber": "59",
"orderDate": "2023-06-15T17:47:26.102Z",
"lastModified": "2023-06-15T17:47:26.102Z",
"totalAmount": 309.60,
"paymentTerms": "NET60",
"rush": false,
"currency": "USD",
"DigitalProof": null,
"OrderContactArray": {
"Contact": [
{
"contactType": "Order",
"ContactDetails": {
"attentionTo": "John Doe",
"companyName": "My Company",
"address1": "Address 1",
"address2": "Address 2",
"city": "City",
"region": "State",
"postalCode": "zip code",
"country": "US",
"email": "me@mycompany.com",
"phone": "",
"comments": ""
},
"accountName": null,
"accountNumber": null
}
]
},
"ShipmentArray": {
"Shipment": [
{
"ShipTo": {
"customerPickup": false,
"shipmentId": 0,
"ContactDetails": {
"attentionTo": "John Doe",
"companyName": "My Company",
"address1": "Address 1",
"address2": "Address 2",
"city": "City",
"region": "State",
"postalCode": "Zip Code",
"country": "US",
"email": "me@mycompany.com",
"phone": "",
"comments": ""
}
},
"packingListRequired": true,
"blindShip": true,
"allowConsolidation": true,
"FreightDetails": {
"carrier": "UPS",
"service": "Ground"
},
"ThirdPartyAccount": null,
"shipReferences": null,
"comments": "string"
}
]
},
"LineItemArray": {
"LineItem": [
{
"lineNumber": "1",
"description": "10 units of 2811BLK",
"lineType": "New",
"Quantity": {
"value": 100,
"uom": "EA"
},
"fobId": "1",
"ToleranceDetails": {
"tolerance": "ExactOnly",
"value": 0,
"uom": "Percent"
},
"allowPartialShipments": false,
"unitPrice": 3.096,
"lineItemTotal": 309.60,
"requestedShipDate": "2023-06-15",
"requestedInHandsDate": "2023-06-25",
"referenceSalesQuote": null,
"Program": null,
"endCustomerSalesOrder": "4343",
"productId": "30070",
"customerProductId": "1996",
"lineItemGroupingId": null,
"PartArray": {
"Part": [
{
"partId": "30070BLK",
"Quantity": {
"value": 100,
"uom": "EA"
},
"partGroup": "",
"customerPartId": "",
"customerSupplied": true,
"description": "",
"locationLinkId": [
0
],
"unitPrice": 3.096,
"extendedPrice": 309.60,
"ShipmentLinkArray": {
"ShipmentLink": [
{
"shipmentId": 1,
"Quantity": {
"value": 100,
"uom": "EA"
}
}
]
}
}
]
},
"Configuration": null
}
]
},
"termsAndConditions": "terms agreed to",
"salesChannel": null,
"promoCode": null,
"TaxInformationArray": null
}COMPLETE URL:
https://api.psrestful.com/v1.0.0/suppliers/HIT/purchase-orders/Response
{
"transactionId": "115867",
"ServiceMessageArray": {
"ServiceMessage": [
{
"code": 999,
"description": "General Error - Contact the System Service Provider Details: **WARNING* Fix: Multiple Models for XXX, must confirm",
"severity": "Warning"
}
]
}
}