Settings
Open Add-ons > Manage add-ons > Bol.com Marketplace Connector > Settings for the general settings, and Orders > bol channel for the working pages (Listings, Categories, Attributes, Rules, Orders, Returns, Connection, Log, Jobs).
General
Section titled “General”| Setting | Default | Description |
|---|---|---|
| Enable | On | When off, no new work is started. Jobs of work that is already under way are still processed. |
| Marketplace owner mode | On | On: every order is processed with the marketplace owner’s account and vendors have no connection page. Off: each vendor connects their own account. |
| Debug log | Off | Also stores every HTTP call with masked request and response. Secrets and tokens are never stored. |
| Log retention (days) | 90 | Older log entries are removed by the cron run. |
| Sync interval (minutes) | 15 | How often products are synchronized, orders and returns imported and shipments reported. |
| Status of imported orders | O (Open) | Status of a new bol order in CS-Cart (the “Created” row of the status mapping). |
| Payment method ID for imported orders | empty | Empty = the first active payment method. |
Connection
Section titled “Connection”Credentials are not ordinary settings: they are entered on the Connection page and stored encrypted (AES-256-GCM, key derived from your store’s own secret). They are never shown again; leave the secret field empty to keep the saved value.
| Field | Description |
|---|---|
| Mode | Test = bol demo environment (fixed example answers, nothing changes at bol). Live = your seller account. |
| Client ID / Client secret | Created in the bol Seller Dashboard (Settings, API settings). Enter the same pair in the test and live sets. |
| Sell in | Netherlands, Belgium or both. The offers are published in these bol country shops. |
| Fulfilment | You ship (FBR): offers carry a delivery promise and tracking numbers are reported. Bol ships (FBB, Logistics via bol): offers need stock in a bol warehouse and orders are only imported. |
| Economic operator ID | Optional. Sent with new offers (product safety information). |
The access token lives five minutes; the add-on keeps it and asks for a new one when needed. bol asks integrations not to log in for every call.
Rules page
Section titled “Rules page”| Group | Setting | Description |
|---|---|---|
| Prices | Markup %, fixed amount | Added to the CS-Cart price. A category mapping overrides it for its products, a product markup (Listings page) overrides both. The price sent to bol includes VAT and must be between 1.00 and 9999.00. |
| Prices | Price endings | Keep, whole numbers, always x.99 or x.90. |
| Prices | Exchange rate | Amount in euro per 1 unit of the store’s primary currency. 1 = use the rate of the CS-Cart currency EUR when it exists, else prices go unchanged. |
| Stock | Stock buffer, show zero at or below, maximum | bol sees stock minus the buffer; 0 at or below the minimum; 0 maximum = no limit. |
| New listings | Create offers automatically | Mapped products that are not on bol yet are sent by the sync. |
| New listings | VAT rate | Used for the order lines. bol prices include VAT. |
| New listings | Delivery time (days) | The promise sent for offers you ship: from N to N+1 days to the customer. |
| Orders | Customers | Guest orders, or attach to the customer account with the same e-mail. |
| Orders | Status mapping | CS-Cart status for each bol state (Created, Shipped, Cancelled, Returned …). Empty = leave unchanged. |
| Shipping | I ship with my own carrier | Sends the tracking number of the CS-Cart shipment to bol (transporter code from the bol list, otherwise OTHER) and follows the process status. |
| Shipping | Cancel reason | The bol reason code used by Cannot supply on the Orders page (default OUT_OF_STOCK). |
The queue runs from cron. Use either the command line or the secret web address shown in the Cron section of the settings:
php /path/to/store/admin.php --dispatch=kv_bol.cronor call index.php?dispatch=kv_bol.cron&key=<your key> every minute. bol limits calls per endpoint (for example 25 order list calls per minute); the add-on keeps well below and retries after a 429 answer.