# Einrichten einer fonQ API
{% hint style="warning" %}
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](https://helpcenter.channable.com/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/mirakl-marktplatze/mirakl-anleitung-einstellungen-und-losungen). 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.
{% endhint %}
Du kannst zu den detaillierten Schritten weiter unten springen:
{% stepper %}
{% step %}
### 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.
| | |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [](https://helpcenter.channable.com/hc/article_attachments/7742486167570) | [](https://helpcenter.channable.com/hc/article_attachments/7742427569426) |
| {% endstep %} | |
{% step %}
### 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.
[](https://helpcenter.channable.com/hc/article_attachments/19237523625874)
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.
{% hint style="info" %}
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.
{% endhint %}
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.
{% endstep %}
{% step %}
### 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:
{% stepper %}
{% step %}
#### 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"](https://helpcenter.channable.com/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/mirakl-marktplatze/mirakl-anleitung-einstellungen-und-losungen).
{% endstep %}
{% step %}
#### Regeln
Erstellen [verschiedene Regeln](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/rules-bulk-edit-and-enrich/using-rules) um deine Produktlistings zu optimieren.
{% endstep %}
{% step %}
#### 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.
[](https://helpcenter.channable.com/hc/article_attachments/15230232201106)
{% endstep %}
{% endstepper %}
{% endstep %}
{% step %}
### GPSR- und DSA-Anforderungen
Die Europäische Union (EU) hat neue [GPSR- und DSA-Anforderungen](https://helpcenter.channable.com/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/erste-schritte-mit-marktplatzen/was-du-tun-musst-um-gpsr-und-dsa-konform-zu-sein) 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.
{% endstep %}
{% step %}
### 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.
{% endstep %}
{% step %}
### 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.
{% endstep %}
{% endstepper %}
### 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](https://helpcenter.channable.com/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/mirakl-marktplatze/mirakl-anleitung-einstellungen-und-losungen).
---
# 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-fonq-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.