Eine Worten API einrichten

Worten ist ein digitales Unternehmen, mit 240 physischen Geschäften, das sich auf Portugal und Spanien konzentriert. Das Unternehmen vertreibt Haushaltsgeräte, IT-Produkte, Telekommunikation, Ton & Bild und Unterhaltung und hat in letzter Zeit in die Bereiche Spielzeug, Schönheit, Wohnen & Gesundheit, Sport, Bücher, Haus & Dekoration, Heimwerken & Garten und sogar Produkte für Haustiere investiert.

• Schritt 1: Eine neue Worten-Verbindung hinzufügen
• Schritt 2: Fügen Sie eine neue Worten API in Channable hinzu
• Schritt 3: Erstellen Sie Ihre Produktangebote in Channable
• GPSR- und DSA-Anforderungen
• Schritt 4: Senden Sie Ihre Produkte an Worten
• Schritt 5: Überprüfen Sie Ihre Produktangebote auf Fehler

Schritt 1: Eine neue Worten-Verbindung hinzufügen

Die API von Worten nutzt die Mirakl-Plattform, d.h. Sie benötigen ein Mirakl-Konto, um Ihre Produktangebote an Worten zu senden.

Wenn Sie ein Mirakl Worten Praxis Konto haben, loggen Sie sich ein und navigieren Sie zu "[Ihr Unternehmen] Einstellungen (oben rechts) > Verbindungen". Klicken Sie auf "+ Verbindung hinzufügen" und Sie gelangen zu einem Bildschirm, auf dem Sie Worten auswählen können. Geben Sie ein Label für Ihre Verbindung ein, zum Beispiel: "Worten". Klicken Sie dann auf "Verbinden mit Worten". Sie werden zu einer Umgebung weitergeleitet, in der Sie sich mit Ihren Mirakl-Zugangsdaten anmelden können. Nach dem Einloggen werden Sie zurück zu Channable weitergeleitet, wo die Verbindung verfügbar sein wird.

Schritt 2: Fügen Sie eine neue Worten API in Channable hinzu

Gehen Sie nun zur API-Übersicht in Ihrem Projekt. Klicken Sie auf "+ Neue API hinzufügen", wählen Sie die soeben erstellte Worten-Verbindung aus und geben Sie Ihrer neuen API einen Namen.

Wählen Sie das Feld, welches Sie als eigene ID pro Item verwenden möchten (wir empfehlen das Feld "id") und die Sprache, in der Sie Kategorisierungen vornehmen und Attribute einrichten. Sie können hier auch eine Masterregelgruppe hinzufügen, wenn Sie möchten. Klicken Sie auf "Weiter", um die Erstellung der neuen Maxeda Paxis API abzuschließen.

Schritt 3: Erstellen Sie Ihre Produktangebote in Channable

Sobald Sie die Worten API erstellt haben, können Sie Ihre Produktdaten einrichten, 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. In unserem Artikel häufig genutzter Regeln finden Sie einige Beispiele.
   
   
3. Aufbau
   Hier finden Sie unsere voreingestellte Vorlage für die Produktangebote. 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 "Preis" sollte zum Beispiel den Preis Ihres Produkts anzeigen und so weiter. Wenn Sie mit dem Einrichten der Produktangebote fertig sind, klicken Sie einfach auf "Speichern" am unteren Rand des Bildschirms.
   
   
   Wichtig: Im Gegensatz zu anderen Mirakl-APIs gibt es bei Worten im Schritt "Aufbau" keinen "Titel". Es gibt im Schritt "Attribute" der API ein "Product Name Pt" Feld, das von Worten als obligatorisch gekennzeichnet ist, sowie ein "Product Name Es" Feld. Die Beschreibung für beide Sprachen muss hingegen im Schritt "Aufbau" eingegeben werden.
   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.
   
   Im Schritt " Aufbau" finden Sie auch die Registerkarte "Verkaufskanäle", wo Sie Ihre Preisinformationen für jeden einzelnen Verkaufskanal von Worten eingeben können. Mehr Informationen über diese Verkaufskanäle gibt es hier.
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.

GPSR- und DSA-Anforderungen

Die Europäische Union (EU) hat neue GPSR- und DSA-Anforderungen für Online-Plattformen, einschließlich Marktplätzen, eingeführt.

Stellen Sie für Ihre Worten-API in Channable sicher, dass Sie die Attribute im Schritt Attribute (V1 Marktplätze) oder im Tab Kategorie-spezifische Attribute pro Kategorie im Schritt Aufbau (V2 Marktplätze) ausfüllen:

• Email Address Of The Person Responsible In The Eu
• Postal Address Of The Person Responsible In The Eu
• Name Of Person Responsible In The Eu

Schritt 4: Senden Sie Ihre Produkte an Worten

Sie haben es fast geschafft: Ihre Produktangebote sind bereit zum Senden. Wenn Sie Ihr Projekt noch nicht aktiviert haben, gehen Sie auf Setup > Projekteinstellungen auf der linken Seite des Bildschirms und klicken Sie auf "Projekt aktivieren". Danach gehen Sie zurück zur API-Übersicht und gehen Sie zu "Ihr Worten API-Name" > Einstellungen, wo Sie die API aktivieren, indem Sie "API aktivieren" wählen. Nachdem Sie diesen Schritt abgeschlossen haben, gehen Sie zurück zur API-Übersicht und wählen Sie die blaue Schaltfläche "Aktualisieren", um Ihre Produktangebote an Worten zu senden.

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

Nachdem Sie Ihre Produktangebote an Worten gesendet haben, gehen Sie auf die Registerkarte Resultat Ihrer Worten API. Klicken Sie im Filter auf 'Fehler'. Jetzt können Sie sehen, welche Produktangebote Fehler aufweisen und nicht platziert werden. Klicken Sie auf einen bestimmten Fehler, um mehr Informationen über die Ursache des Fehlers zu erhalten. Wenn Sie einige Fehler durch Änderung der Einstellungen oder der Produktinformation behoben haben, führen Sie die Worten API erneut aus, um die neuen Ergebnisse zu sehen.