Latest API newsletter

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