Get started with the Retailer API
Thank you for choosing bol.com as a retail partner. This site will help you to set up your development environment and begin selling your goods on our marketplace.
Please make sure that you have read and understand the Terms of Service that apply to the Retailer API before connecting.
Before you start, make sure you have a bol.com retailer account. You cannot connect to us without it.
The base URL for all your API connections is https://api.bol.com/retailer.
You can now start automating a complete workflow for selling on bol.com. You can manage your products, offers, orders and shipments, retrieve and confirm cancellations, handle your returns, view your invoices, and even print your shipping labels.
Before you start, make sure you understand the key concepts of our data model and the process flow of selling on bol.com. Also, make sure that you adhere to our conventions when developing your connections.
To make development easier, you can use our standard Postman export. Please be aware that you need to update the public Postman environment first with your production API credentials.
By default, the Postman collection is pointing to the demo environment. If you wish to change this to the production environment, you can change the environment variable accordingly.
Since much of our processing is asynchronous, if you create for example an offer or shipment through the API, always use a process status request afterwards. This allows you to verify that the process was completed successfully.
We recommend that you test your bol.com API connections against our demo environment. This allows you to can test your API calls and add products without being shown live on the website.
All endpoints are represented in the demo environment, except where the response is a PDF.
While all efforts have been made to simplify and standardize our partner integrations, bear in mind that we do not offer a plug-and-play solution. There are several ways to connect to bol.com, but all require knowledge of software development and programming.
There are, however, several third party plug-and-play solutions on the market which can be purchased or used on a subscription basis. We have listed a few of them on the website for retailers.