Skip to main content

bol.com

The Dutch market bol.com is the leading online market in Benelux and distributes many different products, including multimedia, electronics, toys etc.

1. Registering with bol.com

Before setting up bol.com in plentymarkets, you have to register with bol.com first.

2. Setting up bol.com in plentymarkets

Set up bol.com in plentymarkets to sell items on bol.com. To do so, proceed as follows.

Setting up bol.com in plentymarkets:

  1. Go to System » Markets » bol.com » Settings.

  2. Carry out the settings. Pay attention to the information given in table 1.

  3. Save the settings.

Table 1. Basic settings for the market bol.com
Setting Explanation

Activate automatic data exchange

If the data exchange is activated, then there is a daily item export, an hourly stock synchronisation and an hourly order import.

Public key

Enter the API key as received from bol.com.

Private key

Enter the API key as received from bol.com.

Client

Select a client. When orders are imported, they are assigned to this client.

Warehouse selection

Select the stock quantity for the offer export. Select one of the following options:
Use stock quantity sum of all sales warehouses
Use main warehouse of item
Select warehouses = Select one or several warehouses.
Important: The option Warehouse selection affects the item export. If an item is not linked to the warehouses selected here, then this item will not be exported.

Connecting to this market allows for the following automatic processes to take place:

  • Hourly order import

3. Activating an order referrer

In order to link items, properties etc. with bol.com, you have to activate the order referrer bol.com in the menu System » Orders » Order referrer.

Activating the order referrer bol.com:

  1. Go to System » Orders » Order referrer.

  2. Place a check mark next to bol.com.

  3. Save the settings.

4. Setting the item availability

Items have to be available for bol.com. This is done in the Availability tab of an item within the Item » Edit item » Open item » Tab: Variation ID menu.

Setting the item availability for bol.com:

  1. Go to Item » Edit item » Open item » Tab: Variation ID » Tab: Settings.

  2. Activate the main variation in the Availability section.

  3. Click on the Availability tab.

  4. Click in the selection field in the Markets section.
    → A list with all available markets is displayed.

  5. Activate the option bol.com.

  6. Click on Add.
    → The market is added.

  7. Save the settings.
    → The item is available on bol.com.

The availability for variations can be individually edited in the Item » Edit item » Open item » Tab: Variations » Open variation » Tab: Variation ID » Tab: Availability menu.

Note that item descriptions have to be in Dutch for bol.com.

5. Linking categories

Link your store categories to the bol.com categories in order to display your items in these categories. Further items from the linked category are assigned automatically.

Linking categories:

  1. Go to System » Markets » bol.com » Category link.

  2. Click on Search.
    → The window Select category opens.

  3. Select the bol.com category that best matches your online store category.

  4. Click on Accept.
    → The name and category path of the bol.com category are displayed.

  5. If you know the name of the bol.com category, enter it directly into the Market category field to link it to your online store category.

  6. Save the settings.

6. Creating properties

Next create properties and link these to bol.com properties. Matching properties to a bol.com category can be found within the bol.com data model file. Download the data model file here.

Creating a property:

  1. Go to System » Item » Properties.

  2. Click on the New property tab.

  3. Enter a name for the property under Name (internal).

  4. Select nl for Dutch from the Language drop-down menu.

  5. Enter the Dutch name that you want to use for this property into the Name field.

  6. Select the option Text from the Property type drop-down list.

  7. Enter the bol.com property, which can be found in the column Attribute Name within the bol.com data model file, into the line bol.com property.

  8. Save the settings.

bol_fulfillment is a mandatory field for the offer export. This indicates whether the item is shipped by you or by bol.com. Enter the bol.com property bol_fulfillment into the line bol.com property.

If you want to sell used items on bol.com, you have to indicate this by using the the property bol_used. Enter the bol.com property bol_used into the line bol.com property.

7. Defining a sales price

Proceed as described below to define a sales price for the order referrer bol.com. This price is shown on bol.com.

Defining a sales price for bol.com:

  1. Open the menu System » Item » Sales prices » Open sales price » Tab: Settings.

  2. Place a check mark next to the referrer bol.com.

  3. Save the settings.

8. Setting up item export and offer export

This chapter explains how to export your items and offers to bol.com. The elastic export is used to transfer data to bol.com. First, create the data formats BolItemExport and BolOfferExport and then send the CSV files to bol.com. Both files have to be sent in order to sell items on bol.com.

The following fields are mandatory for the item export:

  • EAN

  • SKU

  • Name

  • Categories

  • Item description

  • Image

  • Manufacturers

The following fields are necessary for the offer export:

  • EAN

  • SKU

  • Stock

  • Price

  • Item condition

  • Shipping availability

  • Fulfillment by

Setting up the export:

  1. Go to Data » Elastic export.

  2. Click on New export.

  3. Carry out the settings. Pay attention to the information given in table 2.

  4. Carry out further settings for item filters and format settings. Pay attention to the information given in table 5 on the Exporting data page of the manual .

  5. Save the settings.
    → The export format is given an ID and it appears in the overview within the Exports tab.

Table 2. Settings for the item export
Setting Explanation

Settings

Name

Enter a name. The export format is listed by this name in the overview within the Exports tab.

Type

Select the type item from the drop-down list.

Format

Select the format BolItemExport for the item export or BolOfferExport for the offer export.

Limit

Enter a number. If you want to transfer more than 10,000 data records to bol.com, then the output file will not be generated again for another 24 hours. This is to save resources.

Provisioning

Select FTPS.

File name,
Server,
Port,
User name,
Password,
Path

Enter parameter. The access data including the password and user name are provided by bol.com. The file name for BolOfferExport has the structure <SellerID>.csv. The file name for BolItemExport has the structure <SellerID>.txt.
The file for BolItemExport has to be saved in the folder /SQUARE/feed.
The file for BolOfferExport has to be saved in the folder /inbound.

Transfer

Select Daily for the item export because bol.com allows a maximum of 4 exports per day. Select Hourly for the offer export.

9. Activating the payment method

Activate the payment method *BOL.com as described below.

Activating the bol.com payment method:

  1. Go to System » Orders » Payment » Methods.

  2. Place a check mark next to the setting Also show inactive.

  3. Open the folder International.

  4. Click on BOL.com.
    → The Settings tab opens.

  5. Carry out the settings. Pay attention to the information given in table 3.

  6. Place a check mark next to the option Active.

  7. Save the settings.

Table 3. Settings for the payment method
Setting Explanation

Language

The following options are saved for the language selected: Name, Info page, Info page (internal), Logo and Upload logo. This makes it possible to enter values for these options in various languages. The values for a language are activated as soon as a buyer selects the language in the online store.

Name

Enter the name that should be displayed in the online store and on invoices etc.

Info page

Select a category page of the type content or enter the URL of a website to provide information about the payment method.

Info page (external)

If you have selected the option Info page (external) under Info page, then enter the URL of the info page here.

Countries of delivery

Do not select a country of delivery.
You cannot use the payment method in your online store. Therefore, this payment method is only activated in plentymarkets. It is not completely configured.

Logo

Select one of the following options for displaying the logo:
Show standard logo = The logo that is saved in plentymarkets for this payment method is displayed.
Do not show a logo = The logo that is saved in plentymarkets for this payment method is not displayed.
Show upload logo = The options Logo view and Upload logo are displayed.

Logo view

If Show upload logo has been selected from the Logo drop-down list, then the logo that has been uploaded is displayed here.

Upload logo

If Show upload logo has been selected from the Logo drop-down list, upload an external logo here.
Click on Upload files and select the logo that you want to upload for the payment method. Permitted data formats: GIF, PNG and JPG.

Priority

Select the priority for displaying the payment method in the online store.

Costs: Flat rate or percentage

If the payment method results in additional costs, enter the percentage value or flat rate value. The choice depends on the conditions of your contract. Important: Do not enter a value into both fields.
For further information, refer to the Statistics page of the manual. For an example of flat rate and percentage costs, refer to the Managing payment methods page of the manual.

Permitting the payment method in customer classes

Go to System » CRM » Classes to activate or deactivate Permitted payment methods.
For further information, refer to the Permitting the payment method in a customer class chapter of the manual.

For further information, refer to the Payment methods page of the manual.

10. Automatically sending shipping confirmations

Set up an event procedure to automatically send shipping confirmations to bol.com when the outgoing items have been booked.

Setting up an event procedure
  1. Go to System » Orders » Events.

  2. Click on Add event procedure.
    → The Create new event procedure window opens.

  3. Enter a name.

  4. Select the event listed in table 4.

  5. Save the settings.

  6. Carry out the settings. Pay attention to the explanations given in table 4.

  7. Place a check mark next to the option Active.

  8. Save the settings.

Table 4. Event procedure for sending automatic shipping confirmations to bol.com
Setting Option Selection

Event

Order change: Outgoing items booked

Filter 1

Order > Order type

Order

Filter 2

Order > Referrer

bol.com

Procedure

Shipping > Send shipping confirmation to bol.com

11. Automatically sending the return status

Set up an event procedure to automatically inform bol.com of the status of a return. bol.com requests the status of returns. The following cancellation reasons can be transferred to bol.com:

  • Return received

  • Repaired or exchanged

  • Incomplete return

  • Refund without returning goods

Setting up an event procedure
  1. Go to System » Orders » Events.

  2. Click on Add event procedure.
    → The Create new event procedure window opens.

  3. Enter a name.

  4. Select the event listed in table 5.

  5. Save the settings.

  6. Carry out the settings. Pay attention to the explanations given in table 5.

  7. Place a check mark next to the option Active.

  8. Save the settings.

Table 5. Event procedure for automatically sending return status to bol.com
Setting Option Selection

Event

New return

Filter 1

Order > Order type

Return

Filter 2

Order > Referrer

bol.com

Procedure

Order > Send return status to bol.com

Select a status

12. Automatically sending cancellations

Set up an event procedure to automatically inform bol.com of cancellations. Whenever you are dealing with cancellations, you need to send bol.com a reason for the cancellation. Go to System » Orders » Status and create additional order statuses as needed. The following cancellation reasons can be transferred to bol.com:

  • Item not in stock

  • Customer cancellation

Setting up an event procedure
  1. Go to System » Orders » Events.

  2. Click on Add event procedure.
    → The Create new event procedure window opens.

  3. Enter a name.

  4. Select the event listed in table 6.

  5. Save the settings.

  6. Carry out the settings. Pay attention to the information given in table 6.

  7. Place a check mark next to the option Active.

  8. Save the settings.

Table 6. Event procedure for automatically sending cancellations to bol.com
Setting Option Selection

Event

Status change: [8.1] Cancelled by customer

Filter 1

Order > Order type

Order

Filter 2

Order > Referrer

bol.com

Procedure

Order > Send cancellation to bol.com

Customer cancellation

13. Viewing the API log

The menu Data » API log contains a history of processes that run via the bol.com interface.

Viewing the API log:

  1. Go to Data » API log » Tab: API log.

  2. Select the format bol.com from the Process drop-down list.

  3. Select a date if you only want to see entries for a specific day.

  4. Click on Search to carry out the search.
    → The processes are displayed.

To top