Een OTTO API opzetten

Voordat je begint

• Als je nieuw bij OTTO bent, zul je eerst door een onboarding/registratie proces moeten gaan. Je kunt in dit artikel meer informatie over die proces vinden.
• OTTO stelt voor partners die geïnteresseerd zijn in het verkopen op OTTO een aantal eisen, deze vind je hier terug. Wij raden je aan om deze nauwkeurig door te lezen voordat je de OTTO API in Channable instelt. Als je aan de eisen voldoet en je hebt je geregistreerd voor een OTTO Partner Connect account, kun je beginnen met het opzetten van de OTTO API in Channable! 
• Als je gebruik wilt maken van een orderkoppeling voor OTTO, raden wij je aan om ons artikel te lezen over hoe je een orderkoppeling voor OTTO kunt opzetten.
• Let op! Onze API verwijdert alle bestaande listings in jouw OTTO verkoopaccount wanneer de API voor het eerst wordt uitgevoerd.

Stap 1: Een koppeling opzetten

Ga naar API's > Nieuwe API toevoegen. Een nieuw scherm zal openen met de API-instellingen waar je op de knop "+ Koppeling toevoegen" kunt klikken.

Je wordt doorgestuurd naar een overzicht waar je op pagina 3 de koppeling met OTTO ziet, genaamd "OTTO Market - Otto OAuth".

Klik op de knop 'Koppel met OTTO OAuth'. Nadat je op deze knop hebt geklikt, word je doorgestuurd naar de omgeving van OTTO waar je kunt inloggen op je OTTO-account.

Na de autorisatie word je teruggeleid naar Channable om de koppeling te bevestigen en een naam te geven. We raden aan om een herkenbare naam te geven om de koppeling gemakkelijk te kunnen herkennen.

Stap 2: Aanmaken van productvermeldingen

Zodra je een nieuwe API met de nieuwe koppeling hebt aangemaakt, kun je jouw productgegevens instellen door de stappen van de API te volgen. 

1. Categorieën
   Nu je de API hebt aangemaakt, is het tijd om de categorieën in te stellen. Hierdoor kun je jouw eigen categorisatie converteren naar die van OTTO. Dit kan met behulp van de functie categorieën genereren, of door handmatig de categorieën in te vullen.
   
   
2. Regels
   Maak verschillende regels aan om je productdata te optimaliseren. Voor voorbeelden verwijzen we je graag naar ons helpcenter artikel over veel voorkomende regels. 
   
   
3. Opbouw 
   Hier vindt je de standaard template voor het aanmaken van de 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. Wanneer je klaar bent met het opzetten van je productvermeldingen kun je deze opslaan door te klikken op ''Opslaan'' onderaan het scherm.
   
   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.
   
   
   Belangrijk: De productreferentie in de Opbouw stap groepeert alle variaties die je wilt combineren tot één product. Dit is niet zichtbaar voor je klanten. De productreferentie kan vrij worden toegekend en mag uit maximaal 50 tekens bestaan. OTTO herkent dan welke producten dezelfde productreferentie hebben en maakt automatisch varianten van bijvoorbeeld verschillende maten, kleuren etc. Je kunt vervolgens in de Attributen stap van de OTTO API in Channable definiëren wat de varianten onderscheidt.
   Let op: Nadat de producten zijn aangemaakt, wijst OTTO een MOIN (Mijn OTTO Integratie Nummer) aan een product toe. Dit is een unieke identifier die alleen op OTTO wordt gebruikt. Als je productinformatie voor een product uploadt dat op OTTO al bestaat, zal OTTO een fout tonen die zegt dat de bestaande productinformatie moet worden gebruikt. Om het gebruik van deze bestaande productinformatie te accepteren, zet je het veld "MOIN-suggestie accepteren" op "True". Als je de door OTTO voorgestelde productinformatie niet wilt accepteren, kun je het beste contact opnemen met de OTTO Partner Help. 
   
   
4. Attributen
   Je bent er bijna! De volgende stap is om de velden in de Attributen stap te optimaliseren. Een voorbeeld van wat je in Attributen zou moeten vinden, zie je in de afbeelding hieronder. Voor een uitgebreide uitleg van hoe je de Attributen kan optimaliseren, kun je ons Attributen support artikel doornemen.
   
   

Stap 3: Stuur je advertenties naar OTTO

Je product listings zijn nu klaar om naar OTTO verzonden te worden. Als je het project nog niet hebt geactiveerd, ga je aan de linkerkant naar Configuratie > Projectconfiguratie en klik je op "Activeer project". Daarna ga je aan de linkerkant naar de APIs tab en klik je op "Jouw OTTO API naam" > Instellen waar je de API kunt activeren door op "Activeer API" te klikken.

Nadat je deze stap hebt voltooid, navigeer je terug naar de APIs tab en klik je op de blauwe "Uitvoeren" knop om te beginnen met het versturen van je product listings naar OTTO. 

Je producten en afbeeldingen hebben minstens 24 uur nodig om te worden verwerkt. Als je producten na een paar dagen nog niet zijn verwerkt, raden wij je aan om een email naar OTTO Verkopers Help te sturen.

Stap 4: Controleer je producten op fouten

Nadat de API klaar is met uitvoeren ga je naar de Resultaat stap voor een overzicht van de foutmeldingen in de 'fouten' tab. Je kan hier zien welke foutmeldingen voorkomen en als je op een foutmelding klikt, krijg je meer informatie te zien over de foutmelding en voor welke producten de foutmelding geldt.