Skip to main content

Purchase order

Represents a purchase order to a supplier: number, status, order and expected receipt dates, vendor (vendorId), optional supplier quote reference (vendorReference), receiving warehouse (shipToWarehouseId), lines with ordered and received quantities, prices, tax rates, totals, and payment terms. Typical for procurement, MRP, and goods-receipt flows into an ERP.

Full JSON example​

{
  "id": "po_3Bc6De9Fg2Hi5",
  "channel": "demoipaas",
  "createdAt": "2026-01-09T09:00:00+00:00",
  "updatedAt": "2026-01-11T11:45:00+00:00",
  "number": "PO-2026-0045",
  "status": "approved",
  "orderDate": "2026-01-09",
  "expectedReceiptDate": "2026-02-05",
  "vendorId": "vend_SUPPLIER_XYZ",
  "vendorReference": "QT-77881",
  "currency": "EUR",
  "shipToWarehouseId": "wh_MIL01",
  "lineItems": [
    {
      "position": 10,
      "itemId": "itm_RAW_STEEL_COIL",
      "description": "Bobina acciaio 2t",
      "quantityOrdered": 5,
      "quantityReceived": 0,
      "unitPrice": 820,
      "taxRate": 22,
      "lineTotal": 4100
    }
  ],
  "subtotal": 4100,
  "taxTotal": 902,
  "grandTotal": 5002,
  "paymentTerms": "Net 45",
  "notes": null
}

Remarkable notes​

  • quantityReceived updates with receipts; it is often zero on create.
  • Map status (draft, approved, closed, etc.) to the connected ERP lifecycle.
  • Multiple ship-to addresses may need extra fields beyond shipToWarehouseId depending on the connector.