A new version of the Retailer API has been released on 1st October 2022.
The Retailer API version 8 introduces eminent new features and significant improvements in the API.
New features:
- Product Content API: Offers the following two new endpoints:
- Get catalog product details by EAN - Retrieves the details of a catalog product by means of its EAN.
- Get chunk recommendations - Retrieves a selected number of recommendations for a product. For more information on the aforementioned endpoints, see Get catalog product details by EAN and Get chunk recommendations v8 functional documentation.
- Replenishments API: Offers the following two new endpoints:
- Request product destinations - Requests a list of product destinations by EANs.
- Get product destinations by product destinations id - Retrieves the product destinations for one or more products by product destinations id. For more information on the aforementioned endpoints, see v8 functional documentation.
- Offers API: The following endpoints have moved out of Beta and are now available in v8 [GA] in Offers API of the Retailer API:
- Request an unpublished offer report
- Retrieve an unpublished offer report by report id. For more information about the Offers API, see v8 functional documentation.
Improvements:
- Orders API: Following new fields have been added to the Get a list of orders endpoint in the Orders API:
- change-interval-minute - Retrieves a list of all the new and changed orders within the specified timeframe sorted by the time of the latest change.
- latest-change-date - Retrieves a list of all the order items that were last changed on a given date for up to three months in the past.
- New fields added to the response body of Get a list of orders endpoint and Get an order by order id endpoint. For more information on the Orders API, see v8 functional documentation.
- Invoices API: Changes in supported media type formats.
- Changes to the request and body structures of the APIs. For more information about the overview of the changes, see v8 Release Notes.
- Changes in the functional documentation.
Upgrade from v7 to leverage the advantages of the enhanced designs and features in the new v8 API. For more information, see v7-v8 migration guides.