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. All about our test environment (Preprod)
     

    The test environment that we offer you is based on our preproduction. 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 134 Times
  • 2. 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 69 Times
  • 3. 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 40 Times
  • 4. 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 34 Times
  • 5. Give us your IP(s)
     

    To access the API you have to send to technical support your 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 34 Times
  • 6. 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 55 Times
  • 7. 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 32 Times
  • 8. 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 33 Times
  • 9. 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 51 Times
  • 10. 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 62 Times
  • 11. Account locked in loop
     

    You must reset them in your seller interface, here : Https://seller.cdiscount.com/Seller_parameters.

    It is important that your attempts to connect to the API are stopped before resetting, otherwise your account may be re-locked immediately.

    If you are working with an integrator, contact him beforehand to stop automatic flows or this will systematically lock your account.

    Was this answer helpful ? Yes / No
    Viewed 18 Times
  • 12. 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 17 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 129 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 19 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 16 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 25 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 51 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 62 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 62 Times
  • 2. 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 3 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 10 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 18 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 11 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 7 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 6 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 8 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 8 Times