Een fonQ API instellen

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

UI-update: Er is een nieuwe kanaalselectiepagina en overzicht voor Feeds en Marktplaatsen (voorheen API's genoemd)! Sommige visuals en instructies zijn mogelijk niet up-to-date.

Je kunt naar de gedetailleerde stappen hieronder springen:

1

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.

2

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.

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.

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.

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.

3

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:

1

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".

2

Regels

Maak aan verschillende regels om je productvermeldingen te optimaliseren.

3

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.

Tip: Houd je muis boven voor meer informatie over specifieke veldvereisten.

4

GPSR- en DSA-vereisten

De Europese Unie (EU) heeft nieuwe GPSR- en DSA-vereisten 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.

5

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.

6

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.

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.