This procedure aims to explain how to use BeezUP to publish your products on the Bol.com marketplace
SUMMARY
1. Prerequisites to know to integrate Bol marketplace
2. Integration procedure
3. Special case of products with variations
4. Order management
1. Prerequisites to know to integrate Bol marketplace
Publications of offers
The update of offers is automatically sent by API in "update" mode with a "differential" content.
👉 More information here on the different publication strategies.
⏩ The publications of offers are done every 2 hours.
2. Mandatory EAN
BOL does not accept products without EAN (13 digits).
3. Product updates/creations are managed by BeezUP via dedicated channels: "BOL Products NLD API V.2" and "BOL Products BEL API V.2" ⏩ Product publications are done every 24 hours (full update mode without unpublishing products that are not sent from BeezUP).
2. Integration procedure
✔️ If you don't have an account, contact Bol.com and/or go to their website to register.
✔️In BeezUP, add the "BOL Offers API" channel in "Channels" tab to be able to publish your offers and the "BOL Products API V.2" channel to be able to publish your products.
✔️Go to the "Categories" page to define your CPA (commission charged by Bol.com) as well as to categorize your products.
✔️Go to the mapping page and map all the required fields.
For more information on each field, you can click on the 'i' for an explanation of each field that requires one.
⚠️ Attributes like FRONT, BACK, BOTTOM, IN PACKAGE, SIZE, UPS, MULTIPACK, ACCESSORIES, etc. must be filled in media format (image, PDF, video URL). These attributes are indicated in capital letters. The exhaustive list of media attributes and formats accepted by the marketplace is available attached.
⚠️To allow the creation of your products on the Belgian (BEL) and Dutch (NLD) sales channels, or for exclusive distribution on the Belgian channel, the system requires the submission of attributes in 2 languages: German and French. Submitting only in French will not be sufficient.
The relevant attributes are:
Description, BE_Description
Name, BE_Title
NL Admission Number, BE Admission Number (related to categories:
30004427 Désinfectant / Desinfectiemiddel
30016563 Contrôle des algues / Algenbestrijding
30017021 Poison pour vermines / Gif voor ongedierten
80006653 Pesticide contre les mauvaises herbes / Onkruidbestrijder
80008057 Produit de nettoyage pour piscine / Zwembadreinigingsmiddel)
✔️Go to the API Settings tab and set your API credentials:
You can find them by clicking on "Settings" / "API Settings" (in Dutch: "Instellingen" / "API Instellingen").
⚠️ Make sure to:
A: Click on "Create" (Aanmaken)
B: Enter "BeezUP"
C: Copy/paste the "Client Id" and the "Client Secret" (Toon Secret)
into the Bol API settings page (within BeezUP) as described below.
Once the 2 keys are entered, click on "Save" and if the credentials are valid, they will be saved.
Otherwise, a warning message will prompt you to verify them.
✔️ Finally, switch your BOL channels to "On" on the "Channels" page of BeezUP, and the publications will then begin within 2 hours maximum. In order to ensure that the publications occur correctly, you can consult the "Publications" tab, which will indicate any possible corrections to be made in your feed.
3. Special case of products with variations
Sometimes a product can be identified by several EANs. This can be due to several factors, including:
Different packaging sizes.
Regional variations.
Variations in product attributes, such as color or flavor.
Labeling regulations.
Product specifications.
The bol platform merges several EANs that precisely identify the same product into a single product for the webshop. BOL Product ID (BPID) serves as an identifier for this product.
4. Order management
✔️ Once your offers are successfully published, your offers are ready to be sold and your sales will appear in the "Orders" tab (including those in Fulfilment) and (if activated) in your shop system.
We wish you good sales on Bol.com via BeezUP!