FAQ

Please refer to the section : How to connect for the first time to the API

The timeout mainly relate to filters and IP restrictions. Check your filters in your queries and send us your server IP if do not already. The environment preproduction is not always available. Please refer to the section : Availability planning of the test environnement

The token is your access key. It authenticates you to the API.

It is accessible via the URL STS. It is necessary to encode its password idenfiants base 64 as mentioned in the documentation for it,

Each token is valid during 48 hours.

You can create multiple tokens during the same period, they will have different periods of validity.

There are two types of accounts:

• Seller account
• API account.

Seller account is use to seller space and API account (created automatically from your seller account) is only for communication with Cdiscount API. It consists of the seller login and a suffix "-api"

For safety reasons, the support team can not provide login or passwords to sellers.

If you have access to your seller space, you can reset your API password  by using the following link : https://seller.cdiscount.com/Seller_parameters.html

Before change your password, you must stop to send API calls as they try to connect with the old password which will block the account immediately.
In the same way, if you work with an integrator, please inform them before any password modification.

If you have access to your seller space, you can reset your password (seller account) via this URL: https://seller.cdiscount.com/ForgottenPassword.html

Please note you must use your login and not your e-mail.

The reset password unlock your account and send you a new password by email (the same one as configured in your seller space), remember to check your spam box.

We offer you a specific API for simulate the order process in our production environment.
You can simulate several order processing scenario

The sent files must follow a specific structure. You can find full examples by browsing this site.

The files must be made available in a storage space accessible to our systems

You can book an appointment with our engineer on our new online planning available here : book an appointment

To meet your needs at best we invite you to express us of your opinion and your suggestions : Your suggestions

If you do not remember of your password anymore, click on the link "Forgotten password "  upon connection to your seller's interface or checkout this link : https://seller.cdiscount.com/ForgottenPassword?language=en-GB . Fill in your seller ID.  A recover email link will be sent to you on the email provided upon registration. This email notification takes a few minutes to appear on your mail box. Wait until you have received the email and check your spam or unwanted mail folders if it takes time to arrive.       3.  Click on the link and fill your password Your password must contain eight characters including one special character and one number . For example: @motdepasse12 / motdepasse1!2     A confirmation email changing your password will then be sent to all email addresses saved in your Seller Store . Don't forget to communicate this new password to your integrator feeds manager and all of the members using the platform. If you still have difficulties, you can still open a case to the seller support.  Please note : if you enter 3 times in a row a wrong password, your account's access will freeze, you would need to click on "Forgotten password" and start over.   
https://cdiscount.secure.force.com/ssc/articles/en_US/FAQ/How-to-recover-your-password

You can find below urls in order to test your API connection :

In your production environment :

• Authentication service in production : https://sts.cdiscount.com
• API in production : https://wsvc.cdiscount.com
• Sellershop in production : https://seller.cdiscount.com

In your preproduction environment :

• Authentication service in preproduction : https://sts.preprod-cdiscount.com
• API in preproduction : https://wsvc.preprod-cdiscount.com
• Sellershop in preproduction : https://seller.preprod-cdiscount.com

The test environment that we offer you is based on our preproduction here.

Your IP address must be whitelisted before you can use this environment, if it has not been done yet you can send us your IP address form your Help section of your seller's zone.
Your ticket must be assign to our API Team.
Your credentials will be the same on both environments.

It is therefore subject to weekly update for the deployment of new fixes and features.

As such the test environment may be unavailable one to two days per week. Generally this is Wednesday.

Please check the availability planning here : Planning

The synchronization of the production and pre-production takes place every Tuesday, all your pre-production data will be replaced by production every Tuesday

Your seller and API account will be available from next Wednesday following your account creation (see synchronisaton). If you need an account quickly please use our ticketing system, that is accessible through the “Help” menu on the header of your interface

They will give you an earlier access. This account will be deleted during the next synchronization.

Important: When you reset your API or Seller password, make sure that there is no ongoing use of your API, otherwise your API or Seller account could be locked.

To recover your API or Seller password:

1. Go to your home page of your Seller:
- In production: https://seller.cdiscount.com/login
- In Pre-production: https://seller.preprod-cdiscount.com/login

2. Click on the link Forgotten password;

3. When, you will be connected to this page: https://seller.cdiscount.com/ForgottenPassword
- If you filled your Seller identifier (for example: demo) -> you will received an email containing a link to a webpage to change your Seller password (your API password will not be modified)
- If you filled your API identifier (for example: demo-api) -> you will received an email containing a link to a webpage to change your API password (your Seller password will not be modified)

This email will be send to your email address that you have filled during your creation of Seller and API account. If you don’t receive this e-mail, assure, that it is not in your spams or otherwise ask to your network manager to verify if this e-mail is not a part of his blacklist.

4. Personalize your API or Seller password with the link you received by e-mail.
Your password must contain between eight and fifteen characters including one special character and one number.
Example: @motdepasse12 / motdepasse1!2

5. If you are working with an integrator, give him your API username and password and ask him to use them to connect to your Cdiscount account.

If you need to retrieve your API user ID or your password in your seller area >Settings>Your personal settings and bank details>Change your API connection settings. Retrieve your user ID (e.g. login-api)
- Click on Reset your API password. You will receive the temporary API password at the email address entered in your seller area.
- Change this temporary API password for a more suitable password in this same tab (Change your API login settings).
- Finally send your API user ID to your service provider and ask them to log into your Cdiscount account.

Our quotas are set up for optimum performance in all of our sellers and secure use of our systems.

Quotas are defined by method, per hour and per seller account. They are suitable for all sellers profiles.
If exceeded, you have to wait an hour to make a new call.

You waited an hour and it is still not available?
Sometimes exceptionally synchronization quotas fails, Please try again later.

In the test environment, it is possible exceptionally and temporarily increase the quota of few targeted methods.

The quota of each method is not communicated.

If you encounter difficulties on the development of a method, please contact the technical support by using our ticketing system, that is accessible through the “Help” menu on the header of your interface
Thank you to provide XML files of the SOAP request (call and response) and clearly detailing your request.
These files are required to analyze your issue.

If you have made a commercial gesture or a refund but the customer disputes its receipt, we invite you, as a first step, to check that the action has been taken into account on the order concerned, in the " Orders " section of your sales space.   If this is the case, you must ask the customer to contact Cdiscount customer service 0970 809 050
https://cdiscount.secure.force.com/ssc/articles/en_US/FAQ/How-do-I-know-if-the-customer-has-received-my-commercial-gesture-or-my-refund

These are Ips output of Cdiscount :

• 62.122.8.8
• 81.252.251.70
• 193.27.194.3
• 213.56.76.189
• 62.122.15.8
• 62.122.8.21
• 62.122.15.21
• 62.122.8.24
• 62.122.15.24

You can find here properties of SOAP Web Services to respect :
- The parameters are case sensitive: You need to respect upper and lower case characters.
- You have to put all attributes out of the header message of each request method xml in alphabetic order.
You have to take care about this order in order to not have this error message in your response xml : OrderStateIncoherent => Le champ One or more field are incorrectly filled. Could be CarrierName, TrackingNumber et TrackingUrl de la commande n'est pas renseigné ! . Example given for the method ValidateOrderList
- The expected value by the parameter is specified in the file SmoBridge.php (Example: Login: xsd:string).
- When several parameters concern the same information, a search algorithm processes the parameters one by one and in a precise order until the corresponding record is found. If the record is not found, an error will be returned and the processing is stopped.
- To avoid errors during the data entry of the parameters, use the Cut & Paste function from the request xml for each method.
- Date type parameters: Respect the date format used in the country of the user connected to our API.
- Label type parameters: Enter the defined labels in the language of the user connected to our API (here: in French).

We offer you a specific API for simulate the order process in our production environment.
You can simulate several order processing scenario

You need to replace the special character & by & in order to shipped your order using our API method ValidateOrderlist.

For example, this wrong tracking url https://www.mywebsite?num=1234567890147&cid=dhlt will be replaced by https://www.mywebsite?num=1234567890147&cid=dhlt

As long as the order is not accepted, the customer can cancel it at any time. Once you have accepted the order, the customer can make a cancellation request. Then you will receive a notification by email inviting you to validate his request. The commission will be refunded automatically within 30 days. If the client has opened his request within the wrong type of case, we invite you to suggest the client to open the correct cancellation request via his seller's space. If you refund and cancel an order on his behalf you can see your indicators impacted. If by mistake you accept this request but the order has already been shipped, we invite you to contact your carrier to make him return the product or ask the customer to refuse delivery.
https://cdiscount.secure.force.com/ssc/articles/en_US/FAQ/What-if-the-customer-cancels-his-order

You can now ask to our API service from your seller's store here heading 'Help/Contact us', a request in order to have some test orders in your preproduction environment.

To do so, you need to fill fields and clic to the button 'New Case' like explained below

You can find here scenarios Marketplace: order processing on the API (GetOrderList and ValidateOrderList).

The sent files must follow a specific structure. You can find full examples by browsing this site.

The files must be made available in a storage space accessible to our systems

Your offers package must be built by this way :

1. Two folders call :
1. _rels with the file .rels without extension xml;
2. Content with the file Offers .xml (it is the file to be completed for creation or updates);
2. A file named [Content_types].xml

Do not put these two folders and this file in an other folder.

You have to include between 10K and 20K products in your products package in zip format.

The sent files must follow a specific structure. You can find full examples by browsing this site.

The files must be made available in a storage space accessible to our systems

Your products package must be built by this way :

1. Two folders call :
1. _rels with the file .rels without extension xml;
2. Content with the file Products.xml (it is the file to be completed for creation or updates);
2. A file named [Content_types].xml

Do not put these two folders and this file in an other folder.

The method GetDiscussionMailList allows you to obtain an encrypted mail address about a discussion.
This operation allows getting an encrypted mail address to contact a customer about a discussion (claim, retraction, questions).

The method GenerateDiscussionMailGuid allows you to obtain an encrypted mail address.
This operation allows getting an encrypted mail address to contact a customer about an order.

This error message means :
- You probably using an incorrect PackageId ;
- You probably also get a products or offers report in your pre-production environment and not in your production environment ;
- Your packageId of your products package must be associated to the GetProductPackageSubmissionResult method and not an GetOfferackageSubmissionResult method.

This error message means :
- Your products or offers package zip must be structured like those in our API documentation ;
- Your package must contains an error about the structure of your package or an error in your xml file.

This error message means that the given data does not match the expected size.

This error message means that you have to filled the attribute in your offers package zip.
You can find example here in our API documenation.

This error message means that you can't update your orders.
You have to take care about the structure of our API method ValidateOrderList.

This error message is return automatically when you have some errors in your offers or products package zip.

That's why, we will need to analyze your package in our side in order to communicate later about your errors message.

These error messages could be :
- Your offer or product package with a bad format ;
- Missing fields in your xml file