- Schritt 1: Fügen Sie eine fonQ-Verbindung hinzu
- Schritt 2: Fügen Sie eine neue fonQ-API in Channable hinzu
- Schritt 3: Erstellen Sie Ihre Produktangebote in Channable
- GPSR- und DSA-Anforderungen
- Schritt 4: Senden Sie Ihre Produktdaten an fonQ
- Schritt 5: Überprüfen Sie Ihre Produktangebote auf Fehler
Schritt 1: Fügen Sie eine fonQ-Verbindung hinzu
Die fonQ-API verwendet die Mirakl-Plattform, d.h. Sie benötigen einen Mirakl-Account, um Ihre Produktlistings an fonQ zu senden.
Wenn Sie ein Mirakl fonQ-Konto haben, loggen Sie sich ein und navigieren Sie zu "[Ihr Unternehmen] Einstellungen (oben rechts) > Verbindungen > Verbindung hinzufügen". Klicken Sie auf "+ Verbindung hinzufügen" und Sie gelangen zu einem Bildschirm, auf dem Sie fonQ auswählen können. Geben Sie ein Label für Ihre Verbindung ein, zum Beispiel: fonQ. Klicken Sie dann auf "Verbinden mit fonQ". 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 fonQ-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 fonQ-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 das Land, in dem Sie verkaufen möchten. Sie können hier auch eine Masterregelgruppe hinzufügen, wenn Sie möchten. Klicken Sie auf "Weiter", um die Erstellung der neuen fonQ-API abzuschließen.
Der Unterschied zwischen einem Angebot und einem Produkt in der fonQ API
Bevor Sie Ihre Produktangebote erstellen, ist es wichtig, den Unterschied zwischen einem Angebot und einem Produkt über die fonQ API zu verstehen.
- Angebot: Ein Angebot beinhaltet nur die Felder im Aufbau-Schritt der API
- Produkt: Ein Produkt hat mehr Informationen als ein Angebot, wie z.B. eine ausgefüllte Kategorisierung und Attribute, und wird benötigt, wenn Artikel in fonQ unbekannt sind.
Wenn Sie keinen NL-Shop haben und Ihre Produkte fonQ nicht bekannt sind, müssen Sie einen NL-Shop erstellen und eine Produkt-API für diese unbekannten Produkte einrichten. Sie müssen diese Produkte kategorisieren und in den NL-Shop übertragen, um diese Produkte bekannt zu machen. Sobald dies geschehen ist, können Sie eine zweite API einrichten, um BE-Angebote zu erstellen, was jedoch dazu führt, dass auch im NL-Shop Angebote erstellt werden. Um dies zu vermeiden, müssen Sie die NL-API löschen, sobald die Produkte akzeptiert worden sind.
Schritt 3: Erstellen Sie Ihre Produktangebote in Channable
Sobald Sie die fonQ-API erstellt haben, können Sie Ihre Produktdaten einrichten, indem Sie den Schritten der API folgen.
-
Kategorien
Wir raten Ihnen, zunächst zu versuchen, Ihre Produkte ohne Kategorien zu versenden. Wenn fonQ bereits mit den EAN-Codes Ihrer Produkte vertraut ist, brauchen Sie diesen Schritt nicht durchzuführen. Wenn die Produkte noch nicht bekannt sind, werden Sie im Resultat-Schritt der API den folgenden Fehler sehen: "mirakl_unknown_error_code". -
Regeln
Erstellen Sie verschiedene Regeln, um Ihre Produktlistings zu optimieren. Beispiele finden Sie in unserem Artikel zu gängigen Regeln. -
Aufbau
Hier finden Sie unsere Vorlage für die Produktangebote. Diese können Sie ausfüllen, indem Sie auf das Feld selbst klicken und auswählen, womit es ausgefüllt werden soll. Zum Beispiel sollte das Feld 'Preis' den Preis Ihres Produktes anzeigen und so weiter. Wenn Sie mit dem Einrichten der Produktangebote fertig sind, klicken Sie einfach unten auf dem Bildschirm auf "Speichern".
Tipp! Beachten Sie das Fragezeichen hinter jedem Feld; wenn Sie mit der Maus über das Fragezeichen fahren, sehen Sie die Beschreibung des Feldes und Vorschläge für mögliche Werte. -
Attribute
Genau wie beim Schritt Kategorien empfehlen wir Ihnen, zunächst zu versuchen, Ihre Produkte ohne die Attribute zu versenden. Wenn fonQ bereits mit den EAN-Codes Ihrer Produkte vertraut ist, brauchen Sie diesen Schritt nicht durchzuführen.
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 fonQ-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:
- Adres Marktdeelnemer
- Email Marktdeelnemer
- Naam Marktdeelnemer
- Telefoon Marktdeelnemer
Schritt 4: Senden Sie Ihre Produktdaten an fonQ
Fast fertig, Ihre Produktangebote sind versandfertig. 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 Übersicht der APIs und gehen Sie zu "Ihr fonQ-API Name" > Einstellungen, wo Sie die API aktivieren, indem Sie "API aktivieren" drücken. Nachdem Sie diesen Schritt abgeschlossen haben, navigieren Sie zurück zur API-Übersicht und wählen Sie die blaue Schaltfläche "Aktualisieren", um Ihre Produkteinträge an fonQ zu senden.
Schritt 5: Überprüfen Sie Ihre Produktangebote auf Fehler
Wenn Sie Ihre Produktangebote an fonQ geschickt haben, gehen Sie zur Resultat-Registerkarte Ihrer fonQ-API. Klicken Sie auf 'Fehler'. Jetzt können Sie sehen, welche Produktangebote Fehler aufweisen und nicht erstellt wurden. Klicken Sie auf einen bestimmten Fehler, um mehr Informationen darüber zu erhalten, was den Fehler verursacht, und sehen Sie sich unseren Abschnitt Fehlerlösungen an, in dem Sie erfahren, wie Sie Fehler korrigieren können. Wenn Sie den "mirakle_unkown_error_code" für Produkte sehen, befolgen Sie diesen Leitfaden zur Lösung dieses Fehlers.
Best Practices
Hinzufügen mehrerer Attributwerte: Wenn Sie mehrere Werte in ein Attributfeld für Mirakl Marketplaces eingeben, trennen Sie jeden Wert mit dem Pipe-Zeichen "|", um eine korrekte Erkennung und Verarbeitung sicherzustellen.
Die Produkt-ID des Verkäufers für einzelne/einfache Produkte: Bitte beachten Sie, dass es zwei Attribute mit den Bezeichnungen „SellerArticleId“ und „SellerProductId“ gibt. SellerProductId“ bezieht sich auf die übergeordnete ID, während sich ‚SellerArticleId‘ auf die Variantenartikel bezieht. Bei Einzelprodukten ohne Varianten müssen beide Attribute mit demselben Wert gefüllt werden.
Weitere Informationen zu Mirakl Marketplace Fehlern, Anleitungen und Best Practices finden Sie in unserem entsprechenden Artikel. Klicken Sie hier, um mehr zu lesen.