Note: 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". Click on the "Vernieuw API keys" button to create new tokens. Copy the production public key and private key (you will need these later).
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 the 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.
If you have already advertised on Bol.com with your products you can skip this step, you will not need to fill out the categories. If you haven't advertised on Bol.com make sure to read through the section "What to do if you need to send content data to Bol.com?" below.
Create different rules to optimize your productdata. For examples take a look at our common rules support article.
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' on the bottom of the screen.
If you have already advertised on Bol.com with your products you can skip this step, you will not need to add attributes for your products. If you haven't advertised on Bol.com make sure to read through the section "What to do if you need to send content data to Bol.com?" below.
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 the Attributes step in 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 you have completed this step navigate back to then APIs overview and select 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.
What to do if you need to send content data to Bol.com?
If you haven't advertised on Bol.com before, or if you are going to create product listings for a new collection of products you will need to send so called content data for your products to Bol.com. The steps below shows you how to send this kind of product information to Bol.com.
Step 1: Request and add content FTPS credentials to your Bol.com API in Channable
With content FTPS we can send a content file with this additional product content to Bol.com, so that they can process it automatically. To make use of the content FTPS, you have to apply for a content FTPS account. The content FTPS account is only possible with a Bol.com business seller account. Channable customers have to use the following form:
After filling in this form Bol.com will send you an email containing a user name and password for your content FTPS account. Then, you can add these credentials to the Bol.com connection. Go to the top right corner of your screen and go via your name to 'Connections'. There you can edit your Bol.com connection and fill in the credentials you received from Bol.com.
Note I: After Bol sends the FTPS credentials, it takes about an hour before the FTPS-account is ready to use. If you try to send information to the account before it is ready, a square map missing-error will show.
Note II: With an enabled content FTPS account it can take up to 48 hours for the content to be processed by Bol.com, so if you think you've entered the correct content in the attribute builder, wait at least 48 hours before you check if your unknown products are accepted.
Note III: After the content is processed (max 48 hours) there will be a feedback Excel file available in the FTPS-account that shows possible mistakes in your Bol.com content. Contact our Support Team if you want this file.
Step 2: Fill out the Categories step in the API
Step 3: Fill out the Attributes step in the API
In the Attributes phase you can add the attributes required by Bol.com.
Here you will get an overview of your different categories which have their own different attributes and you can select the category for which you would like to add attributes. After selecting the right category an overview will appear. The red fields are demanded, whereas the grey fields are optional. Make sure to have filled all the demanded fields in the right way - if an invalid value is given the field will stay red.
In the image above you can see that there is a red field in the attribute 'Kledingmaat'. You can fill these by adding an attribute value. In some cases you want to send the same value for this attribute for every product. In that case you can simply type the value you want to send through in the field "Attribute value".
However, in most cases the information you need to add is different for each product and therefore typing a static value in "Attribute value" is not good enough. In this case it is better to choose a field from Channable that contains the right information. Click on the attribute wanted, in the case 'Kledingmaat' and choose the right field which contains the right information. You can do this as shown below:
By clicking on the 'plus' you will get a drop-down where you can select the field that you want to add as an attribute. Make sure that you have a field generated (edit mapping) and filled (rules) if this field is not automatically available from your import feed or connection with your web shop. It is important that the field you select here contains the information you want to add to the selected attribute. You can always check this by going to "items" on the left menu of Channable and searching the product that you need to add this attribute for. If it doesn't contain the right information, you could go to the Rules section in the Bol.com marketplace to add the right information to the selected field.
Step 4: Optimize your data based on the feedback Excel file Bol.com generates
In your Bol.com FTPS-account we can download a feedback file from the last 10 offered content feeds. I you want this file, please contact our support Team.
When you open up the Excel file you can find out what information needs to be changed or added in order to successfully add the refused products to the Bol.com database.
On top of the first page you get a description of how this file works, which we would advise you to read once. On the bottom you should see one or more tabs for different categories of your products. These tabs contain the products that have been rejected because the product information for these products is not sufficient. Click on a tab to get an overview. Here you can find red highlighted fields which show you which information is missing for each product. The next step is to add the missing attributes for these products in Channable.