fonQ API einrichten

Hinweis: Dieser Artikel geht davon aus, dass du bereits mit deinen Produkten auf fonQ geworben hast. Wenn du neu bei der Werbung auf fonQ bist, stelle sicher, dass du weißt wie man unbekannte EAN-Codes zu fonQ hinzufügt. EAN-Codes sind bei fonQ verpflichtend. Stelle sicher, dass du gültige EAN-Codes für alle deine Produkte hast, sonst können keine Produktlistings für deine Produkte erstellt werden.

Du kannst zu den detaillierten Schritten weiter unten springen:

1

Schritt 1: Neue fonQ-Verbindung hinzufügen

Die fonQ-API verwendet die Mirakl-Plattform, das heißt du brauchst ein Mirakl-Konto, um deine Produktlistings an fonQ zu senden.

Wenn du ein Mirakl-fonQ-Konto hast, gehe zu Verbindungen > Verbindung hinzufügen. Klicke auf "+ Verbindung hinzufügen" und wähle fonQ. Trage ein Label für deine Verbindung ein (zum Beispiel: fonQ). Klicke dann auf "Mit fonQ verbinden". Du wirst in die Umgebung weitergeleitet, wo du dich mit deinen Mirakl-Zugangsdaten einloggen kannst. Nach dem Login wirst du zurück zu Channable geleitet, wo die Verbindung dann verfügbar ist.

2

Schritt 2: Erstelle eine neue fonQ-API in Channable

Gehe in deinem Projekt zur API-Übersicht und klicke auf "+ Neue API hinzufügen". Wähle die fonQ-Verbindung, die du erstellt hast, und gib deiner neuen API einen Namen.

Wähle das Feld, das du als Eigene ID pro Item verwenden möchtest (wir empfehlen das Feld 'id') und das Land, in dem du verkaufen willst. Du kannst hier auch optional eine Masterregel-Gruppe hinzufügen. Klicke auf Weiter, um die neue fonQ-API zu erstellen.

Unterschied zwischen einem Angebot und einem Produkt in der fonQ-API:

• Angebot: Ein Angebot enthält nur die Felder aus dem Build-Schritt der API.

• Produkt: Ein Produkt enthält mehr Informationen als ein Angebot (z. B. ausgefüllte Kategorisierung und Attribute) und wird benötigt, wenn Artikel fonQ unbekannt sind.

Hinweis: fonQ NL akzeptiert AUSSCHLIESSLICH Produkt-Submissions für in NL ansässige Shops. Wenn dein Shop kein NL-Shop ist, solltest du Angebote senden, indem du deine Daten nicht kategorisierst.

Wenn deine Produkte fonQ nicht bekannt sind und du keinen NL-Shop hast, musst du einen NL-Shop erstellen und eine Produkt-API für unbekannte Produkte einrichten (kategorisieren und in den NL-Shop pushen). Sobald diese akzeptiert sind, kannst du eine zweite API einrichten, um BE-Angebote zu erstellen. Das kann jedoch auch Angebote im NL-Shop erzeugen; um das zu vermeiden, musst du ggf. die NL-API löschen, sobald die Produkte akzeptiert wurden.

3

Schritt 3: Erstelle deine Produktlistings in Channable

Sobald du die fonQ-API erstellt hast, kannst du deine Produktdaten einrichten, indem du den Schritten der API folgst:

1

Kategorien

Wir empfehlen zunächst zu versuchen, deine Produkte ohne Kategorisierung zu senden. Wenn fonQ die EAN-Codes deiner Produkte bereits kennt, brauchst du diesen Schritt nicht. Sind die Produkte noch unbekannt, siehst du im Preview-Schritt der API folgenden Fehler: "mirakl_unknown_error_code".

2

Regeln

Erstellen verschiedene Regeln um deine Produktlistings zu optimieren.

3

Der Build-

Hier findest du unsere vorgefertigte Vorlage für die Produktlistings. Fülle sie aus, indem du auf ein Feld klickst und den Wert auswählst, mit dem es befüllt werden soll (z. B. das Title-Feld auf deinen Produkttitel setzen). Wenn du fertig bist, klicke unten auf der Seite auf Speichern.

4

GPSR- und DSA-Anforderungen

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

Für deine fonQ-API in Channable fülle im Build-Schritt unbedingt den Tab Attribute pro Kategorie aus:

• Adres Marktdeelnemer: Gib die vollständige Adresse des Herstellers oder Importeurs an.

• Email Marktdeelnemer: Trage die E-Mail-Adresse des Herstellers oder Importeurs ein.

• Naam Marktdeelnemer: Gib den Namen des Herstellers oder Importeurs an.

• Telefoon Marktdeelnemer: Gib eine gültige Telefonnummer des Herstellers oder Importeurs an.

5

Schritt 4: Sende deine Produktdaten an fonQ

Wenn du dein Projekt noch nicht aktiviert hast, gehe links zu Projekteinstellungen und klicke Projekt aktivieren. Gehe dann zurück zur Kanäle-Übersicht, öffne "Dein fonQ-API-Name > Einstellungen" und aktiviere die API, indem du "Aktiviere API" auswählst. Nach der Aktivierung klicke auf die blaue Schaltfläche "Aktualisieren", um deine Produktlistings an fonQ zu senden.

6

Schritt 5: Überprüfe deine Produktangebote auf Fehler

Nachdem du deine Produktlistings an fonQ gesendet hast, gehe zum Preview-Tab deiner fonQ-API und klicke auf Fehler. Dort siehst du, welche Produktlistings Fehler haben und nicht erstellt wurden. Klicke auf einen konkreten Fehler, um mehr Informationen zu erhalten.

Best Practices

Klicke, um Best Practices aufzuklappen

• 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'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.

Für weitere Informationen zu Mirakl-Marktplatz-Fehlern, Anleitungen und Best Practices, sieh dir unsere spezielle Anleitung.