Latest API newsletter

November 2020


We would like to remind you that Cdiscount has asked its sellers to provide a tracking link for order validation since 1st of November. Indeed, the rate of customer contact is really less significant for tracked orders and therefore, customer satisfaction is higher.

There are two ways to fill in this field from the API:

  1. In the CarrierName field, fill in one of the bounded carrier names present in the GetGlobalConfiguration method (e.g. "La Poste - Courrier").
  2. And/or fill in the order tracking url link in the TrackingIdUrl field. Please note that the tracking links are subject to validity checks on our side.
  • For the specific case of dematerialized products: please select “Other” as CarrierName and fill out the Tracking number field with “DEMAT”.
  • Note “Standard” Shipping mode doesn’t need tracking information but this mode is not available for customers when the order amount is higher than €10.

In order to avoid any order cancellation due to a bad request during the Christmas time, we suggest you double-check from your side if orders have been well changed in “validated” or “shipped” status. Note double-check implementation is a prerequisite from your side for any order validation dispute. Do not hesitate to do a GetOrderList method filtering by OrderReference and check if the orders are in “Shipped” status. Furthermore, from now on, we advise you to retrieve orders over a wider time slot (90min): set the filter by date (BeginCreationdate and Begin ModificationDate) at least 90 minutes before for collecting orders in order not to forget any order.

Would you like to highlight your offers for Black Friday and Christmas time? If you want to use Flash Sales, note you should put a maximum gap of 72 hours between StartDate and EndDate and the Discount (%) is based on the Price. You can get more general information on these marketing tools by following this link. You can click here if you want to get a sample of these tools.

October 2020


After months of development, we are finalizing the Cdiscount Marketplace REST API and we would like to know what you expect about the use of this new language.

We would really appreciate it if you could fill in this survey.

Only 4 questions for you, that’s really quick for you and important for us!

We would like to inform you that Cdiscount will be asking its sellers to provide a tracking link for order validation starting from 1st of November. Indeed, the rate of customer contact is really less significant for tracked-orders and therefore, customer satisfaction is higher.

There are two ways to fill in this field from the API:

  1. In the CarrierName field, fill in one of the bounded carrier names present in the GetGlobalConfiguration method (e.g. "La Poste - Courrier").
  2. And/or fill in the order tracking url link in the TrackingIdUrl field. Please note that the tracking links are subject to validity checks on our side.
  • For the specific case of dematerialized products: please select “Other” as CarrierName and fill out the Tracking number field with “DEMAT”.
  • Note “Standard” Shipping mode doesn’t need tracking information but this mode is not available for customers when the order amount is higher than €10.

Important: During the past weeks, we have noticed an important increase of products packages submissions. A large part of them were not compliant with Cdiscount expectations.

Could you please make sure you follow these rules:

  • Do not resubmit already existing products
  • Do not resubmit products that have been rejected already without changes
  • Do not send more than 1 package per hour
  • Do not send more than 50K products per day

September 2020


Cdiscount has decided to streamline and improve the cellphones and product datasheets, starting with Apple and Samsung. We recently added MacBook and updated new references for other brands.

You will find here the list of Apple, Samsung and Huawei EANs and the corresponding sub-states that we will keep. Please note that it is one EAN per sub-state.

If you are concerned, please follow these steps:

  1. First, inform your 3rd-party solution in order to map the new EANs provided in the listing.
  2. Then, open a ticket in your Seller Zone: Help > Contact Us > Create or Modify your product sheets > Modify your product references / EAN Code

More and more merchants/partners contacted us to benefit from our advices! 250 calls have been done this quarter, if you need assistance, book for a call on the planning here.

Same trend via the ticket system. You’re 650 in Q2 (vs 500 in Q1). The average time for answering is under 2 days (40 hours). Do not hesitate to use it to contact us through your sellerzone: Help > Contact us > API.

July 2020


Following the June 18 release of the latest version of our General Terms and Conditions, you now have to set up a preparation time of 5 working days or less for all your offers.

All the offers that previously had a preparation time greater than 5 working days will be automatically unpublished.

To change your preparation time, use the "SubmitOfferPackage" method using full update only. Learn more about this method by clicking here; you may download an offer package sample here.

A new API discussion method is available: GetDiscussionList. It substitutes 3 of them: GetOrderClaimList, GetOfferQuestionList and GetOrderQuestionList.

We will add new attributes into this method:

  • DiscussionType (Questions, Discussion,…)
  • Message’s sender (Seller, Customer or Cdiscount)
  • Items concerned by the discussion

The method is available on the API documentation.

A new "Pricing" tab on the Seller Zone gives you access to special temporarily deals on some SKUs and the conditions of the deals. Based on the same concept, a new API method named GetSellerDeals is now available and gives you the possibility to collect this listing of deals through our API.

You can find the request and response xml here and the description of data retrieved here.

Check our API Documentation to get more information about this new method.

In order to improve our datasheet quality presentation and make the search engine even more efficient on Cdiscount, our product creation system is changing.

As of today, 300 models with their specific attributes are available in production.

We invite you to check your workflow for creating products on Cdiscount. Over 300 models are now available to create your products with the mandatory specific attributes.

Don’t hesitate to check GetAllAllowedCategoryTree and GetModelList methods to collect new models.

June 2020


A new “Pricing” tab on the Seller Zone gives you access to special temporarily deals on some SKUs and the conditions of the deals. Based on the same concept, a new API method named GetSellerDeals is now available and gives you the possibility to collect this listing of deals through our API.

Check our API Documentation to get more information about this new method.

Important news: in order to improve our datasheet quality presentation and make the searchengine evenmore efficient on Cdiscount, our product creation system is changing.

From the 8th of June, more than 300 models with their specific attributes will be available in preproduction. And from the 6th of July, they will be available in production. >> As an integrator, if you are interested in activating sellers who use your solution before the 6th of July, you can contact the partners team.

We invite you to check your workflow for creating products on Cdiscount. More than 300 models will be available to create your products with the mandatory specific attributes.

Don’t hesitate to check GetAllAllowedCategoryTree and GetModelList methods to collect new models.

Would you like to check if your order workflow is OK ? Do not hesitate to ask us in your Seller Zone to create test orders in preproduction for you, by clicking on: Help > Contact us > API > Test Order Creation Request.

We will create hundreds of test orders to validate or test your workflow.

Note if you want to access our preproduction, you should previously give us your IP addresses by opening a ticket: Help > Contact us > API > Authentification / Access.

Cdiscount has decided to streamline and improve the cellphones product datasheets, starting with Apple and Samsung. Now, we also added Huawei.

You will find here the list of Apple, Samsung and Huawei EANs and the corresponding sub-states that we will keep. Please note it is one EAN per sub-state.

If your are concerned, please follow these steps:

  • First, inform your 3rd-party solution in order to map the new EANs provided in the listing.
  • Then, open a ticket in your Seller Zone: "Help > Contact Us > Create or Modify your product sheets > Modify your product references / EAN Code"

May 2020


An API Dashboard has been created to inform sellers and integrators about the status of our API. You can find the status of each API methods in its environments:

  • In production:
    • Important messages
    • Distribution of API method status
    • Problems encountered
    • Status by methods
  • In pre-production:
    • Important messages
    • Important messages
    • Distribution of the API methods status
    • Problems encountered
    • Status by methods
    • The pre-production planning, over 2 months

This API Dashboard is accessible by clicking on the button below:

Would you like to animate your offers? We would like to present you different marketing tools that can help you to promote your products on our Marketplace:

You can get more general information on these marketing tools by following this link. You can click here if you want to get a sample of these tools.

As we informed you before, Cdiscount Fulfilment can manage the dispatch of your products sold on all channels (marketplaces and websites) in Europe thanks to our External Order service. The great news of this month is that the "Domicile Express" delivery mode is now available, in addition to the Domicile Standard delivery mode.

Furthermore, you can now collect the error message linked to your order status with the GetExternalOrderStatus method. You will then be able to understand the issue immediatly.

April 2020


In order to improve our network infrastructure, we would like to warn you that our output IP addresses will evolve. Please find everything you need to know about these adjustments here (Global informations > Ip output Cdiscount).

Stock&Price or Full offers packages? How to check if I do EAN mismatching? How to create a product with multiple variations?

You are interested in knowing the best practices for Products / Offers workflow on Cdiscount Marketplace? Please find here our best practices.

More and more merchants/partners contacted us through the ticket system. You are 500 in Q1 and more than 60% have been closed in less than 24 hours. The average processing time is 36 hours.

Do not hesitate to use this way to contact us through your Seller Zone: Help > Contact us > API.

March 2020


We have just launched our new API Support call tool ! If you want to speak with one of our API expert, feel free to book an appointment. The schedule is available on the right section of the API documentation homepage.

You are an API partner and you have developed the Cdiscount Marketplace API, you will find the method to identify your API Activity below:

 
                  <a:Security>
                    <a:DomainRightsList i:nil="true"/>
                    <a:IssuerID i:nil="true"/>
                    <a:SessionID i:nil="true"/>
                    <a:SubjectLocality i:nil="true"/>
                    <a:TokenId>Token</a:TokenId>
                    <a:UserName>partnername</a:UserName>
                </a:Security>

Specifying this username will help us to identify merchants working with you and will ensure the potential issues to be resolved faster.

We highly recommend you to complete the username field (displayed in the header of each method) for all API calls you do and all seller accounts you manage. Furthermore, tickets from merchant/partners with filled username will be priorized.

If you use various partners for API, you may create an API credentials for each of them. A dedicated page is available on the API documentation and explains how to generate new API credentials.

We would like to thank every partners to have answered to our January survey. 
We will analyse the results in order to improve your experience on Cdiscount as partners.

February 2020


A new API discussion method is coming: GetDiscussionList. It substitutes 3 of them: GetOrderClaimList, GetOfferQuestionList and GetOrderQuestionList. We will add new attributes into this method:

  • DiscussionType (Questions , Discussion,…)
  • Message’s sender (Seller, Customer or Cdiscount)
  • Items concerned by the discussion

This new API discussion method will be available at the end of February!

Cdiscount Fulfilment can manage the dispatch of your products sold on all channels (marketplaces and websites) in Europe. Good news! the express delivery mode will be opened at the end of March. Get ready:

    • if you were already creating external orders through API, note you should by then use the Express mode and indicate an Estimation date for collecting the parcel.

Warning: note it’s mandatory to use French zip code (5 digits) for France and ShippingCity for orders outside of France to create external orders.

Cdiscount Fulfilment Service is enhancing. In order to improve our API Fulfilment management, we are modifying the Warehouse Code using new simpler codes instead of the former (CMS, SMD, and ANZ). This will be effective mid-March.

These codes will be available for all API Fulfilment methods.

Cdiscount has decided to streamline and improve the cellphones product datasheets, starting with Apple and Samsung. You will find here the list of Apple and Samsung EANs and the corresponding sub-states that we will keep. Please note it is one EAN per sub-state. If your are concerned, please follow these steps:

  1. Inform your 3rd-party solution in order to map the new EANs provided in the listing
  2. Open a ticket in your Seller Zone: "Help > Contact Us > Create or Modify your product sheets > Modify your product references / EAN Code"

From the end of February, you will no longer be able to use the other EANs for Samsung products.

January 2020


Important news: Sell to B2B customers will be a new feature on cdiscount.com (Q1 2020).

What will change: Sell to B2B customers will be directly on cdiscount.com.

What will not change: No new API method, publishing and getting orders is unchanged. If needed, you’ll be able to filter orders by Corporation code (B2C/B2B) in the GetOrderList What you should do: please tick/untick the option in your seller zone in Settings > Your store settings.

More information will be sent in January to be ready for this new 2020 business opportunity!

We identified on our Marketplace, offers with incoherent and abnormally high price.

We were not aligned with DDPP rules (French Customers Protection Instance), we decided to block all offers with incoherent price even if the product is not online (with stock 0) from 31st January.

In order to help you to do this change, we advise you to:

  • Either use SubmitOfferMethod with StockAndPrice Mode and adding only the Stock if you unpublish product
  • Or SubmitOfferMethod with Full Mode and keeping the initial price you use during the publication.

If your are concerned, please follow these steps:

  1. Inform your 3rd-party solution in order to map the new EANs provided in the listing
  2. Open a ticket in your Seller Zone: "Help > Contact Us > Create or Modify your product sheets > Modify your product references / EAN Code"

From mid-February, you will no longer be able to use the other EANs for Samsung products.

Cdiscount has decided to streamline and improve the cellphones product datasheets, starting with Apple and Samsung.

You will find here the list of Apple EANs and the corresponding sub-states that we will keep. The Samsung one will be available on the 17th of January. Please note it is one EAN per sub-state.

December 2019


Do not miss Cdiscount sales ! This year it will start on 8th January and end on 4th February 2020. If you want to be ready for the first hour of sales, we highly recommend to send your offers package with sales at least 2 days before this starting date.

Find out how to parameter your offers with the API into English here and into French here.

And here the offer sample with sales

Would you like to automize your Refund Vouchers or Commercial Gesture ? It’s possible to refund a specific order line, a free amount or the whole order using CreateRefundVoucher.

  1. Free Amount is managed by CommercialGestureList and need an OrderNumber, an Amount and a MotiveID (see RefundInformation)
  2. Refund an order line or the whole order is managed by SellerRefundRequest and need an OrderNumber, a Cause (Claim or Retraction), a Motive (see RefundMotive) if you refund Shipping charges (RefundShippingCharges) and the SKU (SellerProductID)

November 2019


Do you want to update only stock and/or price? The StockandPrice mode will help you coordinate various third-party solutions (ex : integrator, wms, pricing systems…) and speed up your offer integration up. It’s possible using StockandPrice mode and you only fill in SKU, EAN + Stock and/or Price. You may download the sample here.

This feature allows you to activate the trade negotiation on the site and to allow the client to negotiate the price of the offer. Eligible offers are those on which you are positioned as a best offer.

 

2 steps for offering this kind of marketing actions :

  • Activate the option in your sellershop : Settings > Your store settings > Others parameters > Your configurable settings > Activate commercial negotiation function on parameterized deals with price matching
  • Send Full offers packages with MinimumPriceForPriceAlignment and PriceMustBeAligned in the offers.xml

October 2019


Cdiscount has decided to streamline and improve the cellphones product datasheets, starting with Apple. You will find here the list of Apple EANs and the corresponding sub-states that we will keep. Please note it is one EAN per sub-state.

If your are concerned, please follow these steps:

  1. Inform your 3rd-party solution in order to map the new EANs provided in the listing
  2. Open a ticket in your Seller Zone : "Help > Contact Us > Create or Modify your product sheets > Modify your product references / EAN Code"
 

From November 8th, you will no longer be able to use the other EANs for Apple products.

In order to improve the visibility and the purchasing process of refurbished and/or used offers for our customers, we would like to share with you a change regarding the sub-states:

 

Good State (3) and Refurbished (5) will be desactivated.

 

The sub-states maintained for sale on our site will be as follows:

  • As New / Comme Neuf (1)
  • Very Good / Très Bon Etat State (2)
  • Average State / Etat Correct (4)
  • New / Neuf (6)
 

For each product category, a main status "Refur" or "Used" will be assigned by Cdiscount and visible to customers via search filters in particular.

Are you a web-agency or a feed-integrator? Would you like to improve the merchant journey to connect to Cdiscount ? Now you can create a professional seller accounts through API. Please find here the documentation.

We would like to know your feedbacks regarding our API: support, documentation, availability and tools. Could you please use 2 minutes of your time to help us priorize subjects ? We thank you in advance to fill out our form below

 

Important news: our product creation system is changing in order to improve our datasheet quality presentation and make Cdiscount search engine even more efficient.

 

What will change: More than 300 models will be available to create your products with the mandatory specific attributes.

 

What will not change : There is no new API method , the existing method already includes this new model.

 

What you should do : Please check your workflow for products creation on Cdiscount and make sure it follows the right method.

 

Click here to see the detailed workflow and specifities.

September 2019


Image
Image

Important news: our product creation system is changing in order to improve our datasheet quality presentation and make Cdiscount search engine even more efficient.

 

What will change: More than 300 models will be available to create your products with the mandatory specific attributes.

 

What will not change : There is no new API method , the existing method already includes this new model.

 

What you should do : Please check your workflow for products creation on Cdiscount and make sure it follows the right method.

 

Click here to see the detailed workflow and specifities.

Image
Image

Cdiscount inform their customers about shipment progress thanks to a status bar on their customer back-office. This bar reduces drastically the claims & questions about order status. In terms of API development you should fill the carriername in the ValidateOrderList method with the marked out carriername present in GetGlobalConfiguration method.

 

August 2019


Image

Have your API partners already filled his UserName Tag ? Indeed, in the header of each method, the UserName tag must be filled with the name of your program which use the API connection (integrator, logistic solution, payment solution…). Your next step depending on who you are :

  • If you’re a seller using a API solution, please contact your partners to fill it.
  • If you’re an integrator, pricer, logistic solution… please put your name in the username tag.
  • If you develop the API by yourself, please fill the name of your company.

When using API for orders and catalog management, the sellers do not log very often in their seller’s backoffice to check on their quality rates. If you want to be constantly aware of your activity and create a warning system, do not hesitate to use the GetSellerIndicators method/functionality.

 

Do you know if your shop is put in default or in holiday mode ? Do you know which delivery modes you have activated in order to set well your offers package ? Do you know if you have activated Cdiscount (B2C) and/or Cdiscount Pro (B2B) ? GetSellerInformation will give you the answer below

 

March 2019


Image

Logistics type management

 

From April, sellers will have a new option allowing them to impose the publication of an offer in status delivered by the seller or in status fulfilment on demand, even if some stocks are currently stored in Cdiscount's warehouses. Fulfilment sellers will be able to choose the logistics mode for each of their offers by using the LogisticsManagement attribute in their offer file. By default, we will first continue to sell the products stored in our warehouses.

 

SoldOut Management

 

In order to facilitate the transition between the different logistics modes and to prevent the display of stock offers as "soldout", we will make available an option allowing to put the declared stock for sale (in the seller's warehouse) as soon as the quantity stored in our warehouses is out of stock. To activate this feature, you must add the optional attribute SoldOutManagement in your Offers.xml file with the value 1. If you set this attribute with the value 0 or if you remove this attribute from your file, the feature will be disabled.

 

Stock Management

 

To help you improve and optimize your stock management the method GetProductStockList has been Upgraded. From W15 you will have a better visibility on your activity. Information about different statuses of your stock will be added, and sales indicators and details on your fees will be made available. In addition, you will able to focus information on different typologies of stock: - ShippableStock / BlockedStock / SoldOut

 
Image
Image

Multi-model product creation

 

You have requesting this, and it will be soon available: From this summer, you will be able to create your products with many more attributes depending on the category of your product (e.g.: screen size for a computer, number of seats for a sofa,...). You will be able to provide more information in your product sheets and increase their quality to develop your business. No modifications, you will use the existing method (GetModelList) BUT it will return you a new model and the list of associated attributes according to the category. More details to come.

 
Image