bol: how to manage economic operators

This article describes economic operators, how to retrieve them from bol, and how to upload them to bol.

Table of contents

Introduction

Retrieve economic operators from bol

Download economic operators

Export economic operators to bol

CSV file examples

Introduction

Economic operators are entities required by the Digital Services Act (DSA). Economic operators can be manufacturers, distributors, or importers of the product.

As a merchant on bol, you must assign an economic operator ID to each product you offer.

Retrieve economic operators from bol

You can retrieve economic operators from bol to ChannelEngine so you can assign appropriate IDs to your products.

On bol

First generate economic operator IDs for your products in bol's back-end. For detailed instructions, check out bol's article Adding responsible economic operators within the EU.

On ChannelEngine

1. On ChannelEngine, go to the Mappings page of your bol marketplace. Select the Economic operators tab.
2. Click Schedule sync task to retrieve your available economic operator IDs from bol.
3. Once the information is retrieved, it is presented in the form of a table. 
   
   • ID - the ID of the economic operator.
   • Name - the name of the economic operator.
   • Location - the registered address of the economic operator.
   • Email - the email address of the economic operator.
   • Phone - the phone number of the economic operator.
   • Status - the status of the economic operator (Valid or Invalid).
4. On the Offer mappings tab, map the Economic operator ID attribute to the corresponding ID. Use advanced rules to simplify the mapping process and assign multiple products to the same ID.

Download economic operators

Once you retrieve economic operators from bol, you can download this data as a CSV file. On the Economic operators tab, click Export to start downloading.

The downloaded CSV file includes all economic operators currently stored on bol, together with their IDs. The format of the file is as follows:

• Separator - semicolon (;)
• Text fields - enclosed in double quotes (“”)

You can modify the downloaded CSV file and upload it back to ChannelEngine. Check out the next section to learn more about this.

Export economic operators to bol

You can upload a CSV file that contains the economic operator data to ChannelEngine for export to bol. First, in the CSV file:

• Update the existing economic operator details on ChannelEngine and bol.
• Add new economic operator IDs on ChannelEngine and bol.

Make sure the contact details are those of the manufacturer, and not your personal. Use a semicolon (;) as your delimiter. Make sure the text values you provide are enclosed in double quotes (“”). The columns are:

• Id - the ID of the economic operator. Leave empty for new economic operators.
• Name - the name of the economic operator. The maximum character count is 100.
• AdditionalAddressInfo - the optional address details. The maximum character count is 100.
• Street - the street name of the economic operator. The maximum character count is 100.
• City - the city of the economic operator. The maximum character count is 100.
• PostalCode - the postal code of the economic operator. The maximum character count is 100.
• HouseNumber - the house number of the economic operator. The maximum character count is 100.
• Country - the country of the economic operator. This must be a two-letter code of the country. E.g.: AT, BE, FR, IT, DE, NL, US.
• Email - the email of the economic operator. The maximum character count is 100.
• PhoneNumber - the phone number of the economic operator. The character count must be between 7 and 17 characters. Supported characters are 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, ( ), and +.
• Action - the action to perform on the economic operator. The actions are:
  • SYNC - create or update the economic operator on bol.
  • DELETE - remove the economic operator from bol.

On the Economic operators tab, click Upload CSV and select your file from the file manager.

Once ChannelEngine uploads the data, it uses scheduled tasks to export the economic operator details to bol and retrieve any updates from bol. The synchronization status changes accordingly:

• In sync - the economic operator details are synchronized between ChannelEngine and bol. The upload was successful.
• Waiting to export - ChannelEngine has scheduled but not yet exported the economic operator details to bol.
• Failure - ChannelEngine could not export the economic operator details due to an error. E.g.: the economic operator IDs on ChannelEngine did not match those on bol.

CSV file examples

Creating an economic operator

"Id";"Name";"AdditionalAddressInfo";"Street";"City";"PostalCode";"HouseNumber";"Country";"Email";"PhoneNumber";"Action"
"";"ABC Logistics";"Suite 12";"Main Street";"Amsterdam";"1012AB";"50A";"NL";"info@abclogistics.com";"+31201234567";"SYNC"

Updating an economic operator

"Id";"Name";"AdditionalAddressInfo";"Street";"City";"PostalCode";"HouseNumber";"Country";"Email";"PhoneNumber";"Action"
"12345";"ABC Logistics";"Suite 12";"Main Street";"Amsterdam";"1012AB";"50A";"NL";"info@abclogistics.com";"+31201234567";"SYNC"

Deleting an economic operator

"Id";"Name";"AdditionalAddressInfo";"Street";"City";"PostalCode";"HouseNumber";"Country";"Email";"PhoneNumber";"Action"
"12345";"ABC Logistics";"Suite 12";"Main Street";"Amsterdam";"1012AB";"50A";"NL";"info@abclogistics.com";"+31201234567";"DELETE”