Setting up a Cdiscount API

Requirements before getting started

Cdiscount is a French marketplace that allows you to sell products based on a cost-per-sale (CPS) model. Please consider the following conditions when submitting your product listings to Cdiscount:

1. You will need a Cdiscount seller account, which you can create here: https://seller.octopia.com/login. 
2. Your product data must be available in French.
3. If you have previously sold on Cdiscount without using Channable, you must use the same unique identifier (ID) for all of your products as you did before. 
4. Cdiscount doesn't allow you to delete product listings from your account. Instead, you can only disable ads by setting the stock to 0 (When excluding a product in Channable automatically does this you for 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”: 

After that, navigate  to your Channable account and click on “[your company name in the upper right] > Connections > +Add a new connection”. You can name the connection and click on “Create”.

A new window will appear 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. See our common rules support article.
   
   
3. Build
   In the "Item" 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 and to select the shipping methods that you support, with a minimum of selecting the “tracked” and “registered” shipping method (in “Price & Shipping”). Products exported without a price will get rejected by Cdiscount even if the API does not show any error. You can find more information about the shipping methods here.
   Important II: In accordance with 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! Notice the question mark following every field. Hovering over the question mark will display the field's description and suggestion 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 into the marketplace. Click on a specific error to get more information about the cause of the error. If you get the error with the code “1300 - Inexistant - Demandez la création dans la rubrique Création produit", please follow our guide. If the error cannot be resolved as indicated in the specification, you may contact our technical support for assistance. Finally, you can check the Integration & Data Modification reports in your Octopia account. In order to retrieve them, please follow this article.