> For the complete documentation index, see [llms.txt](https://helpcenter.channable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.channable.com/list-advertise/list-and-advertise-nl/verkoop-op-marktplaatsen/mirakl-marktplaatsen/een-fonq-api-instellen.md).
# Een fonQ Api instellen
{% hint style="warning" %}
Opmerking: dit artikel gaat ervan uit dat je al met je producten op fonQ hebt geadverteerd. Als je nieuw bent met adverteren op fonQ, zorg er dan voor dat je weet [hoe je onbekende EAN-codes aan fonQ toevoegt](/list-advertise/list-and-advertise-nl/verkoop-op-marktplaatsen/mirakl-marktplaatsen/mirakl-gids-instellingen-en-oplossingen.md). EAN-codes zijn verplicht voor fonQ. Zorg dat je geldige EAN-codes hebt voor al je producten, anders kunnen er geen productvermeldingen voor je producten worden aangemaakt.
{% endhint %}
{% hint style="info" %}
**UI-update:** Er is een nieuwe kanaalselectiepagina en overzicht voor **Feeds** en **Marktplaatsen** (voorheen API's genoemd)! Sommige visuals en instructies zijn mogelijk niet meer actueel.
{% endhint %}
Je kunt naar de gedetailleerde stappen hieronder springen:
{% stepper %}
{% step %}
### Stap 1: Voeg een nieuwe fonQ-koppeling toe
De fonQ API gebruikt het Mirakl-platform, wat betekent dat je een Mirakl-account nodig hebt om je productvermeldingen naar fonQ te sturen.
Als je een Mirakl fonQ-account hebt, ga naar Koppelingen > Koppeling toevoegen. Klik op "+ Koppeling toevoegen" en selecteer fonQ. Vul het label voor je koppeling in (bijvoorbeeld: fonQ). Klik vervolgens op "Koppel met fonQ". Je wordt doorgestuurd naar de omgeving waar je kunt inloggen met je Mirakl-gegevens. Na het inloggen word je teruggestuurd naar Channable waar de koppeling beschikbaar zal zijn.
| | |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [](https://helpcenter.channable.com/hc/article_attachments/7742486167570) | [](https://helpcenter.channable.com/hc/article_attachments/7742427569426) |
| {% endstep %} | |
{% step %}
### Stap 2: Maak een nieuwe fonQ API in Channable
Ga naar het APIs-overzicht in je project en klik op "+ Nieuwe API toevoegen". Selecteer de fonQ-koppeling die je hebt aangemaakt en geef je nieuwe API een naam.
[](https://helpcenter.channable.com/hc/article_attachments/19237523625874)
Selecteer het veld dat je wilt gebruiken voor Uniek ID per item (we raden het veld 'id' aan) en het land waarin je wilt verkopen. Je kunt hier ook een master regel groep toevoegen als je dat wilt. Klik op Doorgaan om het aanmaken van de nieuwe fonQ API te voltooien.
Verschil tussen een Offer en een Product in de fonQ API:
* Offer: Een offer bevat alleen de velden uit de Build-stap van de API.
* Product: Een product bevat meer informatie dan een offer (zoals ingevulde categorisering en attributen) en is nodig wanneer items onbekend zijn bij fonQ.
{% hint style="info" %}
Opmerking: fonQ NL accepteert ALLEEN Product-indieningen voor NL-gebaseerde winkels. Als je winkel geen NL-winkel is, moet je offers sturen door je data niet te categoriseren.
{% endhint %}
Als je producten niet bekend zijn bij fonQ en je geen NL-winkel hebt, moet je een NL-winkel aanmaken en een Product-API instellen voor onbekende producten (categoriseer en push ze naar de NL-winkel). Zodra ze geaccepteerd zijn, kun je een tweede API instellen om BE-offers aan te maken, maar dit kan ook offers in de NL-winkel creëren; om dat te voorkomen moet je mogelijk de NL API leegmaken zodra de producten zijn geaccepteerd.
{% endstep %}
{% step %}
### Stap 3: Maak je productvermeldingen in Channable
Zodra je de fonQ API hebt aangemaakt kun je je productgegevens instellen door de stappen van de API te volgen:
{% stepper %}
{% step %}
#### Categorieën
We adviseren eerst te proberen je producten te sturen zonder de categorieën in te vullen. Als fonQ de EAN-codes van je producten al kent, hoef je deze stap niet te doen. Als de producten nog niet bekend zijn, zie je de volgende fout in de Preview-stap van de API: ["mirakl\_unknown\_error\_code"](/list-advertise/list-and-advertise-nl/verkoop-op-marktplaatsen/mirakl-marktplaatsen/mirakl-gids-instellingen-en-oplossingen.md).
{% endstep %}
{% step %}
#### Regels
Maak aan [verschillende regels](/manage-improve-product-data/manage-product-and-improve-data-nl/regels-in-bulk-bewerken-en-verrijken/regels-gebruiken.md) om je productvermeldingen te optimaliseren.
{% endstep %}
{% step %}
#### Bouwen
Hier vind je onze preset template voor de productvermeldingen. Vul deze in door op een veld te klikken en de waarde te selecteren waarmee je het wilt vullen (bijvoorbeeld: stel het Title-veld in op je producttitel). Als je klaar bent, klik je onderaan het scherm op Opslaan.
{% hint style="success" %}
**Tip:** Ga er met je muis overheen :circle-question: voor meer informatie over de specifieke veldvereisten.
{% endhint %}
[](https://helpcenter.channable.com/hc/article_attachments/15230232201106)
{% endstep %}
{% endstepper %}
{% endstep %}
{% step %}
### GPSR- en DSA-vereisten
De Europese Unie (EU) heeft nieuwe [GPSR- en DSA-vereisten](/list-advertise/list-and-advertise-nl/verkoop-op-marktplaatsen/ga-aan-de-slag-met-marktplaatsen/wat-je-moet-doen-naar-aanleiding-van-gpsr-en-dsa-om-daaraan-te-voldoen.md) voor online platformen, inclusief marketplaces.
Voor je fonQ API in Channable: zorg dat je in de Build-stap het tabblad attributen per categorie invult :
* Adres Marktdeelnemer: Geef het volledige adres van de fabrikant of importeur op.
* Email Marktdeelnemer: Vul het e-mailadres van de fabrikant of importeur in.
* Naam Marktdeelnemer: Geef de naam van de fabrikant of importeur op.
* Telefoon Marktdeelnemer: Geef een geldig telefoonnummer van de fabrikant of importeur op.
{% endstep %}
{% step %}
### Stap 4: Stuur je productgegevens naar fonQ
Als je je project nog niet hebt geactiveerd, ga links naar Projectinstellingen en klik op Project activeren. Ga vervolgens terug naar het Kanalen-overzicht, open "Je fonQ API Naam > Instellingen" en activeer de API door "Activeer API" te selecteren. Na activatie klik je op de blauwe knop "Uitvoeren" om je productvermeldingen naar fonQ te sturen.
{% endstep %}
{% step %}
### Stap 5: Controleer je productvermeldingen op fouten
Na het versturen van je productvermeldingen naar fonQ, ga naar het Preview-tabblad van je fonQ API en klik op Fouten. Je ziet welke productvermeldingen fouten hebben en niet zijn aangemaakt. Klik op een specifieke fout om meer informatie te zien.
{% endstep %}
{% endstepper %}
### Beste praktijken
Klik om best practices uit te vouwen
* Meerdere attributenwaarden toevoegen: Wanneer je meerdere waarden toevoegt in een attribuutveld voor Mirakl Marketplaces, scheid je elke waarde met een pijp-teken "|" zodat ze correct worden gedetecteerd en verwerkt.
* Product-ID van de verkoper voor single/simple producten: Er zijn twee attributen met de namen 'SellerArticleId' en 'SellerProductId'. 'SellerProductId' verwijst naar de Parent ID, terwijl 'SellerArticleId' verwijst naar de variant-items. Voor single producten moeten beide attributen met dezelfde waarde worden ingevuld.
Voor meer informatie over Mirakl-marktplaatsfouten, handleidingen en best practices, bekijk [onze speciale handleiding](/list-advertise/list-and-advertise-nl/verkoop-op-marktplaatsen/mirakl-marktplaatsen/mirakl-gids-instellingen-en-oplossingen.md).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://helpcenter.channable.com/list-advertise/list-and-advertise-nl/verkoop-op-marktplaatsen/mirakl-marktplaatsen/een-fonq-api-instellen.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.