Installation guide

Prerequisites

Downloading and installation

🗎 Speak Dutch? Then consider watching this installation instruction video🗎 for version 2.1.8

Once you have received the zip file containing the module you can simply upload it through the “modules and services” page in Prestashop.
To do so, follow these steps:

Prestashop 1.6

  1. Navigate to the “Modules and Services” tab.
  2. Click the “Add a new module” button at the top-right of the page.
    A file upload section will now appear in the page
  3. Click on “Choose file” and select the bolcom vx.y.z.zip file that you have received.
  4. Click “Upload this module”
  5. A warning will appear that this module could not be verified.
    This is correct as it wasn’t purchased via Prestashop’s official module directory.
    Click “Proceed with the installation”

Prestashop 1.7

  1. Navigate to the Module Manager
  2. Click the “Upload a module” button at the top-right of the page
    A file upload dialog will now appear.
  3. Click on “Choose file” and select the bolcom vx.y.z.zip file that you have received.
  4. Click “Upload this module”
  5. A warning will appear that this module could not be verified.
  6. This is correct as it wasn’t purchased via Prestashop’s official module directory.
  7. Click “Proceed with the installation”

Finishing the set up

The first time you install the module it will perform the following tasks:

  1. Install the module’s files on into your modules directory.
  2. Create new tables in your database.
  3. Create new order statuses and configure the module to respond to them.
  4. Create a new customer group “bol.com”.
  5. Add an item to the tabs (menu) called “bol.com connector”

Once the installation has finished click the “bol.com connector” tab (menu) item and you should see the module’s homepage.

This screenshot does not show the module’s latest version

Let’s first address those warning messages and get you started!

Configure the module for first use

The module’s useful “configure” screen provides access to configuration screens and to useful features such as:

  • Mass product updates
  • Fixing failing order imports

And if you have just installed the module you will be seeing some warnings here which are the result of the module’s health check.

To resolve these warnings we must:

  1. Inform the module which order statuses it should watch.
  2. Provide the bol.com accounts the module needs to get started.
  3. Teach the module which of the Carriers in your Prestashop installation relate to what “bol.com transporters”.

1. Manage account data

Before the module can do it’s job you must add a bol.com account.

  1. Click on the “Manage bol.com accounts” link in the “Configuration” section
  2. At the right top of the screen, his the plus sign to add a new account.
  3. Fill out all fields. See below for info on how to obtain all account information.
  4. Click save.

You are now ready to start selling on bol.com.

Obtaining account information

API Keys

Login to the bol.com backoffice for professional sellers and navigate to the “account” page.
Here you can create one or more sets of API keys.

Copy the Client ID and the Client Secret into respectively the “Public key” and “Private key” fields of the bol.com connector.

2. Configuring order states

In Prestashop, orders have order states. Each order state triggers certain functionality such as the sending of e-mails, registering payments, etc.

During installation, the module creates 4 new order states and configures those to be used for the bol.com connector.
It’s up to you to decide to stick with the default configuration or if you want to change them. The standard configuration is compliant with bol.com.

See the chapter “General configuration” for more details on these states and their behaviors.

3. Importing your product feed (offers) from bol.com

If you are already active on bol.com it is recommended that you import your product feed (offers) right after adding your bol.com account data.

4. Set up the various Cron jobs

Set up the cron tasks that make sure your orders keep getting imported and your products remain synchronized at bol.com