> ## Documentation Index
> Fetch the complete documentation index at: https://developer.jtl-software.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CreatePurchaseOrderCommandRequestInput

> Creates a new purchase order with item positions. - Request



**Kind**: `input`

## Fields

**`supplierId`**: `ID!` (required)

ID of the supplier the order is placed with. Must reference an existing procurement supplier.

---

**`requestedDeliveryDate`**: `DateTime!` (required)

The delivery date requested from the supplier.

---

**`items`**: `[CreateCreatePurchaseOrderItemInput]!` (required)

Item positions of the order. At least one is required (enforced server-side; the list schema here has no declarative minimum-length constraint).

---

**`deliveryAddress`**: `CreatePurchaseOrderAddressInput`

Delivery address of the order. When omitted, it is defaulted from the effective warehouse's address (see WarehouseId). A country name that cannot be resolved to an ISO code yields an empty CountryIso rather than failing the create.

---

**`billingAddress`**: `CreatePurchaseOrderAddressInput`

Billing address of the order. When omitted, it is defaulted from the effective company's address.

---

**`externalOrderNumber`**: `String`

The buyer's own external reference for this order (free text). Never generated by the server — contrast the order's own number, which the server assigns and which is not settable through this API.

---

**`referenceOrderNumber`**: `String`

A reference order number for this order — the "Zugehörige Auftragsnummer" field, free text, editable in the desktop UI.

---

**`internalComment`**: `String`

Internal comment on the order, not communicated to the supplier.

---

**`warehouseId`**: `ID`

Target warehouse of the incoming goods. When omitted, the supplier's own default warehouse is used. When supplied (or defaulted from the supplier), it must reference an existing warehouse.

---

**`disableAutomaticWorkflows`**: `Boolean`

Indicates whether automatic workflows should be disabled for this purchase order.

---

**`idempotencyKey`**: `String`

Client-supplied idempotency key. When provided, a repeated request with the same key and payload replays the original result instead of re-executing the mutation.