Setting up a Carrefour Spain API

Note: EAN codes are mandatory for Carrefour. Make sure you have valid EAN codes for all your products, otherwise no product listings can be created for your products.

Note: Through Channable you can create a connection with Carrefour Spain and France, not with other countries. For more information about setting up a Carrefour France API, see this Setting up a Carrefour France API

UI update: There is a new channel selection page and overview for Feeds and Marketplaces (previously called APIs)! Some visuals and instructions may not be up-to-date.

1

Add a new Carrefour Spain connection

The Carrefour Spain API uses the Mirakl platform, which means you will need a Mirakl account to start sending your product listings to Carrefour.

• Once you have a Mirakl Carrefour Spain account, go to Connections > Add connection.

• Click + Add a new connection and select Carrefour Spain.

• Fill in the label for your connection, for example, "Carrefour".

• Click Connect with Carrefour. You will be redirected to the environment where you can log in with your Mirakl credentials. After logging in, you will be redirected back to Channable where the connection will be available.

2

Create a new Carrefour Spain API in Channable

• Go to [Your project] > API's.

• Click + Add new API.

• Select the Carrefour Spain connection you just made.

• Give your new API a name.

Select the field you want to use for Unique ID per item (we recommend the 'id' field) and the Country you want to sell in. YClick on "Continue" to finish creating the new Carrefour Spain API.

3

Create your product listings in Channable

Once you have created the Carrefour Spain API, set up your product data by following the steps of the API.

1

Categories

For your product listings to be created, your products need a category. Add categories to your products by using the generate categories feature or create new categories from scratch.

2

Rules

Create different rules to optimize your products listings.

3

Build - Shared attributes

Shared attributes are attributes that apply across all your items, like price and stock.

1. Start by mapping fields to attributes marked as required by the marketplace.

2. Check the remaining attributes and map fields to ones relevant for your business.

3. Click Save.

4

Build - Attributes per category

Category attributes are attributes that apply to items from specific categories, like battery information for electronic items, or sizing information for clothing.

1. Start by mapping fields to attributes marked as required by the marketplace.

2. Check the remaining attributes and map fields to ones relevant for your business.

3. Click Save.

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 products, depending on their weight.

Tip: Hover over for more information on specific field requirements.

Best practices

• 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, while 'SellerArticleId' refers to the variant items. For single products, both attributes must be filled with the same value.

For more information on Mirakl Marketplace errors, how-to's, and best practices, check out our dedicated guide.

4

Step 4: Send your product data to Carrefour

• If you have not activated your project, go to Your project > Settings and click Activate project.

• Go back to the APIs and go to Your Carrefour API Name > Settings.

• Click Activate API.

• Navigate back to the APIs overview and click Run now to send your product listings to Carrefour.

Note: Sellers can now send their new products via the Carrefour API for Spain, without having to send a manual CSV template to Carrefour. However, Carrefour always requires that any seller who wants to register new products sends a copy of their feed, in Excel format, for review, because Carrefour needs to check and validate all the new items that are going to be put on Carrefour.es.

5

Step 5: Check your product listings for errors

• After sending your product listings to Carrefour, go to the Preview tab of your Carrefour API. Click filter on 'error'. Now you can see which product listings have errors and are not created.

Note: In Carrefour it is not possible to eliminate products from your account, only to set them to stock=0 (which inactivates the product on the platform). Therefore, if you want to remove your products from Carrefour, send the products again with stock 0.

GPSR and DSA requirements

The European Union (EU) has introduced new GPSR and DSA requirements for online platforms, including marketplaces.

For your Carrefour Spain API in Channable, make sure to fill in the Attributes per category tab in the Build step

• Reglamento Advertencia / Indicación

• Reglamento Correo Electrónico

• Reglamento Dirección Del Fabricante/Importador

For more information on Mirakl Marketplace errors, how-to's, and best practices, check out our dedicated guide.