Setting up a Carrefour Spain 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.

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 Help Center article.

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 [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. Click on "Continue" to finish creating the new Carrefour Spain channel.

3

Create your product listings in Channable

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

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

Rules Create rules to optimize your product listings.

Build Use the preset template for the product listings and fill it out by clicking the field and selecting the source value. For example, the 'Stock' field should display the product stock. When finished, click 'save' at the bottom of the screen.

Note: Carrefour asks for the Shipping Class (Logistics category) of the products, depending on the weight. You can add the Logistics Category 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.

• Build Fill in the fields in the Build step. Select the category you want to optimize first. A more detailed explanation of the Attributes step can be found in our Attributes support article.

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' respectively. '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

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 in the Attributes per category tab in the Build step:

• Reglamento Advertencia / Indicación

• Reglamento Correo Electrónico

• Reglamento Dirección Del Fabricante/Importador

5

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 APIs and open Your Carrefour API Name > Setting.

• 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 new products via the Carrefour API for Spain without sending a manual CSV template to Carrefour. However, Carrefour always requires that any seller registering new products sends a copy of their feed in Excel format for review and validation.

6

Check your product listings for errors

If you have sent your product listings to Carrefour, go to the Preview tab of your Carrefour API. Click filter on 'error' to 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 put them to stock=0 (which inactivates the product on the platform). To remove products, send the products again with stock 0.

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' respectively. '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.