{
"external_user_id": "user_purchasing_01"
}
{
"purchase_order": {
"id": "po_01j5k...",
"status": "SUBMITTED",
"submitted_at": "2026-08-11T13:00:00.000Z"
}
}
{
"error": {
"kind": "purchase_order_invalid_status_transition",
"message": "Purchase order is not in DRAFT status"
}
}
Purchase Orders
Submit purchase order
Moves a purchase order from DRAFT to SUBMITTED status, indicating it was sent to the supplier.
POST
/
api
/
v1
/
public
/
vendors
/
{vendorId}
/
procurement
/
orders
/
{orderId}
{
"external_user_id": "user_purchasing_01"
}
{
"purchase_order": {
"id": "po_01j5k...",
"status": "SUBMITTED",
"submitted_at": "2026-08-11T13:00:00.000Z"
}
}
{
"error": {
"kind": "purchase_order_invalid_status_transition",
"message": "Purchase order is not in DRAFT status"
}
}
string
required
API key with
inventory:write scope.string
required
Vendor UUID.
string
required
Purchase order UUID. Must be in
DRAFT status.string
required
Must be
submit.string
Actor for audit trail.
object
Updated purchase order with
status: "SUBMITTED".{
"external_user_id": "user_purchasing_01"
}
{
"purchase_order": {
"id": "po_01j5k...",
"status": "SUBMITTED",
"submitted_at": "2026-08-11T13:00:00.000Z"
}
}
{
"error": {
"kind": "purchase_order_invalid_status_transition",
"message": "Purchase order is not in DRAFT status"
}
}