Setting up a Cdiscount API

Requirements before getting started

Cdiscount is a French marketplace that lets you sell products based on a cost-per-sale (CPS) model. Take the following conditions into account when sending product listings to Cdiscount:

1. You need a Cdiscount seller account, which you can create here: https://seller.octopia.com/login. 
2. Your product data needs to be available in French
3. If you already sold at Cdiscount without using Channable you have to use the same unique identifier (id) as id that you used before for all the products
4. Cdiscount doesn't allow you to delete product listings from your account. We can only disable ads by setting the stock to 0 (excluding a product in Channable automatically does this for you in Cdiscount)

Step 1: Add a new Cdiscount API connection in Channable

In your Octopia account, you will find the API username and the API password, under the tab "Settings > Your personal and banking data > Login settings": 

Then, go to your Channable account and click on "[your name in the upper right] > Connections > +Add a new connection". You can name the connection and click on "Create".

A new window appears in which you can copy your API ID and the API password in the available fields. Give the connection a name under "Label" (e.g. "[your store] - Cdiscount") and finally click on "Create". 

Step 2: Create a new Cdiscount API

Once you have created the API connection, go to "APIs > + Add a new API". A new screen will appear with the API settings:

1. Select your new Cdiscount connection and choose a name for your API (e.g. "Cdiscount")
2. Unique ID per item : The ID of your products must be unique otherwise Cdiscount will not accept your products. This field is usually called "id" in your online store import.
3. Click Continue.

Step 3: Create your product listings in Channable

Once you have created the API connection, you can create your product ads by following the four steps below.

1. Categories
   We advise you to first try to send your products without filling in the categories. If Cdiscount already knows the EAN codes of your products, you will not need to do this step.
   Note : If Cdiscount does not recognize the EAN codes of your products after running your Cdiscount API, you will get the following error in the Results tab: "1300 - Inexistant - Demandez la création dans la rubrique Création produit". If you get this error, we advise you to consult our help center article. 
2. Rules
   Create different rules to optimize your product data. For examples take a look at our common rules support article.
   
   
3. Build
   In the "Product" tab of the "Build" step, make sure to fill in all required fields. Please consult this help center article to find all the limitations and requirements imposed by Cdiscount.
   
   Note: If the product type is set to "Variant", the "Color" field is mandatory for all variants.
   Important I: It is mandatory to fill in a price (in "Price & Shipping"). Products exported without a price will get rejected by Cdiscount even if the API does not show any error.
   Important II: According to the AGEC law, it is now mandatory to display the amount of eco-participation tax for electrical & electronic equipment (WEE) and furniture items (WFI). For more information, please read this article on Octopia.
    
   
   Tip! I 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. 
4. Attributes
   Next you need to fill in the attributes per category in the "Attribute" tab. 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 listings to Cdiscount (Octopia)

If you have not activated your project in Channable, go to the Settings tab in the left menu bar and click on 'activate project'. Your product ads are ready to be sent. Click on "Settings > Activate API" then "Run".

Step 5: Check your product listings for errors

In the "Result" tab, click on "Errors" to see which product listings contain errors and are not being correctly integrated in the marketplace. Click on a specific error to get more information about the cause of the error and contact our technical support if you need help. If you get the error with the code "1300 - Inexistant - Demandez la création dans la rubrique Création produit", please follow our guide. Finally, you can check the Integration & Data Modification reports in your Octopia account. In order to retrieve them, please follow this article.