Setting up a Carrefour France API – Channable

Do you want to learn interactively all basics related to the creation of an API export, or how to make an advanced setup for an API in Channable? Learn how to create a Channacademy account in the Channable app through this Help Center article and start with the Basic APIs or Expert APIs course.

Note I: 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 II: Through Channable you can create a connection with Carrefour Spain and France, not with other countries. For more information about setting up a Carrefour Spain API, see this helpcenter article.

Step 1: Add a new Carrefour France connection

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

When you have a Mirakl Carrefour France account, go to "[Your company] settings menu (in the top right corner) > Connections > Add connection". Click on "+ Add a new connection" and you will see a screen, where you can select Carrefour France. Fill in the label for your connection, for example: Carrefour FR. And then click on ''Connect with Carrefour''. You will be redirected to the environment where you can login with your Mirakl-credentials. After logging in, you will be redirected back to Channable where the connection will be available.

Step 2: Create a new Carrefour France API in Channable

Now go to the API's overview, in your project. And click on add new API, Select the Carrefour France connection you just made and 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. For Carrefour France you can only choose 'France'. You can also add a master rule group here if you would like. Click on "Continue" to finish creating the new Carrefour French API.

Step 3: Create your product listings in Channable

Once you have created the Carrefour French API you can setup your product data by following the steps of the API.

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.
Rules
Create different rules to optimize your products listings. For examples, take a look at our common rules support article.
Build
Here you can find our preset template for the product listings. All you have to do is to fill it out by clicking on the field itself and selecting what you would like to go in there. For example, the field 'Title' should display the title of your product, and so on. When you have finished setting up the product listings, just click 'save' at the bottom of the screen.

Note I: Carrefour asks for the Shipping class of the products, depending on the weight. 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. If a project field is chosen, only the following values are allowed: XXS, XS, S, M, L, XL, XXL

Note II: France introduced legislation for eco-participation. If your company is operating in France, your company has the obligation to add eco-contributions to your offers on the marketplace. An eco-contribution, also known as an environmental contribution, is an amount added to the price of a product to compensate for the environmental impacts related to its manufacturing, distribution or disposal.

An eco-contribution consists of three parts: EPR category code, Producer ID and Amount. In this paragraph, you can find a list of available EPR categories.

Tip! Notice the question mark behind every field, if you hover over the question mark you will see the description of the field and suggestions for possible values.
Attributes
Almost done! Next up is filling in the fields in the Attributes step. Select the category you want to optimize first. A more detailed explanation of what to do in the Attributes step can be found in our Attributes support article.

Step 4: Send your product data to Carrefour

Almost there, your product listings are ready to be sent. If you have not activated your project go to Settings panel on the left hand side of the screen and click "activate project". After, go back to the APIs overview and go to "Your Carrefour API Name" > Settings where you activate the API by selecting "Activate API". After you have completed this step navigate back to then APIs overview and select the blue "Run now" button to sent your product listings to Carrefour.

Note: Sellers can now send their new products via the Carrefour API for France, 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.fr.

Step 5: Check your product listings for errors

If you have sent you 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 put them to stock=0 (which inactivates the product on the platform). Therefore, if for any reason, you want to eliminate your products from Carrefour, you just have to send the products again, but with stock 0.

EPR Category overview

ECO - Carrefour 2.png