Create a purchase order with lines

Lines reference products by SKU within the client's catalog (clientId omitted = house catalog). Unknown SKUs are rejected with 422.

Request body (optional)

poNumberstringrequired

clientIdstringnullable

statusenum

draftopenpartially_receivedreceivedclosedcancelled

supplierNamestringnullable

supplierRefstringnullable

expectedDatestring (date-time)nullable

notesstringnullable

linesobject[]

idstring

productIdstringnullable

skustringrequired

orderedQtyintegerrequired

unitOfMeasurestring

Responses

201Created purchase order

object

422Unknown SKU or invalid input

errorstringrequired

Sending requests from a browser

Open https://v3.revolutionstreetwxs.io/api/v3/docs to send requests to this endpoint with your API key.

Request

curl -X POST 'https://v3.revolutionstreetwxs.io/api/v3/purchase-orders' \
  -H "Authorization: Bearer wxs_pk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "poNumber": "PO-2041",
  "clientId": "client id",
  "status": "draft",
  "supplierName": "supplier name",
  "supplierRef": "supplier ref",
  "expectedDate": "2026-09-15T14:30:00Z",
  "notes": "Example note",
  "lines": [
    {
      "id": "id",
      "productId": "product id",
      "sku": "SKU-ABC-001",
      "orderedQty": 1,
      "unitOfMeasure": "unit of measure"
    }
  ]
}'

const response = await fetch("https://v3.revolutionstreetwxs.io/api/v3/purchase-orders", {
  method: "POST",
  headers: {
    Authorization: "Bearer wxs_pk_YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "poNumber": "PO-2041",
    "clientId": "client id",
    "status": "draft",
    "supplierName": "supplier name",
    "supplierRef": "supplier ref",
    "expectedDate": "2026-09-15T14:30:00Z",
    "notes": "Example note",
    "lines": [
      {
        "id": "id",
        "productId": "product id",
        "sku": "SKU-ABC-001",
        "orderedQty": 1,
        "unitOfMeasure": "unit of measure"
      }
    ]
  }),
});
const data = await response.json();

import requests

response = requests.post(
    "https://v3.revolutionstreetwxs.io/api/v3/purchase-orders",
    headers={"Authorization": "Bearer wxs_pk_YOUR_API_KEY"},
    json={
      "poNumber": "PO-2041",
      "clientId": "client id",
      "status": "draft",
      "supplierName": "supplier name",
      "supplierRef": "supplier ref",
      "expectedDate": "2026-09-15T14:30:00Z",
      "notes": "Example note",
      "lines": [
        {
          "id": "id",
          "productId": "product id",
          "sku": "SKU-ABC-001",
          "orderedQty": 1,
          "unitOfMeasure": "unit of measure"
        }
      ]
    },
)
data = response.json()

Response 201

{
  "id": "3f9c2c6e-9d0b-4b62-8f7d-2a4b9e1c5d10",
  "poNumber": "PO-2041",
  "clientId": "3f9c2c6e-9d0b-4b62-8f7d-2a4b9e1c5d10",
  "status": "status",
  "supplierName": "supplier name",
  "supplierRef": "supplier ref",
  "expectedDate": "expected date",
  "notes": "Example note",
  "createdAt": "created at",
  "updatedAt": "updated at",
  "closedAt": "closed at",
  "lines": [
    {
      "id": "3f9c2c6e-9d0b-4b62-8f7d-2a4b9e1c5d10",
      "lineNumber": 1.5,
      "productId": "3f9c2c6e-9d0b-4b62-8f7d-2a4b9e1c5d10",
      "sku": "SKU-ABC-001",
      "orderedQty": 1.5,
      "receivedQty": 1.5,
      "unitOfMeasure": "unit of measure"
    }
  ]
}