Purchase Order Lifecycle
A Purchase Order advances through a series of states throughout its lifecycle.
This diagram illustrates the different states in the lifecycle and the transitions between them. The most typical transition paths are shown in solid lines, while dotted lines indicate possible but less common paths.
|Purchase Order is in a draft state, meaning it can be edited.|
|Purchase Order is waiting for a somebody to approve or reject it. It cannot be edited in this state.|
|Purchase Order has been rejected. It can be edited in this state.|
|Purchase Order has been approved. At this point, it can no longer be edited.|
|Purchase Order has been purchased|
|Some line items has been partially received|
|All line items have been fully received|
|Purchase Order is complete. The only editable fields at this point are description and labels.|
To transition from one state to the next, you must call the appropriate API endpoint with the
We do not support receiving inventory in the Purchase Orders API.
The table below describes which all possible states and which endpoints you need to call to perform the transition.
If you attempt to call an endpoint and the transition is impossible, you will get a HTTP 422 with an error in the response body.
|Initial State||Possible Transition States||Endpoint|