API changes from 06.09.2016
Dear sellers/partners,
Following our previous communications, we would like to inform you about new processus concerning Offers and Orders updates from September 6th 2016.
The current version will be out-of-service from end of September. So you will have 1 month to switch to the new version.
Please find the API Documentation updated here : http://marketplace.cdiscount.com/espace-developpeur/
____
1$^{st }$step: already available
New process to validate orders: CarrierName, TrackingNumber + GetGlobalConfiguration
In the context of continuous improvement of the information delivered to the customers, we make the « Carrier » and «Tracking number » fields’ mandatory. The tracking link becomes an option and is no longer mandatory.
Carrier’s field can be filled as below :
- Select from the list your carrier (recommended)
- Fill yourself the name of the carrier
The tracking link is now standard and optional. If you decide to use it, it must start with https:// or http:// and not exceed 255 characters.
Field tracking number cannot exceed 50 characters and won’t allow the following symbols : “ “ , (space), &, * and $.
This information will be passed to the customers, a wrong or fake input will prevent the customer from following the product and he will receive wrong information from your side.
Through webservice / API :
Fields that are being affected are CarrierName, TrackingNumber and TrackingUrl in the method ValidateOrderList.
To access the pre-defined carriers list for the CarrierName, a new method is now available GetGlobalConfiguration– see attachement.
oooThis selection can be updated regularly in order to offer new carriers.
___
2$^{nd}$ step: available from September 6th 2016
Time of Order Preparation : PreparationTime
This preparation time should be defined for each of your offers, in a range between 1 and 10 working days. It will be completed by a transport time previously defined by Cdiscount depending on your country of shipment, as follows:
| Catégories | France | Europe | Hors Europe |
|---|---|---|---|
| Standard Package | 2/4 days | 2/7 days | 5/15 days |
| Voluminous Package | 2/7 days | 3/10 days | 5/15 days |
| Point retrait | 2/4 days | 2/7 days | - |
| Express* | 1 days | 2 days | 3 days |
- For this delivery mode, PreparationTime are not added. Cut-off : 2pm CET
This innovation will allow you to focus on the estimation of your preparation times, and rely on transport times in compliance with the market standards. The minimum and maximum delivery time you currently fill will no more be then available.
Through webservice / API :
That means you have to substitute the Min/MaxDeliveryTime attributes by PreparationTime in the method SubmitOfferPackage – see file attached
Please note it isn’t possible to fill at the same time Min/MaxDeliveryTime and PreparationTime for a same offer.
Furthermore offers changes from Min/MaxDeliveryTime to PreparationTime are definitive (roll-back to Min/MaxDeliveryTime are impossible).
3$^{rd}$ step: available from September 6th 2016
New Delivery Mode : Express, BigParcelEco, BigParcelStandard, BigParcelComfort
From this date, the use of this new preparation time will also allow you to benefit from 4 new delivery mode :
- Express
- Eco, Standard and Comfort for your large parcels (*)
To do so, go in the screen " Your shipping choices" of your SellerShop, available from the "Settings" menu from September 6th
For API users, you should integrate the preparation time for all your offers before the end of September 2016. You can make your first tests from August 30th, 2016 by using the dedicated environment. Note : the setting of the preparation time is mandatory for the use of the new delivery mode listed above. The technical documentation of the API is available by following this link.
()Large parcels: the weight of the parcel is greater than 30kg and/or the sum of the dimensions of the parcel is greater than 2 meters.*
Through webservice / API :
New DeliveryMode are available in the methods SubmitOfferPackage and Get/ValidateOrderList – see file attached
In the SubmitOfferPackage in order to define if a package is heavier or lighter than 30kg you will have to:
-
30kg: at least fill the mode BigParcelEco (+ BigParcelStandard and/or BigParcelComfort if ticked in sellershop
- <30kg: at least fill the tracked mode and the registered (+ standard if ticked in the seller space)
Pickup points and express delivery modes can be used for >30kg and <30kg.
It won’t be possible to set up simultaneously delivery modes for >30kg and <30kg.
Ex : It’s not allowed to set up Tracked and BigParcelEco on the same offer/SKU.
4$^{th}$ step : available Octobre 2016
Tracking information recovery
Cdiscount is developing connections with Carriers in order to get back the tracking info of your packages to show to the customer. The benefit would be to decrease the number of questions/ claims raised by the customer about tracking number to the seller
This information of tracking will be also available in the Sellerspace and it will be possible to get them into the API through the method GetOrderList
An update of the API documentation will be online in September with the new field
____
If you have any request about this API changing, please create a ticket on : **https://sellercontactform.cdiscount.com** chosing :
- Help Topic : OFFERS
- Request Type : Problem of Update
- Application : API Clemarche
- Issue Summary : API PreparationTime changes
Attachments: