> 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/sell-on-marketplaces/mirakl-marketplaces/how-to-set-up-a-boulanger-channel.md).

# How to set up a Boulanger channel

Boulanger is a leading French retailer specializing in household appliances and consumer electronics/multimedia.

In this article, you'll learn how to set up a Boulanger channel to create, update and manage your Boulanger listings in Channable.

***

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

**You’ll need**

* [A Mirakl account](https://www.miraklconnect.com/)
* A project in Channable with your imported products
* Products with EAN codes

**Good to know**

* Boulanger uses the Mirakl platform
* Some attributes may be mandatory even if they don't seem relevant for your specific situation (like an attribute for adding a Spanish title when you’re only selling in France). You can leave these attributes unmapped.

{% stepper %}
{% step %}

### Create a Boulanger channel

1. In Channable, go to **Projects > \[Your project] > Channels**.
2. In the search bar, enter Boulanger and select **Boulanger**.

{% hint style="info" %}
If it doesn’t appear, click **Clear** to reset your filters.
{% endhint %}

3. Set your channel settings:
   1. For **Name**, give your channel a descriptive name (like Boulanger - FR).
   2. For **Unique ID per item**, select a field containing your products EAN codes (e.g. ean, id)
   3. For **Language**, choose the language your product data is in.
   4. For **Master rules** (Optional), set a rule group if you already have one to apply to your channel.
4. Click **Save**.
   {% endstep %}

{% step %}

### Categorize your items

Categorize your items so they match Boulanger's taxonomy, and appear in the right place.

1. Go to the **Categories** step.
2. Choose your categorization method(s):
   1. **Generate from field:** Select a category field (like `product_type`, `category`) from your product data to quickly match items to categories.
   2. **+ Add category rule:** Add text-based conditions to assign categories to items in bulk.
   3. **Copy from channel:** Reuse categories you've set up from another channel.
3. Click **Save**.
   {% endstep %}

{% step %}

### Create rules to fill data gaps

Use rules to prepare product data for Boulanger. If later steps show missing data, create project fields and populate them with rules. You can also adjust existing fields to meet Boulanger's requirements.

* Rule templates: Use common rules that you can adjust for your needs.
* Rules setup: Set up rules to filter, modify, or enhance data fields for marketplace requirements.
  {% endstep %}

{% step %}

### Map shared attributes

Link project fields to attributes that apply across your entire catalog on Boulanger.

1. Go to the **Build** step.
2. Map any attributes marked **Required by marketplace**.
   1. To map an attribute, click the dropdown and select the project field containing that data.

{% hint style="info" %}
For some attributes, you can fill in a custom value or select a supported value if the marketplace supports only certain values.

Filling in a custom value or selecting a supported value this way applies the same value across all items.
{% endhint %}
{% endstep %}

{% step %}

### Map category attributes

Category-specific 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**.

<details>

<summary><strong>Adding multiple attribute values in Mirakl</strong></summary>

Separate multiple attribute values with a pipe symbol (`|`). This helps Mirakl detect and process each value.

</details>

**Indicate whether the item is a single item, or a parent/child variant**

To map parent and child items, map the following attributes:

* For **SellerProductId**, map the field containing the parent ID.
* For **SellerArticleId**, map the field containing the variant items IDs.

For single products without variants, enter the same value for both **SellerArticleId** and **SellerProductId**.

{% hint style="info" %}
For Mirakl marketplace errors and best practices, see [the Mirakl guide](https://helpcenter.channable.com/hc/en-us/articles/360012678720-Mirakl-guide-settings-and-solutions).
{% endhint %}
{% endstep %}

{% step %}

### Additional requirements for Boulanger

**Meet GPSR and DSA requirements**

The European Union (EU) has introduced new[ GPSR and DSA requirements](https://helpcenter.channable.com/hc/en-us/articles/22175644897042) for online platforms, including Boulanger.

You can map these fields in the **Attributes per category** tab in the **Build** step of your Boulanger channel.
{% endstep %}

{% step %}

### Check the quality of your setup

The **Quality** step provides feedback on your channel before you activate it. It highlights mandatory and optional errors to ensure your product data meets requirements to list on the marketplace.

Solve errors, prioritizing mandatory errors first.

**Actions**

* **View items**: See products with specific issues.
* **View in build**: Redirects to the **Build** step to map missing information.
* **Set categories:** Directs to the **Categories** step to categorize items.
* **Show source**: Available for ID fields. Directs to the **Settings** step.

[Learn more about the Quality step for marketplaces](https://helpcenter.channable.com/hc/en-us/articles/19452435834642-Marketplaces-Quality-step)
{% endstep %}

{% step %}

### Preview before activating

The **Preview** step displays the attributes you mapped in the **Build** step, helping you check if everything is configured correctly by providing an overview of your products and potential errors.

**Filtering**

* **Filter by error**: Click the **All** dropdown and select if you would like to filter to display only products with errors, or products with a specific error.
* **Filter by category**: Click the **All categories** dropdown and select the category you want to filter by.

[Learn more about the Preview step for marketplaces](https://helpcenter.channable.com/hc/en-us/articles/19452509593746-API-s-Preview-step)
{% endstep %}

{% step %}

### Connect to Boulanger via Mirakl

To send your listings to Boulanger, you need to connect your channel to your Mirakl Connect account.

{% hint style="success" %}
Nothing will change by linking your account - any existing listings stay exactly the same until you activate.
{% endhint %}

1. Log in to your Mirakl connect account.
2. In **\[your Boulanger channel]**, go to **Settings**.
3. At **Linked seller account**, click **Select seller account**.
4. Select an existing seller account, or click **+ Add new connection** to add a new seller account.
   1. If adding a new seller account:
      1. For **Name**: Name your seller account connection. This is only used to identify your connection within Channable.
      2. Click **Connect with Boulanger**.

You’ll be redirected to Mirakl to log in to your account. This is to authenticate your connection to ensure Channable can list products for you.

After successfully logging in, your connection will be ready, and you will be navigated back to your channel.
{% endstep %}

{% step %}

### Activate and run your channel

Once your product listings are ready, you can send them to Boulanger:

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

{% step %}

### Review and fix listing errors

After you run your channel, the marketplace provides feedback about missing listing data. Treat each run as part of an iterative process!

To review feedback and resolve errors, go to the **Result** step and click the **Feedback** tab.

#### Resolving errors

1. In **Description**, click the error name. This opens an overview of products with that error.
2. In **ID**, click the ID number and scroll to the error callout. Hover over the callout for more information.
3. If the error is a mapping error, click **View in build**. This opens the attribute that you need to map or remap.
4. For more information about the attribute and its accepted values, hover over <i class="fa-circle-question">:circle-question:</i>.
5. Resolve the error.
   {% endstep %}
   {% endstepper %}

\ <br>


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/mirakl-marketplaces/how-to-set-up-a-boulanger-channel.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.