# Einrichten einer Worten API
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.
| [](https://helpcenter.channable.com/hc/article_attachments/13880231501842) | [](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.
{% 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 %}
{% 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-vertriebskanale-einrichten](https://helpcenter.channable.com/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/mirakl-marktplatze/mirakl-vertriebskanale-einrichten "mention")
{% endstep %}
{% endstepper %}
{% endstep %}
{% step %}
### GPSR- und DSA-Anforderungen
Die Europäische Union (EU) hat neue [GPSR- und DSA-Anforderungen](https://helpcenter.channable.com/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/erste-schritte-mit-marktplatzen/was-du-tun-musst-um-gpsr-und-dsa-konform-zu-sein) 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-anleitung-einstellungen-und-losungen](https://helpcenter.channable.com/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/mirakl-marktplatze/mirakl-anleitung-einstellungen-und-losungen "mention")
---
# Agent Instructions: 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:
```
GET https://helpcenter.channable.com/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/mirakl-marktplatze/einrichten-einer-worten-api.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.