Newsletter

You can find on this page all the newsletters related to our APIs. If you want to subscribe to be informed of the next news, click on the button below:

Subscribe to our Newsletter

------------------------ DECEMBER 2022 ------------------------

Focus on Sales Process

Following the application of the omnibus law, the rules of the offer package for sales have been modified.
 
Sales will be activated automatically and only during official French Sales Periods (The 2023 winter sales will take place from Wednesday, January 11, 2023 to Tuesday, February 7, 2023).

Attributes settings:

<Type>=3

<DiscountUnit>=1
<Price>= current price
<SalesReferencePrice>= Price used to calculate the sales price.
<DiscountValue> = Discount to apply in %.

The discount will be applied on the attribute <SalesReferencePrice>

  Calculation : Sales Price = (<SalesReferencePrice> x ((100 - <DiscountValue>)/100)

The comparison price (<StrikedPrice>) and the current (<Price>) aren’t taken into consideration.
 
Please Note: The Sale will be displayed if the discount is 1% minimum based on the Previous Price (or 1€ if Price <100€).

You can download an exemple of a sales offer package here 
 

Picture

Picture

----------------------- SEPTEMBER 2022 -----------------------

New features available on the REST V2 API:

Here a the new feature of the REST V2 API :

  • Product Product creation is only available for sales channels. The teams are working to make the method compatible with Cdiscount. If you want to create products on Cdiscount you must use either the SOAP API or the Seller Zone.

  • Order V2

You can also find the functional documentation for V2 here.
 

Finally, you can download the Postman collection for the V2 API by clicking here.

--------------------------- April 2022 --------------------------

OCTOPIA SALES CHANNELS

We are pleased to inform you that the first sales channels have been integrated to Octopia. For the time being, only a few sellers are eligible to sell on the new sales channels, depending on the marketplaces's choices.  

These new sales channels integration have an impact on your API calls.

To summarise, you will be able to push, filter and get information concerning the sales channels:

1. SubmitOfferPackage:

Offer Management by sales channel (live on Casino from the 26/01/2022): Only the « full » offer package on « update » mode will be compliant to the sales channels.
 
Please see below the 2 available options to submit an Offer on Casino:  
 
1st Option: With the « PublicationPoolId »

              <OfferPackage.OfferPublicationList>
                            <OfferPublicationList Capacity="1">
                            <PublicationPool Id="25"/>
                            </OfferPublicationList>
              </OfferPackage.OfferPublicationList>

2nd Option: With the « PublicationPool SalesChannelId »

              <OfferPackage.OfferPublicationList>
                            <OfferPublicationList Capacity="1">
                            <PublicationPool SalesChannelId="CASIFR"/>
                            </OfferPublicationList>
              </OfferPackage.OfferPublicationList>

You can find the « PublicationPool Id » and « PublicationPool SalesChannelId » for each sales Channel in the table below

Please note:

  • The stock value published on Cdiscount will be replicated on other sales channels

  • If the offer package doesn’t include the OfferPoolId or SalesChannelId, the file will only be destinated to Cdiscount Marketplace

2. GetOfferListPaginated:
 
For Casino get the offer catalog thanks to the « SalesChannel ».
See the correct syntax below:

<offerFilter>
                <IncludeObsoleteOffers>true</IncludeObsoleteOffers>
                <OfferFilterCriterion>NewOffersOnly</OfferFilterCriterion>
                <OfferSortOrder>BySoldQuantityDescending</OfferSortOrder>
                <PageNumber>1</PageNumber>
                <SalesChannel>CASIFR</SalesChannel>
 </offerFilter>

N.B : Please respect the attributes alphabetic order.
 
To filter only on Cdiscount delete the SalesChannel attribute.
 
 3. GetOrderList:
 Apply a filter through the « CorporationCode » to get the orders by sales channel.

 <orderFilter xmlns:i=http://www.w3.org/2001/XMLSchema-instance>
                <BeginCreationDate>2021-03-25T01:44:39.227</BeginCreationDate>
                <BeginModificationDate>2021-03-25T01:44:39.227</BeginModificationDate>
                <CorporationCode>CASIFR</CorporationCode>
                <EndCreationDate>2021-04-01T08:44:39.227</EndCreationDate>
                <EndModificationDate>2022-04-01T02:00:00.00</EndModificationDate>
                <FetchOrderLines>true</FetchOrderLines> 
                <States>
                </States>
    </orderFilter>

N.B: Please respect the attributes alphabetic order.
 

Find below the corresponding attributes by Sales Channel:

Picture

To see more information regarding the Sales Chanels, click here

We will inform you as soon as the integration of the new sales channels is complete and let you know what the impact is on your API calls.

--------------------------- May 2021 ----------------------------

[REMINDER] LABELS AND DESCRIPTION MUST BE TRUNCATED BY YOURSELFHeading

Picture

From the 1st February, Cdiscount stops to truncate automatically Description and Label fields. The merchant / feed provider must do it itself otherwise products creation will be rejected.

Please find below the maximum characters for the following fields :

·       ShortLabel (= title in the cart) : 30 characters

·       LongLabel (= title on the product listing and sheet) : 132 characters

·       Description : 420 characters

·       EncodedMarketingDescription (Marketing Description) : 5000 characters

Note all these attributes are mandatory except EncodedMarketingDescription

[IMPORTANT] PRODUCT SHEET SUBMISSION LIMITS

Picture

We had during the last weeks an important increase of products package submission but a large part of them were not in phasis with what Cdiscount expect. The increase of submission causes error on Cdiscount product creation system.

Could you please follow these rules :

-          Do not resubmit already existing products

-          Do not resubmit products that have been already rejected and without changes

-          Do not send more than 1 package per hour

Do not send more than 10K products by hour

Important : if you don’t follow these rules, the Product team could reduce your quota until 100 SKUS by hour. If you have any questions/claims about this limitation, please open a ticket to…

[COMING SOON] PRODUCT SHEET MODIFICATION WILL BE AVAILABLE ON REST APIHeading

Picture

Cdiscount starts to develop this new API feature. And it should be probably available  in the 2nd semester. The merchant could modify the product sheet directly trough API if he is the product sheet creator

------------ December 2020 & January 2021 -------------

What's new?

Picture

Cdiscount plans to stop SOAP for end 2021.
We would like to know when you plan to migrate to our REST API.
Please, visit the API Portal and fill the form to let us know.

Visit the API Portal

It's time to...

Picture

November 2020

Picture

[REMINDER] Url tracking ID is getting mandatory

We would like to remind you that Cdiscount has asked its sellers to provide a tracking link for order validation since 1st of November. Indeed, the rate of customer contact is really less significant for tracked orders and therefore, customer satisfaction is higher.
There are two ways to fill in this field from the API:

  1. In the CarrierName field, fill in one of the bounded carrier names present in the GetGlobalConfiguration method (e.g. "La Poste - Courrier").

  2. And/or fill in the order tracking url link in the TrackingIdUrl field. Please note that the tracking links are subject to validity checks on our side.

  • For the specific case of dematerialized products: please select “Other” as CarrierName and fill out the Tracking number field with “DEMAT”.

  • Note “Standard” Shipping mode doesn’t need tracking information but this mode is not available for customers when the order amount is higher than €10.

Picture

[TIPS] Order filter managementHeading

In order to avoid any order cancellation due to a bad request during the Christmas time, we suggest you double-check from your side if orders have been well changed in “validated” or “shipped” status. Note double-check implementation is a prerequisite from your side for any order validation dispute.

Do not hesitate to do a GetOrderList method filtering by OrderReference and check if the orders are in “Shipped” status.

Furthermore, from now on, we advise you to retrieve orders over a wider time slot (90min): set the filter by date (BeginCreationdate and Begin ModificationDate) at least 90 minutes before for collecting orders in order not to forget any order.

Picture

[TIPS] Use different marketing tools on offer packageHeading

Would you like to highlight your offers for Black Friday and Christmas time? If you want to use Flash Sales, note you should put a maximum gap of 72 hours between StartDate and EndDate and the Discount (%) is based on the Price. You can get more general information on these marketing tools by following this link. You can click here if you want to get a sample of these tools.

Picture

October

2020

Picture

REST API is coming soon!

After months of development, we are finalizing the Cdiscount Marketplace REST API and we would like to know what you expect about the use of this new language.
We would really appreciate it if you could fill in this survey.
Only 4 questions for you, that’s really quick for you and important for us!

Picture

Url tracking ID

We would like to inform you that Cdiscount will be asking its sellers to provide a tracking link for order validation starting from 1st of November. Indeed, the rate of customer contact is really less significant for tracked-orders and therefore, customer satisfaction is higher.
 
There are two ways to fill in this field from the API:

  1. In the CarrierName field, fill in one of the bounded carrier names present in the GetGlobalConfiguration (Old version of API) method (e.g. "La Poste - Courrier").

  2. And/or fill in the order tracking url link in the TrackingIdUrl field. Please note that the tracking links are subject to validity checks on our side.

  • For the specific case of dematerialized products: please select “Other” as CarrierName and fill out the Tracking number field with “DEMAT”.

  • Note “Standard” Shipping mode doesn’t need tracking information but this mode is not available for customers when the order amount is higher than €10.

September

2020

Picture

Ticket for API support team

More and more merchants/partners contacted us to benefit from our advices! 250 calls have been done this quarter, if you need assistance, book for a call on the planning here.

Same trend via the ticket system. You’re 650 in Q2 (vs 500 in Q1). The average time for answering is under 2 days (40 hours). Do not hesitate to use it to contact us through your sellerzone: Help > Contact us > API.

Picture

Restricted Cellphones ean listing

Cdiscount has decided to streamline and improve the cellphones and product datasheets, starting with Apple and Samsung. We recently added MacBook and updated new references for other brands.

You will find here the list of Apple, Samsung and Huawei EANs and the corresponding sub-states that we will keep. Please note that it is one EAN per sub-state.

If you are concerned, please follow these steps:

  1. First, inform your 3rd-party solution in order to map the new EANs provided in the listing.

  2. Then, open a ticket in your Seller Zone: Help > Contact Us > Create or Modify your product sheets > Modify your product references / EAN Code