| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Inventory (stock)
• Sales (sale_management) • Discuss (mail) • Invoicing (account) |
| Lines of code | 1451 |
| Technical Name |
mp_nl_bol |
| License | OPL-1 |
| Website | https://gencbaris.com/odoo_plugins/ |
| Versions | 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Inventory (stock)
• Sales (sale_management) • Discuss (mail) • Invoicing (account) |
| Lines of code | 1451 |
| Technical Name |
mp_nl_bol |
| License | OPL-1 |
| Website | https://gencbaris.com/odoo_plugins/ |
| Versions | 18.0 19.0 |
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: gencbaris@outlook.com.tr
Screenshots
Api Log
Settings
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module