News

November 2018


Participate in the prioritization of our roadmap!

To meet your needs at best we would like to take into account your opinion in our roadmap prioritization.
Please share with us your ideas and suggestions here :

Improve your customer relationship

Follow our tutorial to help you automate the management of your customer relationship throughout the claims / refunds / commercial gestures management part.

Thanks to this API you will have the possibility to:

  • Centralize the management of your customer relations from your various marketplace.
  • Gain in productivity.
  • And improve customer satisfaction !

Opening of the International delivery!

We are glad to inform you that Cdiscount Marketplace is now offering the opportunity to send products abroad, in Spain, Italy, Belgium and Germany! These countries’ customers can now order on www.cdiscount.com as easily as in France and benefit from pick-up points or home delivery.

Sellers could now publish their offers for delivery in Europe:
In the Seller Store > Your Shipping options > Tick the “International shipping” box.

October 2018


SECONDARY API ACCOUNT

Follow our tutorial to create new secondary API account with your new API login and password:

  • Secure your data
  • Avoid problems of API authentication
  • Manage access to all your partners
  • Improve your API connections

JUNE 2018


Do not miss Cdiscount Sales !

1. Remember to use your API login and not your backoffice login on the API.

2. In case you work with different marketplace management system, we advice you to create a dedicated secondary api login per partner (join the section Settings/User Rights management on your seller space).

3. During the sales, orders can literally take off and an error can have unwanted consequences. That is the reason why it is important to keep an eye on your integration report and on your offers.

4. To be sure that your offers are well configured from the start of sales (on Wednesday, June 27th from 8 ô-clock) send your sales at least 24 hours before (on Tuesday, June 26th 8 ô-clock).

5. Do not hesitate to test the sales feature on preproduction: the preproduction is in sales mode from the 1st of June.

As a reminder: to access to our preproduction, your must have an IP addresses validated so far.

If you have any questions or need help, do not hesitate to contact us by:

  • Creating a support request in the help section of your sellerzone
  • Booking a phone appointment with one of our technician here

MAY 2018


Migrate to a minimum of TLS 1.1, preferably TLS 1.2

If it is not done yet, we strongly recommend you to stop using TLS versions lower than 1.2.

The vulnerabilities in SSL and early TLS poses a risk of being breached.

Therefore, it is critically important that you upgrade to a secure alternative as soon as possible, and disable any fallback to both SSL and early TLS.

StockOrPrice

From W20 you will be able to dissociate Price and Stock updates.

In the “light” version of your offers file, these attributes will become optional to let you use easily pricing tools at your sole disposition and/or the logistic management system.

All information about the StockProductStock

At the moment the only information available about the stock of your products stored in Cdiscount warehouse are:

  • BlockedStock
  • FodStock
  • FrontStock
  • StockInWarehouse

From June, to increase your visibility, we will add the following information in the GetProductStock method response:

  • LandingStock
  • ReceivingStock
  • ShippableStock
  • ReservedStock
  • Stock from reception disputes
  • ReturnedStock

In addition an estimated time before stock shortage will be calculated and provided for your information only, and you will be able to filter products out.

These information will help you face stock run out and delivery times.
More details will be available in the dedicated documentation.

The Cdiscount API team

NEWSLETTER SUBCRIPTION

To make sure you receive our next API newsletters, please register ►here

April 2018


Migrate to a minimum of TLS 1.1, preferably TLS 1.2

If it is not done yet, we strongly recommend you to stop using TLS versions lower than 1.2.

The vulnerabilities in SSL and early TLS poses a risk of being breached.

Therefore, it is critically important that you upgrade to a secure alternative as soon as possible, and disable any fallback to both SSL and early TLS.

StockOrPrice

From April you will be able to dissociate Price and Stock updates.

In the “light” version of your offers file, these attributes will become optional to let you use easily pricing tools and/or the logistic management system.

Offers listing filters

To optimize your offers synchronization and your pricing management, we are making available new filters on the method GetOfferListPaginated.

It will soon be possible to get offer information from one reference, to filter on last updated offers, or exclude offers fulfilled by Cdiscount.

NEWSLETTER SUBSCRIPTION

To make sure you receive our next API newsletters, please register ►here

March 2018


Warning : SellerZone will not be accepted anymore on the API

If you still use your seller zone username (login which does not finish by “-api”) on our API, in your add-ons or in your partners interface then you are running a risk.
The reason is that you communicated your identifiers to a third party which allows to access to your account information.
To secure your data you have to use the api username and api secondary usernames.
This way you will be sure that automatic interaction with our API will not be disrupted and your data will be secured.

That is the reason why your seller zone username will not be accepted anymore on the API.
If you are concerned you probably already received an e-mail about this subject from our dedicated support.

Optimize the recovery of your offers

The method GetOfferListPaginated will be updated with some of the most required upgrades.

From March you will be able to :

  • Filter offers by Last updated date.
    It will enable you to only get offers modified recently in order to validate that your offers have been updated and to check that you are synchronized with your data in Cdiscount.
  • Check if an offer is fulfilled by Cdiscount
  • Filter offers by seller product id

You will not have to get through every pages of your catalog to find an offer, you will be able to get directly benchmark information about one offer.

Give us more visibility

This message is intended to feed managers, add-ons editors and developers.
We will make available tools to give you more visibility about interaction between your sellers and our API like dashboards and incident detection and notification.
To benefit from these new features we need that you tag your call to our api. We will be able to monitor your activity and give you feedback on it.
To tag your calls please use the attribute UserName of the headermessage to provide the name of your company.

Get Products information in mass from our test interface

You want to check if your products exist and are well categorized on Cdiscount, to prevent mismatching for instance.
Get Cdiscount product information from a csv file containing up to 500 ean without any development here.

February 2018


Your secondary API account is available

  • A secondary API account

From the end of the month, you will see a new section in the User Rights management page of your backoffice to create your secondary API account.

  • Give access to all your partners

You will be able to provide dedicated API access to each of your partners.
It will allow to avoid interference between partners’authentication system, to manage access according to their activity and to secure the information you want to keep private.

Our testing tool evolves

  • Validate your files with the XSD files

From now, you can validate your files with the XSD files. However, starting this month, we put at your disposal an interface in order to generate your offers or products xml files from a form.

  • Visualize your file and compare it

You will be able to visualize the file format expected by our API and compare it with the file generated on your side.

Sellers Day Invitation

NEWSLETTER SUBSCRIPTION

To make sure you receive our next API newsletters, please register ►here

January 2018


OUR MAJOR FIELDS IN 2018

Discover the new upgrades already planned for the coming year :

  • Discussion

The discussion classification has already evolved in your backoffice according to the subject and criticality. Tags, filters and dedicated methods will be added to allows an automatic prioritization of the customer request, a secure shipment address modification request validation and a customer relationship quality improvement.

If you already use our API to manage your customer relationship on Cdiscount, you probably noticed that attachments are only available in your backoffice. These documents will be made available through API allowing a fully automatized your customer relationship management.

  • Offers

To fully benefit of pricing tools and logistic partners, this year, we offer you the possibility to dissociate prices and stock updates.

  • Authentification

You will have the opportunity to provide different usernames to each partners with specific rights.That way you should not have any more authentification problems due to the use of your API login from different providers. And you will be able to revoke their access.

In order to optimize the creation of product sheets, we inform you that more information will be available in our Category tree. (GetAllowedCategoryTree method).

In this way, you will be able to automatically identify on which category, products with declension are allowed.

From now, a new interface is available in our documentation to test our API methods and to visualize the xml soap call.

This way, you already can :

  • Visualize calls an answer according to your parameters
  • Test your own soap call

T-est several use cases without any prerequisites

PS : do not hesitate to create a ticket in the help section of your backoffice if you need more information or if you want to rise an issue.

NEWSLETTER SUBSCRIPTION

To make sure you receive our next API newsletters, please register ►here

December 2017


Automate your Fulfilment process !

The Fulfilment By Cdiscount service is fully available through the API since September.

You can take advantage of this service in a totally automated way :

  • Manage your supply orders
  • Get your delivery documents
  • Activate your products for Cdiscount Fulfilment
  • Manage the offers’ publication state
  • Transfer orders from other websites to Cdiscount warehouse

Find here a tutorial describing how to implement this functionality with the guidelines and best practices to connect your system in the most effective way.
Our php SDK up to date is available here.
For more information about the fulfilment service click here.

  • Millions of visitors who come to track down offers on sales
  • Millions of products sold during this period
  • Increased visibility of your offers thanks to a different signage
  • > Find out how to parameter your offers with the API > here

NEWSLETTER SUBSCRIPTION

To make sure you receive our next API newsletters, please register ►here

November 2017


Product kind eligibility

In order to continue improving the referencing of products on the website, the product kind (Standard or Variant) will depend on the category (Ex : Variant compulsory on clothing).

Categories can accept product kind this way :

  • Standard only
  • Variant only
  • Standard or variant

This control was manual in the past, it will be automated in the coming weeks.

The list of authorized product kind will be available in the GetAllowedCategoryTree and GetAllAllowedCategoryTree with the attributes CategoryTree.
Is Standard Product Lind Eligible / CategoryTree. Is Variant Product Kind Eligible.
Product that do not comply with the rules will be rejected with a message like “Nature of product: Variant mandatory on this category, please fill Parent sku, size and marketing color” and can be consulted in the method: GetProductPackageSubmissionResult.

Creation of product sheet

The data contact does not change, you can continue to your catalog as usual.
However, from now on, the products with an “OK” message in your integration report are already available to publish an offer.

Only Products with a non-existing brand / size will be manually checked to be rejected or created after size / brand creation.
The report will be updated according to the results of the manual checks.
Therefore the report returned by the method only contains the result of manual checks, the products created directly will not appear in this report.

To benefit from the best conditions of this feature, we kindly ask you to respect the following best practices :

  • Do not submit more than 30 000 products in the same file,
  • Acquaint youself with the product sheet creation tutorial available here to be sure to respect quality criteria,
  • If you have any doubts about categorization of your products, check the cdiscount category for similar existing products thanks to the GetProductListbyIdentifier methodology,
  • Get the list of specific properties available for your category thanks to the GetModelList method and fill as many properties as you can to optimize your referencing,
  • Contact our technician team here if you have any technical question.

Manage certifies requests for customer delivery address modification

From now on, a new certified process is available to allow our customer to send a request delivery address modification request.
You will find all the needed information in our tutorial which is also available in the Message section of you Cdiscount backoffice.

IMPORTANT: in order to protect and satisfy our customers, it is important that you only accept certified requests. If other requests reach you through other channels made available to customers, we advise you to redirect them to the dedicaded typology : “Demande de modification d’adresse de livraison” available in their customer area.

NEWSLETTER SUBSCRIPTION

To make sure you receive our next API newsletters, please register ►here

October 2017


GIVE US YOUR OPINION

We appreciate your business and want to make sure we meet your expectations.
Please help us by taking a few seconds to tell us about the service that you have received so far.
Thank you for giving us the opportunity to better serve you click.

From November on, Cdiscount Pro is offering a new optional payment means : “the delayed bank transfer”. If you decide to activate the service, your offers will be eligible to this payment option: Delayed bank transfer 15 calendar days.
Please note this new option has no impact on the existing order process API.

How does it work ?

Once the order is accepted by the seller (OrderStateEnum = AcceptedBySeller »), the validation of the customer credit’s balance by Cdiscount Accounting department will change the order status to « Waiting shipping » (OrderStateEnum = WaitingForShipmentAcceptation).
Please note that the validation period can take up to 15 days.
Without validation of the payment, the order status will be automatically cancelled (OrderStateEnum = AutomaticCancellation).

TERMINATION OF OLD API FULFILMENT ON SPTEMBER 30th

For your information, the old API Fulfilment will be outdated starting on September 30th, 2017.

The principle now :

All the Fulfilment methods are now included within the Marketplace methods in a single API.
You absolutely need to adapt your calls, by simply modifying the call WSDL.

API Connection with seller shop login

You should pay attention to the identifiers used by your system or by your aggregator.

How does the login ID must end ?

The login ID must end by “-api”.
If it is not the case, your personal information are not properly secured.
So please, replace your login by the specific API connection.
To do this, log in to the SellerShop by following this statement : Settings > Your personal settings and bank details > Connection information.

NEWSLETTER SUBSCRIPTION

To make sure you receive our next API newsletters, please register ►here

September 2017


Fulfilment API Fully available

All the API Fulfilment methods are now available. You can now benefit from the same features to manage your fulfilment offers with our API or our SellerShop web interface :

  • Manage your supply orders,
  • Get your delivery documents,
  • Activate your product to the Fulfilment,
  • Manage the offers’ publication state.

If you need more information, please go to the Fulfilment section of the documentation or contact our support via the help section of your Seller Shop.

In order to continue improving the referencing of products on the website, the product kind (Standard or Variant) will depend on the category (Ex : Variant compulsory on clothing).
Categories can accept product kind this way :

  • Standard only
  • Variant only
  • Standard or variant

This control was manual in the past, it will soon be automated.
The list of authorized product kind by category will be available in the GetAllowedCategoryTree and GetAllAllowedCategoryTree with the attributes CategoryTree.IsStandardProductKindEligible / CategoryTree.IsVariantProductKindEligible.
Products that do not comply with the rules will be rejected with a message like “Nature of product : Variant mandatory on this category, please fill Parent sku, size and marketing color” and can be consulted in the method: GetProductPackageSubmissionResult.

New payment

From October, CDISCOUNTPRO customers will be able to choose to pay their orders by Bank Transfer, in addition to payment by card. This new option has no impact on the API orders flow.
Here is the principle :

  • Once the order is accepted (OrderStateEnum = AcceptedBySeller »), and after the accounting service validates the payment, the order status will change to « To be shipped » (OrderStateEnum = WaitingForShipmentAcceptation).
  • Please note the validation phase of the Cash Transfer payment can last up to 15 days. After 15 days, if the customer’s payment is still not validated, the order will be canceled automatically (OrderStateEnum = AutomaticCancellation).

GIVE US YOUR OPINION !

We appreciate your business and want to make sure we meet your expectations. Please help us by taking a few seconds to tell us about the service that you have received so far by filling the survey here

NEWSLETTER SUBSCRIPTION

To make sure you receive our next API newsletters, please register ►here

August 2017


Best practise

Read advices of our catalog esperts to improve the quality of your produtcs and increase not only the visibility, but also the referencing and the conversion rate of your offers. Find here the tutorial page that will give you all the details needed.

BEFORE: Your customer discussions’ answers that were not sent from the Seller Shop were not flagged as answered.
FROM NOW: All your answers are taken into account, even if your answers are sent from your own email client tool.

To ensure you propose the best offer on Cdiscount Marketplace, we have added a new “BestOfferPrice “ attribute on the offer benchmark. This new flag is available by using the GetOfferListPaginated API method, within the OfferBenchMark xml tag.

SATISFACTION SURVEY

Please help us by taking a few seconds to tell us about our API. We appreciate your business and want to make sure we meet your expectations

NEWSLETTER SUBSCRIPTION

To make sure you receive our next API newsletters, please register

July 2017


Fulfilment API

The marketplace API is now your unique access to manage your Fulfilment activity. This means that if you already work with the CreateExternalOrder, GetExternalOrderStatus, GetProductStockList method, you just have to change your SOAPAction by “https://wsvc.cdiscount.com/MarketplaceAPIService.svc”

In addition, the new GetFulfilmentOrderListToSupply, and methods are already available for use, and will be completed soon by supply order management.

All documentation and the activation planning are already available on our API website

API Performances

To always provide you with the more stable and available platform, we have worked on enhancing the response time of our orders management methods.

Best Offer

A new parameter will be added in return of the GetOfferListPaginated method to help you identify if you are proposing the best Cdiscount Marketplace offer.

June 2017


API Connection

Please have a special attention on the login used by your system or by your aggregator. This login need to be ended by “-api”.
If it is not the case, you still have few days to replace your login by the specific API login. To do it, go to you SellerShop (Settings > Your personal settings and bank details).

Fulfilment API

The existing API methods will be enhanced by new methods enabling you to manage your supply order, products’ activation, Fulfilment On demand orders acceptation or downloading of the delivery documents.
Moreover, to provide a complete API, Fulfilment and Marketplace methods will be merged into a unique API.

Do not miss Cdiscount sales!

  • Millions of visitors who come to track down offers on sales
  • Millions of products sold during this period
  • Increased visibility of your offers thanks to a different signage

Find out how to parameter your offers with the API here (page 6).

May 2017


RSS Feed

By subscribing to our RSS feed, you will stay informed and will not miss any upgrates or incidents on our API.
For more information, click here

Code Github

Thanks to this .Net Core web application you can interact with our API sending parameters and visualize the xml request and responses.
Do not hesitate to contribute here, your feedbacks are important to us !

Cdiscount PRO Marketplace

Our new business-to-business CdiscountPRO Marketplace has been launched in April ! Get ready and find the available methods to publish your offers on our new website. You can now create new offers and copy existing catalogs.
Subscribe to Cdiscount PRO and click here to find the method that fits with your business.

Fulfilment API methods

To provide a single access point to all the different API methods available on Cdiscount Marketpalce, we are going to merge our Fulfilment methods within the Marketplace API.
If you are already using the Fulfilment API, we will contact you soon to give you information about the détails of the migration plan.

Sellers Day

The API team thanks all the sellers who have attends the Cdiscount Sellers Day !
We were glad to meet you and to exchange with you. We hope that we have answered all your questions.
Do not hesitate to contact our team here

April 2017


Cdiscount PRO

Our new business-to-business CdiscountPRO Marketplace will open in April ! Get ready and find the available methods to publish your offers on our new website. You will be able to create new offers and copy existing catalogs.
Subscribe to Cdiscount PRO and click here to find the method that fits with your business.

New API method

Thanks to a bar code (EAN), the new API method GetProductListByIdentifier will help you find the main attributes of a product : URL of the main image, description, category code, brand, size, color, Product family, product type (standard or variant).

Merge of the Fulfilment API methods

To provide a single access point to all the different API methods available on Cdiscount Marketpalce, we are going to merge our Fulfilment methods within the Marketplace API.
If you are already using the Fulfilment API, we will contact you soon to give you information about the details of the migration plan.

Cdiscount Sellers Day

The API team will be present at the Cdiscount Sellers Day on April 7th in Paris. We will be glad to meet all of those who will attend the event! Come meet us on our booth!

March 2017


APIConnectionsSecurity

We recommend you to check your system or your integrator has properly set up the login and password dedicated to the API.
If not, your sensitive data are not protected.

Manage your commercial gesture

You will have access soon to a new method called “CreateRefundVoucher”. It replace the previous method “CreateRefundVoucherAfterShipment”.
By using this new method you will be able to make commercial gestures. In addition, you will have access to the list of Commercial Gesture vouchers through the “GetOrderList” : the Orders Datatype will integrated a new tag .
This tag will include all information related to the vouchers on an order : Date, Amount, Motive ID and Source.
Check our Roadmap section on the API website to learn the launch date.

Example of SDK use

A SDK is now available to help you manage your interface.
It is a guide which will provide you directions for use.
Also, this SDK will help the sellers and / or the internal professional to use the API without the need of coding.
Do not hesitate to contribute !

Product Xml Schema definition

In order to validate your product package, please find in our documentation website the Xml Schema definition.
it will allow you to validate your xml structure before moving up to the package submission. Moreover, you will save some precious time ! Do not hesitate to give us your feedback on this subject.

Roadmap prioritization

All the API team thanks those who have already responded. All your feedbacks are very constructive and will help us concentrate our efforts on your needs.
For the others, please, note that the form remains available here

Automation

To allow a better referencing of the products on the website, some specific properties are mandatory depending on the category. (Ex: Genre for luggage). for several months, this control was manual. It will soon be automated.
The list of mandatory specific properties will be available in the GetModelList method. Products that do not comply with the rules will be rejected with a message like Property specific {property field} : Required field, please enter data and can be consulted in the method: GetProductPackageSubmissionResult.

February 2017


Roadmap

To meet your needs at best we would like to take into account your opinion in our roadmap prioritization.
Please share with us your ideas and suggestions here.
Thank you !

Assistance planning

You can now schedule a call or a skype meeting with a dedicated technical support here.
Try this new service and benefit from live exchange with our experts and API tips to speed up your developments.

Website safety

In order to offer our customers an optimal safety and to keep our website well references, a project is in progress to enhance the safety or our website.
Main consequence: it is not possible to publish anymore HTTP urls on your product sheets HTTPS urls only will be viewable.
please note the existing product sheets will be updated accordingly and the product sheets’ four main images are not concerned.

Good news !

To facilitate interactions with our systems and to offer an easier way to work with our API, we have recently put at your disposal our latest SDK PHP here.
This SDK is now available on Github. This SDK will help you set up and update each in-coming improvement.
You are also welcome to join the GitHub community and to be part of the continuous improvement of your SDK.

Automation of mandatory specific property by category control

To allow a better referencing of the products on the website, some specific properties are mandatory depending on the category. (Ex: Genre for luggage). for several months, this control was manual. It will soon be automated.
The list of mandatory specific properties will be available in the GetModelList method. Products that do not comply with the rules will be rejected with a message like Property specific {property field} : Required field, please enter data and can be consulted in the method: GetProductPackageSubmissionResult

.