Prerequisites
- A bol.com professional seller account
- Prestashop 1.6 or 1.7
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
- Navigate to the “Modules and Services” tab.
- Click the “Add a new module” button at the top-right of the page.
A file upload section will now appear in the page - Click on “Choose file” and select the bolcom vx.y.z.zip file that you have received.
- Click “Upload this module”
- 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
- Navigate to the Module Manager
- Click the “Upload a module” button at the top-right of the page
A file upload dialog will now appear. - Click on “Choose file” and select the bolcom vx.y.z.zip file that you have received.
- Click “Upload this module”
- 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”
Finishing the set up
The first time you install the module it will perform the following tasks:
- Install the module’s files on into your modules directory.
- Create new tables in your database.
- Create new order statuses and configure the module to respond to them.
- Create a new customer group “bol.com”.
- 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.
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:
- Inform the module which order statuses it should watch.
- Provide the bol.com accounts the module needs to get started.
- 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.
- Click on the “Manage bol.com accounts” link in the “Configuration” section
- At the right top of the screen, his the plus sign to add a new account.
- Fill out all fields. See below for info on how to obtain all account information.
- 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