Bol.com Marketplace Connector
Edition: CS-Cart & Multi-Vendor · Latest version: 1.0.0 · Compatible with: CS-Cart & Multi-Vendor 4.17.2 – 4.21.x, PHP 7.4 – 8.3 · Changelog: view
Sells your CS-Cart and Multi-Vendor catalog on bol.com (Netherlands and Belgium): category mapping with price rules, offers created by EAN, price and stock updates, order import, tracking numbers, cancellations and returns, all through your own bol API credentials.
What it does
Section titled “What it does”- Maps CS-Cart categories to bol categories (a price markup per category or product, price endings, a stock buffer).
- Creates offers on bol from mapped products with the Offers API v11: EAN, price (including VAT), stock, delivery promise, country shops (Netherlands, Belgium or both) and condition new. An EAN that already has an offer is updated instead. When bol holds an offer back, the reasons (price, missing content, on hold) are shown on the product.
- Pushes price and stock with one update per offer when a product changes and on a schedule.
- Imports open orders (the list for new or changed orders, then each order for its addresses) into CS-Cart without duplicates: delivery address with house number and extension, pickup point, billing address with company name, VAT number and KvK number, prices as sold. Order items that bol anonymised stay anonymised.
- Reports the tracking number of your own carrier (shipment with a transporter code from the bol list) and follows bol’s process status until the shipment is accepted. Cancels order items with a bol reason code and accepts returns.
- Product content (attributes and images) can be sent through the Product Content API when a listing carries attribute values; bol takes attribute ids from its data model file, so there is no attribute mapping screen in this version.
- Your own bol API credentials (client ID and secret from the Seller Dashboard) are stored encrypted; the access token (valid for five minutes) is cached and renewed. The add-on polls bol, so no inbound firewall rule is needed.
- A job queue with automatic retries (5 minutes, 15 minutes, 1 hour, 3 hours, 12 hours) that also honours bol’s rate limits (a 429 answer is retried later), and a log with filters and CSV export.
- Multi-Vendor: marketplace owner mode (one bol account for the whole marketplace) or one bol account per vendor in the vendor panel.
Trademark
Section titled “Trademark”bol and bol.com are trademarks of their owner; this add-on is not affiliated with or endorsed by bol. It uses the public bol Retailer API with your own seller credentials and is subject to the bol terms of use of that API.
Compatibility
Section titled “Compatibility”- CS-Cart and Multi-Vendor 4.17.2 to 4.21.x.
- PHP 7.4 to 8.3, depending on your CS-Cart version.
- The queue needs a cron job (a command line or a secret web address; see Configuration).