# Einrichten einer vtwonen API
{% stepper %}
{% step %}
### Schritt 1: Erstelle eine neue Verbindung
* Navigiere zu **\[Dein Projekt] > Kanäle**.
* Klicke **+Add new API**. Du wirst zur Verbindungsseite deiner Firma weitergeleitet.
* Auf der Verbindungsseite wähle **+Neue Verbindung hinzufügen.**
* Suche die Verbindung „vtwonen“, indem du durch die Seiten klickst, und wähle sie durch Anklicken aus.
* Füge ein Label hinzu.
* Klicke **Erstellen**. Du wirst für den nächsten Schritt zu vtwonen weitergeleitet.
* Sobald du weitergeleitet wurdest, melde dich mit deinen vtwonen-Zugangsdaten an.
Nach erfolgreicher Anmeldung ist die Verbindung mit vtwonen bereit. Anschließend wirst du zurück zur API-Einrichtung geleitet.
{% endstep %}
{% step %}
### Schritt 2: Erstelle die API
Nachdem du deine Verbindung erstellt hast, musst du deine neue vtwonen-Verbindung auswählen und deine API-Einstellungen konfigurieren:
* Im **Name** feld, gib einen Namen für deine API ein.
* Wähle die **Eigene ID pro Item** aus dem Dropdown. Wir empfehlen das Feld 'id'.
* Wähle die **Sprache** für deine API.
* Klicke **Weiter** um deine vtwonen-API zu erstellen.
{% endstep %}
{% step %}
### Schritt 3: Erstelle deine Produktangebote
Folge diesen Schritten, um deinen Kanal einzurichten.
{% stepper %}
{% step %}
#### Kategorisiere deine Produkte
Weise deinen Produkten Kategorien zu, um die Produktdaten einzurichten.
* KI-Produktkategorisierung: Weist Produktkategorien automatisch mithilfe unseres Algorithmus zu.
* Manuelle Kategorisierung: Ordne Produktkategorien manuell mit benutzerdefinierten Regeln zu. Du kannst detaillierte Filter erstellen, um jedes Produkt der richtigen Kategorie zuzuordnen.
* Nicht kategorisierte Items: Produkte, die noch überprüft und kategorisiert werden müssen
[Erfahre mehr über die Kategorisierung für Marktplätze](https://helpcenter.channable.com/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/erste-schritte-mit-marktplatzen/marktplatze-schritt-kategorisierung)
{% endstep %}
{% step %}
#### Regeln einrichten
Regeln helfen dir, deine Produktdaten schnell für den gewünschten Marktplatz zu optimieren.
* Regelvorlagen: Häufig verwendete Regeln, die du an deinen Anwendungsfall anpassen kannst.
* Regel-Setup: Richte Regeln ein, um deine Produktdaten zu verfeinern. Das kann Filtern, Ändern oder Erweitern von Datenfeldern umfassen, damit die Anforderungen des Marktplatzes erfüllt werden.
[Lies mehr darüber, wie man Regeln für Marktplätze nutzt](https://helpcenter.channable.com/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/erste-schritte-mit-marktplatzen/marktplatze-schritt-regeln)
{% endstep %}
{% step %}
#### Erstelle deine Listings
Der **Der Build-** Schritt, in dem du deine Produktlistings so konfigurierst, dass sie den Marktplatzanforderungen entsprechen. Dieser Schritt ist wichtig, damit deine Produkte live gehen und Fehler vermieden werden.
Pflicht- und optionale Felder:
* **Pflichtfelder** : Erforderlich, um deine Produkte auf diesem Marktplatz zu listen
* **Empfohlen** : Empfohlen, um Fehler zu vermeiden
* **Optional** : Nicht erforderlich für die Listung
Gemeinsame Attribute
* Gemeinsame Attribute sind die allgemeinen Felder, die für deine Produkte gelten, wie EAN, Preise und Titel. Dieser Schritt sorgt für Einheitlichkeit der Basis-Produktinformationen über deine Listings hinweg.
* Verwende statische oder dynamische Werte:
* Statische Werte: Feste Werte, die sich nicht ändern (z. B. Markenname, Hersteller)
* Dynamische Werte: Felder, die sich automatisch anhand der verknüpften Daten ändern (z. B. Bestand, Preise)
Kategorie-spezifische Attribute
* Kategoriespezifische Attribute sind Felder, die speziell für die Kategorie deiner Produkte gelten. Dieser Schritt hilft, deine Listings an die Kategorievorgaben des Marktplatzes anzupassen.
* Fülle Attribute aus, die spezifisch für die ausgewählte Kategorie sind (z. B. Größe bei Kleidung oder Abmessungen bei Möbeln).
[Erfahre mehr über den Build-Schritt für Marktplätze](https://helpcenter.channable.com/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/erste-schritte-mit-marktplatzen/marktplatze-schritt-erstellen)
{% endstep %}
{% step %}
#### Überprüfe die Qualität deiner Einrichtung
Der **Qualität** Dieser Schritt gibt Feedback zu deinem Kanal, bevor du ihn aktivierst. Er hebt Pflicht- und optionale Fehler hervor, damit deine Produktdaten den Anforderungen für die Listung auf dem Marktplatz entsprechen.
* Behebe Fehler und priorisiere dabei zuerst Pflichtfehler.
Aktionen:
* **Artikel anzeigen**: Zeigt Produkte mit bestimmten Problemen an.
* **Im Aufbau-Schritt anzeigen**: Leitet weiter zu den **Der Build-** Schritt, um fehlende Informationen zuzuordnen.
* **Kategorien festlegen**: Führt zu den **Kategorien** Schritt, um Artikel zu kategorisieren.
* **Quelle anzeigen**: Verfügbar für ID-Felder. Führt zu den **Einstellungen** Schritt.
[Erfahre mehr über den Quality-Schritt für Marktplätze](https://helpcenter.channable.com/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/erste-schritte-mit-marktplatzen/marktplatze-schritt-qualitat)
{% endstep %}
{% step %}
#### Vorschau vor Aktivierung
Der **Vorschau** Der Schritt zeigt die Attribute an, die du im **Der Build-** Schritt zugeordnet hast, und hilft dir zu prüfen, ob alles korrekt konfiguriert ist, indem er eine Übersicht deiner Produkte und möglicher Fehler bietet.
Filterung:
* Nach Fehler filtern: Klicke auf das **alle** Dropdown und wähle aus, ob nur Produkte mit Fehlern oder Produkte mit einem bestimmten Fehler angezeigt werden sollen.
* Nach Kategorie filtern: Klicke auf das **Alle Kategorien** Dropdown und wähle die Kategorie, nach der du filtern möchtest.
Bevor du fortfährst:
* Geteilte Attribute prüfen: Stelle sicher, dass alle verpflichtenden gemeinsamen Attribute ausgefüllt sind.
* Kategoriespezifische Attribute prüfen: Stelle sicher, dass alle verpflichtenden kategoriespezifischen Attribute ausgefüllt sind.
* Auf Fehler prüfen: Korrigiere alle rot markierten Felder.
[Erfahre mehr über den Vorschau-Schritt für Marktplätze](https://helpcenter.channable.com/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/erste-schritte-mit-marktplatzen/marktplatze-schritt-vorschau)
{% endstep %}
{% endstepper %}
{% endstep %}
{% step %}
### Zusätzliche Anforderungen für vtwonen
Diese Attributanforderungen sind spezifisch für vtwonen und gelten für die Attribute im **Der Build-** Schritt.
Tab „Geteilte Attribute“
* Versandklasse (logistische Klasse): Die logistischen Klassen bestimmen die jeweiligen Versandkosten für deine Items. Gib die logistische Klasse deines Produkts an.
* Lieferzeit bis Versand: Die Versandvorlaufzeit gibt an, wie lange es bis zur Übergabe des Pakets an den Versand dauert. Gib die Versandzeit in Tagen an.
Anforderungen an den Titel
Produkt-Titel sollten aus Folgendem bestehen:
| | |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **Marke** | Der Markenname, so wie er registriert ist |
| **Produkttyp** | Die Produktkategorie, zum Beispiel „sofa“. Diese muss in Kleinbuchstaben geschrieben sein |
| **Reihe/Produktname** | Die Reihe oder der Produktname, der hilft, die Variante des Produkts zu identifizieren. Jedes Wort muss mit einem Großbuchstaben beginnen |
| **Attribute** | Die unterscheidenden Merkmale des Produkts, z. B. Farbe, Maße oder Material |
* Struktur: Marke Produkttyp Name - Attribute
* Beispiel: vtwonen Pendelleuchte Titan - schwarz.
Produktbeschreibung
Die Produktbeschreibungen für deine vtwonen-API sollten:
* den Kunden ansprechen („du“ und „dein“)
* in einem freundlichen, hilfreichen und respektvollen Ton verfasst sein
* Fachbegriffe oder technische Ausdrücke vermeiden, wenn sie für die Zielgruppe nicht relevant sind
* die Produktmerkmale sowie Vorteile und Nutzungserlebnis beschreiben
* relevante Keywords verwenden
* keine Abkürzungen enthalten
Produktbeschreibungen sollten Folgendes enthalten:
| | |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Kurzbeschreibung** | Eine Übersicht über das Produkt, die die wichtigsten Merkmale hervorhebt. HTML ist nicht erlaubt |
| **Aufzählungspunkte** | Die wichtigsten Merkmale und Vorteile des Produkts. Mindestens 3 und maximal 5 Punkte |
| **Lange Beschreibung** | Detaillierte Informationen zu Produktmerkmalen, Spezifikationen, Materialien und Nutzung. Ebenso Stil- und Pflegehinweise. HTML ist erlaubt (fett und Listen) |
Bildanforderungen
| | |
| ------------------------ | ------------------------------------------------ |
| **Minimale Auflösung** | 800 x 800 px |
| **Maximale Auflösung** | 4472 x 4472 px |
| **Unterstützte Formate** | JPEG, PNG, WebP, GIF |
| **Stil** | Keine Wasserzeichen, Logos oder Textbestandteile |
Videoanforderungen
| | |
| ------------------------ | ---------------------------------------------------------------------------- |
| **Dauer** | Zwischen 30 Sek. und 2 Min. |
| **Auflösung** | 1080p oder höher |
| **Unterstützte Formate** | .mp4, .mov, .avi, .flv |
| **Stil** | Keine Rahmen, Skizzen, Wasserzeichen, Logos,
Etiketten oder Preise
|
| {% endstep %} | |
{% step %}
### Best Practices
* 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.
* Seller-Produkt-ID für Einzel-/einfache Produkte: Es gibt zwei Attribute namens 'SellerArticleId' bzw. '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.
Für weitere Informationen zu Mirakl-Marktplatz-Fehlern, Anleitungen und Best Practices, sieh dir [unsere spezielle Anleitung](https://helpcenter.channable.com/hc/en-us/articles/360012678720-Mirakl-guide-settings-and-solutions).
{% endstep %}
{% step %}
### Schritt 4: Sende deine Produktlistings an vtwonen
Sobald deine Produktlistings fertig sind, musst du sie an vtwonen senden:
* Wenn du dein Projekt noch nicht aktiviert hast, gehe zu **\[Dein Projekt] > Einstellungen** und klicke **Projekt aktivieren**.
* In **\[Dein Projekt] > APIs**, gehe zu **\[Deine vtwonenAPI] > Einstellungen**.
* Klicke **API aktivieren**.
* Nachdem du die API aktiviert hast, navigiere zurück zu **APIs**.
* Klicke auf die **Aktualisieren** Button in der Spalte ‚Status‘, um deine Produktlistings an vtwonen zu senden.
{% endstep %}
{% step %}
### Schritt 5: Überprüfe deine Produktangebote auf Fehler
* Um auf Fehler zu prüfen, navigiere zur **Resultat > Tab Fehler**. Hier findest du eine Liste der Produktlistings, die Fehler aufweisen.
* Klicke auf den spezifischen Fehler, um mehr Informationen darüber anzuzeigen, was den Fehler verursacht.
{% endstep %}
{% endstepper %}
---
# 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-vtwonen-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.