Eine OTTO-API einrichten

Inhaltsverzeichnis

1. Vorbereitung
2. Einrichten einer Verbindung
3. Erstellen Sie eine API
4. Erstellen Sie Ihre Produktlistings in Channable
5. Senden Sie Ihre Produktdaten an OTTO
6. Überprüfen Sie Ihre Produktlistings auf Fehler

Vorbereitung

• Wenn Sie neu bei OTTO sind, müssen Sie zunächst einen Onboarding-/Registrierungsprozess durchlaufen. Mehr über diesen Prozess können Sie hier nachlesen. 
• OTTO hat eine Reihe von Anforderungen für Partner, die auf dem Marktplatz verkaufen möchten - diese können Sie hier finden. Wir empfehlen Ihnen, diese gründlich zu lesen, bevor Sie die OTTO-API einrichten. Wenn Sie diese Anforderungen erfüllen und sich für einen OTTO Partner Connect Account registriert haben, können wir mit der Einrichtung der API beginnen!
• Wenn Sie eine Bestellanbindung für den OTTO-Marktplatz nutzen möchten, empfehlen wir Ihnen, unseren Artikel zur Einrichtung einer Bestellanbindung für OTTO zu lesen. 
• Achtung! Unsere API deaktiviert alle bestehenden Listings in Ihrem OTTO-Verkäuferkonto und erstellt neue Listings. Es können auch keine Listings manuell aktiviert werden, da diese bei der nächsten Aktualisierung der API deaktiviert werden.

Schritt 1: Einrichten einer Verbindung

Gehen Sie zu "APIs > Neue API hinzufügen".  Es öffnet sich ein neues Fenster, in dem Sie auf die Schaltfläche "+ Verbindung hinzufügen" klicken können. 

Sie werden zu einer Übersicht weitergeleitet, in der Sie die OTTO OAuth-Verbindung sehen. Wählen Sie diese Verbindung aus.

Klicken Sie auf die Schaltfläche "Verbinden mit OTTO OAuth". Sobald Sie dies getan haben, werden Sie zur OTTO-Umgebung weitergeleitet, wo Sie sich bei Ihrem OTTO-Konto anmelden können.

Nach der Autorisierung werden Sie zu Channable zurückgeleitet, um die Verbindung zu bestätigen und zu benennen. Wir empfehlen, der Verbindung einen wiedererkennbaren Namen zu geben, damit sie leicht zu identifizieren ist.

Schritt 2: Erstellen Sie eine API

Jetzt können Sie mit der Erstellung Ihrer Produktangebote beginnen. Wählen Sie Ihre neue Verbindung mit OTTO und fahren Sie mit der Einrichtung Ihrer API fort.

1. API Einstellungen konfigurieren:
   • Geben Sie ihrer API einen Namen
   • Wählen Sie die "Eigene ID pro Item" aus (wir empfehlen das Feld "id")
     
     
2. API erstellen: Klicken Sie auf "Weiter", um die neue OTTO-API zu erstellen.

Schritt 3: Erstellen Sie Ihre Produktlistings in Channable

Um Ihre API einzurichten, folgen Sie bitte den unten aufgeführten Schritten. Klicken Sie auf jeden Schritt, um die detaillierten Anweisungen anzuzeigen, die Sie durch den gesamten Prozess führen.

1. Kategorisierung

2. Regeln

3. Schritt "Aufbau"

Der Schritt "Aufbau" in Channable ermöglicht es Ihnen, alle notwendigen Attribute für Ihre Artikel zu konfigurieren, um sicherzustellen, dass Ihre Produktdaten mit den Anforderungen des Marktplatzes übereinstimmen. Dieser Schritt ist entscheidend für erfolgreiche Produktlistings und die Vermeidung von Fehlermeldungen.

3.1 Überblick

1. Gehen Sie zum Aufbau-Schritt: Gehen Sie zunächst zur zentralen Benutzeroberfläche des Aufbau-Schrittes. Hier werden Sie alle Produktattribute verwalten und zuordnen.
2. Identifizieren Sie obligatorische und optionale Felder: Obligatorische Felder sind pink markiert und zeigen an, dass sie für die Auflistung Ihrer Produkte zwingend erforderlich sind. Optionale Felder sind orange markiert und können je nach Bedarf ausgefüllt werden.

3.2 Gemeinsame Attribute

1. Füllen Sie die geminsamen Attribute aus: Geben Sie allgemeine Informationen ein, die für alle Produkte gelten, z. B. EAN, Preise und Titel. Dieser Schritt gewährleistet die Einheitlichkeit der grundlegenden Produktinformationen in Ihren Angeboten.
   • Benutzen Sie statische oder dynamische Werte:
     • Statische Werte: Geben Sie Werte ein, die konstant bleiben, wie Markennamen oder Hersteller.
     • Dynamische Werte: Verwenden Sie Felder, die automatisch auf der Grundlage verknüpfter Daten aktualisiert werden, ideal für Variablen wie Lagerbestände oder Preis.

Nachdem Sie die gewünschten Werte für die gemeinsamen Attribute eingegeben haben, fahren Sie, wie unten beschrieben, mit den kategoriespezifischen Attributen fort.

3.3 Attribute pro Kategorie

1. Wählen Sie eine Produktkategorie: Wählen Sie die entsprechende Kategorie für Ihr Produkt, z. B. Kleidung oder Möbel.
2. Kategoriespezifische Attribute: Geben Sie Attribute ein, die für die ausgewählte Kategorie spezifisch sind, z. B. die Größe für Kleidung oder die Abmessungen für Möbel. Dieser Schritt hilft bei der Feinabstimmung Ihrer Angebote entsprechend den Anforderungen der Kategorie. Auch hier können Sie statische oder dynamische Werte verwenden.

Klicken Sie hier, um mehr über den Schritt "Aufbau" zu erfahren.

4. Schritt "Qualität"

Der Schritt "Qualität" liefert sofortige Rückmeldung über die Einrichtungsqualität und weist auf obligatorische und optionale Fehler hin, um sicherzustellen, dass Ihre Produktdaten den Standards der Marktplätze entsprechen.

Aktionen

• Artikel anzeigen: Sehen Sie sich die Produkte mit dem spezifischen Problem an.
• Im Aufbau-Schritt anzeigen: Leitet Sie zum Schritt "Aufbau" weiter, wo Sie ein Feld zuordnen können, um die fehlenden Informationen hinzuzufügen.
• Kategorien anlegen: Leitet Sie zum Schritt "Kategorien", wo Sie die fehlende Kategorie anlegen können.
• Quelle: Diese Option ist nur für das ID-Feld verfügbar und leitet Sie zum Schritt "Einstellungen" weiter.

Klicken Sie hier, um mehr über den Schritt "Qualität" zu erfahren.

5. Schritt "Vorschau"

Der Schritt "Vorschau" zeigt die zugeordneten Attribute für mehrere Artikel und Detailansichten für einzelne Artikel an und weist auf Fehler hin, bevor der Export auf den Marktplatz erfolgt.

Features

• Such- & Filterleiste: Suchen Sie nach bestimmten Produkten oder filtern Sie nach Fehlermeldung/Kategorie.
• Artikelübersicht: Zeigt alle zu exportierenden Artikel an; es kann gefiltert werden, um nur Artikel mit Fehlern anzuzeigen.
• Detaillierte Produktvorschau: Zeigt fehlende Informationen und dynamische Aktionen zur Fehlerbehebung an.

Checkliste zur Fertigstellung von Attributen

• Überprüfen Sie die gemeinsamen Attribute: Stellen Sie sicher, dass alle obligatorischen gemeinsamen Attribute korrekt ausgefüllt sind.
• Überprüfen Sie die kategoriespezifischen Attribute: Stellen Sie sicher, dass alle obligatorischen kategoriespezifischen Attribute korrekt ausgefüllt sind.
• Suchen Sie nach Fehlern: Suchen Sie nach rot markierten Feldern und korrigieren Sie diese.

Klicken Sie hier, um mehr über den Schritt "Vorschau" zu erfahren.

6. Schritt "Resultat"

Zusätzliche Anforderungen für Otto

• Produktreferenz: Die Produktreferenz im Aufbau-Schritt fasst alle Varianten zusammen, die Sie zu einem Produkt kombinieren möchten. Diese ist für Ihre Kunden nicht sichtbar. Die Produktreferenz kann frei vergeben werden und darf aus maximal 50 Zeichen bestehen. OTTO erkennt dann, welche Produkte die gleiche Produktreferenz haben und erstellt automatisch Varianten aus z.B. verschiedenen Größen, Farben, etc. Bei den Attributen der OTTO-API in Channable können Sie festlegen, was die Varianten unterscheidet.
• MOIN: Nach der Erstellung von Produkten vergibt OTTO eine MOIN (My OTTO Integration Number) an ein Produkt. Dies ist ein eindeutiger Identifier, der nur auf OTTO verwendet wird. Wenn Sie Produktinformationen für ein Produkt hochladen, das OTTO bereits bekannt ist, zeigt OTTO eine Fehlermeldung an. Diese besagt, dass die bestehenden/bekannten Produktinformationen verwendet werden müssen. Um die Verwendung dieser bestehenden Produktinformation zu akzeptieren, setzen Sie das Feld "MOIN-Vorschlag akzeptieren" auf "true".
  Wenn Sie die von OTTO vorgeschlagenen Produktinformationen nicht akzeptieren möchten, wenden Sie sich an die OTTO-Partnerhilfe.

Schritt 4: Senden Sie Ihre Produktdaten an OTTO

Ihre Produktlistings sind nun bereit zum Senden. Wenn Sie Ihr Projekt noch nicht aktiviert haben, gehen Sie zu "Einstellungen > Projekteinstellungen" auf der linken Seite des Bildschirms und klicken Sie auf "Projekt aktivieren".

Gehen Sie anschließend zurück zur Registerkarte APIs und gehen Sie zu "Ihre OTTO-API" > Einstellungen, wo Sie die API aktivieren, indem Sie "API aktivieren" wählen.

Nachdem Sie diesen Schritt abgeschlossen haben, navigieren Sie zurück zur Registerkarte "APIs" und klicken auf die blaue Schaltfläche "Aktualisieren", um mit der Übertragung Ihrer Produktangebote an OTTO zu beginnen.

Wichtige Hinweise:

• Entfernung bestehender Einträge: Unsere API deaktiviert alle bestehenden Listings in Ihrem OTTO-Verkäuferkonto, wenn Sie die API das erste Mal ausführen. Beachten sie dass keine Listings manuell aktiviert werden können, da diese bei der nächsten Aktualisierung der API deaktiviert werden.
• Anzeigenbeschränkung: Wenn Sie neu bei OTTO sind und zum ersten Mal auf OTTO verkaufen, dann werden Sie auf eine Anzeigebeschränkung stoßen. Bitte lesen Sie hier, wie Sie die Anzeigebeschränkung aufheben können und beachten Sie, dass es unterschiedliche Workflows gibt (siehe "Hinweis" im Artikel), je nachdem, wann das Onboarding abgeschlossen wurde.
• Überprüfung des Erfolgs: "Erfolgreich" in Bereich "Resultat" der API bedeutet nicht automatisch, dass Ihre Produkte sofort live auf OTTO sind oder dass es keine Fehler oder Warnungen in den übermittelten Daten gibt. "Erfolgreich" bedeutet, dass Ihre Produkte erfolgreich an den Staging-Bereich für Produkte (in Ihrem OTTO-GUI unter "Produktübersicht" sichtbar) gesendet wurden. Hier werden auch mögliche Fehler angezeigt, warum Produkte (noch) nicht live sind.
• Bearbeitungszeit: Es dauert mindestens 24 Stunden, bis Ihre Produkte und Bilder verarbeitet sind. Wenn Ihre Artikel nach ein paar Tagen noch nicht verarbeitet wurden, empfehlen wir Ihnen, eine E-Mail an die OTTO-Verkäuferhilfe zu senden.
• Brand IDs: Um zu wissen, welche Brand-IDs zu verwenden sind, halten wir hier eine Liste für Sie bereit!

Schritt 5: Überprüfen Sie Ihre Produktlistings auf Fehler

Wenn Sie Ihre Produktangebote an OTTO gesendet haben, gehen Sie auf die Registerkarte "Resultat" Ihrer OTTO-API. Unter "Fehler" sehen Sie, welche Produktangebote Fehler aufweisen und nicht gepusht werden. Klicken Sie auf einen bestimmten Fehler, um weitere Informationen über die Fehlerursache zu erhalten.