Skip to main content
PATCH
Update Item Special Price

Authorizations

Authorization
string
header
required

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

FlowAuthorization Code
Authorization URL
https://id.jtl-cloud.com/oauth/v2/authorize
Token URL
https://id.jtl-cloud.com/oauth/v2/token

Headers

x-companyid
string

The Company-Id (int or uuid) of the company on whose behalf the request is executed.

x-tenant-id
string<uuid>
required

The tenant ID for the target ERP instance.

Path Parameters

itemId
integer<int32>
required

The id of the item that the special price belongs to.

Body

application/json

The special price details of the item to update.

Model Class: UpdateItemSpecialPrice

IsActive
boolean
required

Indicates if the special price is active.

SpecialPrice
object[]

List of all special prices for JTL-Wawi and the sales channel with the type online shop and JTL-POS.

StartDate
string<date-time>

The date when the special price should start.

EndDateActive
boolean

If set, the special price will end on a given date. In this case, the field EndDate is required.

EndDate
string<date-time>

This is required if EndDateActive is set. In this case, the special price ends on this date.

TillAmountActive
boolean

Indicates that the special price ends when a certain amount is reached. The field TillAmountInStockSmallerThan is required in this case.

TillAmountInStockSmallerThan
integer<int32>

If this amount of stock for the item is reached, the special price ends. Only applies if TillAmountActive is true.

Response