Quick Start Guide

Get Bol.com Integration up and running in minutes. This guide walks you through the essential setup steps to connect your Magento store with Bol.com and start selling on the Netherlands' largest marketplace.

Step 1: Install the Extension

Via Composer (recommended)

composer require magmodules/magento2-bol
bin/magento module:enable Magmodules_Bol
bin/magento setup:upgrade
bin/magento cache:flush

Step 2: Enable the Module

1. Go to Magmodules → Bol.com → Configuration → Settings
2. Set Enabled to Yes
3. Click Save Config
4. Flush cache: System → Cache Management → Flush Magento Cache

Step 3: Get Your Bol.com API Credentials

Before you can connect, you need API credentials from Bol.com:

1. Log in to your Bol.com seller account
2. Go to Settings → API Settings
3. Create new API credentials or use existing ones
4. Copy your Client ID and Client Secret

Step 4: Create a Bol.com Account

1. Go to Bol.com → Configuration → Accounts
2. Click Add New Account
3. Configure the account:

4. Configure Order Import settings:

   • Enable order import
   • Set Import Orders From date
   • Select Store View for orders
   • Choose Product Identifier (attribute containing EAN)
   • Select shipping methods

5. Click Save

Test the Connection

Run the connection test to verify your credentials:

bin/magento magmodules-bol:test-connection

Step 5: Create a Product Profile

Product profiles define which products to sell on Bol.com and how:

1. Go to Bol.com → Configuration → Product Profiles
2. Click Add New Product Profile
3. Configure:

4. Set up Conditions to select which products to include
5. Configure Price Data (price attribute, markup percentage)
6. Configure Offer Data (condition, fulfilment type, delivery code)
7. Click Save

Step 6: Export Your Offers

1. Go to Bol.com → Data → Offers
2. Wait for the product profile to process (or run manually)
3. Select the offers you want to export
4. Use mass action Export to push offers to Bol.com

Or export via CLI:

bin/magento magmodules-bol:export-offers

Step 7: Enable Cron Jobs

For automatic synchronization, configure cron jobs at Magmodules → Bol.com → Configuration → Settings → Cron:

Verification Checklist

• Module is enabled
• Bol.com account is created and connection test passes
• Product profile is created with correct EAN attribute
• Offers appear in the Offers grid
• Offers are successfully exported to Bol.com
• Test order imports correctly

Common Setup Issues

Connection test fails

• Verify Client ID and Client Secret are correct
• Check if API credentials are active in Bol.com partner portal
• Ensure "Is Demo" matches your credential type

No products in Offers grid

• Check product profile conditions
• Verify EAN attribute has values
• Run product profile processing manually

Orders not importing

• Verify order import is enabled on the account
• Check "Import Orders From" date
• Ensure cron is running

Need More Help?

Documentation:

• All Help Articles - Complete documentation overview

Support:

• Contact Support - Get help from our team