FAQ

  • 1. Get started and authentification
  • 2. Global informations
  • 3. Order
  • 4. Offer
  • 5. Product
  • 6. Discussion
  • 7. Error messages
Expand All | Collapse All
  • 1. How can I start with the API ?
     

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

    Was this answer helpful ? Yes / No
    Viewed 77 Times
  • 2. I obtained a Timeout issue
     

    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

    Was this answer helpful ? Yes / No
    Viewed 56 Times
  • 3. Give us your IP(s)
     

    To access the API you have to send to technical support your public IPs by using our ticketing system, that is accessible through the “Help” menu on the header of your interface
    Then we add these IPs to the allowed IP list.

    You can not access the API until the IPs of your servers are not in our database.

    Was this answer helpful ? Yes / No
    Viewed 84 Times
  • 4. What is a Token
     

    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.

    Was this answer helpful ? Yes / No
    Viewed 261 Times
  • 5. Which login to use for API connection
     

    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"

    Was this answer helpful ? Yes / No
    Viewed 65 Times
  • 6. Recover and change password
     

    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.

    Was this answer helpful ? Yes / No
    Viewed 108 Times
  • 7. How to simulate orders
     

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

    Was this answer helpful ? Yes / No
    Viewed 80 Times
  • 8. Recommendation for working with files and product offers
     

    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

    Was this answer helpful ? Yes / No
    Viewed 82 Times
  • 9. Support information
     

    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

    Was this answer helpful ? Yes / No
    Viewed 32 Times
  • 10. All about our test environment (Preprod)
     

    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.

    Was this answer helpful ? Yes / No
    Viewed 265 Times
  • 11. Account locked in loop
     

    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.

    Was this answer helpful ? Yes / No
    Viewed 44 Times
  • 12. API connection user ID and password
     

    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.

    Was this answer helpful ? Yes / No
    Viewed 223 Times
  • 1. Quotas
     

    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.

    Was this answer helpful ? Yes / No
    Viewed 206 Times
  • 2. In case of issue, how to contact our support
     

    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.

    Was this answer helpful ? Yes / No
    Viewed 39 Times
  • 3. Ip output Cdiscount
     

    These are Ips output of Cdiscount :

    • 62.122.8.8
    • 81.252.251.70
    • 193.27.194.3
    • 213.56.76.189
    Was this answer helpful ? Yes / No
    Viewed 33 Times
  • 4. Tag and attributes case
     

    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).

    Was this answer helpful ? Yes / No
    Viewed 58 Times
  • 1. How to simulate orders
     

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

    Was this answer helpful ? Yes / No
    Viewed 80 Times
  • 1. Recommendation for working with files and product offers
     

    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

    Was this answer helpful ? Yes / No
    Viewed 82 Times
  • 2. How to built an offers package in zip format ?
     

    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.

    Was this answer helpful ? Yes / No
    Viewed 12 Times
  • 1. How many products can I put in my products package in format zip ?
     

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

    Was this answer helpful ? Yes / No
    Viewed 14 Times
  • 2. Recommendation for working with files and product offers
     

    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

    Was this answer helpful ? Yes / No
    Viewed 82 Times
  • 3. How to built a products package in zip format ?
     

    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.

    Was this answer helpful ? Yes / No
    Viewed 11 Times
  • 1. Difference between GetDiscussionMailList and GenerateDiscussionMailGuid
     

    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.

    Was this answer helpful ? Yes / No
    Viewed 20 Times
  • 1. "CdiscountApi.CdiscountAPI.ErrorTypeEnum.SellerNotAuthorized "Vous n'êtes pas autorisé à récupérer les rapports d'intégration d'autres vendeurs."
     

    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.

    Was this answer helpful ? Yes / No
    Viewed 59 Times
  • 2. "Specified part does not exist in the package"
     

    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.

    Was this answer helpful ? Yes / No
    Viewed 35 Times
  • 3. "Commentaire offre : Taille de la donnée incorrecte, vérifiez la taille attendue"
     

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

    Was this answer helpful ? Yes / No
    Viewed 28 Times
  • 4. Offers without shipping information list
     

    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.

    Was this answer helpful ? Yes / No
    Viewed 33 Times
  • 5. "Unknown exception was thrown during validating identity token"
     

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

    Was this answer helpful ? Yes / No
    Viewed 36 Times
  • 6. "Le fichier d'intégration des produits soumis ('xxx.zip') a été intégré dans un précédent appel ! Il n'est pas possible de soumettre plusieurs fois le même fichier"
     

    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

    Was this answer helpful ? Yes / No
    Viewed 54 Times