Usage
Listings
Section titled “Listings”Orders > bol channel > Listings lists the mapped products with their state: not listed, waiting for bol, live or with an error. Add a product with its EAN (the barcode is the offer key), or add all products of a category. Stock and price switches decide what is pushed. Sync now queues the sync at once.
A new offer is created at bol in one request and evaluated afterwards: the product shows Waiting for bol until bol has released it for sale in a country. When bol holds it back, the reasons are shown on the product, for example “Price too high (4000-1)” or “essential product information is missing (4004-2) [missing: Title, Brand]”. Fix the cause (price, product content in the bol Partner Platform) and press Retry.
Categories and rules
Section titled “Categories and rules”Map each CS-Cart category to a bol category (search the list, it is loaded from bol). The mapping carries the price markup for its products. Price, stock and delivery rules are on Rules.
Orders
Section titled “Orders”New and changed orders are read from bol every sync interval: first the list of orders changed in the last minutes, then every order for its addresses. Each becomes one CS-Cart order with the buyer, the delivery address (street, house number and extension; pickup point name when bol delivers to a point), the billing address (company, VAT number and KvK number go to the order notes) and the prices as sold. An order whose item has no mapped product is not imported and shows the reason (for example “No product mapping for barcode …”); it is retried.
When an order item is shipped or cancelled at bol, the CS-Cart order status follows the mapping on the Rules page. If the customer asks bol to cancel an item, bol marks it as a cancellation request; confirm it with Cannot supply (reason code REQUESTED_BY_CUSTOMER) so that the customer is refunded by bol.
Shipping and cancelling
Section titled “Shipping and cancelling”When the CS-Cart shipment of an order gets a tracking number, the add-on sends the open order items to bol with your carrier (the transporter code from the bol list when the name matches, otherwise OTHER) and reads bol’s process status until bol accepts it. A failure is logged and retried. Cannot supply on the Orders page cancels the order and sends the reason code.
Returns
Section titled “Returns”Returns registered at bol appear on Returns with items and reasons. Approve sends the handling result RETURN_RECEIVED with the expected quantity for every open item; bol refunds the customer. Other handling results are decided in the bol Partner Platform.
Log and jobs
Section titled “Log and jobs”Log shows every action with filters and a CSV export (secrets and tokens are masked). Jobs shows the queue, retries and the jobs that gave up, with a Retry button.
Product content
Section titled “Product content”bol needs content (attributes and images) for products it does not know. This version creates offers by EAN; for an EAN that bol does not know, bol keeps the offer back until content exists. A listing that carries attribute values is also sent to the Product Content API with its images; the attribute ids come from the data model file bol publishes. A screen for mapping them is not part of this version.