Skip to main content
POST
/
items
/
{itemId}
/
salesChannelPrices
Create Item Sales Channel Price
curl --request POST \
  --url https://api.jtl-cloud.com/erp/items/{itemId}/salesChannelPrices \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-tenant-id: <x-tenant-id>' \
  --data '
{
  "SalesChannelId": "<string>",
  "CustomerGroupId": 123,
  "FromQuantity": 123,
  "NetPrice": 123,
  "ReduceStandardPriceByPercent": 123
}
'
{
  "ItemId": 123,
  "SalesChannelId": "<string>",
  "CustomerGroupId": 123,
  "FromQuantity": 123,
  "NetPrice": 123,
  "ReduceStandardPriceByPercent": 123
}

Authorizations

​
Authorization
string
header
required

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

Headers

​
x-tenant-id
string<uuid>
required

The tenant ID for the target ERP instance.

​
x-runas
string

The User-Id (int or uuid) on whose behalf the request is executed. Requires scope 'Application.RunAs'.

​
x-companyid
string

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

Path Parameters

​
itemId
integer<int32>
required

The id of the item that the sales channel price belong to.

Body

application/json

The sales channel price for an item to create.

Model Class: CreateItemSalesChannelPrice

​
SalesChannelId
string
required

The ID of the sales channel for this description. Only specific sales channels are allowed for this operation and are specified in the sales channel endpoint (GET).

​
CustomerGroupId
integer<int32>

Unique ID to identify a customer group. If CustomerGroupId is 0, the price will be the default value for all customer groups.

​
FromQuantity
integer<int32>

The quantity for the scale prices. This should be 0 or empty for the default price. If a FromQuantity is given, this price applies to the range from this quantity to the next specified FromQuantity. If no higher FromQuantity exists, then this price applies to all quantities from this point on.

​
NetPrice
number<decimal>

The net sales price of the item. If you use NetPrice, you can't use ReduceStandardPriceByPercent too. Only one can be used.

​
ReduceStandardPriceByPercent
number<decimal>

Reduce the default sales price by a percentage. If you use NetPrice, you can't use ReduceStandardPriceByPercent too. Only one can be used.

Response

The created item sales channel price.

Model Class: ItemSalesChannelPrice

​
ItemId
integer<int32>
required

Unique ID to identify an item.

​
SalesChannelId
string
required

The ID of the sales channel for this description. Only specific sales channels are allowed for this operation and are specified in the sales channel endpoint (GET).

​
CustomerGroupId
integer<int32>
required

Unique ID to identify a customer group. If CustomerGroupId is 0, the price will be the default value for all customer groups.

​
FromQuantity
integer<int32>
required

The quantity for the scale prices. This should be 0 or empty for the default price. If a FromQuantity is given, this price applies to the range from this quantity to the next specified FromQuantity. If no higher FromQuantity exists, then this price applies to all quantities from this point on.

​
NetPrice
number<decimal>
required

The net sales price of the item. If you use NetPrice, you can't use ReduceStandardPriceByPercent too. Only one can be used.

​
ReduceStandardPriceByPercent
number<decimal>
required

Reduce the default sales price by a percentage. If you use NetPrice, you can't use ReduceStandardPriceByPercent too. Only one can be used.