Een Cdiscount API opzetten – Channable

Wil je interactief alle basisprincipes leren met betrekking tot het maken van een API export, of wil je leren hoe je een geavanceerde API setup maakt in Channable? Leer via dit Helpcenterartikel hoe je een Channacademy-account aanmaakt in de Channable app en start met de Basic APIs of Expert APIs course.

Note: EAN-codes zijn verplicht voor Cdiscount. Zorg ervoor dat je geldige EAN-codes voor al je producten hebt, ander kan er geen advertentie worden aangemaakt.

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:

Je hebt een Cdiscount-account nodig. Je kunt er hier een account aanmaken: https://seller.octopia.com/login
Je productinformatie moet in het Frans worden doorgegeven.
Als je al eerder producten hebt verkocht op Cdiscount, stel dan in de Instellen-stap van de API het "unieke id per item" in op de id die je eerder ook al bij Cdiscount hebt gebruikt.
Het is niet mogelijk om product listings van Cdiscount te verwijderen, 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

In jouw Octopia account, vind je de API-gebruikersnaam en het API-wachtwoord, onder het kopje ""Settings > Your personal and banking data > Login settings":

Let op: Bij het maken van de kopeling moet je een Cdiscount gebruikersnaam en wachtwoord invoeren. Gebruik hiervoor je API-inloggegevens en niet de inloggegevens waarmee je inlogt bij Cdiscount.

Cdiscount - 1.png

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:

Cdiscount - 2.png

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.

Cdiscount - 3.png

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.

Let op: Als je al eerder producten hebt verkocht op Cdiscount, stel dan in de Instellen-stap van de API de "unieke id per item" in op de id die je eerder ook al gebruikte bij Cdiscount. Wanneer je de naam en unieke ID per item hebt ingesteld kan je op "Volgende" klikken om de API aan te maken.

Cdiscount - 4.png

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.

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.
Note: 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.
Regels
Maak verschillende regels aan om je productdata te optimaliseren. Voor voorbeelden kan je naar ons helpcenter artikel gaan over veel voorkomende regels.
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. Raadpleeg dit helpcenter artikel voor alle beperkingen en vereisten die door Cdiscount worden opgelegd.

Note I: Als het producttype is ingesteld op "Variant", is het veld "Kleur" verplicht voor alle varianten.

Note II: Het is verplicht om een prijs en om de verzendmethoden die je ondersteunt (in "Prijs & levering") in te vullen. Cdiscount heeft als vereiste dat je de verzendmethoden selecteert die je ondersteunt, met in ieder geval de 'tracked' en 'registered' verzendmethoden. Producten die zonder prijs worden geëxporteerd, worden geweigerd door Cdiscount, zelfs als de API geen foutmelding geeft. Meer informatie over de verzendmethoden vind je in dit helpcenter artikel.

Note III: Volgens de wet AGEC is het nu verplicht om het bedrag van de milieuheffing voor elektrische & elektronische apparatuur (WEE) en meubelstukken (WFI) weer te geven. Lees voor meer informatie dit artikel op Octopia.

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.
Het volgende tabblad dat je ziet, is het prijs & levering. Hier moet je het veld met de prijs koppelen en de verzendopties selecteren die je aanbiedt met, in ieder geval de 'tracked' en 'registered' verzendmethoden, plus de verzendkosten voor die verzendopties.
Wanneer je klaar bent met het opzetten van je productvermeldingen kan je deze opslaan door te klikken op ''Opslaan'' onderaan het scherm.
Attributen
Vervolgens moet je de attributen per categorie invullen in het tabblad "Attributen ". Een meer gedetailleerde uitleg van wat je moet doen in de Attributen stap kun je vinden in ons Attributen helpcenter artikel.

Stap 4: Stuur je product listings naar Cdiscount (Octopia)

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 (Octopia) 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 Octopia account staan up-to-date staan door de stappen uit ons support artikel te volgen.