Please note that this documentation describes the beta version of our Retailer API version 3. This page is intended only for use by the partners participating in our beta testing program.
Endpoints can still be subject to change and support is limited in the beta phase.
Before starting development, you should understand a few central concepts in the bol.com data model: products, offers, orders and order items.
A product is any article that can be sold on bol.com. It is defined by its European Article Numbering code (EAN), and enriched with descriptions, pictures and other content.
If the product you wish to sell is not yet available on bol.com, you can use the product information management FTPS connection to add it. You can also use this content flow to update product information.
Please note that the product information FTPS flow is not part of the beta.
If a product is offered on the website, by a retailer or by bol.com itself, this results in an offer. An offer is defined by the combination of product (EAN), retailerID, condition category (new/secondhand) and condition name (for example new, as new) . Additionally, an offer must always contain a price and delivery promise.
For example, if two retailers offer the same product for a different price on bol.com, this results in two different offers. Also, one retailer can have two offers on the website for the same product: one with condition ‘new’ and one with condition ‘used’.
Orders and order items
When a customer purchases one or more items on bol.com, an order is created. The order contains of one or more order items. Each order item contains an EAN, offer reference, quantity, price, customer reference, et cetera.
Later process flows all refer to the relevant orders and order items.
Other concepts and flows
All other process flows are related to one of the previous concepts. A shipment is created when one or more order items are sent to the customer, a return is created when a customer wants to return an order item and a cancellation is used to cancel an order or order item. The commissions bol.com asks, are determined based on the product.
The full process flow of selling on bol.com is described here.