Möchten Sie interaktiv alle Grundlagen für die Erstellung eines API-Exports erlernen oder wie man ein fortgeschrittenes Setup für eine API in Channable vornimmt? Erfahren Sie in diesem Helpcenter-Artikel, wie Sie ein Channacademy-Konto in der Channable-App erstellen und beginnen Sie mit dem Kurs Basic APIs oder Expert APIs.
Inhaltsverzeichnis
- Vorbereitungen
- Erstellen Sie eine Zalando API Verbindung
- Erstellen Sie die Zalando API in Channable
- Erstellen Sie Ihre Produktlistings
- Zalando Bestellsynchronisation
- Freigabe auf Zalando & Go live!
Vorbereitungen
Wenn Sie die Zalando API in Channable nutzen möchten, müssen Sie alle Voraussetzungen hierfür erfüllen, bevor Sie mit der Einrichtung der API beginnen können. Die folgende Liste zeigt die Anforderungen, die Sie erfüllen müssen, um die Zalando-API in Channable zu nutzen. Die Anforderungen werden in diesem Artikel genauer erklärt.
- Zulassung für den Verkauf über das Zalando Partnerprogramm mit Channable
- Genehmigung der 'Brand-Readiness-Phase'
- Zugang zum zDirect Konto
- Die Nutzung unserer Bestellsynchronisation, da Zalando keine Schnittstelle anbietet, die Bestellungen abwickelt
- Sie sind sich der Anforderungen bewusst, damit Ihre Items von Zalando akzeptiert werden können, siehe bspw. die Anforderungen für die Bilder und Dokumente für die Bestellungsabwicklung.
Schritt 1: Erstellen Sie eine Zalando API Verbindung
Um eine Verbindung herzustellen, müssen Sie Channable als externe technische Organisation einladen, indem Sie zDirect verwenden. Dazu senden Sie bitte eine E-Mail an unsere Support-Abteilung. Sie erhalten dann einen Einladungslink. Wenn Sie die Einladung durchgeführt haben, senden Sie uns eine Antwort auf die E-Mail, an die Sie die Einladung geschickt haben. Wir werden dann die Einladung annehmen und die Zalando-Verbindung für Sie einrichten.
Schritt 2: Erstellen Sie die Zalando API in Channable
Sobald Sie eine E-Mail von uns erhalten haben, dass Ihre Verbindung bereit ist, können Sie eine neue Zalando-API in Channable erstellen. Gehen Sie zu Channable, öffnen Sie Ihr Projekt und navigieren Sie zu APIs > neue API hinzufügen. Es öffnet sich ein neuer Bildschirm, in welchem Sie die Zalando-Verbindung auswählen können. Wenn Sie die Verbindung ausgewählt haben, sehen Sie einen Bildschirm (siehe Bild unten), in welchem Sie einen Namen für die API eingeben und die richtige Region auswählen können.
Schritt 3: Erstellen Sie Ihre Produktlistings
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
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 manuell neue Kategorien erstellen.
- Smart Categorization: Diese Funktion ordnet Ihren Produkten automatisch Kategorien auf der Grundlage vordefinierter Kriterien zu und vereinfacht so den Kategorisierungsprozess.
- Manuelle Kategorisierung: Weisen Sie Ihren Produkten manuell Kategorien zu, indem Sie bestimmte Regeln festlegen. Sie können detaillierte Filter erstellen, um jedes Produkt der richtigen Kategorie zuzuordnen.
- Nicht kategorisierte Items: Überprüfen und kategorisieren Sie alle Artikel, die nicht kategorisiert sind, um sicherzustellen, dass alle Produkte ordnungsgemäß kategorisiert sind.
Klicken Sie hier, um mehr über den Schritt "Kategorien" zu erfahren.
2. Regeln
Erstellen Sie verschiedene Regeln zur Optimierung Ihrer Produktdaten. Beispiele finden Sie in unserem Artikel zu häufig benutzten Regeln.
- Regeln einrichten: Richten Sie verschiedene Regeln ein, um Ihre Produktdaten zu verfeinern. Dazu kann das Filtern, Ändern oder Erweitern von Datenfeldern gehören, um den Anforderungen des Marktes gerecht zu werden.
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
- Gehen Sie zum Aufbau-Schritt: Gehen Sie zunächst zur zentralen Benutzeroberfläche des Aufbau-Schrittes. Hier werden Sie alle Produktattribute verwalten und zuordnen.
- 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
-
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.
-
Benutzen Sie statische oder dynamische Werte:
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
- Wählen Sie eine Produktkategorie: Wählen Sie die entsprechende Kategorie für Ihr Produkt, z. B. Kleidung oder Möbel.
- 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"
Die Registerkarte "Resultat" bietet einen Überblick über die Ergebnisse Ihrer API-Einrichtung, einschließlich erfolgreicher Übertragungen, Fehler und eine Vorschau der Produkte, die gelistet werden sollen. Diese Registerkarte stellt sicher, dass Ihre Produktdaten korrekt verarbeitet werden und identifiziert alle Probleme, die gelöst werden müssen.
- Überblick: In diesem Schritt wird der Status Ihrer Produktangebote angezeigt, wobei Fehler und Probleme hervorgehoben werden, um detaillierte Einblicke zu erhalten.
- Vorschau der Produkte: Zeigt eine Übersicht der Produkte an, die an den Marktplatz gesendet werden sollen, so dass überprüft werden kann, ob die Attribute korrekt ausgefüllt wurden.
- Erfolgreich: Listet Produkte auf, die erfolgreich verarbeitet wurden und für eine Listung bereit sind, d.h. die den Anforderungen des Marktplatzes entsprechen.
- Fehler: Identifiziert Fehler während der Verarbeitung und liefert detaillierte Informationen zur Fehlerbehebung und Problemlösung.
Optionale Registerkarten, wie z. B. Fehler beim Repricer, Historie der Repricer-Ereignisse, Bestandsaktualisierungen und Fulfillment-Aktualisierungen werden nur angezeigt, wenn sie für die von Ihnen verwendete API relevant sind.
Klicken Sie hier, um mehr über den Schritt "Resultat" zu erfahren.
Zusätzliche Information für Zalando
-
Kategorien
Kategorien sind ein Muss für Zalando. Richten Sie Zalando-Kategorien für Ihre Produkte ein, indem Sie die Funktion "Kategorien generieren" nutzen oder neue Kategorien von Grund auf neu erstellen. Während der Brand Readiness Phase nennt Zalando Ihnen bestimmte Kategorien, in denen Sie verkaufen dürfen. Derzeit sind alle Zalando Kategorien im Kategorienbereich sichtbar. Auch wenn alle Kategorien in der Channable API sichtbar sind, bedeutet das nicht, dass Sie in jeder Kategorie verkaufen dürfen. Um Fehler zu vermeiden, raten wir Ihnen, nur die Kategorien auszuwählen, in denen Sie laut Zalando verkaufen dürfen. -
Gemeinsame Attribute
Speziell für Zalando gibt es beim Ausfüllen der Attribute ein paar Dinge zu beachten:
1. Item Group ID + Artikel-Untergruppen-ID + EAN bestimmen die Produktstruktur. Es ist wichtig, dass diese Angaben korrekt ausgefüllt werden und dass Sie dieselben IDs und dieselbe Produktstruktur verwenden, die Sie derzeit nutzen.
2. EANs sind erforderlich.
3. Bilder müssen in separaten Feldern eingereicht werden.
Mehr Informationen über die Produktstruktur in Zalando finden Sie hier. -
Attribute pro Kategorie
Der Bereich Attribute pro Kategorie in der Zalando API ist ein wenig anders, als Sie es von uns gewohnt sind. Die Zalando-Attributwerte bestehen aus einem Code und einer besser lesbaren Bezeichnung. Leider können wir die Bezeichnung im Attribute-Builder nicht zuverlässig verwenden. Deshalb haben wir uns entschieden, nur mit den Codes zu arbeiten. Wir zeigen eine Liste möglicher Werte an und Sie müssen einen dieser Codes eingeben. Diese Codes sind in der Regel nicht wirklich aussagekräftig (z. B. entspricht der Code '302' dem Wert 'Rot'). Um Ihnen bei der korrekten Einrichtung der Attribute zu helfen, können wir Ihnen eine spezielle CSV-Datei mit allen zulässigen Werten und ihren Codes zur Verfügung stellen. Bitte wenden Sie sich an unsere Support-Abteilung, damit wir Ihnen die CSV-Datei zur Verfügung stellen können.
Schritt 4: Zalando Bestellsynchronisation
Wie bereits beschrieben, ist es notwendig, dass für Zalando eine Bestellsynchronisation eingerichtet wird. Um diese einzurichten, wenden Sie sich bitte an unseren Support. Weitere Informationen zu Zalando-Bestellungen finden Sie in diesem Artikel.
Schritt 5: Freigabe auf Zalando & Go live!
Gehen Sie zum Vorschau-Schritt Ihrer API, um die Produkte zu prüfen, die an Ihr Zalando-Konto gesendet werden sollen. Da Zalando eine manuelle Prüfung der Produktinhalte vornimmt, ist es zeitsparend, die API so vollständig wie möglich einzurichten, bevor sie das erste Mal ausgeführt wird. Wenn alles richtig aussieht, gehen Sie zum Schritt Einstellungen Ihrer API und aktivieren Sie die API.
Wenn die Bestellsynchronisation eingerichtet und die API vollständig mit Ihren Produktdaten konfiguriert ist, wird Zalando Ihre Produktdaten und die Bestellabwicklung überprüfen. Bitte kontaktieren Sie Zalando, um dies in die Wege zu leiten.
Das Artikel-Onboarding hat mehrere Stufen, die Sie über das Modul Artikelstatusübersicht in zDirect verfolgen können. Weitere Informationen zu den einzelnen Schritten finden Sie hier.
Sobald Zalando die Freigabe erteilt hat, wird die sogenannte "Händlersperre" in der API aufgehoben und Ihre Produkte gehen bei Zalando online. Die Freischaltung erfolgt immer in Absprache mit Ihnen und Zalando.