v1

latestOpenAPI 3.0.02026-07-2455104.8 MB

SalesOrder

🔒 Update sales 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: salesOrder:update.

Update a line item in a sales order.

patch/api/v3/salesOrders/{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").

discountnumber float

Discount percentage

taxLegalNoticestring

Legal notice regarding tax for this line item

externalNumberstring

External number for the line item, typically used for shop/web order line item references.

Example request

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

Response

Update a line item in a sales 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",
    "taxRate": "standard",
    "effectiveTaxRate": 19,
    "price": {
      "net": {
        "amount": "13.37",
        "currency": "EUR"
      },
      "gross": {
        "amount": "13.37",
        "currency": "EUR"
      }
    },
    "discount": 10,
    "itemRevenue": {
      "net": {
        "amount": "13.37",
        "currency": "EUR"
      },
      "gross": {
        "amount": "13.37",
        "currency": "EUR"
      }
    },
    "lineItemRevenue": {
      "net": {
        "amount": "13.37",
        "currency": "EUR"
      },
      "gross": {
        "amount": "13.37",
        "currency": "EUR"
      }
    },
    "purchasePrice": {
      "net": {
        "amount": "13.37",
        "currency": "EUR"
      }
    },
    "contributionMargin": 0.25,
    "taxLegalNotice": "Tax exempt according to §19 UStG",
    "externalNumber": "WEB-12345",
    "parentLineItem": {
      "id": "1"
    },
    "desiredQualityControlAttributes": {
      "bestBeforeDate": "2024-12-31",
      "batch": "BATCH-12345"
    }
  }
}