🔒 Update sales price V3

patch

https://{xentralId}.xentral.biz/api/v3/salesPrices/{id}

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: salesPrice:update.

Update a single sales price. Only the properties present in the payload are written.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

string

required

Body Params

SalesPrice update payload. The sales price to update is addressed by the id in the URL.

customer

object | null

Customer this sales price applies to. Provide either customer or customerGroup, not both. Send both as null to make this the list price for all customers.

customerGroup

object | null

Customer group this sales price applies to. Provide either customer or customerGroup, not both. Send both as null to make this the list price for all customers.

price

object

Net sales price as amount and currency. Prices in Xentral are net B2B prices.

quantity

float

Minimum quantity of the product from which this sales price applies.

packageAmount

float | null

Quantity contained in one packaging unit for this sales price. Send null to clear it.

customerProductNumber

string | null

The product's article number as used by the customer. Send null to clear it.

isNotCalculatedFromExchangeTable

boolean

If true, this price is not converted via the currency exchange table.

hideInBulkPriceListing

boolean

If true, this price is hidden in scale-price listings on documents.

remark

string | null

Internal comment for this sales price. Send null to clear it.

validFrom

date | null

Date from which this sales price is valid. Send null to remove the lower limit.

expiresAt

date | null

Date until which this sales price is valid. Send null to remove the upper limit.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

401

Unauthorized

403

Forbidden

404

Not Found

Language

Credentials

Bearer

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json

200Update a single sales price. Only the properties present in the payload are written.

400Failed validation

429Too Many Requests