Een Conrad API opzetten

Conrad, al bijna 100 jaar een familiebedrijf, voorziet klanten in heel Europa van innovatieve en betrouwbare technologie. Met meer dan 1,5 miljoen producten van toonaangevende fabrikanten bedient Conrad industriële klanten, professionals, onderwijsinstellingen, makelaars en particulieren.

Deze handleiding leidt je door de stappen voor het opzetten van een API tussen Channable en Conrad.

Inhoudsopgave

1. Voorbereiding
2. Een nieuwe koppeling aanmaken
3. API aanmaken
4. Maak je productvermeldingen aan
5. Stuur je productvermeldingen naar Conrad
6. Controleer je productvermeldingen op fouten

Voorbereiding

Lees en volg deze belangrijke richtlijnen om de set-up soepel te laten verlopen en problemen te voorkomen:

• Account aanmaken: Om je producten op Conrad te kunnen verkopen, heb je een professioneel verkopersaccount nodig. Volg hier de richtlijnen voor het aanmaken van een account.
• Ondersteunde landen: Momenteel zijn de volgende landen beschikbaar Duitsland, Italië, Frankrijk, Nederland, Oostenrijk en Tsjechië.
• Meerdere Conrad API's: Elk winkelaccount is 1 verkoopkanaal. Als je in meerdere landen wilt verkopen, moet je:
  • Een nieuw winkelaccount openen.
  • Een nieuwe Conrad API in Channable aanmaken om verbinding te maken met dat winkelaccount.

Na het voltooien en doornemen van alle voorbereidingspunten, ben je klaar om naar de eerste stap te gaan.

Stap 1: Een nieuwe koppeling aanmaken

Volg de onderstaande stappen om een nieuwe Conrad-koppeling te maken:

1. Navigeer eerst naar de API-pagina binnen je project en klik op de knop “+API koppeling toevoegen”. Deze actie leidt je door naar de pagina met de verschillende koppelingen.
2. Selecteer op de pagina met koppelingen “+Koppeling toevoegen”.
   
3. Zoek naar de 'Conrad'-koppeling door door de pagina's te klikken. Als je de 'Conrad'-koppeling hebt gevonden, geef dan een label aan deze nieuwe koppeling.
   
4. Klik op “Maak verbinding met Conrad” Je wordt doorgestuurd naar Conrad voor de volgende stap. Eenmaal doorgestuurd, log in met Mirakl/Conrad referenties.

Nadat je succesvol bent ingelogd is de koppeling met Conrad tot stand gebracht en beschikbaar voor gebruik! Je wordt nu teruggestuurd naar de API-instelling.

Stap 2: API aanmaken

Eenmaal terug moet je je nieuwe koppeling met Conrad selecteren en doorgaan met het instellen van je API.

1. 1. API-instellingen configureren:
2. • Geef je API een naam
   • Selecteer het unieke ID per item (wij raden het 'id' veld aan).
   • Selecteer de taal van je API
     

2. API aanmaken: Klik op “Volgorde” om de nieuwe Conrad API aan te maken.

Stap 3: Maak je productvermeldingen aan

Volg de onderstaande stappen om je API in te stellen. Klik op elke stap om deze uit te klappen en de gedetailleerde instructies te bekijken, die je door het hele proces zullen leiden.

1. Categorieën

2. Regels

3. Opbouw stap

Met de Opbouw stap in Channable kun je alle benodigde attributen voor je items configureren, zodat je productgegevens overeenkomen met de vereisten van de marketplace. Deze stap is cruciaal voor succesvolle product listings en het vermijden van fouten.

3.1 Overzicht

1. Ga naar de Opbouw stap: Begin met het openen van de gecentraliseerde interface van de Opbouw stap. Hier kun je alle productattributen beheren en in kaart brengen.
2. Identificeer verplichte en optionele velden: Verplichte velden zijn roze gemarkeerd om aan te geven dat ze essentieel zijn. Optionele velden zijn oranje gemarkeerd en kunnen worden ingevuld op basis van specifieke behoeften.

3.2 Gedeelde attributen vullen

1. Gedeelde attributen vullen: Voer algemene gegevens in die van toepassing zijn op alle producten, zoals EAN, prijzen en titels. Deze stap zorgt voor uniformiteit in de basisproductinformatie voor al je listings.
   • Gebruik statische of dynamische waarden:
     • Statische waarden: Direct waarden invoeren die constant blijven, zoals merknaam of fabrikant.
     • Dynamische waarden: Gebruik velden die automatisch worden bijgewerkt op basis van gekoppelde gegevens, ideaal voor variabelen zoals voorraadniveaus of prijzen.

Nadat je de gewenste waarden voor de gedeelde attributen hebt ingevuld, ga je verder met de categoriespecifieke attributen hieronder.

3.3 Categoriespecifieke attributen opgeven

1. Selecteer een productcategorie: Kies de relevante categorie voor je product, zoals kleding of meubels.
2. Invullen van categoriespecifieke attributen: Vul de attributen in die specifiek zijn voor de geselecteerde categorie, zoals maten voor kleding of afmetingen voor meubels. Deze stap helpt bij het afstemmen van je listings op de categorie vereisten. Ook hier kun je statische of dynamische waarden gebruiken.

Klik hier om meer te lezen over de Opbouw stap in een API.

4. Kwaliteitsstap

De kwaliteitsstap geeft direct feedback over de kwaliteit van de instellingen en markeert verplichte en optionele fouten om ervoor te zorgen dat je productgegevens voldoen aan de standaarden van de marketplaces.

Acties

• Bekijk items: Bekijk producten met specifieke problemen.
• Bekijk in de opbouw stap: Leidt je door naar de opbouw stap om ontbrekende informatie in kaart te brengen.
• Categorieën instellen: Hiermee ga je naar de Categorieën stap om items te categoriseren.
• Toon Bron: Beschikbaar voor ID-velden, hiermee ga je direct naar de instellen stap.

Klik hier om meer te lezen over de kwaliteitsstap in de API.

5. Bekijk stap

De Bekijk stap toont in kaart gebrachte attributen voor meerdere items en markeert fouten voordat er naar de marketplace wordt geëxporteerd.

Features

• Zoek & filter: Zoek specifieke producten of filter op foutmelding/categorie.
• Item overzicht: Toont alle items die geëxporteerd moeten worden; het kan filteren om alleen items met fouten te tonen.
• Gedetailleerd productoverzicht: Toont ontbrekende informatie en dynamische acties om fouten te corrigeren.

Checklist voor het afronden van attributen

• Gedeelde kenmerken bekijken: Zorg ervoor dat alle verplichte gedeelde attributen zijn ingevuld.
• Categoriespecifieke kenmerken bekijken: Zorg ervoor dat alle verplichte categoriespecifieke attributen zijn ingevuld.
• Contoleer op fouten: Corrigeer rood gemarkeerde velden.

Klik hier om meer te lezen over de Bekijk stap in een API.

6. Resultaat stap

Extra vereisten voor Conrad

De volgende informatie is specifiek voor Conrad, we bespreken per tabblad waar je op moet letten.

Item tab

• Doorlooptijd verzenden: De verzendtijd geeft de tijd aan die nodig is tot het pakket wordt overgedragen aan de verzenddienst. Deze waarde overschrijft alle standaardinstellingen van Mirakl.
  Als de waarde leeg blijft, gaat Conrad uit van verzending op dezelfde dag. In de Conrad Shop worden 1-2 dagen toegevoegd aan de opgegeven verzendtijd.
• Verzendklasse: De logistieke klassen bepalen de respectievelijke verzendkosten voor je items.

  Je kunt maximaal acht verschillende verzendklassen configureren. De juiste waarden moeten worden ingevuld in het attribuut 'Verzendklasse' in de Opbouw stap. Hieronder staan de mogelijke waarden, deze zijn ook te vinden als statische waarden door met de muis over het (?) symbool naast het “Verzendklasse” attribuut te gaan.

  Verzendklasse waarde	Verzendklasse ID	Beschrijving
  Small & Medium 1	SM1	10 kg en minder
  Small & Medium 2	SM2	Meer dan 10 kg tot 15 kg
  Small & Medium 3	SM3	Meer dan 15 kg tot 31,5 kg
  Bulk Shipment	bulk	Van 31,5 kg tot 40 kg
  Pallet Shipment	pallet	Meer dan 40 kg tot 500 kg
  Extra Logistic Class 1	extra1	Specifieke prijs voor Extra logistiek 1
  Extra Logistic Class 2	extra2	Specifieke prijs voor Extra logistiek 2
  Free shipping	free	Gratis verzending
  Fulfillment Small & Medium 1	FSM1	Verzending 10 kg en minder
  Fulfillment Small & Medium 2	FSM2	Verzending van meer dan 10 kg tot 15 kg
  Fulfillment Small & Medium 3	FSM3	Verzending van 15 kg tot 31,5 kg
  Fulfillment Bulk Shipment	fbulk	Grofgewicht boven 31,5 kg tot 40 kg
  Fulfillment Pallet Shipment	fpallet	Pallet meer dan 40 kg tot 500 kg
  Fulfillment Extra Logistic 1	fextra1	Verzending Extra 1
  Fulfillment Extra Logistic 2	fextra2	Verzending Extra 2
  Fulfillment Free shipping	fulfree	Verzending Gratis verzending (geen verzendkosten toegestaan)
  OCI assortment	oci	OCI-assortiment (geen verzendkosten)

  Opmerking: Extra Logistic Class 1 en 2 zijn alleen geactiveerd in Duitsland.
• Verlegging heffing van toepassing: Met de verleggingsregeling wordt de btw-schuld voor de leveringen verlegd: Niet het bedrijf dat de levering doet, betaalt de btw aan de belastingdienst, maar de klant. De voorwaarde voor de toepassing van de verleggingsregeling is dat de klant ook houder is van een btw-identificatienummer.
  Geef bij elke vermelding de waarde “false” of “true” aan, afhankelijk van of deze regeling van toepassing is of niet.
• Magazijn ID: Geeft als resultaat de magazijnlocatie van waaruit het betreffende item wordt verzonden. De configuratie wordt gedaan in het “Magazijn ID” attribuut in de Opbouw stap.
  Een waarde van 1 tot 5 wordt ingevoerd, afhankelijk van de configuratie van de opgeslagen magazijnlocaties. Het magazijnattribuut is bedoeld voor een specifiek cijfer, je kunt maximaal 5 opslaglocaties in je Conrad account opgeven. Dit attribuut bepaalt vervolgens uit welk magazijn het item uiteindelijk komt door de identifier 1-5 te selecteren.
• Maateenheden: Het attribuut “Maateenheden” specificeert de eenheid die wordt gebruikt om de prijs per eenheid van een product te berekenen. Dit zorgt ervoor dat consumenten de kosten gemakkelijk kunnen vergelijken. Voor producten die worden verkocht op basis van gewicht, volume, lengte of oppervlakte, kun je eenheidsprijzen gebruiken in gangbare eenheden zoals kilogram (KG), liter (L), meter (M) of vierkante meter (M2). Zorg ervoor dat het attribuut “Maateenheden” in Channable nauwkeurig is gevuld om deze standaarden weer te geven.
• Hoeveelheid: In Channable specificeert het attribuut “Hoeveelheid” de maateenheid voor het product dat wordt verkocht. Als je bijvoorbeeld een 4-pack pluggen verkoopt, voer je “4” in als hoeveelheid.

  Hierdoor kan Conrad zowel de prijs per eenheid als de totaalprijs voor het 4-pack weergeven. Je kunt dit voor specifieke producten bereiken door:

  1. Een projectveld aan te maken

  2. Dat veld in een regel gebruiken en vullen met een waarde

  3. Selecteer vervolgens het veld in het attribuut “Hoeveelheid”. Raadpleeg dit artikel voor meer informatie over dynamische velden

• Thuiskopieheffing: In Frankrijk is de heffing voor het kopiëren voor privégebruik een wettelijke vereiste die auteurs en rechthebbenden compenseert voor kopieën voor privégebruik die zijn gemaakt met behulp van blanco media zoals cd's, dvd's, externe harde schijven en USB-sticks. Deze heffing is inbegrepen in de verkoopprijs van deze blanco media en wordt vervolgens verdeeld onder de makers en rechthebbenden via collectieve beheersorganisaties. Verkopers moeten het bedrag van de ''copie-privée'' heffing in euro's voor elk artikel in deze categorie specificeren.
• Eco-bijdragen: In Frankrijk is de particuliere kopieerheffing wettelijk verplicht, Frankrijk heeft wetgeving voor ecoparticipatie ingevoerd. Als je bedrijf actief is in Frankrijk, moet je eco-bijdragen toevoegen aan je vermeldingen op deze marketplace. In dit artikel vind je een lijst met beschikbare EU-categorieën.

Als je deze richtlijnen volgt, zorg je ervoor dat je vermeldingen op Conrad correct zijn ingesteld en voldoen aan hun vereisten.

Best practices

Meerdere attributen toevoegen: Wanneer je meerdere waarden in een attribuutveld toevoegt voor Mirakl Marketplaces, scheid elke waarde met een pipe-symbool "|" om ervoor te zorgen dat ze correct worden gedetecteerd en verwerkt.

Seller's Product ID voor enkele/simpele producten: Let op dat er twee attributen zijn genaamd 'SellerArticleId' en 'SellerProductId'. 'SellerProductId' verwijst naar de Parent ID, terwijl 'SellerArticleId' verwijst naar de varianten. Voor enkele producten moeten beide attributen met dezelfde waarde worden ingevuld.

Voor meer informatie over fouten, instructies en best practices voor Mirakl Marketplaces, bekijk onze speciale gids. Klik hier om meer te lezen.

Stap 4: Stuur je productvermeldingen naar Conrad

Je bent er bijna, je productvermeldingen zijn klaar om verzonden te worden. Als je je project nog niet hebt geactiveerd, ga dan naar je (project)configuratie aan de linkerkant van het scherm en klik op “Activeer project”.

Ga daarna terug naar het API-overzicht en ga naar [Jouw Conrad API] > Instellen, waar je de API activeert door op “Activeer API” te klikken.

Zodra je de API hebt geactiveerd, navigeer je terug naar het API-overzicht en klik je op de blauwe knop “Uitvoeren” om je productvermeldingen naar Conrad te sturen.

Stap 5: Controleer je productvermeldingen op fouten

Om op fouten te controleren, navigeer je naar de pagina Resultaat van de API > tabblad Fouten, waar je kunt zien welke productvermeldingen fouten hebben. Door op de specifieke fout te klikken, wordt er meer informatie weergegeven over de oorzaak van de fout. Lees dit artikel voor meer informatie over wat de fouten betekenen. Daarnaast is er ook veel informatie te vinden in het Conrad helpcenter.