Note I: This article assumes you have already advertised on Bol.com with your products. If you are new to advertising on Bol.com, please also read our support article on how to add unknown EAN codes to Bol.com.
Note II: EAN codes are mandatory for Bol.com. Make sure you have valid EAN codes for all your products, otherwise no product listings can be created for your products.
Note III: You have to log out from your Bol.com account before creating a connection. Otherwise, it will be connected automatically and this can cause unexpected problems later in the process.
Step 1: Create a Bol.com V3 API connection in Channable
We recently made the switch from Bol.com's old V2 API to the new V3 API. Making a new connection with Bol is different from before. The main difference in the Bol.com V3 API is the authentication. To use Bol.com V3, you need to authorize Channable via an automated route. It is no longer possible to copy-paste keys from your Bol.com seller account to your Channable account.
You need to perform the following steps:
First, go to the project you are working in and navigate to the APIs tab. Click on "+Add new API" and then on "+Add a new connection". You will see this screen, where you can select Bol.com V3:
After selecting Bol.com V3, give the connection a label and click on "Connect with Bol.com". You will be redirected to log into your Bol.com seller account and accept the Bol.com Retailer API terms:
As soon as you have logged into your Bol.com seller account and accepted the terms, you are redirected back to Channable. Please do not forget to click the blue "Add connection" button to save your new connection.
You can now select the new Bol.com V3 API connection when adding a new API. Give the API a name and click on "Continue" to start creating your product listings!
Step 2: Create your product listings in Channable
Actually creating your product listings is very simple and fast. You can create your product listing by following the four step shown below in the Bol.com API.
We advise to first try to send your products without doing the categories. If Bol.com is already familiar with the EAN codes of your products, you will not need to do this step. You will know if Bol.com doesn't recognize the EAN codes of your products after running your Bol.com API. If the products are not yet known, you will see the following error in the Preview step of the API: "UNMATCHED_OFFER".
Create different rules to optimize your product data. For examples take a look at our common rules support article. Be sure to include the three following rules as well to prevent errors.
Rule 1: Check if an EAN code is invalid. Bol.com only accepts products of which the EAN code is valid, so if the EAN code is invalid this rule excludes the product.
Rule 2: Check if your additional images contain any duplicates of your main image. If it does contain a duplicate, remove it. This can be done by using this rule below.
Rule 3: Limit the stock of your products if it is greater than 500. For Bol.com the maximum stock a product can have is 500, so if your stock is greater than that this rule sets it back to 500.
Here you can find our preset template for the product listings. All you have to do is to fill it out by clicking on the field itself and selecting what you would like to go in there. For example, the field 'Title' should display the title of your product and so on.
Tip! Notice the question mark behind every field, if you hover over the question mark you will see the description of the field and suggestions for possible values.
When you have finished setting up the product listings, just click 'save' at the bottom of the screen.
Note: The new Bol V3 API also supports volume discount. This can be configured in the Build step as well. See this article on how to configure volume discount in Channable!
Just as with the Categories step, we advise to first try to send your products without doing the attributes. If Bol.com is already familiar with the EAN codes of your products, you will not need to do this step.
Step 3: Remove the old product listings from your Bol.com account
It is important that there are no old product listings in your account when you activate the Bol API in Channable. To delete the old product listings navigate to Artikelen > Mijn aanbod. Here you can select all listings and delete them by clicking on Bewerk aanbod > Verwijderen. This step is important, because deleting the old listings prevents errors from occurring when you activate the Bol API in Channable.
Note: Any product content information you have already filled out for your products will be saved in the Bol database. You will not have to fill out the information for these products in Channable. Also, your Bol.com reviews will be saved when you remove the old product listings from your Bol.com account. Your reviews will re-appear when the products are live again via Channable
Step 4: Send your product listings to Bol.com
Almost there, your product listings are ready to be sent. If you have not activated your webshop go to Settings panel on the left-hand side of the screen and click 'activate webshop'. After, go back to the APIs overview and go to "Your Bol API Name" > Settings where you activate the API by selecting "Activate API". After activating your API, navigate back to APIs overview and click on the blue "Run now" button to sent your product listings to Bol.com.
Step 5: Check your product listings for errors
If you have sent you product listings to Bol.com go to the Preview tab of your Bol API. Click filter on 'error'. Now you can see which product listings have errors and are not placed. Check out our error solutions section on how to correct errors.
If you receive error "UNMATCHED_OFFER" this means that your products are not yet known on Bol.com. This means that you have to add these new products to the Bol.com EAN database. To solve this error read our support article on how to add unknown EAN codes to Bol.com.