Manage Bol.com Accounts in Magento 2
Accounts connect your Magento store to your Bol.com seller accounts. You can configure multiple accounts if you sell under different Bol.com seller names.
Location: Bol.com → Configuration → Accounts
Creating an Account
- Click Add New Account
- Configure the General settings
- Configure Order Import settings
- Click Save
General Settings
Enabled
Enable or disable this account. Disabled accounts won't sync offers or import orders.
Name
Internal name for this account. Use something descriptive like "Main Account" or "Brand X Account".
Is Demo
Enable if using Bol.com demo/sandbox API credentials. Demo mode connects to the test environment instead of production.
Client ID
Your Bol.com API Client ID. Get this from your Bol.com Partner Portal under Settings → API Settings.
Client Secret
Your Bol.com API Client Secret. Keep this secure - treat it like a password.
Order Import Settings
Enabled
Enable order import for this account. When enabled, orders from Bol.com will be fetched and can be created in Magento.
Import Orders From
The starting date for order import. Orders placed before this date will not be imported.
Tip: Set this to today when first setting up, then backdate if needed.
Store View
Which Magento store view to create orders in. This affects product data, prices, and customer settings.
Product Identifier
Which product attribute holds the EAN/barcode. Bol.com identifies products by EAN, so this must match.
Common options:
sku- If your SKUs are EANsean- Dedicated EAN attributebarcode- Custom barcode attribute
Default Shipping Method
The shipping method applied to imported orders.
Fallback Shipping Method
Used if the default shipping method is unavailable.
Import Customers
Whether to create customer accounts for Bol.com buyers. If disabled, orders are created as guest orders.
Customer Group
Which customer group to assign to imported customers.
Separate House Number
If enabled, the house number is placed in the second street line instead of being appended to the address.
Use when: Your checkout or ERP requires house numbers in a separate field.
Use Bol.com Order ID
Use the Bol.com order ID as the Magento order increment ID instead of generating a new one.
Order ID Prefix
Prefix added to order increment IDs when using Bol.com Order ID. For example, "BOL-" results in "BOL-123456789".
Import Orders With
Select which fulfilment types to import:
- FBR - Fulfilled by Retailer (you ship)
- FBB - Fulfilled by Bol (Bol ships from their warehouse)
Auto Ship FBB Order Items
Automatically create shipments for FBB orders since Bol.com handles the actual shipping.
Testing the Connection
After saving, verify your credentials work:
bin/magento magmodules-bol:test-connection
Or test a specific account:
bin/magento magmodules-bol:test-connection 1
Multiple Accounts
You can create multiple accounts for:
- Different Bol.com seller accounts
- Separate demo and production environments
- Different business units or brands
Each Product Profile is linked to one account.
Need More Help?
Documentation:
- All Help Articles - Complete documentation overview
Support:
- Contact Support - Get help from our team