Een OTTO API opzetten

• Als je nieuw bij OTTO bent, zal je eerst door een onboarding/registratie proces moeten gaan. Je kunt in dit artikel meer informatie over dit 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 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: De API aanmaken

Nu kun je beginnen met het maken van je productvermeldingen. Kies je nieuwe koppeling met OTTO en ga verder met het instellen van je API.

1. API-instellingen configureren:
   
   
   • Geef je API een naam.
   • Kies de unieke ID per item (wij raden het veld 'id' aan).
     
     
     
     
2. API aanmaken: Klik op "Volgende" om de nieuwe OTTO API aan te maken.

Stap 3: Aanmaken van productvermeldingen

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

GPSR- en DSA-vereisten

De Europese Unie (EU) heeft nieuwe GPSR- en DSA-vereisten ingevoerd voor online platforms, inclusief marktplaatsen.

Voor je OTTO API in Channable: zorg ervoor dat je deze secties invult op het tabblad Gedeelde attributen in de Opbouw stap.

Productveiligheid (informatie van de fabrikant)

Bij Productveiligheid (informatie van de fabrikant) moet je de volgende informatie toevoegen:

• • Fabrikant of importeur: Voer de bedrijfsnaam in van de fabrikant of importeur.
  • Adres: Vermeld het volledige adres, inclusief: Straatnaam en huisnummer, Postcode, Plaats en Land. Zorg ervoor dat je komma’s gebruikt om de adresonderdelen te scheiden en voeg geen extra opmaak of regeleinden toe.
  • E-mail: Vul het volledige e-mailadres in van de fabrikant of importeur.
  • Telefoonnummer: Geef een geldig telefoonnummer op van de fabrikant of importeur.

Extra afbeeldingen
Bij ‘Extra afbeeldingen’ in de sectie Afbeeldingen moet je een veld toevoegen met een afbeeldings-URL van de veiligheidsinformatie van het product. Bijvoorbeeld, de afbeeldings-URL kan een afbeelding bevatten van het veiligheids datasheet of het waarschuwingslabel van het product (zie de beschikbare opties bij ‘Type’).

Aanvullende vereisten voor OTTO

• Productreferentie: De productreferentie in de Opbouw-stap groepeert alle varianten die je wilt combineren tot één product. Dit is niet zichtbaar voor je klanten. De productreferentie kan vrij worden toegewezen en mag maximaal 50 tekens bevatten. OTTO herkent welke producten dezelfde productreferentie hebben en maakt hier automatisch varianten van (bijv. verschillende maten, kleuren, enz.). Je kunt in de Opbouw-stap van de OTTO API in Channable definiëren wat de varianten onderscheidt.
  
• MOIN: Nadat producten zijn aangemaakt, kent OTTO een MOIN (My OTTO Integration Number) toe aan een product. Dit is een unieke identificatie die uitsluitend op OTTO wordt gebruikt. Als je productinformatie uploadt voor een product dat al bestaat op OTTO, geeft OTTO een foutmelding waarin staat dat de bestaande productinformatie moet worden gebruikt. Om het gebruik van deze bestaande productinformatie te accepteren, stel je het veld "Accept MOIN suggestion" in op "True". Als je de door OTTO voorgestelde productinformatie niet wilt accepteren, neem dan contact op met OTTO Partner Help.
  

Stap 4: Je productvermeldingen naar OTTO sturen

Bijna klaar! Je productvermeldingen zijn gereed om te worden verzonden. Als je jouw project nog niet hebt geactiveerd, ga dan naar Configuratie > Projectconfiguratie aan de linkerzijde van het scherm en klik op "Activeer project".

Daarna kan je de OTTO API activeren.

1. Ga terug naar het overzicht van de API’s en navigeer naar [Je OTTO API] > Instellen.
2. Activeer de API door te klikken op "Activeer API".
3. Keer terug naar het API-overzicht en klik op de blauwe knop "Uitvoeren" om je productvermeldingen naar OTTO te sturen.

Belangrijke opmerkingen

• Verwijdering van bestaande vermeldingen: Bij de eerste keer dat je onze API gebruikt om producten te uploaden, worden alle bestaande vermeldingen in je OTTO-verkoopaccount verwijderd.
• Display Restriction: Als dit je eerste keer is dat je op OTTO verkoopt, kun je een Display Restriction tegenkomen. Volg de richtlijnen die hier worden gegeven om dit probleem op te lossen, afhankelijk van je onboardingstatus.
• Verificatie van succes: Een status 'Succesvol' in het tabblad Resultaten betekent dat je producten met succes zijn verzonden naar OTTO's stagingomgeving voor producten ("Produktübersicht" in je OTTO-GUI). Let op: dit garandeert niet dat je producten direct zichtbaar zijn op OTTO of dat er geen fouten of waarschuwingen in de data zijn.
• Verwerkingstijd: OTTO heeft minimaal 24 uur nodig om je producten en afbeeldingen te verwerken. Als dit langer duurt, overweeg dan om na een paar dagen contact op te nemen met OTTO Seller Help.

Stap 5: 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.