Hinweis I: Dieser Artikel geht davon aus, dass Sie bereits Ihre Produkten auf fonQ inseriert haben. Wenn Sie zum ersten Mal auf fonQ verkaufen, lesen Sie bitte auch unseren Support-Artikel über das Hinzufügen unbekannter EAN-Codes zu fonQ.
Hinweis II: EAN-Codes sind für fonQ obligatorisch. Stellen Sie sicher, dass Sie für alle Ihre Produkte gültige EAN-Codes haben, da sonst keine Produktlistings für Ihre Produkte erstellt werden können.
Schritt 1: Generieren Sie Ihre API-Zugangsdaten in Ihrem fonQ-Konto
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, melden Sie sich an und navigieren Sie zu Meine Benutzereinstellungen, indem Sie oben rechts auf Ihre E-Mail-Adresse klicken. Danach gehen Sie zur Registerkarte "API-Schlüssel" und klicken Sie auf "API-Schlüssel generieren" - falls noch kein Schlüssel verfügbar ist. Wenn ein API-Schlüssel verfügbar ist, können Sie diesen verwenden, Sie müssen keinen Neuen erstellen. Kopieren Sie den API-Schlüssel, da Sie diesen für den nächsten Schritt benötigen.
Als Nächstes müssen Sie Ihre Shop-ID in Ihrer Verkäuferzentrale finden. Wählen Sie zunächst in der oberen rechten Ecke den Shop aus, an den Sie Produkte senden möchten. Als Nächstes gehen Sie zu Mein Konto > Einstellungen, um Ihre Shop-ID zu finden. Kopieren Sie auch Ihre Shop-ID, Sie benötigen diese für den nächsten Schritt.
Schritt 2: Erstellen einer neuen fonQ-API in Channable
Gehen Sie zu Channable, öffnen Sie Ihr Projekt und gehen Sie zu APIs > Neue API hinzufügen. Es öffnet sich ein neuer Bildschirm mit den API-Einstellungen, wo Sie auf die Schaltfläche "+ Neue Verbindung hinzufügen" klicken können.
Sie werden zu einer Übersicht weitergeleitet, in der Sie "fonQ" auswählen können, um eine neue Verbindung zu erstellen. Geben Sie unter "Label" einen Namen für die Verbindung ein, wir empfehlen, Ihre Verbindung "fonQ-API" zu nennen. Geben Sie den API-Schlüssel und die Shop-ID ein, die Sie in Schritt 1 kopiert haben, und klicken Sie auf die Schaltfläche "Erstellen", um Ihre Verbindung zu speichern.
Sie werden dann zum Schritt API-Einstellungen zurückgeleitet, wo Sie Ihre API benennen können. Nachdem Sie einen Namen gewählt haben, klicken Sie auf die Schaltfläche "Weiter", um Ihre neue fonQ-API zu erstellen.
Der Unterschied zwischen einem Angebot und einem Produkt in der fonQ API
Bevor Sie Ihre Produktlisten 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 Erstellungsschritt 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.
Hinweis: fonQ NL akzeptiert NUR Produkteinreichungen für NL-basierte Shops. Wenn Ihr Shop kein NL-Shop ist, sollten Sie nur Angebote senden, ohne Ihre Daten zu kategorisieren.
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 Produktlistings 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 Vorschau-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 Produktlistings. Sie brauchen sie nur auszufüllen, indem Sie auf das Feld selbst klicken und auswählen, womit es ausgefüllt werden soll. Zum Beispiel sollte das Feld 'Titel' den Titel Ihres Produktes anzeigen und so weiter. Wenn Sie mit dem Einrichten der Produktlistings 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.
Schritt 4: Senden Sie Ihre Produktdaten an fonQ
Fast fertig, Ihre Produktlistings 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 Produkteinträge auf Fehler
Wenn Sie Ihre Produktangebote an fonQ geschickt haben, gehen Sie zur Vorschau-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.