Commissions and reductions
|Version 3 of the Retailer API has been deprecated. Please migrate to the V4 API as soon as possible.|
Of every purchase via the bol.com plaza platform a small margin, also known as commission, is deducted from the purchasing price.
The commission consists of a fixed amount and percentage of the selling price and may vary depending on the product categories.
The Commission endpoints allow you to identify and calculate relevant commissions per EAN and adjust your price accordingly.
Additionally, you can provide us a selling price and we will calculate and return the applicable commission fee. This option is available in both single and bulk requests and is set by either a parameter in the single request, or an element in the bulk request. For the bulk endpoint, you can provide a maximum of 100 EANs in a single request.
The Commissions endpoint can also return information on reductions. Some EANs are eligible for reductions in the commission fee. In this case an additional element called reductions is returned, showing the boundaries for when reductions become active.
To retrieve the entire list, first use
GET /reductions. This will download a file that is 13 MB or more. This file also contains the file name in the
GET /reductions/latest to get the file name of the most recent reductions-list. Do not use the
GET /reductions endpoint again unless this file name has changed.
GET /reductions/latest and comparing this to your most recent download you can be certain that you are always up-to-date.