Setting Up a New Bol.com Account in Magento 2

The New Account page in the Magento 2 Bol.com plugin allows you to connect your Magento store with your Bol.com seller account. From here, you can link API credentials, enable import options, and configure order synchronization.

Why This Setup Matters

Connecting your Bol.com account ensures seamless synchronization between Magento and Bol.com. This means orders, stock levels, and shipping details can be automatically updated — saving time and avoiding manual errors.

Steps to Create a New Bol.com Account

1. Go to Bol.com > Accounts > Add New in your Magento admin.
2. In your Bol.com seller account, go to Settings → API Settings.
3. Under Client credentials for the Retailer API, click Create.
4. Copy the Client ID and Client Secret to Magento.
5. Click Save to store your credentials.

General Settings

• Enabled: Activate the Bol.com connection.
• Name: Choose a label for internal reference.
• Is Demo: Test with Bol.com’s demo environment (optional).
• Client ID / Secret: Credentials generated from Bol.com’s API settings.

Order Import Settings

• Enabled: Turn on order import from Bol.com.
• Import Orders From: Select date or time range for imports.
• Store View: Assign orders to the correct store view.
• Product Identifier: Choose SKU or EAN for mapping.
• Default & Fallback Shipping Method: Set your preferred shipping carriers.
• Import Customers: Automatically create Magento customers for Bol.com buyers.
• Import Orders With: Select whether to import Retailer (FBR) or Bol (FBB) orders.
• Auto Ship FBB Items: Automatically mark FBB items as shipped when fulfilled by Bol.com.

Note on FBB Orders

Enable the FBB (Fulfilled by Bol.com) option only if your products are stored and shipped directly by Bol.com. For self-fulfillment, use the Retailer (FBR) mode.

Troubleshooting

Invalid Credentials?

Double-check the Client ID and Secret in your Bol.com account under API Settings. Remember that credentials differ between production and demo environments.

Orders Not Importing?

Make sure the “Order Import” toggle is set to Yes and that your cron jobs are active for scheduled imports.

Conclusion

Once your Bol.com account is connected, Magento will automatically import and sync orders, helping you manage your marketplace operations efficiently. Need help? Visit the Bol.com Orders Help Article or contact our support team.