Skip to main content

Bol.com: offers and products publication

Charles BARAT avatar
Written by Charles BARAT
Updated over a week ago
bol marketplace et BeezUP

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

  1. 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" for the Netherlands and Dutch-speaking Belgium and

"BOL Products BEL API V.2" for France and Wallonia.

⚠️ BOL indicates that publishing relevant offers is a necessary step to complete the product creation process.

Add the BOL Offers NLD API to your store. You can use both Offers and Products as a single channel for your subscription.


​⏩ 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.

✔️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

If your products come in multiple sizes or colors (or any other type of variation) and you want to publish them on BOL, put the ID that groups the variations of the same product in the "Family Key" attribute.

⚠️ Note: It is recommended to be consistent with the value of the distinctive feature (size, color, etc.) for all products in the product family to avoid the ungrouping of products.

The value of the "Family Key" attribute is stored for 28 days, therefore, any update to the Family Key value after 28 days of the initial upload requires the inclusion of all the family members to the product family once more. Currently, no feedback is provided to track the processing of the request. Therefore, you can also use the Seller Dashboard alternatively to verify the status of your request.

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.

Cancellation by the Customer

If a customer requests cancellation, we ask you to confirm the cancellation requested by the client by a normal cancellation with us with the reason 'REQUESTED_BY_CUSTOMER'.

We wish you good sales on Bol.com via BeezUP!

Did this answer your question?