Skip to main content

bol.com

Switch the item export to catalogues now!

bol.com’s API v3 will be deactivated. Please create catalogues for your item export now. (How?)

The Dutch market bol.com  is the leading online market in Benelux and offers many different products, including multimedia, electronics, toys, etc. On bol.com, you can sell your items in the Netherlands and Belgium.

1. Frequency of data exchange

After you have set up the interface to bol.com, the automatic processes described in Table 1 are available.

Table 1. Frequency of data exchange
Data Interval

Item export

once a day

Stock synchronisation

Every 15 minutes

Price synchronisation

Hourly

Synchronisation of delivery times, visibility of offers etc.

Hourly

Deletion of offers for deleted or deactivated variations

daily

Order import

Every 15 minutes

Import of returns registered on bol.com

Hourly
Note: Returns are imported with the status [9.00] by default.

2. Registering with bol.com

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

3. Setting up the market in plentymarkets

3.1. Carrying out the basic settings for the market

There are two ways to save the basic settings for the market:

  • In the assistant Base settings - bol.com (How?)

  • In the Setup » Markets » bol.com » Settings menu (How?)
    Note: You cannot link bol.com delivery times in the Setup menu. As such, go through the bol.com assistant to map delivery times with plentymarkets.

3.1.1. Alternative 1: Carrying out the base settings with the assistant

The basic settings for bol.com are carried out in the Setup » Assistants » Omni-Channel menu with the Basic settings - bol.com assistant. With this assistant, you set up your bol.com account in plentymarkets. You also carry out settings for warehouses and map plentymarkets delivery times with bol.com delivery times.

Carrying out settings in the assistant:

  1. Go to Setup » Assistants » Omni-Channel.

  2. Click on the assistant Base settings - bol.com.

  3. Follow the instructions on the screen. If you need additional information about one of the options, expand the info box shown below this instruction ().

  4. In the step Summary, check your settings to makes sure they are correct.
    Tip: Click on the arrow in the step Summary () to show the settings.

  5. If everything is as it should be, click on Finalise.
    → The settings are saved.

Options in the assistant
Setting Explanation

Step Settings

Select the client that should be used to sell your items.

From the drop-down list Client, select a client. This client is used to generate the item URL in the catalogue and bol.com orders are assigned to this client.

Would you like to activate your bol.com user account?

Account not activated = The settings are saved but the data exchange with bol.com is not started.
Account activated = Data exchange with bol.com is started once the assistant is completed.
Recommendation: Check all settings before activating the user account.

Step Access data

Enter the API access data.

The API access data can be generated in the seller section at bol.com.

  • Client ID (mandatory) = Enter the user ID for the API interface you received from bol.com.

  • Client Secret (mandatory) = Enter the password for the API interface that you received from bol.com.

Step Warehouse

Select how stock for bol.com should be calculated.

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 more warehouses.
    → The warehouses listed under Warehouses can be selected. Place a check mark to select a warehouse.
    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.

Step Delivery times

Link bol.com delivery times

Link one or more bol.com delivery times with delivery times saved in plentymarkets. The linked delivery times will be shown with your items on bol.com.

3.1.2. Alternative 2: Saving basic settings in the Setup menu

In the Setup » Markets » bol.com » Settings menu, you can carry out the basic settings for bol.com. However, note that bol.com delivery times cannot be mapped in this menu. Go through the bol.com assistant to map delivery times with plentymarkets.

Setting up bol.com in the Setup menu:

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

  2. Carry out the settings. Pay attention to the explanations given in Table 2.

  3. Save () the settings.
    → The settings are saved.

  4. Go to Setup » Assistants » Omni-Channel.

  5. Click on the assistant Base settings - bol.com.

  6. Navigate to the step Delivery times.

  7. Link one or more bol.com delivery times with delivery times saved in plentymarkets.

  8. Complete the assistant.

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

Activate the automatic data exchange

If the data exchange is activated, offer and order data is exchanged with bol.com. Go to Automatic processes to see how often data is exchanged with the market.

Client ID

Enter the Client ID. The API access data can be generated in the seller section at bol.com.

Client Secret

Enter the Client Secret. The API access data can be generated in the seller section at bol.com.

Client

Select a client. Orders are assigned to this client during the order import.

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 more warehouses.
    → The warehouses listed under Warehouses can be selected. Place a check mark to select a warehouse.
    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.

3.2. Activating an order referrer

An order referrer tags an order with the sales channel on which the order was generated. You also need to activate the order referrer in order to link items, characteristics etc. with bol.com. Go to Setup » Orders » Order referrer to activate the order referrer.

Activating the order referrer for bol.com:

  1. Go to Setup » Orders » Order referrer.

  2. Activate the option bol.com.

  3. Save () the settings.

3.3. Selecting the sales price

Sales prices define the conditions under which a variation is sold at a specific price and on a specific sales channel. That means that to sell variations on bol.com, you need a sales price in which the order referrer bol.com is activated. The price that you save for this sales price is the price that will be shown on bol.com.

Defining a sales price for bol.com:

  1. Go to Setup » Item » Sales prices » [Open sales price].
    Tip: No sales prices? Then create a new sales price first.

  2. Open the Settings tab.

  3. Activate the referrer bol.com.

  4. Save () the settings.

3.4. Activating the payment method

As soon as an active account for bol.com exists, the payment method Bol.com is automatically available in your plentymarkets system. No separate configurations are needed for this. You just need to permit the payment method in one or more customer classes.

Permitting the payment method in a customer class:

  1. Go to Setup » CRM » Classes.

  2. Open the customer class for which you want to permit the payment method.

  3. For the setting Permitted payment methods, activate the option Bol.com.

  4. Save () the settings.

3.5. Preparing shipping settings

Next, carry out settings for shipping. For bol.com, you have to save the shipping provider names in Dutch and activate the order referrer bol.com in the shipping profiles that you want to use for bol.com.

3.5.1. Saving names for shipping service providers in Dutch

For bol.com, you have to enter an API transporter code  as name for the shipping service provider. In addition, the name of the shipping service provider has to be saved in Dutch. These settings are carried out in the Setup » Orders » Shipping » Settings menu.

Saving names for shipping service providers:

  1. Go to Setup » Orders » Shipping » Settings.

  2. Click on the Shipping service provider tab.

  3. In the Filters section, select the language nl from the Language drop-down list.

  4. Click on Search ().
    → The shipping service providers are displayed.

  5. In the input field Name (nl), enter the API transporter code for every shipping service provider that you want to use for bol.com.
    Tip: The API transporter codes for the shipping service providers can be found in the developer documentation for bol.com .

  6. Save () the settings.
    → The Dutch names for bol.com shipping service providers were saved.

3.5.2. Activating the referrer in shipping profiles

Now activate bol.com in the shipping profiles that you want to offer for this market.

Activating referrer bol.com in the shipping profile:

  1. Go to Setup » Orders » Shipping » Settings.

  2. Click on the Shipping profiles tab.

  3. Click on the shipping profile.
    Tip: No shipping profiles? Learn how to create shipping profiles here.

  4. For the setting Order referrer, activate the option bol.com.

  5. Save () the settings.
    → The shipping profile is available for orders with the referrer bol.com.

  6. If necessary activate the referrer in additional shipping profiles.

Saving shipping service provider names in Dutch

Make sure that the names for the shipping service providers in the shipping profiles for bol.com are saved in Dutch with the API transporter codes  required by bol.com.

3.6. Linking categories

You no longer need these category links when you export your item data to bol.com using catalogues.

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

Linking categories:

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

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

  3. Select the bol.com category that best matches your plentymarkets category.

  4. Click on Apply.
    → 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 plentymarkets category.

  6. Save () the settings.

4. Setting up the item export

Item data is exported to bol.com using catalogues. Use the assistant Create catalogues - bol.com to create a marketplace format for every bol.com category.

4.1. Creating a catalogue in the assistant

You need to create a separate catalogue for each combination of a bol.com category and a language.

Creating a catalogue in the assistant:

  1. Open the menu Setup » Assistants » Omni-Channel.

  2. Click on the assistant Create catalogues - bol.com.

  3. Follow the instructions on the screen. If you need additional information about one of the options, expand the info box below this description ().

  4. In the step Summary, check your settings to make sure they are correct.
    Tip: In the Summary step, click on the arrow () to show the settings.

  5. If everything is as it should be, click on Finalise.
    → The catalogue is created.

  6. Open the catalogue in the Data » Catalogues menu to map the marketplace data fields with plentymarkets data fields fields.
    Note: You need a separate catalogue for each combination of bol.com category and language.

Settings in the assistant
Setting Explanation

Select a category for your catalogue.

Select a product category from the drop-down list.
→ The catalogue is created with the name of the category and shown in the Data » Catalogues menu.
→ A property with the name of the bol.com category is created. Link this property with the variations that you want to sell on bol.com.
Tip: Enter a few names of the category name to get suggestions.
Note: You need to create a separate catalogue for each combination of a bol.com category and a language.

4.2. Mapping data fields in the catalogue

After you have created a catalogue, map the market’s data fields to item data saved in plentymarkets. Check the documentation of the sales channel to find out what data the market expects for the individual data fields.

Using properties

Use properties to export values for marketplace data fields that have no corresponding field in plentymarkets.

Getting to know the catalogue menu
catalogue menu colours

Menu structure of a catalogue with marketplace format

  • Navigation When you open a catalogue, the view Mapping is shown by default. Use the navigation to switch to other views of the catalogue. Access the catalogue settings or set filters to only export specific data. You can also go back to the catalogues overview or create a new catalogue.

  • Toolbar The toolbar provides actions for the catalogue. For example, save your mappings, restore an older version of the catalogue or hide or show optional marketplace data fields.

  • Marketplace data fields To the right of the navigation, all data fields available for the market are listed. Mandatory fields are marked with an asterisk (✱).
    Tip: Click on the further actions () in the toolbar to show or hide optional data fields.

  • plentymarkets data fields The left side of the catalogue is where you map the marketplace data fields with suitable plentymarkets data fields. In the screenshot, a few of the fields are already mapped.

Mapping catalogue fields:

  1. Go to Data » Catalogues.

  2. Click on the catalogue.
    → The Mapping tab opens.
    → In the left-hand column, the market’s data fields are listed.
    Tip: Mandatory fields are flagged with an asterisk (*).
    → In the right column, you map the plentymarkets data fields. Any plentymarkets data fields that are already assigned are also shown in the right column.

  3. Now, map suitable plentymarkets data fields to the market data fields.
    You can choose from the following mappings which are described in the info boxes below:

    • Simple 1:1 mapping

    • Complex 1:1 mapping

    • 1:1 mapping with fallback data fields

    • 1:n mapping

    • Own value mapping

  4. Save () the catalogue.
    → The mappings are saved.

Simple 1:1 mapping: 1 marketplace data field, 1 plentymarkets data field

In a simple 1:1 mapping, you map a plentymarkets data field to the marketplace data field. If no suitable setting exists in plentymarkets, you can map a property instead.

As such, simple 1:1 mappings allow you to:

  • I want to fill this marketplace data field with the data from this plentymarkets setting.

  • If the data field is empty for a variation, no value is exported for this variation.

Creating a simple 1:1 mapping:

  1. Next to the marketplace data field, click on + Add data field.
    → To the left, the list of available plentymarkets data fields are shown in groups.

  2. Click on a group to expand the associated plentymarkets data fields.
    → The plentymarkets data fields are shown.

  3. Click on the plus to the right of the plentymarkets data field you want to select.
    → The plentymarkets data field is added to the right.

  4. Click on Confirm.

Example: Sales price and RRP

This gif shows you how to map the marketplace data fields Sales price and RRP for Otto Market to suitable plentymarkets data fields:

gif catalogue mapping simple en
Complex 1:1 mapping: 1 marketplace data field, 1 plentymarkets data field

Like with the simple 1:1 mappings, you map a plentymarkets setting or property to a marketplace data field. Complex mappings are necessary if a marketplace data field has more than one possible value. Instead of mapping data fields, for complex mappings you instead map the values of these data fields. For example, you cannot simply map the plentymarkets data field Shipping profile to the marketplace data field Shipping method. This is because the market cannot know which of your shipping profiles in plentymarkets corresponds to which of their shipping methods.

Do not enter own values for complex mappings. All values that you enter must be saved for the variations, either in a setting or as a property value. This also applies if the value Comparative value is shown. You still need to enter exactly the value of the setting or property that you mapped.

Examples of complex 1:1 mappings are:

  • Categories

  • Brands

  • Shipping setting

You can recognize complex mappings from the field that is shown below the name of the marketplace data field. Click on the field to show the values available for the marketplace data field.

catalogue complex mappings
Do not map own values or properties of the type None for complex mappings.

Creating a complex 1:1:n mapping:

  1. Click on the field for the marketplace data field.
    → A list of the available values is shown.

  2. Select the value that you want to map a plentymarkets data field to.
    → The value is mapped.

  3. Next to the marketplace data field, click on + Add data field.
    → To the left, the available plentymarkets data fields are listed in groups.

  4. Click on a group.
    → The plentymarkets data fields are shown.

  5. Click on the plentymarkets data field for which you want to map values.
    Important: Do not map own values or properties of the type None.
    → Your next steps depend on the plentymarkets data field you selected:

    • Alternative 1: The available values for the plentymarkets data value are shown on the left.

      • Next to the value you want to select, click on the plus.
        → The value is added to the field on the right.

      • Click on Confirm.

    • Alternative 2: The plentymarkets data field is inserted and the field Comparative value is shown.

      • In the field Comparative value, enter a value that is saved in the setting or the property of the mapped plentymarkets data field.

      • Click on Confirm.

    • Alternative 3: The plentymarkets data field is inserted and a drop-down list is shown.

      • Select a value from the drop-down list.

      • Click on Confirm.

This gif shows you how to map suitable plentymarkets values to the values of the marketplace data fields Delivery time in days for Otto Market:

gif catalogue mapping complex en
1:1 mapping with fallback data fields 1 marketplace data field, 1 plentymarkets data field with alternatives

In a 1:1 mapping with fallback data fields, you map a plentymarkets data field to the marketplace data field. In addition, you specify one or more fallback data fields. This ensures that the system keeps looking if the first plentymarkets data field is empty or contains an invalid value.

So this mapping specifies:

  • I want to fill this marketplace data field with the data from this plentymarkets setting.

  • If the data field is empty or invalid for a variation, the first fallback data field is checked and the value of that fallback data field is exported instead.

  • If the first fallback data field also is empty or invalid for a variation, the value of the second fallback data field is exported and so on.

Creating a 1:1 mapping with fallback data fields:

  1. Next to the marketplace data field, click on + Add data field.
    → To the left, the list of available plentymarkets data fields are shown in groups.

  2. Click on a group to expand the associated plentymarkets data fields.
    → The plentymarkets data fields are shown.

  3. Click on the plus to the right of the plentymarkets data field you want to select.
    → The plentymarkets data field is added to the right.

  4. In the list of plentymarkets data fields, click on the plus icon next to the plentymarkets data field that you want to map.
    → The fallback data field is exported when the first data field does not exist or is empty.
    Note: Even if you assign one or more fallback data fields, the value of only one of those fields is exported. For each variation, the mapped plentymarkets data fields are checked in the order in which you mapped them. This means that if the first data field does not provide a value for a variation, the first fallback data field is exported etc.

  5. Click on Confirm.

This gif shows you how to map the plentymarkets data field SKU and the fallback data field Variation ID to the marketplace data field SKU for Otto Market:

gif catalogue mapping fallback en
1:n mapping: 1 marketplace data field, several plentymarkets data fields

In a 1:n mapping, you map several plentymarkets data fields to the marketplace data field. You can link these data fields with a separator.

So this mapping specifies:

  • I want to combine these plentymarkets data fields during export so that the marketplace data field is filled with the data of these two or more plentymarkets settings.

Creating a 1:n mapping:

  1. Next to the marketplace data field, click on + Add data field.
    → To the left, the list of available plentymarkets data fields are shown in groups.

  2. Click on a group to expand the associated plentymarkets data fields.
    → The plentymarkets data fields are shown.

  3. Click on the plus to the right of the plentymarkets data field you want to select.
    → The plentymarkets data field is added to the right.

  4. Click on Confirm.

  5. To the right of the mapped plentymarkets data field, click on Add data field ().
    → To the left, the list of available plentymarkets data fields again are shown in groups.

  6. Map one or several additional plentymarkets data fields to the marketplace data field as described above.

  7. Click on Confirm.

  8. To the very right of the row, click on Settings ().

  9. Select a separator from the drop-down list Separator or add a custom separator.

  10. Save the settings.

  11. Save () the catalogue.
    → The mappings are saved.
    → During the export, the content of the plentymarkets data fields is combined and exported as one field.

Own value mapping: 1 marketplace data field, the same value for all variations

You are sure that you want to export the same value for all variations of a catalogue for a marketplace data field? Then specify an own value. This own value is then exported for all variations.

So this mapping specifies:

  • For this marketplace data field, I want to export the value that I entered in the field Own value for all variations of this catalogue.

Creating an own value mapping:

  1. Next to the marketplace data field, click on + Add data field.
    → To the left, the list of available plentymarkets data fields are shown in groups.

  2. Click on the plus next to Own value at the top of the list.
    → The field for the own value is added to the view.

  3. Enter a value into the input field.
    → This value is exported for all variations.

Example: Diameter information

You want to export diameter information for some of your variations. The diameter is saved in centimetres for all your variations. Instead of creating a property for the unit and linking this property to the variations, you can enter the own value cm.

This is how you can map an own value for the diameter unit:

diameter

5. Preparing variations

Continue with preparing your variations.

5.1. Saving mandatory item information

In order to list a variation as an offer on bol.com, you need to save at least the settings described in Table 3 for this variation.

Table 3. Mandatory fields for the variation
Mandatory data Explanation

EAN or ISBN

An EAN or an ISBN must be saved for the variation.

  • In the Setup » Item » Barcode menu, an EAN or ISBN must be created and linked to the referrer bol.com.

  • The EAN/ISBN must be added to the Settings tab of the variation in the Barcode area and a barcode code must be entered.

Price

A price must be saved for the variation.

  • The sales price must be activated for the referrer bol.com in the Setup » Item » Sales prices.

  • The sales price must be added in the Settings tab in the Sales price area of the variation.

  • A price must be saved for the sales price in the Settings tab in the Sales price area of the variation.

Name

A name in the language of the target country must be saved for the variation.
Example: If you want to sell your items in the Netherlands, a name in the language Dutch must be saved for the variation.

  • A name must be saved in the plentymarkets data field that you mapped to the marketplace data field for the name.

Item description

A description in the language of the target country must be saved for the variation.
Example: If you want to sell your items in the Netherlands, a description in the language Dutch must be saved for the variation.

  • A description must be saved in the plentymarkets data field that you mapped to the marketplace data field for the description.

Manufacturer

A manufacturer must be saved for the variation.

  • A manufacturer must be saved in the plentymarkets data field that you mapped to the marketplace data field for the manufacturer.

Image

The variation must have at least one image.

  • At least one image must be linked in the Image tab of the variation.

  • in the Images tab of the item, the option bol.com must be selected from the drop-down list Availability.

Property value for bol.com category

The variation must be linked to the property value for the bol.com category. The property bol.com category is created automatically when you complete the assistant.

  • In the Properties tab of the variation, the property for the bol.com category must be linked in the Variation properties area. The property value has the same name as the bol.com category and the catalogue.

Availability

The variation must be available for the market.

  • In the Availability tab of the variation in the Markets area, the marketplace availabilities bol.com or bol.com FBB must be activated.

    • Referrer bol.com = You ship orders yourself.

    • Referrer bol.com FBB = bol.com ships the order.

After you created the first marketplace format for bol.com with the assistant, the property bol.com category is created in your plentymarkets system. For each bol.com category that you create a catalogue for, a new selection value is added to this property bol.com category. This property value has the same name as the bol.com category and the catalogue.

In order for your variations to be exported in the appropriate catalogue, they have to be linked to the bol.com category property in the Properties tab of a variation.

Linking variation to bol.com category:

  1. Go to Item » Edit item » [Open item].

  2. Click on the Variations tab.

  3. Open the variation that should be linked.

  4. Open the Properties tab.

  5. In the Variation properties area, select the property bol.com category from the Properties drop-down list and click on Add ().
    → The property is added.

  6. Select a category from the drop-down list Value for the property bol.com category.
    → The variation will be exported in this catalogue.

  7. Save () the settings.

5.3. Activating variations for the market

You need to activate the variations that you want to sell on bol.com. This is done in the Availability tab of a variation within the Item » Edit item » [Open item] » [Open variation] menu.

Making a variation available for bol.com:

  1. Go to Item » Edit item » [Open item] » [Open variation].
    → The tab Settings of the variation is shown.
    Tip: To sell all variations of an item on bol.com, carry out the settings for the item’s main variation. This activates the availability of all variations of the item.

  2. In the Availability area, activate the option Active.

  3. Click on the Availability tab.

  4. In the Markets area, click in the selection field.
    → A list of all available markets is displayed.

  5. Activate the option bol.com.

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

  7. Save () the settings.
    → The variation is available for bol.com.

The variation group function allows you to edit several variations at once. You select the variations that you want to edit.

Making several variations available for bol.com using the variation group function:

  1. Go to Item » Edit item.

  2. Set the filter Table type to Variations.

  3. Choose additional filters on the left if needed and click on Search ().

  4. Select () the variations to be edited from the overview on the right.

  5. Click on Variation group function.
    → The Variation group function window opens.

  6. Navigate to the area Market availability.

  7. Activate the checkbox to the left of the option bol.com.

  8. Activate the checkbox to the right of the option bol.com.

  9. Navigate to the area Availability.

  10. Activate the checkbox to the left of the option Active.

  11. Activate the checkbox to the right of the option Active.

  12. Click on Execute to apply the settings.

Batch processing allows you to edit several variations at once. You use filters to limit which variations are edited.

Making several variations available for bol.com using batch processing:

  1. Go to Item » Batch processing.

  2. Click on the tab Variations in the upper left corner.

  3. Use the filters on the left to specify which variations should be processed.

  4. Navigate to the area Market availability.

  5. Activate the checkbox to the left of the option bol.com.

  6. Activate the checkbox to the right of the option bol.com.

  7. Navigate to the area Availability.

  8. Activate the checkbox to the left of the option Active.

  9. Activate the checkbox to the right of the option Active.

  10. Click on Apply to apply the settings to the variations.


5.4. Optional: Activating variations for Fulfillment by bol.com (FBB/LVB)

bol.com orders can be fulfilled in two different ways:

  • Fulfilment by Retailer (FBR) = You ship the order yourself.

  • Fullfilment by bol.com (FBB/LVB) = bol.com ships your products.

Note that plentymarkets does not fully support Fulfilment by bol.com. You can flag your item data for Fulfilment by bol.com when you export item data to the market. However, FBB orders and returns are not imported into plentymarkets. In addition, stock information cannot be retrieved from the bol.com fulfilment warehouse.

To sell a variation with Fulfilment by bol.com (FBB or LVB), you need to activate the market availability bol.com FBB.

Activate the market availability bol.com FBB for the variation
  1. Go to Item » Edit item » [Open item] » [Open variation].
    → The Settings tab of the variation opens.

  2. Click on the Availability tab.

  3. In the Markets area, click in the selection field.
    → A list of all available markets is displayed.

  4. Activate the option bol.com FBB.

  5. Save () the settings.

6. Automating order processing

Set up event procedures to automatically inform bol.com about order status changes. The following event procedures can be set up for bol.com:

  • Send shipping confirmation to bol.com (How?)

  • Send order cancellation to bol.com (How?)

  • Send return status to bol.com (How?)

  • Create a return at bol.com (How?)

6.1. 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 Setup » Orders » Events.

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

  3. Enter a distinct Name for the event procedure.

  4. Select the Event according to Table 4.

  5. Save () the settings.

  6. Carry out the further settings according to Table 4.

  7. Activate the option Active ().

  8. Save () the settings.

Table 4. Event procedure for automatically sending 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

6.2. 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. Open the Setup » Orders » Status menu and create additional order statuses as needed. The following cancellation reasons can be transferred to bol.com:

  • Out of stock

  • Cancellation requested by customer

  • Item is in a bad condition

  • Higher shipping costs

  • Incorrect price

  • Item not available in time

  • No bol.com warranty

  • Item ordered twice

  • Item retained

  • Technical issue

  • Item untraceable

  • Other

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

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

  3. Enter a distinct Name for the event procedure.

  4. Select the Event according to Table 5.

  5. Save () the settings.

  6. Carry out the further settings according to Table 5.

  7. Activate the option Active ().

  8. Save () the settings.

Table 5. 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

6.3. 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 return statuses can be sent to bol.com:

  • Return received

  • Item will be exchanged

  • Return does not meet conditions

  • Item must be repaired

  • Customer keeps item

  • Return accepted after consultation with customer

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

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

  3. Enter a distinct Name for the event procedure.

  4. Select the Event according to Table 6.

  5. Save () the settings.

  6. Carry out the further settings according to Table 6.

  7. Activate the option Active ().

  8. Save () the settings.
    Note: The data is not transferred in real time when the event procedure is triggered. Instead, the data is registered in a queue. As such, transferring the data can take up to several minutes if a large number of jobs need to be processed. On the plus side, this means that several retries will be performed if the target server is throttled or not responding.

Table 6. Event procedure for automatically sending return statuses 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.

6.4. Sending information on direct returns to bol.com

In addition, set up an event procedure to automatically inform bol.com about returns that customers sent back to you directly without registering the return with bol.com first. bol.com requests the status of returns. The following return statuses can be sent to bol.com:

  • Return received

  • Item will be exchanged

  • Return does not meet conditions

  • Item must be repaired

  • Customer keeps item

  • Return accepted after consultation with customer

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

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

  3. Enter a distinct Name for the event procedure.

  4. Select the Event according to Table 7.

  5. Save () the settings.

  6. Carry out the further settings according to Table 7.

  7. Activate the option Active ().

  8. Save () the settings.

Table 7. Event procedure to inform bol.com about returns
Setting Option Selection

Event

Status change: [9.5] Credit note created

Filter 1

Order > Order type

Return

Filter 2

Order > Referrer

bol.com

Procedure

Order > Create a return at bol.com

Select a status.

7. Starting the item export: Activating catalogue export

You have set up bol.com and created a catalogue for exporting your item data? Then start the export of your item data.

Activating the catalogue export to bol.com:

  1. Go to Data » Catalogues.
    → The catalogues are listed.

  2. Scroll to the bol.com catalogue.

  3. In the Active/Inactive column, move the toggle button () to the right.
    → The catalogue is active.
    → Catalogue data is exported to bol.com once a day during the night.

8. Troubleshooting

8.1. Check list: Why is my variation not exported?

To export a variation to bol.com, this variation has to meet the following requirements:

Have you activated the variation?
  1. Go to Item » Edit item » [Open item] » [Open variation].
    → The Settings tab of the variation opens.

  2. In the Availability area, activate the option Active.

  3. Save () the settings.

Is the market availability active?

The variation must be available for the market.

  1. Go to Item » Edit item » [Open item] » [Open variation].
    → The Settings tab of the variation opens.

  2. Click on the Availability tab.

  3. In the Markets area, click in the selection field.
    → A list of all available markets is displayed.

  4. Activate the option bol.com.

  5. Save () the settings.

Does the variation have positive net stock?
  1. Go to Item » Edit item » [Open item] » [Open variation].
    → The Settings tab of the variation opens.

  2. Click on the Stock tab.
    → The net stock of each warehouse is listed in the Net column.

Are the sales price and price settings correct?

Check the sales price:

  1. Go to Setup » Item » Sales prices.

  2. For the filter Referrer, select bol.com.

  3. Click on Search ().
    → The sales price that is active for the referrer is shown.

  4. Check the settings of the sales price.

  5. Make any necessary corrections.

Check the price:

  1. Go to Item » Edit item » [Open item] » [Open variation].
    → The sales prices are listed in the tab Settings.

  2. Check the following settings:

    • Is the sales price for the referrer linked?

    • Does the price for the referrer have the correct price?

  3. Make any necessary corrections.

Did you map all mandatory fields of the market in the catalogue?

As a minimum, plentymarkets data fields must be mapped to all mandatory fields of the market. These mandatory fields are different for different market categories. In the catalogue, mandatory fields are marked with an asterisk.

Is the variation linked to the property of the bol.com category?
  1. Go to Item » Edit item » [Open item] » [Open variation].
    → The Settings tab of the variation opens.

  2. Open the Properties tab.

  3. In the Variation properties area, select the property BOL category group from the Properties drop-down list and click on Add ().
    → The property is added.

  4. Select the desired category from the drop-down list Value for the BOL category group property.
    → The variation will be exported in this catalogue.

  5. Save () the settings.

Is the catalogue active?

The catalogue that the variation is associated with must be activated.

  1. Go to Data » Catalogues.
    → The catalogues are listed.

  2. Scroll to the bol.com catalogue.

  3. In the Active/Inactive column, move the toggle button () to the right.

Couldn’t find any errors?

You have confirmed that the above settings are correct but the variation is still not exported? Then check the data log.

  1. Go to Data » Log.

  2. Use the following filters:

    • bol.com
      **

  3. Click on Search ().

  4. Check all entries for the levels warning and error.

  5. Open the logs containing the message Variation invalid.
    → The the variation ID and the reason for the rejection or the missing characteristic are shown.

  6. Correct the variation data.

8.2. Viewing log entries

The Data » Log menu contains a history of processes that run via the bol.com interface. Note that integrations and identifiers are only shown in the drop-down lists as filters after the process has run at least once.

For bol.com, the following filters are recommended:

  • Identifier » bol.com

Filtering and checking log entries
  1. Go to Data » Log.

  2. In the column to the left, select appropriate filters from the drop-down lists.

  3. Optional: Select filters for dates and/or times to only show entries from a specific period.
    Tip: For further information about the filters, refer to the Data log page of the manual.

  4. Click on Search ().
    → The results are shown.

  5. Check all entries for the levels warning and error.
    Tip: Click on the entry to see details.

Use the reference types and reference values listed in Table 8 to limit the search results:

Table 8. Reference types and reference values for bol.com
Reference type Explanation Reference value

action

Filters by events.

Select a reference type to filter for specific events.

  • orderImport = Order import

  • CreateOffer = Creation of offers

  • CheckOfferStatus = Checking the successful creation of offers

  • DeleteOffer = Deletion of offers

  • UpdateOffer = Updating delivery time, delivery type (FBB, FBR), SKU and activity state of offers

  • UpdateOfferPrices = Updating prices of offers

  • UpdateOfferStock = Updating stock of offers

  • CancelOrder = Cancellation of the order

  • ShipOrder = Shipping of the order

  • HandleReturn = Confirmation of receipt of a return announced on bol.com

  • CreateReturn = Report receipt of a return not announced on bol.com

orderId

Filters by the order ID of the order in plentymarkets.

externalOrderId

Filters by the bol.com order number of the order.

externalOrderItemId

Filters by the ID of the bol.com order item.

To top