Purchase Orders

Create purchase orders

A new order is always a draft, and the items arrive through the items endpoint. The plan must carry the purchase orders, and the team must have one left of its quota for every order of the call: without either the call answers 422. The body is one order or an array of them.

post/api/v1/sa/inventory/purchase-orders

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
  • Auth: one of:
    • API key in query parameter api_key
    • API key in header X-Api-Key

Request body

OR

Example request

{
  "supplier_id": 5
}

Response

One result for each element. An array answers this shape.

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
        }
      ]
    }
  ],
  "meta": {
    "succeeded": 2,
    "failed": 1
  },
  "errors": [
    {
      "code": "not_found",
      "message": "The product [P-1] was not found."
    }
  ]
}

Changes

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