Netherlands Bol.com Connector
Order import, stock & price sync and shipment for Bol.com sellers - straight from Odoo
Bring-your-own-key connector to the official Bol.com Retailer API (orders v10 & synchronous Offer API v11)
Run your Bol.com sales channel from inside Odoo. This app connects directly to the Bol.com Retailer API using your own seller API keys - orders, shipments and cancellations on Retailer v10, and offers on the standalone synchronous Offer API v11. It pulls your marketplace orders into Odoo, keeps your offer stock and prices up to date, and pushes shipments with track & trace back to Bol. No middleware, no third-party portal - just Odoo and the Bol.com seller API.
Bring your own key (BYOK). You paste the Client ID and Client Secret from your own Bol.com seller account (Settings → API). The connector obtains and refreshes short-lived OAuth2 tokens on your behalf and sends data only to the Bol endpoint you configure. We are not a Bol partner or integrator; you operate entirely under your own seller account.
Everything a Bol.com seller needs
Order import (pull)
A scheduled job and an on-demand button pull your open Bol orders page by page, filtered by fulfilment method (FBR or FBB). Each order is fetched in full and mapped to an Odoo sale order with the shipment and billing addresses and order lines resolved by EAN, barcode or internal reference.
Offer stock & price sync (push)
Create offers by EAN, then keep them current: push the on-hand quantity and the Odoo sales price to Bol from a product action or from an hourly scheduled job. Offers run on the synchronous Offer API v11, so each create / update returns its result immediately - no polling.
Shipments & track & trace
A guided wizard creates a Bol shipment for the order items, attaching the transporter (PostNL, DHL, DPD or bpost) and your track & trace number so the buyer is notified automatically.
Cancellations & EAN validation
Cancel out-of-stock order items back to Bol with a reason code, and validate every EAN with the official GS1 modulo-10 check-digit algorithm before an offer is pushed.
Feature matrix
| Capability | Direction | Bol API resource |
|---|---|---|
| Open order import | Pull | GET /orders, GET /orders/{order-id} (v10) |
| Order item cancellation | Push | PUT /orders/{order-id}/cancellation (v10) |
| Shipment creation (track & trace) | Push | POST /shipments (v10) |
| Offer creation by EAN | Push | POST /offers (Offer API v11, synchronous) |
| Offer stock update | Push | PATCH /offers/{offer-id} (Offer API v11, synchronous) |
| Offer price update | Push | PATCH /offers/{offer-id} (Offer API v11, synchronous) |
| Async process tracking (orders/shipments) | Pull | GET /process-status/{id} (v10) |
| Connection test | Auth | OAuth2 client-credentials (login.bol.com) |
Built for reliability
- Token management - OAuth2 client-credentials tokens are cached and refreshed only just before expiry, respecting Bol's "do not request a token per call" rule, with a one-shot retry on a 401.
- Rate-limit aware - HTTP 429 responses are surfaced with the Bol
Retry-Aftervalue and never crash a scheduled run. - Resilient transport - automatic retry with exponential backoff on transient 5xx errors and a 30-second request timeout.
- Full audit log - every call is recorded with operation, HTTP status, duration, process-status id and an error excerpt for troubleshooting.
- Versioned media type - order / shipment calls use
application/vnd.retailer.v10+json; offer calls use the standaloneapplication/vnd.retailer.v11+json.
Requirements
- Odoo 18.0 or 19.0 (Community or Enterprise).
- Depends on the standard Sales, Inventory, Delivery and Product apps only - no Enterprise-only modules.
- An active Bol.com seller account with Retailer API keys (Client ID & Client Secret).
- The Python
requestslibrary (bundled with standard Odoo deployments).
Support: support@pokutsoft.com
Screenshots
Api Log
Settings
Update date: 2026-07-02