Een Cdiscount API opzetten

Goed om te weten voordat je begint

Cdiscount is een Franse marktplaats waar je producten kunt verkopen op basis van een cost per sale-model (CPS-model). Houd rekening met de volgende voorwaarden bij het verzenden van product listings naar Cdiscount:

1. Je hebt een Cdiscount-account nodig.
2. Voor alle producten moet je geldige EAN-codes hebben.
3. Je productinformatie moet in het Frans worden doorgegeven.
4. Als je al eerder producten hebt verkocht op Cdiscount, stel dan in de Instellen-stap van de API de "unieke id per product" in op de code die je eerder ook al gebruikt bij Cdiscount.
5. Je kunt de staat van jouw producten (nieuw, goede staat, als nieuw etc ..) opsturen in de Attributen-stap door de kolom "Sous-état" in te vullen met de geaccepteerde waarden (Bon état, Comme neuf, État correct, Neuf, Reconditionné à neuf, Très bon état).
6. Het is niet mogelijk om product listings te verwijderen van Cdiscount, ze kunnen alleen uitgeschakeld worden door de voorraad op 0 te zetten. Dit kun je via Channable instellen door middel van een regel. 

Stap 1: Zoek de API gegevens op in Cdiscount

Bij het koppelen van Channable met Cdiscount dien je een gebruikersnaam en wachtwoord van Cdiscount in te voeren. Ga in Cdiscount naar Settings > Your personal settings and bank details > Connection Informations om je API-inloggegevens te vinden. 

Stap 2: Maak een nieuwe Cdiscount API in Channable

Ga naar Channable, open je project en ga je naar [je naam rechtsboven] > Koppelingen > Koppeling toevoegen. Wanneer je klikt op ''Koppeling toevoegen+'' krijg je dit scherm te zien, waar je Cdiscount kunt selecteren:

Wanneer je Cdiscount hebt aangeklikt, krijg je het scherm zoals hieronder te zien. Vul onder ''Label'' een naam in voor de koppeling, en onder Cdiscount username en Cdiscount password vul je de gebruikersnaam en wachtwoord van Cdiscount in die je in stap 1 hebt opgezocht. Zorg ervoor dat je de API-gebruikersnaam en het API-wachtwoord gebruikt, niet de gebruikersnaam en het wachtwoord waarmee je bij Cdiscount inlogt. Klik vervolgens op ''Maak aan'' om de koppeling op te slaan.

Nu je de koppeling met Cdiscount hebt aangemaakt in Channable ga je naar jouw project in Channable en klik je op APIs in de linkermenubalk. Klik vervolgens op ''+ API koppeling toevoegen'' en dan zie je de net aangemaakte koppeling met Cdiscount staan. Klik op de koppeling en het scherm zoals hieronder weergegeven verschijnt. Vul de volgende instellingen in: Naam, Unieke ID per item, en eventueel Gebruik master regel groep. 

Stap 3: Bouw je product listings!

Het bouwen van product listings gaat simpel en snel met onze standaard-template. Je kunt een productvermelding aanmaken door de volgende vier stappen in de Cdiscount API te volgen.

1. Categorieën
   We raden je aan te proberen je producten eerst zonder categorieën door te sturen. Als de EAN codes van jouw producten al bekend zijn in de Cdiscount database hoef je namelijk geen categorieën in te vullen. Als de producten nog bekend zijn in de database krijg je in de Bekijk stap uiteindelijk een foutmelding te zien genaamd "1300 - Inexistant - Demandez la création dans la rubrique « Création produit »". Lees in ons support artikel hoe je deze foutmelding vervolgens kan oplossen.
   
   
2. Regels
   Maak verschillende regels aan om je productdata te optimaliseren. Voor voorbeelden kan je naar ons helpcenter artikel gaan over veel voorkomende regels.
   
   
3. Opbouw
   Hier kan je standaard template vinden voor het aanmaken van productvermeldingen. Het enige wat je hoeft te doen is op de velden te klikken en de juiste te selecteren. Het veld 'Title' moet bijvoorbeeld de titel van het product weergeven enzovoort. 
   
   Tip! Let op het vraagteken achter elk veld. Wanneer je je muis op het vraagteken plaatst, zie je de beschrijving van het veld en suggesties voor mogelijke waarden.
   
   In de Opbouw zie je meerdere tabbladen. Let bij het instellen van de informatie in het tabblad item goed op de volgende zaken:
   
   • Beschrijving: De beschrijving mag maximaal 420 characters bevatten en mag geen HTML bevatten (gebruiker hiervoor de maximale lengte regel en de bewerkt tekst regel)
   • Korte label: Hierin zet je een korte versie van je titel die maximaal 30 karakters bevat
   • Lange label: Hierin zet je de uitgebreide versie van je titel die maximaal 132 karakters bevat
   • Franse taal: Alle velden moeten in het Frans ingevuld zijn
     
     
     Het volgende tablad dat je ziet is het prijs & levering. Hier kun je het veld met de prijs koppelen en de verzendopties selecteren die je aanbiedt, plus de verzendkosten voor die verzendopties. Nadat je de velden op deze pagina hebt ingevuld, zou het er ongeveer uit moeten zien als in de afbeeldingen hieronder.
     
     
     Wanneer je klaar bent met het opzetten van je productvermeldingen kan je deze opslaan door te klikken op ''Opslaan'' onderaan het scherm.
     
     
4. Attributen
   Je kan deze stap overslaan.
   
   

Stap 4: Stuur je product listings naar Cdiscount

Bijna klaar, je kunt nu je producten naar Cdiscount sturen. Zorg ervoor dat je je project hebt geactiveerd in Channable door in de tool naar Configuratie te gaan en daarna op "Activeer project" te klikken. Ga daarna naar APIs > "Cdiscount API Naam" > Instellen en klik daarna op "Activeren". Nadat je deze stap hebt voltooid, ga je terug naar het API's-overzicht en klik je op de blauwe knop "Uitvoeren" om de productvermeldingen naar Cdiscount te versturen.

Stap 5: Controleer je product listings op fouten

Wanneer de product listings naar Cdiscount zijn verstuurd, kan je bij Bekijk de voorvertoning van je Cdiscount-product listings zien. Klik op de tab "Fouten". Hier zie je welke advertenties fouten bevatten en niet geplaatst zullen worden op Cdiscount.

Error code "1300 - Inexistant - Demandez la création dans la rubrique « Création produit »"

Als je in de Bekijk stap de foutmelding "1300 - Inexistant" ziet betekent dit dat deze producten nog niet bekend zijn bij Cdiscount. Om deze foutmelding op te lossen kan je de stappen uit ons supportartikel Hoe voeg ik onbekende EAN codes toe aan Cdiscount.

Andere error codes

Als je een foutmelding met een andere code dan "1300" krijgt te zien kan je op de foutmelding klikken om meer info hierover te krijgen. Daarnaast kan je de Cdiscount documentatie nakijken om erachter te komen wat de error code inhoudt: https://dev.cdiscount.com/marketplace/?page_id=1896.

Checken of je producten in Cdiscout up-to-date zijn

Je kan checken of de producten die momenteel in je Cidscount account staan up-to-date staan door de stappen uit ons support artikel te volgen.