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: $599 USD (one-time) License: OPL-1 — no activation key, installs standalone
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
- Scheduled inventory synchronization (every 15 minutes by default, adjustable)
- Commission and fee tracking (V11 commission breakdowns per settlement line)
- Returns and refund management
- LVB (Logistiek via Bol) support — inbound shipments and replenishment forecasting
- Shipping label retrieval via the Transporter API (PostNL, DHL for You, DHL, DPD NL)
- VLAREMA (Flanders) packaging-waste summary on LVB shipments
- Risk flags with fraud scoring on imported orders
- Multi-seller / multi-market support (NL + BE)
Prerequisites
- Odoo 17, 18, or 19 (Community or Enterprise edition)
- A Bol.com seller account (bol.com)
- Bol.com API credentials (Client ID + Client Secret) from the Partner Portal
Installation
- Download the module ZIP from your ECOSIRE Dashboard
- Extract to your Odoo addons directory:
unzip ecosire-bolcom-*.zip -d /opt/odoo/addons/
- Restart the Odoo service:
sudo systemctl restart odoo
- Navigate to Apps, click Update Apps List
- Search for the module and click Install
The module is self-contained — there is no separate licence module to install and no activation key to enter.
Configuration
Step 1: Obtain Bol.com API Credentials
- Log in to your Bol.com Partner Portal
- Navigate to Settings > API Settings
- Generate a new set of API credentials
- Note your Client ID and Client Secret
- These are used with the OAuth 2.0 client_credentials grant -- no user interaction needed
Step 2: Connect in Odoo
- Navigate to Bol.com Store Management > Configuration
- Create a new configuration and enter:
- Client ID (
client_id) -- Bol.com API Client ID - Client Secret (
client_secret) -- Bol.com API Client Secret
- Client ID (
- Click Test Connection to verify API access
- Set the company the store belongs to (each store record is company-bound and isolated by record rules)
Step 3: Configure Sync Settings
Product Sync
- Enable product sync, then choose between scheduled automatic sync or manual runs
- Set the sync frequency: every 15 or 30 minutes, hourly, every 6 or 12 hours, or daily
- Configure product field mapping and EAN matching
- Catalog records validate barcodes with the GS1 check-digit rule and show LVB eligibility
Inventory Sync
- Runs on a scheduled action (every 15 minutes by default) or on demand from the Export Wizard
- Link each bol.com stock location (LVB or self-fulfilled) to an Odoo warehouse under Logistics & LVB > LVB / SF Locations
- Track LVB (bol-fulfilled) and self-fulfilled inventory separately
Order Sync
- Enable automatic order import
- Auto-workflow rules per market: auto-confirm, auto-invoice, auto-deliver, and validate payment (which posts the auto-created draft invoice)
- Review orders on the kanban board grouped by bol.com status, with market and fulfilment filters
Initial Sync
- Go to Bol.com Store Management > Operations > Import Wizard
- Select data types to import (Products, Customers, Orders)
- Set date range for historical orders
- Click Start Import and read the result panel (per-run counts and failures) when the run finishes
API Details
| Field | Value |
|---|---|
| Auth method | OAuth 2.0 client_credentials grant |
| Token URL | https://login.bol.com/token |
| Base URL | https://api.bol.com/retailer |
| API version | v10 |
| Content-Type | application/vnd.retailer.v10+json |
| Key config fields | client_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
- Top Products panel ranked by revenue
- Auto-refresh every 60 seconds with dark mode support
Troubleshooting
| Issue | Solution |
|---|---|
| Connection failed | Verify API credentials; check network connectivity |
| Sync not running | Check Odoo scheduled actions (cron jobs) are enabled |
| Duplicate products | Review product mapping; ensure SKU matching is configured |
| Orders not importing | Verify order status filters and date range settings |
| 401 Unauthorized | Client credentials may have expired; regenerate in Partner Portal |
| LVB inventory mismatch | Check LVB vs self-fulfilled tracking settings |
| Commission discrepancy | Verify product category mapping matches Bol.com commission tiers |
| Barcode flagged on a catalog record | The EAN/GTIN fails the GS1 check-digit test; correct it on the product before exporting |