# CreatePurchaseOrderInput

input type

Create-input for createPurchaseOrder.

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `caption` | [String](/types/#scalars) | no | Optional: when omitted the per-type default applies — 'purchase order <N> line(s)'; when supplied it must be non-blank. |
| `orgVendorId` | [ID](/types/#scalars) `ID!` | yes | The supplying OrgVendor enablement — tenant-scoped + ACTIVE server-side; IMMUTABLE after birth (re-vendor = cancel + new). Its purchasingCurrency SNAPSHOTS as the PO currency (UNSET refuses NAMED — -i). |
| `paymentTerms` | [String](/types/#scalars) | no | Optional canned payment terms (registry tokens, e.g. net-30) — omitted ⇒ the OrgVendor's. |
| `incotermCode` | [String](/types/#scalars) | no | Optional canned Incoterms 2020 rule — omitted ⇒ the OrgVendor's. |
| `vendorReference` | [String](/types/#scalars) | no | Optional vendor-side order/quote reference (max 64). |
| `notes` | [String](/types/#scalars) | no | Optional free-text notes (max 4096). |
| `lines` | [PurchaseOrderLineInput](/types/PurchaseOrderLineInput/) `[PurchaseOrderLineInput!]!` | yes | The lines (1..90 — the PER-CALL ceiling, distinct variant × receiving-LF keys; lineNo assigned 1..N in input order. A bigger order composes: create up to the per-call ceiling, then addPurchaseOrderLines up to 1000 lines on the document). |

## Used by

- [createPurchaseOrder](/reference/purchasing/createPurchaseOrder/)