Submit purchase order

{
  "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"
  }
}

POST

api

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"
  }
}