bol: how do I (re)authorize ChannelEngine for the bol API?

About this article

This article describes the process to authorize and reauthorize ChannelEngine to connect with your bol account.

Table of contents

Introduction

How to authorize

• Step 1: log in to bol from ChannelEngine
• Step 2: set up access scopes on bol
• Step 3: verify OAuth access
• Step 4: check your connection on ChannelEngine

Reauthorizing

Introduction

bol maintains its API security to give you more control over the data you share about your bol account via the API. To accommodate these updates, you need to reauthorize your connection. The most visible change in the reauthorization process is that you now need to set up API access scopes on bol.

How to authorize

Follow the steps below to authorize or reauthorize ChannelEngine to connect with your bol account.

Step 1: log in to bol from ChannelEngine

Before you are able to receive and process orders from bol, make sure that your connection is authorized.

• New sellers - follow the authorization steps below.
• Established bol sellers - periodically reauthenticate your connection to ChannelEngine when your connection token expires, also following the authorization steps below.

To connect bol to ChannelEngine for the first time or to reauthenticate your connection between bol and ChannelEngine:

1. On ChannelEngine, open the bol channel.
2. Go to Setup, Authorization.
3. If this is your first connection to bol, click Authorize. To reauthorize your connection to bol, click Reauthorize.

1. A pop-up message appears to remind you to switch your browser to Incognito mode during the OAuth authorization process. Switch your browser to Incognito mode, and click Yes.
2. In the second pop-up, log in to your bol account using your email address and password.

6. Click the blue Toestaan (Allow) button to connect your bol account with ChannelEngine.

Step 2: set up access scopes on bol

To set up ChannelEngine's access scopes:

1. Once logged in to bol's platform, set up ChannelEngine's access scopes for the Retailer API. In the next pop-up, select your shop name from the dropdown under Kies de retailer die je wilt koppelen (Choose the retailer that you want to connect).
2. Enable Manage access scopes for each of the following parts of the Retailer API:
   • Assortment Management
     • Financial
     • Insights
     • Logistics
     • Subscriptions
3. Click Save.

Step 3: verify OAuth access

You can check that you have given ChannelEngine OAuth access to bol's platform at any time:

1. On bol's platform, go to Settings by clicking your account name in the top right corner, Instellingen (Settings).

   

2. Click API instellingen (API settings) in the Diensten (Services) section.

3. Scroll down to the Authorized parties section. Make sure that ChannelEngine is on the list of authorized parties.

   

4. If you have not yet added a technical contact or agreed to the bol API terms of service, do so now. Add your name, email address, and telephone number, and agree to the API terms of service.

Step 4: check your connection on ChannelEngine

On ChannelEngine, check that the connection is active. On your bol channel, go to Setup, Authorization. If your connection is active, the orange Authorize button has changed to a green Reauthorize button.

Reauthorizing

Once the authorization is successful, ChannelEngine receives a specific token that allows it to get short-term OAuth tokens to perform API calls. However, this specific token has an expiration date of exactly one year. As long as you continue to use bol as a marketplace via ChannelEngine, you need to reauthorize it yearly.

You receive notifications once the expiration date is approaching, so make sure to enable these notifications. If you do not reauthorize on time, ChannelEngine loses the permission to perform API calls for your bol account, and the plugin is disabled.

The steps to perform for reauthorization are exactly the same as for the regular authorization above. Start from Step 1 and click Reauthorize instead of Authorize in step 3.