Commissions and reductions

Version 3 of the Retailer API has been deprecated. Please migrate to the V4 API as soon as possible.

Commissions API

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.

Reductions API

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 Content-Disposition header.

Please use 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.

By checking GET /reductions/latest and comparing this to your most recent download you can be certain that you are always up-to-date.

All information regarding reductions can be found on the dedicated page on the Partner Platform.