Purchase Orders

Update a purchase order

The warehouse cannot change while a shipment is linked to the order, and the call answers 422 then. A change of the order level costs spreads them over the items again.

patch/api/v1/sa/inventory/purchase-orders/{id}

Request

  • Base URL: https://app.sellerassistant.app (the document declares no server; this is the origin it was published from)
  • URL: https://app.sellerassistant.app/api/v1/sa/inventory/purchase-orders/{id}
  • Auth: one of:
    • API key in query parameter api_key
    • API key in header X-Api-Key

Path parameters

idinteger required
Example:42

Request body

po_idstring
status'draft' | 'sent' | 'completed' | 'cancelled'
prep_center_idinteger nullable

The warehouse. It cannot change while a shipment is linked to the order.

order_datestring date nullable
shipping_costnumber nullable
taxesnumber nullable
misc_expensesnumber nullable
user_idinteger

The member of the team who owns the order. A user of another team answers 400.

Example request

{
  "po_id": "PO-2026-018",
  "status": "draft",
  "prep_center_id": 3,
  "order_date": "2026-09-14",
  "user_id": 12
}

Response

The purchase order

Example response

{
  "data": {
    "id": 42,
    "po_id": "PO-2026-018",
    "status": "draft",
    "supplier_id": 5,
    "marketplace_id": "ATVPDKIKX0DER",
    "prep_center_id": 3,
    "order_date": "2026-09-14",
    "currency": "USD",
    "items_count": 12,
    "subtotal": 1240,
    "total_price": 1380.5,
    "supplier": {
      "id": 5,
      "name": "Acme Wholesale",
      "currency": "USD"
    },
    "items": [
      {
        "id": 4471,
        "purchase_order_id": 42,
        "internal_product_id": "P-5XK1S0NQNO",
        "asin": "B0019MQM64",
        "unit_cost": 9.5,
        "unit_count": 12,
        "total_cost": 114
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.