This is the API powering Omnia 2.0 and Pricemonitor, containing operations which can also be used directly by customers from their own systems.
The Omnia 2.0 API is RESTful and provides access to the backend of Omnia 2.0 and Pricemonitor. It is used to manage products, offers, contracts and more.
https://api-docs.omniaretail.dev/_mock/api/omnia/
https://api.patagona.de/
Note:
- Internally the system calculates a price recommendation for every domain
- As aggregation the system then provides the cheapest price recommendation
Within the price recommendations we are providing a field called
relevantDomain. This field contains from which domain the price recommendation originates.
You can get all price recommendations via this operation.
It's a paginated endpoint, so you have to request multiple pages. See pagination. Recommended page size is 1000.
It's important that you define a timerange (by providing startTime and endTime parameters) in order to guarantee a stable pagination. This endpoint returns the most recent price recommendations per product and domain: This means that price recommendations from older price calculation runs within the provided timerange are ignored.
https://api-docs.omniaretail.dev/_mock/api/omnia/api/2/v/contracts/{contractId}/result/pricerecommendations
https://api.patagona.de/api/2/v/contracts/{contractId}/result/pricerecommendations
curl -i -X GET \
-u <username>:<password> \
'https://api-docs.omniaretail.dev/_mock/api/omnia/api/2/v/contracts/qbcxvb/result/pricerecommendations?endTime=2019-08-24T14%3A15%3A22Z&includeTags=true&limit=100&start=0&startTime=2019-08-24T14%3A15%3A22Z'A paginated list of price recommendations is returned for the specified timerange. Only the newest price recommendations are returned in case of multiple price recommendations per product.
The timestamp when the price recommendation has been calculated
Additional information on this product
The double value depends on the decimal separator which has been provided during product import.
The integer value of the tag. It's only defined when the stringValue consists solely of digits.
Absolute percentage how the recommended price changed compared to the oldPrice e.g. 200 stands for 200% which means the recommended price has doubled
The strategy branch name that calculated the price. This is only filled if the Strategy branch that calculated the price was given a name in the strategy tree. It will have the name that was active at the time the price was calculated (see timestamp)
Max price boundary during the time when the price was calculated
The decisive domain of the price recommendation. It's been determined by the cheapest price recommendation.
Min price boundary during the time when the price was calculated
List of tags which were set during the time when the price has been calculated. ATTENTION: These are historic tags which are maybe outdated or incomplete.
The double value depends on the decimal separator which has been provided during product import.
The integer value of the tag. It's only defined when the stringValue consists solely of digits.
{ "data": [ { … } ], "meta": { "nextUrl": "string", "totalSize": 0, "start": 0, "limit": 0 } }
https://api-docs.omniaretail.dev/_mock/api/omnia/api/v3/vendor/contracts/{contractId}/products/{productId}/pricerecommendationhistory
https://api.patagona.de/api/v3/vendor/contracts/{contractId}/products/{productId}/pricerecommendationhistory
curl -i -X GET \
-u <username>:<password> \
'https://api-docs.omniaretail.dev/_mock/api/omnia/api/v3/vendor/contracts/qbcxvb/products/862342/pricerecommendationhistory?endDate=2019-08-24T14%3A15%3A22Z&startDate=2019-08-24T14%3A15%3A22Z'A list of price recommendations
The timestamp when the price recommendation has been calculated
Additional information on this product
The double value depends on the decimal separator which has been provided during product import.
The integer value of the tag. It's only defined when the stringValue consists solely of digits.
Absolute percentage how the recommended price changed compared to the oldPrice e.g. 200 stands for 200% which means the recommended price has doubled
The strategy branch name that calculated the price. This is only filled if the Strategy branch that calculated the price was given a name in the strategy tree. It will have the name that was active at the time the price was calculated (see timestamp)
Max price boundary during the time when the price was calculated
The decisive domain of the price recommendation. It's been determined by the cheapest price recommendation.
Min price boundary during the time when the price was calculated
List of tags which were set during the time when the price has been calculated. ATTENTION: These are historic tags which are maybe outdated or incomplete.
The double value depends on the decimal separator which has been provided during product import.
The integer value of the tag. It's only defined when the stringValue consists solely of digits.
{ "data": [ { … } ] }