Commissions and reductions
Version 3 of the Retailer API has been deprecated. Please migrate to the V4 API as soon as possible. |
Commissions API
-
Retrieve commission: returns the commission for a given EAN.
-
Retrieve bulk commission: returns the commission for a given EAN in bulk.
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
-
Retrieve reductions filename: returns the file name of the latest reduction export.
-
Retrieve reductions file: returns the full reductions file containing all available reduction information.
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.