> ## 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.

# CreatePurchaseOrder

> Creates a new purchase order with item positions.

If a request with this mutation's Idempotency-Key was already completed, the response's `extensions` contains an `idempotency.{responseName}` entry with `wasReplayed: true`.



**mutation** `CreatePurchaseOrder(request: CreatePurchaseOrderCommandRequestInput!): CreatePurchaseOrderCommandResponse!`

## Arguments

**`request`**: `CreatePurchaseOrderCommandRequestInput!` (required)

## Returns

`CreatePurchaseOrderCommandResponse!`

**`purchaseOrderId`**: `ID!`

Unique ID of the newly created purchase order.

## Examples

```graphql Mutation
mutation CreatePurchaseOrder($request: CreatePurchaseOrderCommandRequestInput!) {
  CreatePurchaseOrder(request: $request) {
    purchaseOrderId
  }
}
```

```json Variables
{
  "request": {
    "supplierId": "id",
    "requestedDeliveryDate": "value",
    "items": [
      {
        "itemId": "id",
        "quantity": "value",
        "netPurchasePriceAmount": "value",
        "vatRatePercentage": "value"
      }
    ]
  }
}
```

```json Response
{
  "data": {
    "CreatePurchaseOrder": {
      "purchaseOrderId": "id"
    }
  }
}
```
