# How to set up a Carrefour Spain channel

Carrefour is a multinational retailer with several retail formats: hypermarkets, supermarkets and convenience stores.

In this article, you'll learn how to set up an Carrefour Spain channel (API) to create, update and manage your Carrefour listings for the Spanish market in Channable.

***

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

**You'll need**

* [Permission to sell on Carrefour Spain](https://www.carrefour.es/e-commerce/marketplace/index_en.html)
* Permission to sell your items (contact your Carrefour account manager or <marketplace_carrefourinfo@carrefour.com> for more information)

{% hint style="danger" %}
**Important:** Check that you have permission to list or create new items. If you send an item to Carrefour without their permission, the entire export to fail, and all other items will be rejected too.
{% endhint %}

* A project in Channable with your imported items
* EAN codes for your items

**Good to know**

* Carrefour Spain uses the Mirakl platform
* You can currently create a Carrefour channel for Carrefour Spain or [Carrefour France](/list-advertise/sell-on-marketplaces/mirakl-marketplaces/setting-up-a-carrefour-france-api.md). Other countries are currently not supported.
* You can't remove delete listings directly. To remove products from Carrefour, set their stock to 0. This deactivates them on the platform.

{% stepper %}
{% step %}

### Create a Carrefour Spain channel

1. In Channable, go to **Projects > \[your project] > Channels**.
2. In the search bar, enter "Carrefour" and select **Carrefour Spain**.
3. Set your channel settings:
   1. For **Name**, give your channel a name.
   2. For **Unique ID per item**, select a field containing your products EAN codes (e.g. `ean`, `id` )
   3. For **Master rules**, you can set a rule group if you already have one to apply to your channel.
4. Click **Save**.
   {% endstep %}

{% step %}

### Create product listings

<details>

<summary>Categorize your items (<strong>Categories</strong> step)</summary>

To set up your product data, assign categories to your products.

* **AI product categorization:** Automatically assigns product categories through our algorithm.
* **Manual Categorization:** Manually assign product categories with custom rules. You can create detailed filters to map each product to the correct category.
* **Uncategorized Items:** Products that still need to be reviewed and categorized

[Learn more about categorizing for marketplaces](#categorize-your-items-categories-step)

</details>

<details>

<summary>Set up rules (<strong>Rules</strong> step)</summary>

You can set up [rules](/manage-improve-product-data/rules-bulk-edit-and-enrich/rules-in-channable.md) to help you adjust and optimize your product data for the marketplace you want to sell on.

* **Rule templates:** Commonly used rules you can adjust for your use case.
* **Rules setup:** Set up rules to refine your product data. This can include filtering, modifying, or enhancing data fields to meet marketplace requirements.

[Read more about using rules for marketplaces](/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-rules-step.md)

</details>

<details>

<summary>Build your listings (<strong>Build</strong> step)</summary>

The **Build** step is where you configure your product listings to match marketplace requirements. It’s an essential step for getting your products live and avoiding errors.

**Color key**

* **Required by marketplace**: You need to map this attribute to list your items on this marketplace
* **Recommended**: It's recommended to map this attribute to avoid errors and improve performance

**Shared attributes**

Shared attributes are common fields that apply across your products, such as EAN, prices, and titles.

* **Mapping an attribute**
  * **Supported values:** Select to apply a supported fixed value across all items (e.g. "Yes", "10").
  * **Project field:** Select a field from your import data to reference values from. What is provided will automatically change based on the linked data (e.g. stock, prices)

**Attributes per category**

* Fields that specifically apply to the category for your products (e.g. size for clothing or dimensions for furniture).
* Click the category to view and fill in attributes that are specific to the selected category.

[Learn more about the Build step for marketplaces](/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-build-step.md)

</details>

<details>

<summary>Check feedback (<strong>Quality</strong> step)</summary>

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](/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-quality-step.md)

</details>
{% endstep %}

{% step %}

### Fulfill additional requirements for Carrefour Spain

<details>

<summary><strong>Meet GPSR and DSA requirements</strong></summary>

The European Union (EU) has introduced new[ GPSR and DSA requirements](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/what-you-need-to-do-to-be-gpsr-and-dsa-compliant) for online platforms, including Carrefour.

To comply with these requirements, you’ll need to provide information for the following attributes:

* **Reglamento Advertencia / Indicación**
* **Reglamento Correo Electrónico**
* **Reglamento Dirección Del Fabricante/Importador**

</details>

<details>

<summary><strong>Shipping classes</strong></summary>

Carrefour asks for the Shipping Class (Logistics category) of the products, depending on the weight. You can add the Logistics Category to your products following the specifications on this chart:\
![shipping\_category\_Carrefour.png](/files/3b57c67db7f94e982e6e338d8110116276de3d5f)

To add it, [create a new field in the import mapping](/get-started/getting-started/fields-in-channable/map-and-add-fields.md) and [use a rule](/manage-improve-product-data/rules-bulk-edit-and-enrich/using-rules.md) to add the shipping class that corresponds to your items, depending on their weight.

</details>

#### Best practices for Mirakl marketplaces

* **Adding multiple attribute values:** When adding multiple values in an attribute field for Mirakl Marketplaces, separate each value with a pipe symbol "|" to ensure proper detection and processing.
* **Seller's Product ID for Single/simple products:** There are two attributes named `SellerArticleId` and `SellerProductId`.
  * `SellerProductId` refers to the Parent ID
  * `SellerArticleId` refers to the variant items
  * For single products, both attributes must be filled with the same value.

For more information refer to [our dedicated guide](/list-advertise/sell-on-marketplaces/mirakl-marketplaces/mirakl-guide-settings-and-solutions.md).
{% endstep %}

{% step %}

### Connect to Carrefour Spain via Mirakl

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

1. Log in to your Mirakl connect account.
2. In **\[your Carrefour Spain 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 **Label**: Name your seller account connection. This is only used to identify your connection within Channable.
      2. Click **Connect with Carrefour Spain**.

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 set up your channel.
{% endstep %}

{% step %}

### Activate your channel

{% hint style="danger" %}
**Reminder:** Make sure you have permission to list or create new items. If you send an item to Carrefour without their permission, the entire export to fail, and all other items will be rejected too.
{% endhint %}

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

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

{% step %}

### Review and fix listing errors

Go to the **Result** step and click on the **Feedback** tab. This page displays all possible processing errors your product data has at a given moment.

**Resolving errors:**

1. In **Description**, click on the error name. This takes you to an overview of the products with that error.
2. In **ID**, click the ID number 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 the attribute and its accepted values, hover over .
3. Resolve the error.

For more information on how to solve an error, check [Mirakl guide: settings and solutions](/list-advertise/sell-on-marketplaces/mirakl-marketplaces/mirakl-guide-settings-and-solutions.md).
{% endstep %}
{% endstepper %}


---

# Agent Instructions: 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:

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

The question should be specific, self-contained, and written in natural language.
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.
