bol: data migration module

About this article

This article describes how to import your product content from bol using ChannelEngine's data migration module.

Table of contents

Introduction

Features

Requirements

Setup

How it works

Accessing and mapping your feeds

FAQs

Introduction

As a merchant, you may initially start off selling on bol and use bol to manage your product content. However, this means that your product content resides only in bol's system.

Use ChannelEngine's data migration module to import your product content from bol and save it as a product feed. You can then edit and enrich this feed, and use it as the product feed source for all your channels on ChannelEngine.

Features

*bol has strict API limits for retrieving product images. Therefore, images are not supported in the current data migration module.

Requirements

• An active bol seller account
• An active account on ChannelEngine

Setup

On bol

To connect your bol account to ChannelEngine, generate the required credentials. 

1. Log in to your bol sales account.
2. In the top-right corner, under your account name, select Instellingen (Settings) and go to API Instellingen (API settings).
3. Enter the contact details for your technical contact, then click Opslaan (Save).
4. Under Client credentials for the Retailer API, click Aanmaken (Create). Enter ChannelEngine as the name of your integration partner.
5. Once created, copy and save the Client ID and Client secret for later.

On ChannelEngine

1. From the sidebar menu, go to Plugins.

2. Add the bol.com merchant plugin to your ChannelEngine tenant.

   

3. Go to the Setup step.
4. In the Connection settings, enter Client ID and Client secret that you copied from bol. Click Save.
5. Go to the Activation step.
6. Click Activate synchronization for bol merchant. ChannelEngine performs a test API call to your bol environment. If an error occurs, the credentials are invalid. Check your connection settings and try again.
7. Go to the Setup step.

8. In the Actions settings, click Run products import. This triggers a task that imports product content from bol and creates product feed files on ChannelEngine.

   NB: if you update attributes on bol and want to import them into ChannelEngine, click Run products import again. The synchronization between bol and ChannelEngine does not run automatically.

How it works

When a connection is established between ChannelEngine and your bol account, ChannelEngine requests a list of all your products and their corresponding data.

After importing the data from bol, ChannelEngine compiles it into:

• A main product feed that contains global attributes, such as Productnaam (Product name) and Beschrijving (Description).
• Additional feeds that contain category-specific attributes.

To receive notifications when the feeds become available on ChannelEngine, go to the Notification center and enable the New feeds notification. To learn more about how to configure notifications, check out ChannelEngine: how to configure notifications.

Accessing and mapping your feeds

Once the product feeds become available on ChannelEngine, access them at Products, Product feeds, in the Generated feeds tab.

The imported feeds are in CSV format and have the status New.

Click the pencil icon to map the feed attributes to those on ChannelEngine. To learn more about feed mapping, check out the Mapping feeds section of the article ChannelEngine: product feeds.

To start importing feed files from the database into your ChannelEngine tenant, click Import now. The status of each feed changes to Success or Partial success based on the import result. Review the validation report to check for any issues.

To learn more about how to manage product feeds, check out ChannelEngine: product feeds.

FAQs

Why did my product name disappear after I imported additional feeds?

This issue can occur due to conflicting values in the leading and additional feeds. If you mapped ChannelEngine's Name to the Title attribute in the leading feed, but mapped ChannelEngine's Name to the Name attribute in the additional feed (which is often empty on bol), a conflict occurs. In this case, the additional feed overwrites the leading feed's value. To resolve this, in the additional feed, select the Not mapped keep value option next to the Name attribute.

I updated an attribute on bol. How do I get the updated attribute into the generated feed?

To get the updated attributes from bol into your generated feed, manually trigger a new import on ChannelEngine. The synchronization does not run automatically when changes are made on the marketplace. 

To pull the updated data into your generated feed:

1. From the sidebar menu, go to Plugins.
2. Open your bol.com merchant plugin.
3. Navigate to the Setup step.
4. In the Actions settings, click Run products import.