> For the complete documentation index, see [llms.txt](https://helpcenter.channable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.channable.com/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/mirakl-marktplatze/eine-worten-api-einrichten.md). # Eine Worten API einrichten {% hint style="info" %} **UI-Update:** Es gibt eine neue Kanalauswahlseite und Übersicht für **Feeds** und **Marktplätze** (früher APIs genannt)! Einige Grafiken und Anweisungen sind möglicherweise nicht mehr aktuell. {% endhint %} Worten ist ein digitales Unternehmen mit zusätzlich 240 stationären Geschäften, das sich auf Portugal und Spanien konzentriert. Sie verkaufen Haushaltsgeräte, IT-Produkte, Telekommunikation, Audio & Bild sowie Unterhaltung. Neuerdings haben sie auch in Spielzeug, Beauty, Wohnen & Gesundheit, Sport, Bücher, Heim & Dekoration, DIY & Garten und sogar Produkte für Haustiere investiert. {% stepper %} {% step %} ### Eine neue Worten-Verbindung hinzufügen Die Worten-API nutzt die Mirakl-Plattform. Das bedeutet, du benötigst ein Mirakl-Konto, um deine Produktangebote an Worten zu senden. Hast du ein Mirakl-Worten-Konto, gehe zu „Connections > Add connection“. Klicke auf „+ Add a new connection“ und wähle Worten aus. Vergib ein Label für deine Verbindung, z. B. Worten. Klicke dann auf „Connect with Worten“. Du wirst in die Umgebung weitergeleitet, in der du dich mit deinen Mirakl-Zugangsdaten einloggen kannst. Nach dem Login wirst du zurück zu Channable geleitet, wo die Verbindung verfügbar ist. | [![Worten add connection.png](/files/b84ac7ed7f7ad737dd8b7893a210d3bb9d966633)](https://helpcenter.channable.com/hc/article_attachments/13880231501842) | [![Mirakl API - Worten.png](/files/13a2c893e378b305dbe574b9dbdfed82202a0755)](https://helpcenter.channable.com/hc/article_attachments/21020603799314) | | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | {% endstep %} | | {% step %} ### Eine neue Worten-API in Channable hinzufügen Gehe nun in deinem Projekt zur API-Übersicht. Klicke auf „+ Add new API“, wähle die gerade erstellte Worten-Verbindung und gib deiner neuen API einen Namen.
Wähle das Feld, das du verwenden möchtest für **Eigene ID pro Item** (wir empfehlen das Feld 'id), und das **Sprache** in dem du Kategorisierungen vornimmst und Attribute einstellst. Klicke auf „Continue“, um die neue Worten-API zu erstellen. {% hint style="warning" %} Wichtig: Worten bietet in unserer API die Option, Sales Channels zu definieren. Wenn du mehr über Channels wissen möchtest oder wie du das einrichtest, folge bitte den Schritten in [diesem Artikel](https://helpcenter.channable.com/hc/en-us/articles/11883675662482). Das Einrichten separater Worten-APIs für unterschiedliche Länder unter derselben Verbindung funktioniert nicht, da sich diese APIs gegenseitig überschreiben würden. {% endhint %} {% endstep %} {% step %} ### Erstelle deine Produkt-Listings in Channable Sobald du die Worten-API erstellt hast, kannst du deine Produktdaten einrichten, indem du den Schritten der API folgst. {% stepper %} {% step %} #### Kategorien Damit deine Produktlistings erstellt werden können, brauchen deine Produkte eine Kategorie. Füge deinen Produkten Kategorien hinzu, indem du die [Kategorien automatisch generieren-Funktion](/manage-improve-product-data/manage-product-and-improve-data-de/produkte-kategorisieren/produktkategorien-erstellen/verwende-die-funktion-kategorien-automatisch-generieren.md) oder [neue Kategorien von Grund auf erstellst](/manage-improve-product-data/manage-product-and-improve-data-de/produkte-kategorisieren/produktkategorien-erstellen/kategorien-manuell-hinzufugen.md). {% endstep %} {% step %} #### Regeln Erstellen [verschiedene Regeln](/manage-improve-product-data/manage-product-and-improve-data-de/regeln-massenbearbeitung-und-anreicherung/regeln-verwenden.md) um deine Produktlistings zu optimieren. {% endstep %} {% step %} #### Build - Gemeinsame Attribute Gemeinsame Attribute sind Attribute, die für alle deine Items gelten, wie Preis und Bestand. 1. Beginne damit, Felder zu Attributen zuzuordnen, die vom Marktplatz als erforderlich markiert sind. 2. Prüfe die übrigen Attribute und ordne Felder denjenigen zu, die für dein Unternehmen relevant sind. 3. Klicke auf **Speichern**. {% endstep %} {% step %} #### Build - Attribute pro Kategorie Kategorieattribute sind Attribute, die für Items aus bestimmten Kategorien gelten, zum Beispiel Batteriedaten für elektronische Items oder Größenangaben für Kleidung. 1. Beginne damit, Felder zu Attributen zuzuordnen, die vom Marktplatz als erforderlich markiert sind. 2. Prüfe die übrigen Attribute und ordne Felder denjenigen zu, die für dein Unternehmen relevant sind. 3. Klicke auf **Speichern**. {% endstep %} {% endstepper %} {% hint style="warning" %} Im Vergleich zu anderen Mirakl-APIs hat Worten im Build-Schritt kein 'title'. Es gibt ein „Product Name Pt“, das von Worten als Pflichtfeld gesetzt ist, und „Product Name Es“ im Attributes-Schritt der API. Die Beschreibung für beide Sprachen muss im Build-Schritt ausgefüllt werden. {% endhint %} {% hint style="success" %} **Tipp:** Fahre mit der Maus über :circle-question: für weitere Informationen zu spezifischen Feldanforderungen. {% endhint %} {% stepper %} {% step %} Im Build-Schritt findest du außerdem den Reiter Sales channels, in dem du die Preisangaben für jeden einzelnen Sales Channel auf Worten eintragen kannst. Weitere Informationen zu diesen Sales Channels findest du hier: [Mirakl-Vertriebskanäle einrichten](/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/mirakl-marktplatze/mirakl-vertriebskanale-einrichten.md) {% endstep %} {% endstepper %} {% endstep %} {% step %} ### GPSR- und DSA-Anforderungen Die Europäische Union (EU) hat neue [GPSR- und DSA-Anforderungen](/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/erste-schritte-mit-marktplatzen/was-du-tun-musst-um-gpsr-und-dsa-konform-zu-sein.md) für Online-Plattformen, einschließlich Marktplätzen. Für deine Worten-API in Channable stelle sicher, dass du die kategorien-spezifischen **Attributes per category** Registerkarte im **Der Build-** Schritt ausfüllst: * **E-Mail-Adresse der für die EU verantwortlichen Person:** Gib die E-Mail-Adresse der in der EU verantwortlichen Person ein. * **Postanschrift der für die EU verantwortlichen Person:** Gib die Postanschrift der in der EU verantwortlichen Person an. * **Name der für die EU verantwortlichen Person:** Gib den Namen der in der EU verantwortlichen Person ein. {% hint style="info" %} Diese Attribute sind erforderlich, um den Anforderungen der EU-GPSR und den Marktplatzpflichten nach DSA zu entsprechen. {% endhint %} {% endstep %} {% step %} ### Sende deine Produkte an Worten Fast geschafft — deine Produktangebote sind bereit zum Versenden. Falls du dein Projekt noch nicht aktiviert hast, gehe links in die Projekteinstellungen und klicke auf „activate project“. Gehe danach zurück zur API-Übersicht und öffne „Your Worten API Name > Settings“, wo du die API durch Auswahl von „Activate API“ aktivierst. Nachdem du diesen Schritt abgeschlossen hast, navigiere zurück zur API-Übersicht und klicke auf den blauen Button „Run now“, um deine Produktangebote an Worten zu senden. {% endstep %} {% step %} ### Prüfe deine Produkt-Listings auf Fehler Nachdem du deine Produktangebote an Worten gesendet hast, öffne den Reiter Results deiner Worten-API. Setze im Filter 'error'. Jetzt siehst du, welche Produktangebote Fehler haben und nicht platziert wurden. Klicke auf einen konkreten Fehler, um mehr Informationen zur Ursache zu erhalten. Hast du Fehler behoben, indem du Einstellungen oder Produktinformationen geändert hast, führe die Worten-API erneut aus, um die neuen Ergebnisse zu sehen. {% endstep %} {% endstepper %} ### Best Practices {% hint style="info" %} Mehrere Attributwerte hinzufügen: Wenn du bei Mirakl-Marktplätzen mehrere Werte in einem Attributfeld angibst, trenne jeden Wert mit einem senkrechten Strich "|", damit die Werte korrekt erkannt und verarbeitet werden. {% endhint %} {% hint style="info" %} Seller's Product ID für Einzel-/Einfachprodukte: Es gibt zwei Attribute namens 'SellerArticleId' und 'SellerProductId'. 'SellerProductId' bezieht sich auf die Parent-ID, während 'SellerArticleId' die Variantenartikel bezeichnet. Bei Einzelprodukten müssen beide Attribute mit demselben Wert gefüllt werden. {% endhint %} Für weitere Informationen zu Mirakl-Marktplatz-Fehlern, Anleitungen und Best Practices, sieh dir [Mirakl-Leitfaden: Einstellungen und Lösungen](/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/mirakl-marktplatze/mirakl-leitfaden-einstellungen-und-losungen.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://helpcenter.channable.com/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/mirakl-marktplatze/eine-worten-api-einrichten.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.