Skip to main content
POST
/
v1
/
items
/
{itemId}
/
customerPrices
Create Item Customer Price
curl --request POST \
  --url https://api.jtl-cloud.com/erp/v1/items/{itemId}/customerPrices \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-appid: <x-appid>' \
  --header 'x-appversion: <x-appversion>' \
  --header 'x-tenant-id: <x-tenant-id>' \
  --data '
{
  "CustomerId": 123,
  "FromQuantity": 123,
  "NetPrice": 123,
  "ReduceStandardPriceByPercent": 123
}
'
{
  "ItemId": 123,
  "CustomerId": 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.

​
x-api-key
string
header
required

Optional: If no token is present, the API Gateway injects it.

Headers

​
x-appid
string
required

This is the name of your application, e.g. "MyApp/1.0.0". It is used to identify your application.

​
x-appversion
string
required

This is where the version number of your application is entered, e.g. "1.0.0".

​
x-runas
string

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

​
X-SessionId
string<uuid>

The id of a session in which the call will be executed.

​
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 customer specific price belongs to.

Body

application/json

The item customer price to create.

Model Class: CreateItemCustomerPrice

​
CustomerId
integer<int32>
required

Unique ID to identify a customer.

​
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 ReduceStandardSpBy% too. Only one can be used.

​
ReduceStandardPriceByPercent
number<decimal>

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

Response

The created item price.

Model Class: ItemCustomerPrice

​
ItemId
integer<int32>
required

Unique ID to identify an item.

​
CustomerId
integer<int32>
required

Unique ID to identify a customer.

​
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 ReduceStandardSpBy% too. Only one can be used.

​
ReduceStandardPriceByPercent
number<decimal>
required

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