Eine Miravia-API einrichten

Um mit dem Verkauf Ihrer Produkte auf dem Miravia-Marktplatz zu beginnen, benötigen Sie ein Miravia-Verkäuferkonto. Wenn Sie noch kein Miravia-Verkäuferkonto haben, empfehlen wir Ihnen, sich mit Miravia in Verbindung zu setzen, um dieses zu erhalten. Sobald Sie ein Miravia-Verkäuferkonto eingerichtet haben, können Sie eine Verbindung mit Channable herstellen.

Inhaltsverzeichnis

• Schritt 1: Eine neue Verbindung erstellen
• Schritt 2: Eine Miravia-API erstellen
• Schritt 3: Produktlistings erstellen
• GPSR- und DSA-Anforderungen
• Schritt 4: Produktlistings an Miravia senden
• Schritt 5: Überprüfen Sie Ihre Produktlistings auf Fehler

Schritt 1: Eine neue Verbindung erstellen

Um eine neue Miravia-Verbindung zu erstellen, gehen Sie wie folgt vor:

1. Navigieren Sie zur Registerkarte Kanäle. Klicken Sie auf "+ Kanal erstellen".

2. Klicken Sie dann auf "+ Verbindung hinzufügen". Diese Aktion leitet Sie auf die Seite mit den Verbindungen Ihres Unternehmens weiter.

3. Suchen Sie die "Miravia"-Verbindung, indem Sie sich durch die Seiten klicken. Wenn Sie die "Miravia"-Verbindung gefunden haben, geben Sie ein Label für diese neue Verbindung an.
   
4. Klicken Sie auf "Verbinden mit Miravia". Sie werden für den nächsten Schritt zu Miravia weitergeleitet. Nach der Weiterleitung melden Sie sich mit den Miravia-Anmeldedaten an.

Nach erfolgreicher Anmeldung ist die Verbindung mit Miravia hergestellt und kann genutzt werden! Sie werden zum API-Setup zurückgeleitet.

Schritt 2: Eine Miravia-API erstellen

Im Berich "APIs" können Sie dann Ihre neu erstellte Miravia-Verbindung auswählen und mit der Einrichtung der API beginnen.

1. API Einstellungen konfigurieren
   • Geben Sie der API einen Namen
   • Wählen Sie die Sprache der API aus
   • Wählen Sie die eigene ID pro Item aus (wir empfehlen das Feld "id")
2. Erstellen Sie die API: Klicken Sie on "weiter", um die neue Miravia API zu erstellen.

Schritt 3: Produktlistings erstellen

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

2. Regeln

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

1. Gehen Sie zum Aufbau-Schritt: Gehen Sie zunächst zur zentralen Benutzeroberfläche des Aufbau-Schrittes. Hier werden Sie alle Produktattribute verwalten und zuordnen.
2. 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

1. 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.

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

1. Wählen Sie eine Produktkategorie: Wählen Sie die entsprechende Kategorie für Ihr Produkt, z. B. Kleidung oder Möbel.
2. 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"

Zusätzliche Anforderungen für Miravia

Die folgenden Informationen beziehen sich speziell auf Miravia; im Folgenden erläutern wir pro Bereich im Schritt "Aufbau" worauf Sie achten sollten.

Item

• Item group ID: Dieses Feld wird verwendet, um mehrere Variantenartikel in einer gruppierten Auflistung zusammenzufassen. Wenn Sie keine Varianten haben, können Sie für item_group_id die eindeutige ID des Artikels auswählen.

Versand

• Obligatorische Felder: Stellen Sie sicher, dass alle Versandinformationsfelder, wie z. B. Gewicht, Länge und Inhalt, mit Werten größer als 0 und mit nicht mehr als 2 Dezimalstellen ausgefüllt sind. Falls nicht bekannt, setzen Sie diese Werte mithilfe einer Regel auf 1.
• Lieferung durch den Verkäufer: Setzen Sie diese Option nur nach vorheriger Genehmigung durch Miravia auf "Ja", ansonsten setzen Sie sie auf "Nein", um Fehler zu vermeiden. Detaillierte Informationen finden Sie im Artikel "Delivery by Miravia" in unserem Help Center.
• Standardwerte: Wenn die Versandwerte nicht bekannt sind, setzen Sie sie alle mithilfe einer Regel auf 1.

Bilder

• Bilder verknüpfen: Verknüpfen Sie das/die Feld(er) mit Ihren Bildern.
• Bildanforderungen: Halten Sie die strengen Bildanforderungen von Miravia sowohl für die URL als auch für das eigentliche Bild ein. Die Nichteinhaltung führt zu der Fehlermeldung "Could not upload image due to: .. E302: "Description of error" im Schritt "Resultat".
  

Wenn Sie sich an diese Anleitung halten, können Sie sicher sein, dass Ihre Miravia-Inserate korrekt und entsprechend den Anforderungen des Anbieters eingerichtet sind.

GPSR- und DSA-Anforderungen

Wie man DSA-Informationen in Channable hinzufügt

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

Schritt 1: Angaben zum Hersteller und zur verantwortlichen Person registrieren

Erstellen Sie zunächst Profile im Seller Central von Miravia und navigieren Sie dann zur Verwaltungsseite für Herstellerinformationen (Manufacturer Information management). Sie finden dort zwei Registerkarten:

• Manufacturer Information
• EU Responsible Person Information

Fügen Sie auf der Registerkarte „Manufacturer Information“ die Angaben zum Hersteller hinzu. Auf der Registerkarte „EU responsible person“ fügen Sie die Angaben zur verantwortlichen Person in der EU hinzu. Nachfolgend finden Sie Screenshots zu diesem Vorgang.

Sie erhalten daraufhin eine Hersteller-ID und eine EU-Verantwortlichen-ID. Diese IDs sind für den nächsten Schritt entscheidend. Wenn etwas unklar ist, können Sie sich für weitere Informationen an Miravia wenden.

Schritt 2: Füllen Sie die Attribute für den Hersteller und die verantwortliche Person mit den neu erhaltenen IDs aus

Mit den erforderlichen IDs aus Schritt 1 können Sie mit dem Ausfüllen der Attribute in Channable beginnen. Verwenden Sie in Channable die folgenden Attributnamen:

• Herstellerinformationen: Die registrierte ID des Herstellers.
• EU-Verantwortlicher: Die registrierte ID der verantwortlichen Person, die mit dem Produkt verbunden ist.

Um diese Attribute auszufüllen, navigieren Sie zu [Ihre Miravia-API] > Aufbau > Attribute pro Kategorie. Klicken Sie auf eine Kategorie und suchen Sie nach den genannten Attributen. Geben Sie die im Seller Central erhaltenen IDs in die Attribute ein und klicken Sie auf Speichern.

Allgemeine Produktsicherheitsvorschriften (GPSR)

Zusätzlich zur DSA hat Miravia weitere Felder im Zusammenhang mit der Produktsicherheit hinzugefügt.

Sicherheitshinweise

Die Verkäufer müssen angeben, ob das Produkt Sicherheitswarnungen enthält. Wenn ja, müssen die folgenden Attribute ausgefüllt werden:

• Does the Product Have Safety Warning?: Ja/Nein. Wenn Sie für die Sicherheitswarnung die Option „Ja“ gewählt haben, müssen Sie die erforderlichen Sicherheitsinformationen in das Attribut „Safety Warning Content“ eingeben.
• Safety Warning Content: Geben Sie hier den Inhalt der Sicherheitswarnung an.

Etikett der physischen Verpackung

Sie müssen ein Produktetikett vorlegen, das die erforderlichen Angaben enthält, und jedes Produkt muss mit einem beschrifteten Bild versehen sein. Das physische Verpackungsetikett muss enthalten:

• Informationen über den Hersteller (und die verantwortliche Person in der EU, wenn der Hersteller nicht in der EU ansässig ist)
• Informationen zur Produktidentifizierung
• Etwaige Kennzeichnungen oder Sicherheitswarnungen

In Channable finden Sie dieses Attribut im Abschnitt für Attribute pro Kategorie unter Package/Label Photo (EU).

Produktkonformitätszertifikate

Miravia hat zusätzliche kategoriespezifische Attribute eingeführt, die nur in Channable erscheinen, wenn Ihre Produkte zu bestimmten Kategorien gehören. Mit diesen Attributen können Sie relevante Zertifizierungen, wie CE-Zertifikate und Prüfberichte, einreichen. Die verfügbaren Attribute hängen von der jeweiligen Produktkategorie ab.

• CE Certificate
• ECE Certificate
• CPNP Certificate
• RoHS Testing Report: Prüft, ob elektronische Produkte den Schadstoffvorschriften entsprechen.
• REACH Report: Bestätigt, dass die in Produkten enthaltenen Chemikalien in der gesamten Lieferkette den EU-Vorschriften entsprechen.
• BPR Registration Certificate: Zeigt, dass die Verwendung antibakterieller Produkte nach EU-Recht zulässig ist.
• EU Food Contact Materials Test Report (FCM): Bestätigt, dass die Materialien für den Kontakt mit Lebensmitteln in der EU sicher sind.

Für bestimmte Kategorien sind auch spezielle Prüfberichte erforderlich, wie z. B:

• PIF document: Vollständige Datei mit Informationen, die für den Verkauf von Kosmetika in der EU benötigt werden.
• EMC/LVD test report: Gewährleistet die Einhaltung der Vorschriften zur elektromagnetischen Sicherheit.
• EMC test report: Gewährleistet, ob ein Produkt keine elektromagnetischen Störungen verursacht.
• EN71 test report: Gewährleistet, dass Spielzeug gemäß den EU-Normen sicher ist.
• R44 test report: Gewährleistet, dass Kinderautositze den UN-Sicherheitsvorschriften entsprechen.
• Building product test report: Gewährleistet, dass die Baumaterialien den EU-Normen entsprechen.
• MDR test report: Gewährleistet, dass Medizinprodukte den EU-Vorschriften entsprechen.
• Soother test report (EN1400:2013): Prüft, ob Schnuller EU-sicher sind.
• PPE test report: Gewährleistet, dass persönliche Schutzausrüstung den EU-Normen entspricht.
• EN62115: Gewährleistet die Sicherheit von elektrischem Spielzeug.
• RED test report: Gewährleistet, dass drahtlose Geräte die Funkausrüstungsrichtlinie einhalten.

Weitere Einzelheiten zu den EU-Vorschriften und deren Einhaltung finden Sie in diesem Artikel oder Sie wenden sich an Miravia, um Unterstützung zu erhalten.

Schritt 4: Produktlistings an Miravia senden

Sobald Sie die Konfiguration Ihrer Produktlistings abgeschlossen haben, können Sie beginnen, Ihre Produktlistings an Miravia zu senden. Wenn Sie das Projekt noch nicht aktiviert haben, navigieren Sie zu "Einstellungen > Projekteinstellungen" auf der linken Seite des Bildschirms und klicken Sie auf "Projekt aktivieren".

Gehen Sie dann zurück zu Kanäle, klicken Sie auf die Einstellungen Ihrer Miravia-API und aktivieren Sie hier die API, indem Sie auf "Aktiviere API" klicken.

Sobald Sie die API aktiviert haben, navigieren Sie zurück zur API-Übersicht und klicken Sie auf die blaue Schaltfläche "Aktualisieren", um Ihre Produktangebote an Miravia zu senden.

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

Nachdem Sie Ihre Listings an Miravia gesendet haben, gehen Sie auf die Registerkarte "Resultat" in ihrer API. Wenn alles gut gelaufen ist, sehen Sie alle Ihre Produkte unter "Erfolgreich", aber es ist möglich, dass es einige Probleme mit Ihren Produkten gibt. Wenn Sie auf "Fehler" klicken, können Sie sehen, welche Produktangebote Fehler aufweisen und nicht platziert werden können. Klicken Sie auf einen Fehler, um zu sehen, wie die Fehlermeldung lautet und welche Produkte diesen Fehler aufweisen. Weitere Informationen über die Bedeutung der Fehler finden Sie in diesem Artikel.