Enterprise FeatureThis feature is only available to customers with an enterprise Platform subscription. Please get in touch to discuss enabling it on your account.
The Purchase Orders API allows solution developers to store information in the Platform describing the purchase orders in their supply chain. This is normally done at the time when products are ordered from a supplier, supplying a record of exact quantities ordered.
Each purchase order created contains details on the parties involved in the creation of that order (such as the manufacturer or supplier, and the buyer), as well as the product type or SKU being produced and at which quantities.
API Status
General availability:
/purchaseOrders
/purchaseOrders/:purchaseOrderId
/purchaseOrders
/purchaseOrders/:purchaseOrderId
PurchaseOrderDocument Data Model
An object representing a purchase order.
.id (string, required)
The purchase order ID.
.evrythngId (string, read-only)
Standard 24 character EVRYTHNG ID of this purchase order.
.createdAt (integer, read-only)
Timestamp when the resource was created.
.updatedAt (integer, read-only)
Timestamp when the resource was updated.
.version (string)
The latest version of the purchase order.
.status (string, required)
The status of the purchase order, such as 'open' or
'cancelled'.
.purchaser (string)
The name of the purchasing party.
.description (string)
Friendly description of this resource.
.type (string, required)
The type of purchase order determines how the manufacturer
interprets the Order, such as 'stand-alone', 'reorder',
'direct-ship'.
.issueDate (string, required)
The date the purchase order was issued, in YYYY-MM-DD
format.
.parties (array of PurchaseOrderPartyDocument, max. 13, required)
The parties involved in the purchase order. Must contain one
item for each of 'ship-from', 'ship-to', and 'supplier'.
.lines (array of LineItemDocument, max. 1000, required)
Line Items outlining the products, quantities and dates
included in the purchase order.
.tags (array of string)
Array of string tags associated with this resource.
.customFields (CustomFieldsDocument)
Object of case-sensitive key-value pairs of custom fields
associated with the resource.
.identifiers (IdentifiersDocument)
Various identifiers (EPC, GTIN, etc.) as a JSON object with
one or more key-value pairs.
See also: PurchaseOrderPartyDocument
, LineItemDocument
Filterable Fields
This resource type can be filtered using the following fields and operators.
PurchaseOrderPartyDocument Data Model
See also: AddressDocument
AddressDocument
LineItemDocument Data Model
A single line item.
Create a Purchase Order
Read all Purchase Orders
List purchase orders in an account
Read a Purchase Order
Purchase Order resources can be read from the API using the id
originally supplied in the creation request.
Update a Purchase Order
Update a Purchase Order by submitting a full update to the original resource. A partial update with a partial payload is possible for the following properties: version
, status
, purchaser
, description
, type
, issueDate
, parties
, identifiers
, customFields
, tags
.
Delete a Purchase Order
Delete a single Purchase Order by ID.