Purchase Order 1.0.0

Purchase Order 1.0.0

General Discussion

It is recommended as a best practice for Distributors submitting purchase orders to:

  1. Submit the PO

    1. A transaction ID response indicates the request has been received 

  2. 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

    1. “Order Received” indicates the order is in the system and requester gets a sales order number back 

  3. Monitor from that point forward via Order Status API

    1. Once order is marked as “Complete” in order status, trigger an OSN call for the shipping details

  4. 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:

  1. Art- Person or entity responsible for creating/supporting Artwork. Use this ContactType for Artwork related questions

  2. Bill - Person or entity responsible for receiving/paying the Invoice from the Supplier

  3. Expeditor - Person or team supporting order related questions from the Supplier

  4. Order - Person or team responsible for placing the order

  5. Sales- Person managing/supporting the end customer account. Use this ContactType to apply specific Sales person to the order for Commissions/reporting

  6. Ship- Person or entity receiving the shipment from the Supplier

  7. 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