v1

latestOpenAPI 3.0.02026-07-2455104.8 MB

PurchaseOrder

🔒 Update purchase order line item V3

This endpoint is currently in Beta and available for testing. It may contain bugs, and breaking changes can occur at any time without prior notice. We do not recommend using Beta endpoints in production environments. Should you choose to use it in production, you assume full responsibility for any resulting issues.

This endpoint requires the following scopes: purchaseOrder:update.

Update a line item in a purchase order.

patch/api/v3/purchaseOrders/{id}/lineItems/{lineItemId}

Path parameters

idstring required

lineItemIdstring required

Request body

namestring

Name of the line item.

descriptionstring

Description of the line item.

deliveryDatestring date

Delivery date of the line item.

deliveryDateAsCalendarWeekboolean

Whether to show the delivery date as calendar week or explicit.

internalCommentstring

Internal comment for the line item.

sortinteger

Sort order of the line item.

unitstring

Unit of the line item (e.g., "kg", "pcs").

taxLegalNoticestring

Legal notice regarding tax for this line item.

supplierProductNumberstring

The supplier-specific product number.

supplierProductNamestring

The supplier-specific product name.

Example request

{
  "name": "Product Name",
  "description": "Detailed product description",
  "deliveryDate": "2025-08-15",
  "internalComment": "This is an internal note.",
  "sort": 1,
  "unit": "pcs",
  "price": {
    "net": {
      "amount": 99.99,
      "currency": "EUR"
    }
  },
  "taxLegalNotice": "Tax exempt according to §19 UStG",
  "supplierProductNumber": "SUP-1234",
  "supplierProductName": "Supplier Product Name"
}

Response

Update a line item in a purchase order.

Example response

{
  "data": {
    "type": "product",
    "id": "1",
    "number": "2462-SK-D",
    "name": "Strawberry Jam",
    "description": "Delicious strawberry jam made from fresh strawberries.",
    "quantity": 2,
    "product": {
      "createdAt": "2025-03-15T09:27:00+01:00",
      "updatedAt": "2025-10-20T14:45:12+01:00"
    },
    "customFields": [
      {
        "key": "customer_category",
        "value": "Premium",
        "label": "Customer Category"
      },
      {
        "key": "priority_level",
        "value": "High",
        "label": "Priority Level"
      }
    ],
    "unit": "kg",
    "packagingUnit": "box",
    "internalComment": "This is an internal comment.",
    "customerProductNumber": "CUS-10077",
    "order": 5,
    "updatedAt": "2023-10-01T12:00:00Z",
    "createdAt": "2023-10-01T12:00:00Z",
    "salesOrderLineItem": {
      "id": "1"
    },
    "deliveredQuantity": 2,
    "taxRate": "standard",
    "effectiveTaxRate": 19,
    "price": {
      "net": {
        "amount": "13.37",
        "currency": "EUR"
      }
    },
    "taxLegalNotice": "Tax exempt according to §19 UStG",
    "supplierProductNumber": "SUP-1234",
    "supplierProductName": "Supplier Product Name"
  }
}