Eine OTTO-API einrichten

Bevor Sie beginnen

• 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. 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

Sobald Sie im Onboarding-/Registrierungsprozess den Status 'ready to sell (verkaufsbereit)' erreicht haben, erhalten Sie Ihre API-Zugangsdaten. Bitte beachten Sie, dass diese Zugangsdaten per automatisierter E-Mail versendet werden und nicht über Ihr OTTO Partner Connect-Konto abgerufen werden können. Falls Sie diese E-Mail nicht finden können, wenden Sie sich bitte an OTTO. 

Sobald Sie Ihre Zugangsdaten erhalten haben, gehen Sie zu APIs > Neue API hinzufügen.  Es öffnet sich ein neues Fenster mit den API-Einstellungen, in dem Sie auf die Schaltfläche "+ Neue Verbindung hinzufügen" klicken können. 

Sie werden zu einer Übersicht weitergeleitet, in der Sie die OTTO-Verbindung sehen. Wählen Sie diese Verbindung aus und geben Sie den Benutzernamen und das Passwort ein, die Sie in der oben erwähnten E-Mail erhalten haben. 

Nachdem Sie auf Erstellen geklickt haben, wird die Verbindung hergestellt und Sie können mit der Eingabe Ihrer Produktinformationen beginnen. . 

Schritt 2: Erstellen Sie Ihre Produktlistings in Channable

Sobald Sie einen neuen API-Exporter mit der neu erstellten Verbindung erstellt haben, können Sie Ihre Produktdaten erstellen, indem Sie den Schritten der API folgen.

1. Kategorien

Damit Ihre Produktdaten erstellt werden können, benötigen Ihre Produkte eine Kategorie. Fügen Sie Ihren Produkten Kategorien hinzu, indem Sie die Funktion "Kategorien generieren" verwenden, oder erstellen Sie neue Kategorien von Grund auf.

2. Regeln

Erstellen Sie verschiedene Regeln zur Optimierung Ihrer Produktdaten. Beispiele finden Sie in unserem Artikel zur Unterstützung von häufig benutzten Regeln.

3. Aufbau

Hier finden Sie unsere voreingestellte Vorlage für die Produktdaten. Sie müssen sie nur noch ausfüllen, indem Sie auf das Feld selbst klicken und auswählen, was Sie dort eintragen möchten. Das Feld "Titel" sollte zum Beispiel den Titel Ihres Produkts anzeigen und so weiter. Wenn Sie mit dem Einrichten der Produktdaten fertig sind, klicken Sie einfach auf "Speichern" am unteren Rand des Bildschirms.

Tipp! Beachten Sie das Fragezeichen hinter jedem Feld. Wenn Sie den Mauszeiger über das Fragezeichen bewegen, sehen Sie die Beschreibung des Feldes und Vorschläge für mögliche Werte.

Hinweis: 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. Im Attribute-Schritt der OTTO-API in Channable können Sie festlegen, was die Varianten unterscheidet.

Achtung! 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.

4. Attribute

Fast fertig! Als Nächstes müssen Sie die Felder im Schritt Attribute ausfüllen. Wählen Sie zunächst die Kategorie aus, die Sie optimieren möchten. Ein Beispiel dafür, was Sie jetzt vor sich haben sollten, sehen Sie auf dem folgenden Screenshot. Eine detailliertere Erklärung, was im Schritt "Attribute" zu tun ist, finden Sie in unserem Support-Artikel zu Attributen.

Schritt 3: 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 "Ihr OTTO-API-Name" > 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 "Jetzt ausführen", um mit der Übertragung Ihrer Produktangebote an OTTO zu beginnen.

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.

Schritt 4: Fehlerbehebung

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

Migration zu OTTO API v3

Ab dem 31. März 2023 wird OTTO ihre V2 API abschaffen. Wir haben dafür gesorgt, dass wir V3 vor diesem Termin vollständig unterstützen. Es gibt nur eine Sache, die Sie beachten müssen, wenn Sie auf die Version 3 der OTTO-API umgestiegen sind. Mit der neuen Version der API müssen Sie nun Marken-IDs anstelle von Markennamen an OTTO übermitteln.

Der beste Weg, dies einzurichten, ist die Verwendung einer 'suche Werte' Regel innerhalb des OTTO-API Setups. Wir empfehlen, ein neues Feld "brand_id" zu erstellen, das dafür verwendet wird. Diese Regel könnte etwa so aussehen:

Mit dieser Regel können Sie eine Liste möglicher Marken in der linken Spalte und die entsprechenden Marken-IDs in der rechten Spalte hinzufügen.

Um zu wissen, welche Marken-IDs zu verwenden sind, halten wir hier eine Liste für Sie bereit!

Wenn Sie viele verschiedene Marken verkaufen, können Sie sich an den Support wenden und wir helfen Ihnen, die richtigen Marken-IDs zu finden. Wir können die Marken, die Sie derzeit eingegeben haben, verwenden und eine Datei erstellen, die alle entsprechenden Marken-IDs enthält. Sie können diese Marken-IDs dann importieren oder diese Werte per Copy-Paste in die Regeln einfügen. Wir empfehlen, die Regeln dafür zu verwenden um den Import nicht weiter zu erschweren, aber die Entscheidung liegt bei Ihnen.