Purchase Order 1.0.0
General Discussion
It is recommended as a best practice for Distributors submitting purchase orders to:
Submit the PO
A transaction ID response indicates the request has been received
Check status of purchase order by querying the Order Status API using PO # (query type 1) - this will confirm successful receipt and processing of purchase order by the supplier
“Order Received” indicates the order is in the system and requester gets a sales order number back
Monitor from that point forward via Order Status API
Once order is marked as “Complete” in order status, trigger an OSN call for the shipping details
Use the Order Shipment Notification API to confirm shipment and delivery information
Note that some suppliers may have a time gap between when the PO is received and when a Distributor can successfully query it via Order Status. Distributors might need to review with Suppliers if there is a time gap between the two due to asynchronous processing - Suppliers should detail out any processing delays in their integration guides.
Definitions
ContactType:
Art- Person or entity responsible for creating/supporting Artwork. Use this ContactType for Artwork related questions
Bill - Person or entity responsible for receiving/paying the Invoice from the Supplier
Expeditor - Person or team supporting order related questions from the Supplier
Order - Person or team responsible for placing the order
Sales- Person managing/supporting the end customer account. Use this ContactType to apply specific Sales person to the order for Commissions/reporting
Ship- Person or entity receiving the shipment from the Supplier
Sold - Person or Entity with whom the sales agreement is negotiated
Blank PO RequestsendPO()
Field | Description | Required | Best Practice |
orderType | The type of data transferred in the request; values are enumerated: “Blank”—This is data for blank goods. “Sample”—This data is for a random sample order “Simple”—The data in the purchase order is sent over without supplier configured data and will be processed manually. “Configured”—The data is sent over in conjunction with the supplier’s Product Pricing and Configuration web service and designed for electronic processing of the purchase order. | TRUE | Use Blank as the OrderType |
orderNumber | Purchase order number | TRUE |
|
orderDate | The date and time of the purchase order. | TRUE |
|
lastModified | The date and time the purchase order was last modified | FALSE |
|
totalAmount | The total dollar amount of the purchase order | TRUE |
|
paymentTerms | The terms of the purchase order. i.e. NET15, NET30, etc. | FALSE |
|
rush | Used to indicate a rush on the purchase order. | TRUE |
|
currency | The currency the purchase order is transacted in ISO4217 format. | TRUE |
|
DigitalProof | An object containing preproduction digital proof information | FALSE |
|
OrderContactArray | An array of contact information | FALSE | Recommended to share this information if available to address any issues. SoldTo contact can be used to identify the customer who can help with addressing any issues related to the order. |
ShipmentArray | Any array of purchase order shipments | TRUE |
|
LineItemArray | An array of purchase order line items | TRUE |
|
termsAndConditions | The terms and conditions for this purchase order. Information that is order specific or information dealing with the configuration or shipment of the order should not be entered here. | FALSE |
|
salesChannel | The sales channel | FALSE | Recommended to ensure order is placed under the appropriate office/location. Mark this open to be discussed later since this field is being used for different purposes. |
promoCode | The promotion code | FALSE | Supplier specific feature. Please check with the Supplier before using this field. |
TaxInformationArray | An array of TaxInformation objects related to calculating taxes | FALSE |
|
Digital Proof
Field | Description | Required | Best Practice |
required | A Boolean value set to TRUE indicates a proof is required for this purchase order; the value is FALSE otherwise. | TRUE |
|
DigitalProofAddressesArray | An array containing DigitalProofAddress objects. | TRUE |
|