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.
In diesem Artikel wird erklärt, wie man eine Allegro-API in Channable einrichtet, indem man die folgenden Schritte durchführt:
- Vorbereitung
- Schritt 1: Hinzufügen einer neuen Allegro-Verbindung in Channable
- Schritt 2: Hinzufügen einer neuen Allegro-API in Channable
- Schritt 3: Erstellen Sie Ihre Produktlisten
- Schritt 4: Senden Sie Ihre Produkte an Allegro
- Schritt 5: Prüfen Sie Ihre Produktlisten auf Fehler
Vorbereitung
Wie bei jedem anderen Marktplatz benötigen Sie für den Verkauf auf Allegro ein Allegro-Verkäuferkonto. Sie können sich auf dieser Seite für ein Verkäuferkonto anmelden.
-
Verkäuferrichtlinien einrichten: Wenn Sie ein Allegro-Verkäuferkonto haben, stellen Sie sicher, dass Sie Folgendes in diesem Konto eingerichtet haben, bevor Sie mit der Einrichtung in Channable beginnen:
- Garantierichtlinien
- Rückgaberichtlinien
- Liefereinstellungen
- Richtlinien für Beschwerdeverfahren
Sie finden dies unter Sales Settings in Ihrem Allegro-Konto, wo Sie aufgefordert werden, jede dieser Richtlinien zu benennen. Sie benötigen diese Namen während des Einrichtungsprozesses.
- Gebühren und Provisionen verstehen: Verschaffen Sie sich einen Überblick über Inseratsgebühren und Verkaufsprovisionen, um Ihre Verkaufsstrategie besser steuern zu können. Informationen von Allegro dazu finden Sie hier.
-
Besuchen Sie Allegros Hilfe-Center für internationale Verkäufer: Bevor Sie die Allegro-API einrichten, empfehlen wir Ihnen dringend, Allegros Hilfe-Center für internationale Verkäufer durchzulesen. Hier finden Sie die Grundlagen über das Verkaufen auf Allegro, wie Sie Ihr Konto beantragen und einrichten, und wie Sie durch Ihr Verkäuferkonto navigieren.
Andere Artikel, die wir empfehlen:
Die API einrichten
Schritt 1: Fügen Sie eine neue Allegro Verbindung in Channable hinzu
To create a new Allegro connection, follow the steps below:
- Navigieren Sie zunächst zur API-Seite in Ihrem Projekt und klicken Sie auf die Schaltfläche "+Neue API hinzufügen".
- Klicken Sie dann auf “+ Verbindung hinzufügen”. Diese Aktion leitet Sie auf die Seite mit den Verbindungen Ihres Unternehmens weiter.
- Suchen Sie nach der Allegro-Verbindung, indem Sie sich durch die Seiten klicken. Wenn Sie die Allegro-Verbindung gefunden haben, geben Sie eine Bezeichnung für diese neue Verbindung ein.
- Klicken Sie auf "Verbinden mit Allegro". Sie werden für den nächsten Schritt zu Allegro weitergeleitet. Sobald Sie weitergeleitet werden, melden Sie sich mit den Allegro-Anmeldedaten an.
Nach erfolgreicher Anmeldung ist die Verbindung mit Allegro hergestellt und kann genutzt werden! Sie werden zum API-Setup zurückgebracht.
Schritt 2: Fügen Sie eine neue Allegro API in Channable hinzu
Upon returning, you must select your new connection with Allegro and continue setting up your API.
-
API-Einstellungen:
- Geben Sie Ihrer API einen Namen
- Wählen Sie das Feld, das Sie für die eigenen ID pro Item verwenden möchten (wir empfehlen das Feld "id")
- API erstellen: Klicken Sie auf "Weiter", um die Erstellung der neuen Allegro-API abzuschließen.
Schritt 3: Erstellen Sie Ihre Produktangebote
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 Anforderungen für Allegro
Die folgenden Informationen sind spezifisch für Allegro. Pro Breich im Schritt "Aufbau" besprechen wir, worauf Sie achten sollten.
Item
- Währung: Stellen Sie sicher, dass die Währung dem Markt entspricht, auf den Sie abzielen (z. B. Polen ⇾ PLN).
Lieferung und Versand
-
Bearbeitungszeit:
Allegro verwendet bestimmte Formate für die Bearbeitungszeit. Siehe unten für eine Liste der akzeptierten Werte:
Format Bearbeitungszeit PT0S Sofort PT24H 24 Stunden PT2D 2 Tage P3D 3 Tage P4D 4 Tage P5D 5 Tage P7D 7 Tage P10D 10 Tage P14D 14 Tage P21D 21 Tage P30D 30 Tage P60D 60 Tage
Bilder und Beschreibung
-
Formatierung von Beschreibungen:
Allegro erwartet, dass Beschreibungen HTML verwenden. Um Fehler zu vermeiden, passen Sie Ihre Beschreibungen entsprechend an. Die folgenden HTML-Tags sind in Allegro erlaubt:
HTML Tag Anwendung <h1>
Titel <h2>
Untertitel <p>
Absatz <ul>
Stichpunkte <ol>
Nummerierte Liste <li>
für ein Produkt in der Liste <b>
Fette Schrift - Sie können eine detaillierte Beschreibung mit diesen HTML-Tags erstellen. Alternativ dazu können Sie Ihre gesamte Beschreibung in einem Absatz zusammenfassen, indem Sie diese Regel erstellen:
Weitere Optionen
-
Verkaufsrichtlinien: Unter "After-Sales-Service" können Sie die zuvor erwähnten Richtlinien einreichen. Allegro wird Ihre Produkte mit den Verkaufsrichtlinien verknüpfen, die Sie in Ihrem Allegro-Verkäuferkonto eingerichtet haben, indem es die Namen dieser Richtlinien verwendet. Um sicherzustellen, dass jedes Produkt mit der richtigen Verkaufsrichtlinie verknüpft ist, geben Sie die Namen dieser Richtlinien in die entsprechenden Felder ein, indem Sie einen manuellen Wert erstellen.
Wenn Sie mehrere Verkaufsrichtlinien verwenden, fügen Sie neue Felder in Ihrem Import Mapping hinzu und geben Sie die Namen der Richtlinien mithilfe dynamischer Regeln ein.
Zusätzliche Informationen
-
Felder leer lassen
Gut zu wissen: Allegro füllt eine bestimmte Gruppe von Feldern selbst aus, wenn diese Felder leer sind. Zum Beispiel: das Feld "Verkaufsmodusformat" wird auf "BUY_NOW" gesetzt, wenn das Feld leer ist. Oder wenn Sie das "Datum der Veröffentlichung" leer lassen, wird Allegro dies als "Angebot wird sofort aktiviert" lesen. -
Parent/Child-Struktur
Allegro handhabt dies anders als andere Plattformen. Anstatt dass Verkäufer Allegro mitteilen, was die 'Children' sind, bestimmt Allegro dies selbst, basierend auf den Produktinformationen, die in Ihren Inseraten enthalten sind. Das bedeutet, dass Sie in Channable nichts einrichten müssen, um gruppierte Angebote zu erstellen.
Diese Richtlinien helfen Ihnen, sicherzustellen, dass Ihre Allegro-Listings korrekt und entsprechend den Anforderungen von Allegro eingerichtet sind.
Schritt 4: Senden Sie Ihre Produkte an Allegro
Sie haben es fast geschafft, Ihre Produktangebote sind bereit zum Versenden. Wenn Sie Ihr Projekt noch nicht aktiviert haben, gehen Sie zu "Einstellungen" auf der linken Seite des Bildschirms und klicken Sie auf "Projekt aktivieren". Gehen Sie anschließend zurück zur API-Übersicht und gehen Sie zu "Ihr Allegro 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 API-Übersicht und wählen die blaue Schaltfläche "Aktualisieren", um Ihre Produktangebote an Allegro zu senden.
Schritt 5: Prüfen Sie Ihre Produktangebote auf Fehler
Nachdem Sie Ihre Produktauflistungen an Allegro gesendet haben, gehen Sie zur Registerkarte Resultat Ihrer Allegro API. Klicken Sie in den Registerkarten auf 'Fehler'. Jetzt können Sie sehen, welche Produktangebote Fehler haben und nicht gelistet werden. Klicken Sie auf einen bestimmten Fehler, um weitere Informationen über die Ursache des Fehlers zu erhalten.
Häufige Fehler und Lösungen
To help you efficiently handle common errors when using Channable with Allegro, we’ve detailed some typical errors and their solutions below. This table provides clear, actionable steps to resolve these issues.
Fehler | Beschreibung | Lösung |
---|---|---|
VALIDATION ERROR | Von Allegro generiert, um zu verhindern, dass der Exporter bei vermeidbaren Fehlern (z. B. leere Preisfelder oder falsche HTML-Tags) wiederholt ausgeführt wird. |
Korrigieren Sie die in der Fehlermeldung angezeigten zugehörigen Daten, um dieses Problem zu beheben. Allegro hat eine bestimmte Anzahl von HTML-Elemente, die es unterstützt, wie hier beschrieben. Allegro erwartet, dass die Beschreibung im HTML-Format vorliegt, so dass das Entfernen aller HTML- Elemente das Problem nicht beheben wird. |
Channable VALIDATION ERROR | Wird von Channable generiert, um zu verhindern, dass der Exporter bei vermeidbaren Fehlern wiederholt ausgeführt wird. | Korrigieren Sie die in der Fehlermeldung angezeigten zugehörigen Daten, um dieses Problem zu beheben. |
PARAMETER_MISMATCH | Dieser Fehler tritt auf, wenn der EAN-/GTIN-Code bereits in Allegro bekannt sind und Sie ein Attribut eingegeben haben, das nicht mit dem übereinstimmt, was Allegro erwartet. | Sie können diesen Fehler beheben, indem Sie den Wert im Attribut auf den von Allegro vorgeschlagenen Wert ändern. Dieser Vorschlagswert wird in der Fehlermeldung angezeigt. |
CATEGORY_MISMATCH | Dieser Fehler ist ähnlich wie der bereits erwähnte 'Parameter Mismatch', aber für Kategorien. Allegro erwartet, dass ein Artikel in eine bestimmte Kategorie passt, aber Sie haben eine andere Kategorie angegeben. | Sie können dies beheben, indem Sie Ihre Kategorieneinrichtung ändern. Der richtige Wert wird in der Fehlermeldung angezeigt. |
Attribute Value Error | Channable versucht, einen neuen zulässigen Wert für ein Attribut zu erstellen, aber Allegro zeigt an, dass der Wert bereits bekannt ist, allerdings mit anderer Großschreibung oder ähnliches. | Um diesen Fehler zu beheben, müssen Sie den Wert, den Sie derzeit in den Attributen eingestellt haben, auf die Werte ändern, die in der Liste der erlaubten Werte" angezeigt werden, einschließlich Groß- und Kleinschreibung, Leerzeichen und Akzente. |