=== CatCode bol Connector for WooCommerce ===
Contributors: catcode
Tags: bol, bol.com, marketplace, woocommerce, netherlands
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Connect WooCommerce to bol (NL, BE) directly: link your bol offers by EAN or reference and keep stock and prices in sync.

== Description ==

For sellers on bol (the Netherlands and Belgium) who run a WooCommerce shop. The plugin talks directly to the bol Retailer API with your own API credentials, there is no service in between and no fee per order.

* Link offers: reads all your offers from bol and links them to WooCommerce products and variations by EAN, or else by the offer reference as SKU. Report of what stayed unlinked.
* Stock and price sync: changes go out within a few minutes, one offer at a time and only what changed, as bol asks. A refusal from bol is shown on the product.
* Price rules: markup in percent, fixed add-on, conversion rate to euro, rounding to ,99 or ,95, own price per product. Volume discounts set on bol stay while they fit the new price.
* Stock rules: reserve for your own shop, quantity for products without stock management. A product that leaves the shop goes to 0 on bol. Stock of offers fulfilled by bol (FBB) is never touched.
* Status on the product and in a list: for sale in NL or BE, paused, or not for sale with bol's reasons.
* Respects bol's rate limits and token rules, so the server does not get blocked.
* API log for 30 days. Client secret and access token are never logged and are stored encrypted.
* Compatible with HPOS and with the block checkout.

= Pro =

* bol orders in WooCommerce every 5 minutes, or at once with instant notifications, with the stock lowered here.
* Shipments with track & trace back to bol, partial shipments, a code added later.
* Verzenden via bol and bol shipping labels: choose, download as PDF, ship.
* Cancellation requests of buyers shown on the order, with an e-mail and a check right before shipping; cancellations with a reason.
* Returns decided from the order, invoices for business buyers uploaded as PDF.
* New offers from the product editor with delivery promise and economic operator.

7-day trial on request. Licence for 1 to 5 years; one key works on two sites, your shop and a test copy.

= External service =

The plugin sends data to the bol Retailer API (api.bol.com, tokens from login.bol.com), only with your own API credentials: the credentials to get an access token, and the offer id, stock and price of the products you set to sell on bol. bol's API terms: https://api.bol.com/retailer/public/Retailer-API/legal/terms-of-service-en.html

Pro also receives order data from bol, and bol posts notifications to a URL of your site if you switch them on. The Pro licence is checked at catcode.com.ua: the key and the address of the site are sent. Terms: https://catcode.com.ua/terms/

== Installation ==

1. Install and activate the plugin. WooCommerce must be active.
2. In the bol Seller Dashboard open Instellingen → Diensten → API Instellingen, fill in the technical contact and create client credentials for the Retailer API.
3. Enter the Client ID and Client Secret under WooCommerce → bol → Connection and check the connection.
4. In the Offers tab press "Import and link offers".

== Frequently Asked Questions ==

= Who can use it? =

Registered bol sellers: the API credentials come from your Seller Dashboard.

= Is there a test environment? =

bol has none for real data. To try the connection without buyers, pause your shop on bol for that time: the API keeps working, at low priority.

= Does it create offers on bol? =

That is part of Pro. The free part keeps offers that already exist on bol in sync.
The plugin keeps offers that already exist on bol in sync.

= Does it upload product content? =

No. Title, description and images of a product bol does not know yet are entered in the Seller Dashboard.

= Are my bol prices changed? =

Only for products set to sell on bol, and only with price sync on. Switch it off in the Offers tab if you set prices in the Seller Dashboard.

== Changelog ==

= 1.0.0 =
* First release.
