DISCLAIMER: Providing this information might lead to price increases, possibly interfering with Dutch and Belgian competition law. If the experiment proves that prices increase significantly, the endpoint will not be continued in V4.
The technical documentation for developers can be found on https://api.bol.com/retailer/public/redoc/v4#operation/get-retail-price
What is the Allowable Retail Price?
The Allowable Retail Price endpoint is an experimental endpoint to request the highest allowed price for an EAN on the bol.com platform. This Allowable Retail Price is based on the Relevant Market Price. The Relevant Market Price is recalculated approximately once per week. In this (Dutch) explainer, the origin of the RMP is explained, and the calculation from RMP to Allowable Retail Price is included as well: https://partnerplatform.bol.com/help/aanbieden/hoe-komt-mijn-aanbod-online/het-prijsbeleid-van-bol-com
Why use the Allowable Retail Price endpoint?
At bol.com, offers that are priced too high compared to the Relevant Market Price are not shown in the webshop. These offers get the status ‘unpublished’ with the reason “Price too high”. Using the Allowable Retail Price endpoint helps partners to find out where that boundary is, and set a more attractive price for customers.
How to use the Allowable Retail Price endpoint?
This endpoint provides the Allowable Retail Price for assortment with the condition new, and it is including VAT. Besides that, the Allowable Retail Price is including shipping cost, which differs from Verkoperaccount. If you use Logistics via bol.com to ship your products, please substract the shipping cost of 2.99 for products below 20 euros. At this time, it is not possible to request the Allowable Retail Price based on ISBN.
We see two use cases:
1. When correcting prices for unpublished offers with condition new
EANs that have been unpublished due to a price far above the Relevant Market Price, can be checked against the Allowable Retail Price endpoint. On average, the Relevant Market Price changes once per week, and with that, the boundary above which offers are unpublished.
Logical process flow:
|Create/update offer.||Unpublish offer due to high price.|
|Get price constraint.||Provide price constraint|
|Update offer.||Publish offer (unless other unpublished reasons exist)|
2. When setting the price for an offer with condition new
Requesting the Allowable Retail price for EANs that are not yet in your assortment, can help inform price setting.
Note: When your EAN is less than 13 characters you have to add leading zeros.
When is the Allowable Retail Price available?
For products that are new for the retailer but already known at bol.com the Allowable Retail Price will immediately be available.
For products that are completely new, on average, it will take up to a month before the Allowable Retail Price is available.
Sign up for the beta
We are deciding on a weekly basis if new users are added to the beta. If you want to be participate, please fill out this form.