Price (1.0)
Download OpenAPI specification:Download
API to manage prices
Get items
Authorizations:
query Parameters
required | object (Pageable) |
predicate required | object |
target | string Return selected fields only (multiple occurrences allowed for selecting multiple fields) |
customerId | any Filter prices by customerId |
productId | any Filter prices by productId |
country | any Filter prices by country |
currency | any Filter prices by currency |
value | any Filter prices by price |
upSell | any Filter prices by upSell price |
crossSell | any Filter prices by crossSell price |
msrp | any Filter prices by msrp value |
vatIncluded | any Filter prices with or without vat included |
startingDate | any Filter by start date of the price. You can use date ranges by using < or << operator, examples: startingDate=XXXX< will return prices starting after XXXX, startingDate=<XXXX will return prices starting before XXXX, startingDate=XXXX<<YYYYY will return prices starting between XXXX and YYYY |
endingDate | any Filter by end date of the price. You can use date ranges by using < or << operator, examples: endingDate=XXXX< will return prices ending after XXXX, endingDate=<XXXX will return prices ending before XXXX, endingDate=XXXX<<YYYYY will return prices ending between XXXX and YYYY |
marketingCampaignId | any Filter prices by marketingCampaignId |
Responses
Response samples
- 200
- 401
- 403
- 404
- 500
{- "items": [
- {
- "archived": true,
- "country": "FR",
- "createDate": "2019-08-24T14:15:22Z",
- "crossSell": 12.99,
- "currency": "EUR",
- "customerId": "string",
- "dbVersion": 0,
- "endDate": "2019-08-24T14:15:22Z",
- "externalContext": "string",
- "history": [
- {
- "affectedIds": [
- "string"
], - "event": "CREATED",
- "previousData": { },
- "when": "2019-08-24T14:15:22Z"
}
], - "id": "string",
- "lastUpdateReason": "string",
- "mandateValue": 0.1,
- "marketingCampaignId": "string",
- "modelVersion": "string",
- "msrp": 39.99,
- "productId": "string",
- "remotePrice": {
- "licenseNextExpirationDate": "2019-08-24T14:15:22Z",
- "response": "string",
- "url": "string"
}, - "source": "INTERNAL",
- "startDate": "2019-08-24T14:15:22Z",
- "upSell": 10.99,
- "updateDate": "2019-08-24T14:15:22Z",
- "value": 14.99,
- "vatIncluded": true
}
], - "last": true,
- "number": 0,
- "size": 0,
- "totalItems": 0,
- "totalPages": 0
}
Create an item
Authorizations:
Request Body schema: application/jsonrequired
archived | boolean Indicator if the price was removed/archived |
country | string Country code in ISO 3166-2 format |
createDate | string <date-time> Deprecated |
crossSell required | number <double> CrossSell price, two decimal places format |
required | object Currency code in ISO-4217 format |
customerId | string |
dbVersion | integer <int64> |
endDate required | string <date-time> Price end date timestamp in milliseconds |
externalContext | string |
id | string Deprecated |
idUpdateTask | string |
lastUpdateReason | string |
mandateValue | number <double> Mandate value |
marketingCampaignId | string Marketing campaign Id |
modelVersion | string Deprecated |
msrp | number <double> Recommended price, two decimal places format |
originalId | string |
productId required | string Product identifier |
object (RemotePrice) Remote price information | |
source | string Enum: "INTERNAL" "EXTERNAL" "INTERNAL_CONVERTED" "MANDATE_VALUE" Source of the price |
startDate required | string <date-time> Price start date timestamp in milliseconds |
upSell required | number <double> Upsell price, two decimal places format |
updateDate | string <date-time> Deprecated |
value required | number <double> Regular price, two decimal places format |
vatIncluded required | boolean Tax is included in price |
Responses
Request samples
- Payload
{- "archived": true,
- "country": "FR",
- "createDate": "2019-08-24T14:15:22Z",
- "crossSell": 12.99,
- "currency": "EUR",
- "customerId": "string",
- "dbVersion": 0,
- "endDate": "2019-08-24T14:15:22Z",
- "externalContext": "string",
- "id": "string",
- "idUpdateTask": "string",
- "lastUpdateReason": "string",
- "mandateValue": 0.1,
- "marketingCampaignId": "string",
- "modelVersion": "string",
- "msrp": 39.99,
- "originalId": "string",
- "productId": "string",
- "remotePrice": {
- "licenseNextExpirationDate": "2019-08-24T14:15:22Z",
- "response": "string",
- "url": "string"
}, - "source": "INTERNAL",
- "startDate": "2019-08-24T14:15:22Z",
- "upSell": 10.99,
- "updateDate": "2019-08-24T14:15:22Z",
- "value": 14.99,
- "vatIncluded": true
}
Response samples
- 201
- 401
- 403
- 404
- 500
{- "archived": true,
- "country": "FR",
- "createDate": "2019-08-24T14:15:22Z",
- "crossSell": 12.99,
- "currency": "EUR",
- "customerId": "string",
- "dbVersion": 0,
- "endDate": "2019-08-24T14:15:22Z",
- "externalContext": "string",
- "history": [
- {
- "affectedIds": [
- "string"
], - "event": "CREATED",
- "previousData": { },
- "when": "2019-08-24T14:15:22Z"
}
], - "id": "string",
- "lastUpdateReason": "string",
- "mandateValue": 0.1,
- "marketingCampaignId": "string",
- "modelVersion": "string",
- "msrp": 39.99,
- "productId": "string",
- "remotePrice": {
- "licenseNextExpirationDate": "2019-08-24T14:15:22Z",
- "response": "string",
- "url": "string"
}, - "source": "INTERNAL",
- "startDate": "2019-08-24T14:15:22Z",
- "upSell": 10.99,
- "updateDate": "2019-08-24T14:15:22Z",
- "value": 14.99,
- "vatIncluded": true
}
Get best price for parameters
Search price for product with given parameters: country, currency, defaultCurrency, effective date
Authorizations:
query Parameters
productId required | string ID of the product |
country required | string Example: country=FR Country code in ISO 3166-2 format |
customerId required | string ID of the customer |
currency | string Example: currency=USD Currency code in ISO-4217 format |
defaultCurrency | string Example: defaultCurrency=EUR Fallback currency code in ISO-4217 format |
initialCurrency | string |
date | string <date-time> Default: "2025-05-29T13:11:04.276Z" Effective date in ISO-8601 format, examples: 2020-10-14, 2020-10-14T12:00:00Z |
marketingCampaignId | string ID of marketing campaign |
isRemotePrice | boolean |
useCurrencyConversion | boolean |
Responses
create multiple prices
Create multiple prices for import export service
Authorizations:
Request Body schema: application/jsonrequired
Array of objects (Price) | |||||||||||||||||||||||||||||||||||||||||||||||||||
Array
|
Responses
Request samples
- Payload
{- "prices": [
- {
- "archived": true,
- "country": "FR",
- "createDate": "2019-08-24T14:15:22Z",
- "crossSell": 12.99,
- "currency": "EUR",
- "customerId": "string",
- "dbVersion": 0,
- "endDate": "2019-08-24T14:15:22Z",
- "externalContext": "string",
- "id": "string",
- "idUpdateTask": "string",
- "lastUpdateReason": "string",
- "mandateValue": 0.1,
- "marketingCampaignId": "string",
- "modelVersion": "string",
- "msrp": 39.99,
- "originalId": "string",
- "productId": "string",
- "remotePrice": {
- "licenseNextExpirationDate": "2019-08-24T14:15:22Z",
- "response": "string",
- "url": "string"
}, - "source": "INTERNAL",
- "startDate": "2019-08-24T14:15:22Z",
- "upSell": 10.99,
- "updateDate": "2019-08-24T14:15:22Z",
- "value": 14.99,
- "vatIncluded": true
}
]
}
Get a list of product ids with available marketing campaign prices
This endpoint is used in order to get a list of product ids that have an available marketing campaign. It is currently used by marketing-campaign service
Authorizations:
path Parameters
id required | string marketing campaign's id |
Request Body schema: application/jsonrequired
country | string |
object | |
customerId required | string |
date required | string <date-time> |
productIdsList required | Array of strings |
Responses
Request samples
- Payload
{- "country": "string",
- "currency": {
- "currencyCode": "string",
- "defaultFractionDigits": 0,
- "displayName": "string",
- "numericCode": 0,
- "numericCodeAsString": "string",
- "symbol": "string"
}, - "customerId": "string",
- "date": "2019-08-24T14:15:22Z",
- "productIdsList": [
- "string"
]
}
Response samples
- 200
- 400
- 401
- 403
- 408
- 500
- 503
"string"
Get recap quantities for a given field
Authorizations:
query Parameters
target required | string |
required | object (Pageable) |
predicate required | object |
Responses
Response samples
- 200
- 401
- 403
- 404
- 500
{- "items": [
- {
- "count": 0,
- "targetValue": "string"
}
], - "last": true,
- "number": 0,
- "size": 0,
- "totalItems": 0,
- "totalPages": 0
}
Search unwind for a given field
Authorizations:
query Parameters
target required | string |
required | object (Pageable) |
predicate required | object |
Responses
Response samples
- 200
- 401
- 403
- 404
- 500
{- "items": [
- {
- "empty": true,
- "property1": { },
- "property2": { }
}
], - "last": true,
- "number": 0,
- "size": 0,
- "totalItems": 0,
- "totalPages": 0
}
Response samples
- 200
- 401
- 403
- 404
- 500
{- "archived": true,
- "country": "FR",
- "createDate": "2019-08-24T14:15:22Z",
- "crossSell": 12.99,
- "currency": "EUR",
- "customerId": "string",
- "dbVersion": 0,
- "endDate": "2019-08-24T14:15:22Z",
- "externalContext": "string",
- "history": [
- {
- "affectedIds": [
- "string"
], - "event": "CREATED",
- "previousData": { },
- "when": "2019-08-24T14:15:22Z"
}
], - "id": "string",
- "lastUpdateReason": "string",
- "mandateValue": 0.1,
- "marketingCampaignId": "string",
- "modelVersion": "string",
- "msrp": 39.99,
- "productId": "string",
- "remotePrice": {
- "licenseNextExpirationDate": "2019-08-24T14:15:22Z",
- "response": "string",
- "url": "string"
}, - "source": "INTERNAL",
- "startDate": "2019-08-24T14:15:22Z",
- "upSell": 10.99,
- "updateDate": "2019-08-24T14:15:22Z",
- "value": 14.99,
- "vatIncluded": true
}
Update item
Authorizations:
path Parameters
id required | string |
Request Body schema: application/jsonrequired
archived | boolean Indicator if the price was removed/archived |
country | string Country code in ISO 3166-2 format |
createDate | string <date-time> Deprecated |
crossSell required | number <double> CrossSell price, two decimal places format |
required | object Currency code in ISO-4217 format |
customerId | string |
dbVersion | integer <int64> |
endDate required | string <date-time> Price end date timestamp in milliseconds |
externalContext | string |
id | string Deprecated |
idUpdateTask | string |
lastUpdateReason | string |
mandateValue | number <double> Mandate value |
marketingCampaignId | string Marketing campaign Id |
modelVersion | string Deprecated |
msrp | number <double> Recommended price, two decimal places format |
originalId | string |
productId required | string Product identifier |
object (RemotePrice) Remote price information | |
source | string Enum: "INTERNAL" "EXTERNAL" "INTERNAL_CONVERTED" "MANDATE_VALUE" Source of the price |
startDate required | string <date-time> Price start date timestamp in milliseconds |
upSell required | number <double> Upsell price, two decimal places format |
updateDate | string <date-time> Deprecated |
value required | number <double> Regular price, two decimal places format |
vatIncluded required | boolean Tax is included in price |
Responses
Request samples
- Payload
{- "archived": true,
- "country": "FR",
- "createDate": "2019-08-24T14:15:22Z",
- "crossSell": 12.99,
- "currency": "EUR",
- "customerId": "string",
- "dbVersion": 0,
- "endDate": "2019-08-24T14:15:22Z",
- "externalContext": "string",
- "id": "string",
- "idUpdateTask": "string",
- "lastUpdateReason": "string",
- "mandateValue": 0.1,
- "marketingCampaignId": "string",
- "modelVersion": "string",
- "msrp": 39.99,
- "originalId": "string",
- "productId": "string",
- "remotePrice": {
- "licenseNextExpirationDate": "2019-08-24T14:15:22Z",
- "response": "string",
- "url": "string"
}, - "source": "INTERNAL",
- "startDate": "2019-08-24T14:15:22Z",
- "upSell": 10.99,
- "updateDate": "2019-08-24T14:15:22Z",
- "value": 14.99,
- "vatIncluded": true
}
Response samples
- 200
- 401
- 403
- 404
- 500
{- "archived": true,
- "country": "FR",
- "createDate": "2019-08-24T14:15:22Z",
- "crossSell": 12.99,
- "currency": "EUR",
- "customerId": "string",
- "dbVersion": 0,
- "endDate": "2019-08-24T14:15:22Z",
- "externalContext": "string",
- "history": [
- {
- "affectedIds": [
- "string"
], - "event": "CREATED",
- "previousData": { },
- "when": "2019-08-24T14:15:22Z"
}
], - "id": "string",
- "lastUpdateReason": "string",
- "mandateValue": 0.1,
- "marketingCampaignId": "string",
- "modelVersion": "string",
- "msrp": 39.99,
- "productId": "string",
- "remotePrice": {
- "licenseNextExpirationDate": "2019-08-24T14:15:22Z",
- "response": "string",
- "url": "string"
}, - "source": "INTERNAL",
- "startDate": "2019-08-24T14:15:22Z",
- "upSell": 10.99,
- "updateDate": "2019-08-24T14:15:22Z",
- "value": 14.99,
- "vatIncluded": true
}
Get available currencies
Search the available currencies based on a set of product IDs and a marketingCampaign id
Authorizations:
query Parameters
productId required | any One or multiple productIds separated by comma |
marketingCampaignId | any ID of marketing campaign |
Request Body schema: application/jsonrequired
Array of objects (ProductInput) | |||||
Array
|
Responses
Request samples
- Payload
{- "productInputs": [
- {
- "id": "string",
- "marketingCampaignId": "string"
}
]
}