Update Purchase Order Line Item

curl --request PATCH \
  --url https://api.jtl-cloud.com/erp/v2/purchase-orders/{purchaseOrderId}/line-items/{lineItemId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-tenant-id: <x-tenant-id>' \
  --data '
{
  "quantity": 123,
  "netPurchasePriceAmount": 123,
  "deliveryDate": "2023-11-07T05:31:56Z",
  "note": "<string>",
  "confirmedQuantity": 123,
  "confirmedDeliveryDate": "2023-11-07T05:31:56Z",
  "confirmedPrice": 123,
  "isLineItemConfirmed": true
}
'

import requests

url = "https://api.jtl-cloud.com/erp/v2/purchase-orders/{purchaseOrderId}/line-items/{lineItemId}"

payload = {
    "quantity": 123,
    "netPurchasePriceAmount": 123,
    "deliveryDate": "2023-11-07T05:31:56Z",
    "note": "<string>",
    "confirmedQuantity": 123,
    "confirmedDeliveryDate": "2023-11-07T05:31:56Z",
    "confirmedPrice": 123,
    "isLineItemConfirmed": True
}
headers = {
    "x-tenant-id": "<x-tenant-id>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {
    'x-tenant-id': '<x-tenant-id>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    quantity: 123,
    netPurchasePriceAmount: 123,
    deliveryDate: '2023-11-07T05:31:56Z',
    note: '<string>',
    confirmedQuantity: 123,
    confirmedDeliveryDate: '2023-11-07T05:31:56Z',
    confirmedPrice: 123,
    isLineItemConfirmed: true
  })
};

fetch('https://api.jtl-cloud.com/erp/v2/purchase-orders/{purchaseOrderId}/line-items/{lineItemId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.jtl-cloud.com/erp/v2/purchase-orders/{purchaseOrderId}/line-items/{lineItemId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'quantity' => 123,
    'netPurchasePriceAmount' => 123,
    'deliveryDate' => '2023-11-07T05:31:56Z',
    'note' => '<string>',
    'confirmedQuantity' => 123,
    'confirmedDeliveryDate' => '2023-11-07T05:31:56Z',
    'confirmedPrice' => 123,
    'isLineItemConfirmed' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "x-tenant-id: <x-tenant-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.jtl-cloud.com/erp/v2/purchase-orders/{purchaseOrderId}/line-items/{lineItemId}"

	payload := strings.NewReader("{\n  \"quantity\": 123,\n  \"netPurchasePriceAmount\": 123,\n  \"deliveryDate\": \"2023-11-07T05:31:56Z\",\n  \"note\": \"<string>\",\n  \"confirmedQuantity\": 123,\n  \"confirmedDeliveryDate\": \"2023-11-07T05:31:56Z\",\n  \"confirmedPrice\": 123,\n  \"isLineItemConfirmed\": true\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("x-tenant-id", "<x-tenant-id>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.jtl-cloud.com/erp/v2/purchase-orders/{purchaseOrderId}/line-items/{lineItemId}")
  .header("x-tenant-id", "<x-tenant-id>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"quantity\": 123,\n  \"netPurchasePriceAmount\": 123,\n  \"deliveryDate\": \"2023-11-07T05:31:56Z\",\n  \"note\": \"<string>\",\n  \"confirmedQuantity\": 123,\n  \"confirmedDeliveryDate\": \"2023-11-07T05:31:56Z\",\n  \"confirmedPrice\": 123,\n  \"isLineItemConfirmed\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.jtl-cloud.com/erp/v2/purchase-orders/{purchaseOrderId}/line-items/{lineItemId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["x-tenant-id"] = '<x-tenant-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"quantity\": 123,\n  \"netPurchasePriceAmount\": 123,\n  \"deliveryDate\": \"2023-11-07T05:31:56Z\",\n  \"note\": \"<string>\",\n  \"confirmedQuantity\": 123,\n  \"confirmedDeliveryDate\": \"2023-11-07T05:31:56Z\",\n  \"confirmedPrice\": 123,\n  \"isLineItemConfirmed\": true\n}"

response = http.request(request)
puts response.read_body

{
  "purchaseOrderId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "supplierId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "status": 0,
  "currencyIso": "<string>",
  "currencyFactor": 123,
  "isConfirmed": true,
  "lineItems": [
    {
      "lineItemId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
      "lineItemType": 0,
      "quantity": 123,
      "deliveredQuantity": 123,
      "openQuantity": 123,
      "netPurchasePriceAmount": 123,
      "vatRatePercentage": 123,
      "sortOrder": 123,
      "itemId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
      "itemNumber": "<string>",
      "supplierItemNumber": "<string>",
      "name": "<string>",
      "supplierItemName": "<string>",
      "deliveryTimeInDays": 123,
      "deliveryDate": "2023-11-07T05:31:56Z",
      "note": "<string>",
      "packagingUnit": "<string>",
      "packagingQuantity": 123,
      "confirmedQuantity": 123,
      "confirmedDeliveryDate": "2023-11-07T05:31:56Z",
      "confirmedPrice": 123,
      "isLineItemConfirmed": true
    }
  ],
  "supplierName": "<string>",
  "orderNumber": "<string>",
  "externalOrderNumber": "<string>",
  "referenceOrderNumber": "<string>",
  "requestedDeliveryDate": "2023-11-07T05:31:56Z",
  "createdAt": "2023-11-07T05:31:56Z",
  "warehouseId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "companyId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "internalComment": "<string>",
  "deliveryAddress": {
    "salutation": "<string>",
    "title": "<string>",
    "firstName": "<string>",
    "lastName": "<string>",
    "companyName": "<string>",
    "additionalCompanyLine": "<string>",
    "street": "<string>",
    "additionalAddressLine": "<string>",
    "postalCode": "<string>",
    "city": "<string>",
    "state": "<string>",
    "countryIso": "<string>",
    "phoneNumber": "<string>",
    "faxNumber": "<string>",
    "mobilePhoneNumber": "<string>",
    "emailAddress": "<string>"
  },
  "billingAddress": {
    "salutation": "<string>",
    "title": "<string>",
    "firstName": "<string>",
    "lastName": "<string>",
    "companyName": "<string>",
    "additionalCompanyLine": "<string>",
    "street": "<string>",
    "additionalAddressLine": "<string>",
    "postalCode": "<string>",
    "city": "<string>",
    "state": "<string>",
    "countryIso": "<string>",
    "phoneNumber": "<string>",
    "faxNumber": "<string>",
    "mobilePhoneNumber": "<string>",
    "emailAddress": "<string>"
  },
  "supplier": {
    "companyName": "<string>",
    "additionalCompanyLine": "<string>",
    "street": "<string>",
    "additionalAddressLine": "<string>",
    "postalCode": "<string>",
    "city": "<string>",
    "state": "<string>",
    "countryIso": "<string>",
    "phoneNumber": "<string>",
    "faxNumber": "<string>",
    "mobilePhoneNumber": "<string>",
    "emailAddress": "<string>",
    "contactSalutation": "<string>",
    "contactFirstName": "<string>",
    "contactLastName": "<string>"
  }
}

{
  "type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "instance": "/api/route",
  "traceId": "0HMPNHL0JHL76:00000001",
  "detail": "<string>",
  "errors": [
    {
      "name": "Error or field name",
      "reason": "Error reason",
      "code": "<string>",
      "severity": "<string>"
    }
  ]
}

{
  "type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "instance": "/api/route",
  "traceId": "0HMPNHL0JHL76:00000001",
  "detail": "<string>",
  "errors": [
    {
      "name": "Error or field name",
      "reason": "Error reason",
      "code": "<string>",
      "severity": "<string>"
    }
  ]
}

{
  "type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "instance": "/api/route",
  "traceId": "0HMPNHL0JHL76:00000001",
  "detail": "<string>",
  "errors": [
    {
      "name": "Error or field name",
      "reason": "Error reason",
      "code": "<string>",
      "severity": "<string>"
    }
  ]
}

{
  "type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "instance": "/api/route",
  "traceId": "0HMPNHL0JHL76:00000001",
  "detail": "<string>",
  "errors": [
    {
      "name": "Error or field name",
      "reason": "Error reason",
      "code": "<string>",
      "severity": "<string>"
    }
  ]
}

{
  "type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "instance": "/api/route",
  "traceId": "0HMPNHL0JHL76:00000001",
  "detail": "<string>",
  "errors": [
    {
      "name": "Error or field name",
      "reason": "Error reason",
      "code": "<string>",
      "severity": "<string>"
    }
  ]
}

wawi

Update Purchase Order Line Item

Patches one position of an existing purchase order. Every field is optional — an omitted field leaves its column unchanged. Field editability depends on the ORDER’s status and is graded: quantity, price and delivery date only while the order is Open or Released; the four supplier-confirmation fields in every status except Completed; the note always. Quantity and delivery date additionally apply only to positions of type FreePosition or Item — a charge or discount position has neither. Returns the full re-queried order, so the caller sees what the write did beyond the position itself (recalculated open quantities, and any stock consequence).

PATCH

purchase-orders

{purchaseOrderId}

line-items

{lineItemId}

Update Purchase Order Line Item

curl --request PATCH \
  --url https://api.jtl-cloud.com/erp/v2/purchase-orders/{purchaseOrderId}/line-items/{lineItemId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-tenant-id: <x-tenant-id>' \
  --data '
{
  "quantity": 123,
  "netPurchasePriceAmount": 123,
  "deliveryDate": "2023-11-07T05:31:56Z",
  "note": "<string>",
  "confirmedQuantity": 123,
  "confirmedDeliveryDate": "2023-11-07T05:31:56Z",
  "confirmedPrice": 123,
  "isLineItemConfirmed": true
}
'

import requests

url = "https://api.jtl-cloud.com/erp/v2/purchase-orders/{purchaseOrderId}/line-items/{lineItemId}"

payload = {
    "quantity": 123,
    "netPurchasePriceAmount": 123,
    "deliveryDate": "2023-11-07T05:31:56Z",
    "note": "<string>",
    "confirmedQuantity": 123,
    "confirmedDeliveryDate": "2023-11-07T05:31:56Z",
    "confirmedPrice": 123,
    "isLineItemConfirmed": True
}
headers = {
    "x-tenant-id": "<x-tenant-id>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {
    'x-tenant-id': '<x-tenant-id>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    quantity: 123,
    netPurchasePriceAmount: 123,
    deliveryDate: '2023-11-07T05:31:56Z',
    note: '<string>',
    confirmedQuantity: 123,
    confirmedDeliveryDate: '2023-11-07T05:31:56Z',
    confirmedPrice: 123,
    isLineItemConfirmed: true
  })
};

fetch('https://api.jtl-cloud.com/erp/v2/purchase-orders/{purchaseOrderId}/line-items/{lineItemId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.jtl-cloud.com/erp/v2/purchase-orders/{purchaseOrderId}/line-items/{lineItemId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'quantity' => 123,
    'netPurchasePriceAmount' => 123,
    'deliveryDate' => '2023-11-07T05:31:56Z',
    'note' => '<string>',
    'confirmedQuantity' => 123,
    'confirmedDeliveryDate' => '2023-11-07T05:31:56Z',
    'confirmedPrice' => 123,
    'isLineItemConfirmed' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "x-tenant-id: <x-tenant-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.jtl-cloud.com/erp/v2/purchase-orders/{purchaseOrderId}/line-items/{lineItemId}"

	payload := strings.NewReader("{\n  \"quantity\": 123,\n  \"netPurchasePriceAmount\": 123,\n  \"deliveryDate\": \"2023-11-07T05:31:56Z\",\n  \"note\": \"<string>\",\n  \"confirmedQuantity\": 123,\n  \"confirmedDeliveryDate\": \"2023-11-07T05:31:56Z\",\n  \"confirmedPrice\": 123,\n  \"isLineItemConfirmed\": true\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("x-tenant-id", "<x-tenant-id>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.jtl-cloud.com/erp/v2/purchase-orders/{purchaseOrderId}/line-items/{lineItemId}")
  .header("x-tenant-id", "<x-tenant-id>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"quantity\": 123,\n  \"netPurchasePriceAmount\": 123,\n  \"deliveryDate\": \"2023-11-07T05:31:56Z\",\n  \"note\": \"<string>\",\n  \"confirmedQuantity\": 123,\n  \"confirmedDeliveryDate\": \"2023-11-07T05:31:56Z\",\n  \"confirmedPrice\": 123,\n  \"isLineItemConfirmed\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.jtl-cloud.com/erp/v2/purchase-orders/{purchaseOrderId}/line-items/{lineItemId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["x-tenant-id"] = '<x-tenant-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"quantity\": 123,\n  \"netPurchasePriceAmount\": 123,\n  \"deliveryDate\": \"2023-11-07T05:31:56Z\",\n  \"note\": \"<string>\",\n  \"confirmedQuantity\": 123,\n  \"confirmedDeliveryDate\": \"2023-11-07T05:31:56Z\",\n  \"confirmedPrice\": 123,\n  \"isLineItemConfirmed\": true\n}"

response = http.request(request)
puts response.read_body

{
  "purchaseOrderId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "supplierId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "status": 0,
  "currencyIso": "<string>",
  "currencyFactor": 123,
  "isConfirmed": true,
  "lineItems": [
    {
      "lineItemId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
      "lineItemType": 0,
      "quantity": 123,
      "deliveredQuantity": 123,
      "openQuantity": 123,
      "netPurchasePriceAmount": 123,
      "vatRatePercentage": 123,
      "sortOrder": 123,
      "itemId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
      "itemNumber": "<string>",
      "supplierItemNumber": "<string>",
      "name": "<string>",
      "supplierItemName": "<string>",
      "deliveryTimeInDays": 123,
      "deliveryDate": "2023-11-07T05:31:56Z",
      "note": "<string>",
      "packagingUnit": "<string>",
      "packagingQuantity": 123,
      "confirmedQuantity": 123,
      "confirmedDeliveryDate": "2023-11-07T05:31:56Z",
      "confirmedPrice": 123,
      "isLineItemConfirmed": true
    }
  ],
  "supplierName": "<string>",
  "orderNumber": "<string>",
  "externalOrderNumber": "<string>",
  "referenceOrderNumber": "<string>",
  "requestedDeliveryDate": "2023-11-07T05:31:56Z",
  "createdAt": "2023-11-07T05:31:56Z",
  "warehouseId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "companyId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "internalComment": "<string>",
  "deliveryAddress": {
    "salutation": "<string>",
    "title": "<string>",
    "firstName": "<string>",
    "lastName": "<string>",
    "companyName": "<string>",
    "additionalCompanyLine": "<string>",
    "street": "<string>",
    "additionalAddressLine": "<string>",
    "postalCode": "<string>",
    "city": "<string>",
    "state": "<string>",
    "countryIso": "<string>",
    "phoneNumber": "<string>",
    "faxNumber": "<string>",
    "mobilePhoneNumber": "<string>",
    "emailAddress": "<string>"
  },
  "billingAddress": {
    "salutation": "<string>",
    "title": "<string>",
    "firstName": "<string>",
    "lastName": "<string>",
    "companyName": "<string>",
    "additionalCompanyLine": "<string>",
    "street": "<string>",
    "additionalAddressLine": "<string>",
    "postalCode": "<string>",
    "city": "<string>",
    "state": "<string>",
    "countryIso": "<string>",
    "phoneNumber": "<string>",
    "faxNumber": "<string>",
    "mobilePhoneNumber": "<string>",
    "emailAddress": "<string>"
  },
  "supplier": {
    "companyName": "<string>",
    "additionalCompanyLine": "<string>",
    "street": "<string>",
    "additionalAddressLine": "<string>",
    "postalCode": "<string>",
    "city": "<string>",
    "state": "<string>",
    "countryIso": "<string>",
    "phoneNumber": "<string>",
    "faxNumber": "<string>",
    "mobilePhoneNumber": "<string>",
    "emailAddress": "<string>",
    "contactSalutation": "<string>",
    "contactFirstName": "<string>",
    "contactLastName": "<string>"
  }
}

{
  "type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "instance": "/api/route",
  "traceId": "0HMPNHL0JHL76:00000001",
  "detail": "<string>",
  "errors": [
    {
      "name": "Error or field name",
      "reason": "Error reason",
      "code": "<string>",
      "severity": "<string>"
    }
  ]
}

{
  "type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "instance": "/api/route",
  "traceId": "0HMPNHL0JHL76:00000001",
  "detail": "<string>",
  "errors": [
    {
      "name": "Error or field name",
      "reason": "Error reason",
      "code": "<string>",
      "severity": "<string>"
    }
  ]
}

{
  "type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "instance": "/api/route",
  "traceId": "0HMPNHL0JHL76:00000001",
  "detail": "<string>",
  "errors": [
    {
      "name": "Error or field name",
      "reason": "Error reason",
      "code": "<string>",
      "severity": "<string>"
    }
  ]
}

{
  "type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "instance": "/api/route",
  "traceId": "0HMPNHL0JHL76:00000001",
  "detail": "<string>",
  "errors": [
    {
      "name": "Error or field name",
      "reason": "Error reason",
      "code": "<string>",
      "severity": "<string>"
    }
  ]
}

{
  "type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "instance": "/api/route",
  "traceId": "0HMPNHL0JHL76:00000001",
  "detail": "<string>",
  "errors": [
    {
      "name": "Error or field name",
      "reason": "Error reason",
      "code": "<string>",
      "severity": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

Idempotency-Key

string

Optional, client-generated key for deduplicating repeated write requests. A repeated request with the same key returns the originally recorded result instead of executing the effect again.

Required string length: 1 - 255

x-tenant-id

string<uuid>

required

The tenant ID for the target ERP instance.

Path Parameters

purchaseOrderId

string<uuid>

required

ID of the purchase order the position belongs to. Der LieferantenBestellung Schlüssel.

Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"

lineItemId

string<uuid>

required

ID of the position to patch. It must belong to the order named in the route; a position of another order is rejected exactly like an unknown one, so the API never confirms the existence of a document it otherwise denies. Der LieferantenBestellungPos Schlüssel.

Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"

Query Parameters

disableAutomaticWorkflows

boolean

required

Indicates whether automatic workflows should be suppressed for this write. Defaults to false when omitted.

Body

application/json

Request model for UpdatePurchaseOrderLineItem command endpoint. Route parameters bind from the route, query parameters from the query string, everything else from the body.

quantity

number<decimal>

Ordered quantity; must be greater than zero. Editable only while the order is Open or Released (structural tier), and only on a position of type FreePosition or Item.

netPurchasePriceAmount

number<decimal>

Net purchase price per unit. Editable only while the order is Open or Released (structural tier). Zero is allowed — it is the column's own default — on every position type, including the charge and discount types, whose amount this field carries.

deliveryDate

string<date-time>

Expected delivery date of this position. Editable only while the order is Open or Released (structural tier), and only on a position of type FreePosition or Item. An explicit null clears the date.

note

string

Free-text note on the position, at most 2000 characters. Editable in every status including Completed (annotations tier).

confirmedQuantity

number<decimal>

Quantity confirmed by the supplier. Editable in every status except Completed (confirmations tier). An explicit null means "no confirmation present".

confirmedDeliveryDate

string<date-time>

Delivery date confirmed by the supplier. Editable in every status except Completed (confirmations tier). An explicit null means "no confirmation present".

confirmedPrice

number<decimal>

Net price confirmed by the supplier. Editable in every status except Completed (confirmations tier). An explicit null means "no confirmation present".

isLineItemConfirmed

boolean

Whether the supplier confirmed this position. Editable in every status except Completed (confirmations tier), and bidirectional — an explicit false is a valid reset, while null means "no confirmation status set", a state distinct from false. Fully independent of the order header's IsConfirmed: setting this never changes the header flag and never raises the confirmation event.

Response

The position was patched successfully. The body is the full re-queried order, including all its line items, so the caller can observe the side effects of the write rather than having to infer them.

The full detail of a purchase order, including its line items, addresses and the supplier snapshot.

purchaseOrderId

string<uuid>

required

Unique ID of the purchase order.

Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"

supplierId

string<uuid>

required

ID of the supplier the order was placed with.

Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"

status

enum<integer>

required

The order's current status.

Available options:

0,

5,

20,

30,

50,

500

currencyIso

string

required

ISO code of the order's currency.

currencyFactor

number<decimal>

required

Conversion factor of the order's currency.

isConfirmed

boolean

required

Whether the order has been confirmed by the supplier.

lineItems

object[]

required

The order's line items.

Show child attributes

supplierName

string

The supplier's current display name, resolved at read time. NULL if the supplier could not be resolved.

orderNumber

string

The order's own number.

externalOrderNumber

string

The buyer's own order number.

referenceOrderNumber

string

A reference order number.

requestedDeliveryDate

string<date-time>

The delivery date requested from the supplier.

createdAt

string<date-time>

Date the order was created.

warehouseId

string<uuid>

Target warehouse of the incoming goods.

Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"

companyId

string<uuid>

The company the order was placed for.

Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"

internalComment

string

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

deliveryAddress

object

Delivery address of the order.

Show child attributes

billingAddress

object

Billing address of the order.

Show child attributes

supplier

object

Snapshot of the supplier's master data at the time the order was created.

Show child attributes

Overview

GraphQL

REST API

Update Purchase Order Line Item

Authorizations

Headers

Path Parameters

Query Parameters

Body

Response