Skip to main content

Bol.com Store Management

Connect your Bol.com seller account to Odoo through the Bol.com Retailer API v10. This module uses OAuth 2.0 client credentials authentication to synchronize your product offers, process orders, and manage inventory on the Netherlands' and Belgium's largest online marketplace. The integration handles the application/vnd.retailer.v10+json content type natively and provides a real-time OWL 2 dashboard for monitoring your operations.

Compatibility: Odoo 17 / 18 / 19 Price: $349 (one-time) License: Up to 3 domain activations

Key Features​

  • Bol.com Retailer API v10 integration
  • OAuth 2.0 client credentials authentication
  • Bidirectional product and offer synchronization
  • Automatic order import with fulfillment tracking
  • Real-time inventory synchronization
  • Commission and fee tracking
  • Returns and refund management
  • Bol.com FBB (Fulfillment by Bol.com) support
  • Shipping label generation
  • Performance score monitoring
  • Multi-seller support
  • Promotion management

Prerequisites​

  • Odoo 17, 18, or 19 (Community or Enterprise edition)
  • An active ECOSIRE license for this module
  • A Bol.com seller account (bol.com)
  • Bol.com API credentials (Client ID + Client Secret) from the Partner Portal

Installation​

  1. Download the module ZIP from your ECOSIRE Dashboard
  2. Extract to your Odoo addons directory: 
    unzip ecosire-bolcom-*.zip -d /opt/odoo/addons/
  3. Restart the Odoo service: 
    sudo systemctl restart odoo
  4. Navigate to Apps, click Update Apps List
  5. Search for the module and click Install
  6. Enter your ECOSIRE license key when prompted

Configuration​

Step 1: Obtain Bol.com API Credentials​

  1. Log in to your Bol.com Partner Portal
  2. Navigate to Settings > API Settings
  3. Generate a new set of API credentials
  4. Note your Client ID and Client Secret
  5. These are used with the OAuth 2.0 client_credentials grant -- no user interaction needed

Step 2: Connect in Odoo​

  1. Navigate to Bol.com Store Management > Configuration
  2. Create a new configuration and enter:
    • Client ID (client_id) -- Bol.com API Client ID
    • Client Secret (client_secret) -- Bol.com API Client Secret
  3. Click Test Connection to verify API access
  4. Configure your default warehouse and company mapping

Step 3: Configure Sync Settings​

Product Sync​

  • Choose sync direction: Bol.com-to-Odoo, Odoo-to-Bol.com, or bidirectional
  • Set sync interval: scheduled (every 5, 15, or 60 minutes)
  • Configure product field mapping and EAN matching

Inventory Sync​

  • Map Odoo warehouses to Bol.com stock locations
  • Set buffer stock quantities if needed
  • Enable real-time stock updates on changes
  • Configure FBB vs FBR inventory tracking separately

Order Sync​

  • Enable automatic order import
  • Map Bol.com payment methods to Odoo payment journals
  • Configure fulfillment sync to push tracking numbers
  • Set up order status filter rules

Initial Sync​

  1. Go to Bol.com Store Management > Operations > Initial Import
  2. Select data types to import (Products, Customers, Orders)
  3. Set date range for historical orders
  4. Click Start Import and monitor progress in the sync log

API Details​

FieldValue
Auth methodOAuth 2.0 client_credentials grant
Token URLhttps://login.bol.com/token
Base URLhttps://api.bol.com/retailer
API versionv10
Content-Typeapplication/vnd.retailer.v10+json
Key config fieldsclient_id, client_secret

Dashboard​

The built-in OWL 2 dashboard provides real-time visibility into your integration:

  • 6 KPI cards -- Revenue, Orders, Customers, Products, Avg Order Value, and Sync Health -- each with period-over-period delta indicators
  • Sales Trend chart (Chart.js line chart) with interactive date filtering
  • Order Status breakdown (doughnut chart) showing distribution across statuses
  • Period filters -- Today, 7 days, 30 days, 90 days, Year, or Custom date range
  • Activity feed showing recent sync log entries with type indicators
  • Quick action buttons for Products, Orders, Customers, Queue, Logs, and Settings
  • Status footer with Queue Jobs, Errors, Out of Stock, and Sync Rate
  • Auto-refresh every 60 seconds with dark mode support

Troubleshooting​

IssueSolution
Connection failedVerify API credentials; check network connectivity
Sync not runningCheck Odoo scheduled actions (cron jobs) are enabled
Duplicate productsReview product mapping; ensure SKU matching is configured
Orders not importingVerify order status filters and date range settings
401 UnauthorizedClient credentials may have expired; regenerate in Partner Portal
FBB inventory mismatchCheck FBB vs FBR (Fulfillment by Retailer) tracking settings
Commission discrepancyVerify product category mapping matches Bol.com commission tiers
License not activeVerify your ECOSIRE license key at Settings > ECOSIRE License

Support​

Last updated on