Bol.com Connector FAQs¶

These frequently asked questions cover the most common setup and synchronization topics for the Odoo Bol.com Connector. For a full feature list, see Bol.com Connector Features.

Getting Started¶

What does the connector need to work?¶

The Bol.com connector requires the Base Marketplace module and base_address_extended. Your Odoo server also needs the requests Python library, which is included in any standard Odoo installation.

How do I connect my Bol.com seller account to Odoo?¶

Open your instance, go to the Credentials tab, and enter your Client ID and Client Secret from your Bol.com seller account. Click Test Connection to verify Odoo can reach Bol.com. See Create a Bol.com instance in Odoo for step-by-step instructions.

Can I connect more than one Bol.com seller account in the same Odoo?¶

Yes. Create one instance per Bol.com account (for example, separate stores per brand or country). Each instance has its own credentials, settings, workflows, and scheduled jobs — nothing is shared between them.

Can I run a sync on demand without waiting for the scheduled job?¶

Yes. Click Operations on the Bol.com instance card to start any operation manually. You can also open the Automatic Jobs tab and click Run Manually next to the job you want.

Products & Listings¶

Does the connector support both FBR (you ship) and FBB (Bol.com ships)?¶

Yes. Both fulfillment methods are fully supported. Select FBR, FBB, or FBR & FBB in the Use Operation For setting.

FBR: uses your standard Warehouse for orders and stock updates pushed to Bol.com.
FBB: requires a separate FBB Warehouse for inbound orders and imported Bol.com stock.
Set independent automation rules per fulfillment type using FBR Workflow and FBB Workflow (for example, when to confirm the order, create the invoice, or register payment).

How are products matched between Bol.com and Odoo?¶

The connector matches products using the Sync Listings Based On setting (Barcode, SKU, or Barcode or SKU). Barcode is the recommended option for Bol.com. If no match is found and Create Odoo Products? is enabled, Odoo automatically creates the product.

How are prices kept in sync with Bol.com?¶

Prices are exported from the Pricelist configured on the instance. Enable Export Odoo Product’s Sale Price? to bypass the pricelist and use the product’s sale price instead. The scheduled job is Export Product’s Price to Bol. Products with a zero price in the pricelist are skipped.

See Export Price From Odoo and Import Price In Odoo.

Are there limits when exporting products to Bol.com?¶

Each product variant must have a valid Barcode (13-digit EAN) in Odoo.
Only single-variant listings can be exported. Split multi-variant products into separate listings before exporting.
The Queue Batch Limit on the instance controls the export batch size (default 100).

Orders¶

How do orders come into Odoo from Bol.com?¶

Orders are imported automatically by the Import FBR & FBB Order scheduled job, or manually using the Operations button on the instance card.

You can control what is imported:

By date: set Import Order After to skip older orders.
By status: Order Status is OPEN by default; can also be set to SHIPPED or ALL.
By name: use Order Prefix for FBR orders and Order Prefix (Fulfilment by Marketplace) for FBB orders. Enable Use Marketplace Order Sequence? (default on) to keep the original Bol.com order number.

See Import Bol.com Orders In Odoo.

How are taxes handled when orders come from Bol.com?¶

Bol.com prices already include tax.

Recommended setup: configure your Odoo taxes as included in price to avoid rounding differences.
If your products use excluded taxes, enable Managing Excluded Taxes on Product? on the instance. Odoo adjusts the line price so the order total matches what Bol.com sent.

How is the shipping fee paid by the customer added to the Odoo order?¶

The connector adds a separate line to the sale order for the customer’s shipping fee. The line uses the Delivery Product configured on the instance (default: Bol.com Delivery). You can change this product in the Orders tab in developer mode.

Can Odoo send a VAT invoice when a Bol.com customer requests one?¶

Yes. Enable Export Invoices to Bol.com? on the instance. Two supporting settings control the process:

Invoice Report: the Odoo PDF template used to generate the invoice document.
Invoice Export Delay (Days): how many days to wait before uploading, protecting against early export for cancelled or modified orders.

See Manage Bol.com Invoice Requests & Exports.

How is the tracking number sent to Bol.com when I ship an order?¶

After validating a delivery in Odoo (FBR), the connector sends the shipping status and tracking number to Bol.com automatically via the Export Order Status/Tracking Information to Bol scheduled job, or immediately by clicking Update in Marketplace on the delivery.

Before pushing tracking, ensure the delivery carrier in Odoo is linked to a Bol.com transporter code under Marketplaces ‣ Bol.com ‣ Transporters. See Bol.com Update Order Status From Odoo.

Can I cancel a Bol.com order from Odoo?¶

Yes. First cancel the order in Odoo, then click Cancel In Bol.com on the canceled order. You can cancel the full order or only specific items. Cancellation after Bol.com marks an order as FULFILLED is rejected by the Bol.com API. See Cancel Order In Bol.com From Odoo.

Can I bring in orders that were already shipped before I installed Odoo?¶

Yes. Use Import Shipped Order to import orders shipped in the last 90 days (a Bol.com API limit). Orders are queued and processed in the background to avoid server overload. See Import Shipped Orders From Bol.com To Odoo.

Does the connector distinguish between B2C and B2B (Zakelijk) customers?¶

Yes. For business orders, Odoo saves the Company Name and VAT number to keep your invoices and tax reports accurate.

Are Bol.com commission fees shown in Odoo?¶

Yes. The Bol.com fee is saved on each order line. The order also shows the total fee and the percentage of the order amount.

Inventory¶

How does stock stay in sync between Odoo and Bol.com?¶

Inventory sync depends on the fulfillment method:

FBR: Odoo pushes your stock to Bol.com using the quantity type set in Stock Based On (Free To Use Quantity, Quantity on Hand, or Forecasted Quantity). The scheduled job is Export Product’s Stock to Bol.
FBB: Odoo pulls the stock held in Bol.com’s warehouse using the Import LVB/FBB Product’s Stock job. Enable Validate Inventory Adjustment? to apply stock updates automatically.

See Import Inventory In Odoo and Export Inventory from Odoo to Bol.

Returns¶

How do customer returns work?¶

The Import Returns scheduled job imports returns based on the Import Return for Status setting (Unhandled or Handled). From each return record you can:

Create Return Order: create an incoming receipt so your warehouse can process the physical return.
Handle Return: submit your decision to Bol.com (for example, accept or reject the return).
Get Status: fetch the latest return status from Bol.com on demand.

See Import Returns From Bol.com To Odoo.

Account & Privacy¶

Does the connector show the customer's real email address?¶

No. Bol.com provides a privacy-forwarding email for each customer (for example, [email protected]). Odoo saves this address as received. You can still email this address from Odoo — Bol.com forwards your message to the customer.

Troubleshooting¶

What should I check if synchronization fails or I see errors?¶

Verify your Client ID and Client Secret are correct and the connection is active (use Test Connection).
Review detailed error messages at Marketplaces ‣ Queues ‣ Logs.
Set Log Level to All or Error to capture more detail.
Use Activity Configuration to create a follow-up task for a team member when a sync fails.
Enable Smart Notification Configuration to see pop-up messages in Odoo when imports or exports succeed or fail.

How do I monitor Bol.com background processes?¶

Open Marketplaces ‣ Bol.com ‣ Process Status. It shows every background process with its state (waiting, success, failure, timeout). When a process fails, the error message from Bol.com is saved on the record.