Note I: This article assumes you have already advertised on Bol.com with your products. If you are new to adverting 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.
Step 1: Generate your API keys in Bol.com
Use the following link to log in to Bol.com: Bol.com seller account.
Navigate to the section Instellingen > Diensten > API Instellingen. If you have not yet filled out the "Technisch contactpersoon" section, do this first. If this section is filled you will see a section below named "API keys voor productie".
Instead of going directly to the 'API keys voor productie' heading, you first have to click on 'Ik wil mijn oude API keys inzien'.
After this the correct API keys are shown and you need to copy the production public key and private key (you will need these later). Now you can enter these keys in Channable, as described below in step 2 and 3.
Step 2: Create a new Bol.com API in Channable
Go to Channable, open your project and go to APIs > Add new API. A new screen will open with the API Settings where you can click on the "+ Add new connection" button.
You will be forwarded to an overview in which you can select "Bol.com" to create a new connection. Fill in a name for the connection under "Label", the production public key and private key you copied earlier for the "Plaza Public key" and the "Plaza Private key", and click the "Create" button to save your connection.
You will then be redirected back to the API Settings step where you can click on the "Continue" button to create your new Bol.com API.
Step 3: Create your product listings in Channable
Actually creating your product listings is very simple and fast. You can create your product 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.
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 4: 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 5: 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 6: 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.