> For the complete documentation index, see [llms.txt](https://helpcenter.channable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.channable.com/list-advertise/bol/list-items-on-bol/how-to-set-up-a-bol-channel.md).

# How to set up a bol channel

Learn how to connect bol to Channable, map required listing fields, and send product listings, including refurbished offers.

Bol (also known as bol.com) is a popular marketplace in the Netherlands and Belgium that sells a range of general goods.

In this guide, you’ll learn how to connect bol to Channable to create and manage product listings.

### <i class="fa-memo-circle-check">:memo-circle-check:</i> Before you start <a href="#h_01jj1c6wa2bg47fk8b2hs84yw6" id="h_01jj1c6wa2bg47fk8b2hs84yw6"></a>

**You’ll need**

* A bol seller account
  * Log out of this account before starting. A logged in account can cause automatic sign-in issues during setup.
* Items with valid `EAN` codes
* An [**Economic operator** added to your bol account (GPSR requirement)](https://partnerplatform.bol.com/en/need-help/my-account/adding-responsible-economic-operators-within-the-eu/)

**Good to know**

* Bol only accepts items with `EAN` codes
* Your channel won't run if your connection expires. If it does, [renew your connection](https://helpcenter.channable.com/get-started/getting-started/connections-in-channable/how-to-renew-a-connection.md).

<details>

<summary>Shop settings must match your market</summary>

If your shop country is the Netherlands, your products are listed on bol NL. If your shop country is Belgium, your products appear on bol BE.

</details>

<details>

<summary>Running your channel can replace and delete existing listings</summary>

When you activate and run your channel, any existing bol listings **not included in your channel run** will be deleted.

To avoid losing them, **make sure all relevant items are included before running your channel**.

</details>

***

{% stepper %}
{% step %}

### Create a bol channel

1. Open your channel overview:

{% tabs %}
{% tab title="Modern version" %}
In Channable, go to **All projects** > **\[Your project]** > **Channels**.
{% endtab %}

{% tab title="Legacy version" %}
In Channable, go to **Projects** > **\[Your project]** > **Channels**.
{% endtab %}
{% endtabs %}

2. Click **+ Create Channel**.
3. Search for **bol** and select it.
4. Set up your channel settings:
   1. For **Name**, give your channel a descriptive name to help you identify it later (like "Bol - NL")
   2. For **Unique ID per item**, select the field that contains your item's EANs, such as `ean` or `gtin`.
   3. For **Content language**, select the language of your product data:
      * Select **Dutch** to list in Dutch.
      * Select **French** to list in French.
      * To list in both, see [Listing on bol in French and Dutch](#listing-on-bol-in-french-and-dutch).
   4. For **Product data only**, leave this disabled unless this is your second bol channel on the same connection.
   5. For **Master rules**, you can apply a [master rule group](https://helpcenter.channable.com/manage-improve-product-data/rules-bulk-edit-and-enrich/rules-in-channable/create-master-rule-groups/add-master-rule-groups.md) if you already have one.
5. Click **Save** to create your channel.

#### <i class="fa-flag-swallowtail">:flag-swallowtail:</i> Listing on bol in French and Dutch

<details>

<summary>If you only have one bol seller account</summary>

To list in a second language from the same seller account, create another channel.

When you set it up:

1. Return to **Channels** and create a new bol channel.
2. For **Content language**, select the language you did not choose in your first channel.
3. For **Product data only**, click the toggle to enable it.
4. Click **Save**.
5. Finish setup for both channels as described in this guide.

</details>

<details>

<summary>If you have two bol seller accounts (one for BE and one for NL)</summary>

Create and activate one bol channel first. Then create a second channel for the other language.

</details>
{% endstep %}

{% step %}

### Map shared attributes <a href="#id-01jwavqfn4hxncc489h6cqr6w3" id="id-01jwavqfn4hxncc489h6cqr6w3"></a>

{% hint style="warning" %}
Bol should use your item `ean` codes to assign categories to your items automatically, so you can skip the **Categories** step.
{% endhint %}

{% hint style="info" %}
Hover over <i class="fa-circle-question">:circle-question:</i> to see examples of accepted/supported values and requirements.
{% endhint %}

For help with fixed values and product-specific values, see [Fill missing attribute data](https://helpcenter.channable.com/list-advertise/list-on-channels/fill-missing-attribute-data.md).

1. Go to the **Build** step and click on the **Shared attributes** tab. Review each section and map your product data:

<details>

<summary>Item section <mark style="color:$primary;">(required)</mark></summary>

In the **Item** section, map the following attributes to the matching field from your import.

1. For **EAN**, select the field containing your item's EAN codes.
2. For **Stock**, select the field containing your stock count.
3. For **Price**, select the field containing your item prices.
4. For **Title**, select the field containing your item titles.
5. For **Economic operator**, click **Custom** and enter the name of your economic operator in the text box.
   * If your products have different economic operators, follow[Fill missing attribute data](https://helpcenter.channable.com/list-advertise/list-on-channels/fill-missing-attribute-data.md) to create and fill a project field, then return to map that field.

</details>

<details>

<summary>Fulfillment section <mark style="color:$primary;">(required)</mark></summary>

In the **Fulfillment** section, map the following attributes to the matching field from your import.

1. For **Fulfillment**, select your fulfillment method:
   * **FBB** (Fulfilment by bol): You store your inventory directly in bol's warehouses. Bol handles the packaging, shipping, and customer service/returns.
   * **FBR** (Fulfilment by retailer): You store the inventory in your own warehouse or use your own third-party logistics.
   * [**AUTO\_SWITCH**](https://helpcenter.channable.com/list-advertise/bol/list-items-on-bol/how-to-configure-fbb-lvb-and-fbr-for-bol.md#switch-between-fbb-and-fbr-automatically)
2. For **Delivery code**, [set a shipping time for your products](https://helpcenter.channable.com/list-advertise/bol/list-items-on-bol/how-to-configure-fbb-lvb-and-fbr-for-bol/how-do-i-set-my-delivery-code-for-bol.md).
   1. If you use Bol's MijnLeverbelofte (Delivery promise), select `MijnLeverbelofte`.
   2. If you use Verzenden via Bol \[VVB], select `VVB`.
3. For **Delivery promise profile ID**, enter your delivery promise ID only if you selected `MijnLeverbelofte` for **Delivery code**. You can find your IDs in your bol seller account under **Settings > My Shop > Delivery promise**.

{% hint style="info" %}
If you map **Delivery promise profile ID** but not **Delivery code**, bol returns an error when you run the channel and may take the product offline.
{% endhint %}

</details>

<details>

<summary>Volume discount <mark style="color:$info;">(optional)</mark></summary>

At **Volume discount**, click **+ Add** to [set discounts for customers who buy in bulk](https://helpcenter.channable.com/list-advertise/bol/list-items-on-bol/how-to-set-up-a-bol-channel/configure-volume-discounts-for-bol.md).

</details>

<details>

<summary>Offer condition (for used and refurbished goods)</summary>

In **Offer condition**, map the fields that describe the condition of your offer.

1. For **Condition**, select a supported value to apply the same condition to all items, or map the project field containing your item conditions.

   [*<mark style="color:$primary;">What are the accepted conditions?</mark>*](#user-content-fn-1)[^1]
2. For **Condition description**, map the field containing a more detailed description of your item's condition.

If you select the `Refurbished` condition, map the additional attributes:

1. **Refurbished condition grade:** Map a condition grade. This must match a supported value (`A`, `B`, or `C`).
2. **Refurbished condition margin:** Map a condition margin. This must match a supported value (`true` or `false`). Use `true` if VAT was already paid for the item. The buyer won’t pay VAT again (0% VAT), and business buyers can’t reclaim VAT. Otherwise, set it to `false`.

</details>

<details>

<summary>Price reduction <mark style="color:$info;">(optional)</mark></summary>

At **Price reduction** (optional), you can opt in or out of bol’s reduced commission offer for eligible products. You can also [configure Channable to exclude products automatically when this causes a net loss, or set a maximum acceptable loss](https://helpcenter.channable.com/list-advertise/bol/list-items-on-bol/set-up-automatic-price-reduction-for-bol.md).

</details>

<details>

<summary>Image</summary>

For **Images**, link the images or media assets to include in your bol product listings:

1. For **Images**, click **+ Add**. In the dropdown, map the field containing your item images.
2. For **Labelled assets**, click **+ Add** to add a labelled asset.
   1. For **Link**, map the field that contains your label images.
   2. For **Label**, describe the label position or type.

</details>

2. Map any remaining fields marked as required by marketplace.
3. Click **Save**.
   {% endstep %}

{% step %}

### Map category attributes

Category attributes are fields that specifically apply to your product's categories.

1. In the **Build** step, click on the **Attributes per category** tab.
2. Select a category from the list.
3. Map any attributes marked **Required by marketplace**.
   1. To map an attribute, click the dropdown and select the project field containing that data.
4. Click **Save**.
   {% endstep %}

{% step %}

### Connect to bol

To send listings and receive feedback on them, connect your channel to your bol seller account.

1. In **\[your bol channel]**, go to **Settings**.
2. At **Linked seller account**, click **Select seller account**.
3. Select or add a seller account.
   1. If adding a new seller account:
      1. For **Name**, enter a name for your connection.
      2. Click **Connect with Bol**.
4. On bol, sign in and accept all required permissions (**Assortment management**, **Financial**, **Insights**, **Orders and logistics**, and **Subscriptions**)

   <figure><img src="https://3067532480-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8GepmoSonQRG6RnHOxJ%2Fuploads%2FbJhB9iwDar6oaddAsPkW%2Fbolscpermissions.png?alt=media&amp;token=9d8adec2-a8da-4c45-98d7-0d34066047e1" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

### Activate and run your channel

{% hint style="warning" %}

#### Important

When you activate and run your channel, any existing bol listings not included in your channel run will be deleted. To avoid losing them, make sure all relevant items are included before running your channel.
{% endhint %}

Once your product listings are ready, send them to bol:

1. Go to the **Settings** step in **\[your bol channel]** and click **Activate API**.
2. Click **Save**.
3. Click **Run now** to send your product listings to bol.

Your listings will now be sent to bol for feedback. This can take some time.
{% endstep %}

{% step %}

### Review and fix listing errors in Channable <a href="#h_01j159a025z0n7zndggqd2v4mm" id="h_01j159a025z0n7zndggqd2v4mm"></a>

On the **Channel listings** page in the **Result** step, you'll see an overview of your listing status based on your latest run.

Review items in the **Item listing updates** table marked **Not live** with a **Review & fix** action. This directs you to the **Feedback** tab to solve it.

{% hint style="info" %}

#### Do you see the status 'Not live', but no feedback?

You may need to [take action in your bol account instead](https://helpcenter.channable.com/list-advertise/bol/list-items-on-bol/solving-common-errors-for-bol.md).
{% endhint %}

**Resolving errors in Channable**

1. Click **Review & fix** for the error. This opens that specific error in the **Feedback** tab.
2. Click the dropdown to expand the section and view more information.
3. Check the **Errors** column for information about the error and what may have caused it.
4. In the **ID** column, click the ID and scroll. You should see a red highlighted callout in the section where the error occurred. Hover over the callout for more information.
   1. If the error is a mapping error, click **View in build** to be directed to the attribute you need to map/re-map, which is highlighted in blue.
   2. For more information about an attribute and its supported values, hover over <i class="fa-circle-question">:circle-question:</i>.
5. Resolve the error.

#### Learn more

{% content-ref url="/pages/a75b9a5264748056920e9e60774626c19823a55c" %}
[How to solve common bol errors](https://helpcenter.channable.com/list-advertise/bol/list-items-on-bol/solving-common-errors-for-bol.md)
{% endcontent-ref %}
{% endstep %}

{% step %}

### Review product data in your bol account <a href="#id-01jwb0p2x5zdd0bgpgjyhrm92w" id="id-01jwb0p2x5zdd0bgpgjyhrm92w"></a>

Open the product overview in **\[your bol seller account]** and check for `productinformatie zwak` or missing images. If you see either issue, complete your category mapping and update the relevant fields in the **Build** step.
{% endstep %}
{% endstepper %}

[^1]: *<mark style="color:$primary;">`Nieuw`</mark>* *<mark style="color:$primary;">,</mark>* *<mark style="color:$primary;">`Goed`</mark>* *<mark style="color:$primary;">,</mark>* *<mark style="color:$primary;">`Als nieuw`</mark>* *<mark style="color:$primary;">,</mark>* *<mark style="color:$primary;">`Redelijk`</mark>* *<mark style="color:$primary;">,</mark><mark style="color:$primary;">`Matig`</mark>* *<mark style="color:$primary;">,</mark>* *<mark style="color:$primary;">`As new`</mark>* *<mark style="color:$primary;">,</mark>* *<mark style="color:$primary;">`Reasonable`</mark>* *<mark style="color:$primary;">,</mark>* *<mark style="color:$primary;">`Moderate`</mark>* *<mark style="color:$primary;">,</mark>* *<mark style="color:$primary;">`Refurbished`</mark>*


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://helpcenter.channable.com/list-advertise/bol/list-items-on-bol/how-to-set-up-a-bol-channel.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
