How to set up a Carrefour Spain channel

Learn how to set up a Carrefour Spain API in Channable, connect your Mirakl account, map required attributes, and send your listings to Carrefour Spain.

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.

---

Before you start

You'll need

• Permission to sell on Carrefour Spain
• Permission to sell your items (contact your Carrefour account manager or [e-mail] for more information)

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.

• 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. 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.

1

Create a Carrefour Spain channel

Modern version

1. In Channable, go to All projects.
2. Select [your project].
3. Go to Channels.

Legacy version

1. In Channable, go to Projects > [your project] > Channels.

1. In the search bar, enter "Carrefour" and select Carrefour Spain.
2. 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.
3. Click Save.

2

Create product listings

Categorize your items (Categories step)

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

Set up rules (Rules step)

You can set up rules 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

Build your listings (Build step)

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

Check feedback (Quality step)

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

3

Fulfill additional requirements for Carrefour Spain

Meet GPSR and DSA requirements

The European Union (EU) has introduced new GPSR and DSA requirements 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

Shipping classes

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:

To add it, create a new field in the import mapping and use a rule to add the shipping class that corresponds to your items, depending on their weight.

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.

4

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.

5

Activate your channel

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.

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.

6

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.