Stap 1: Voeg een nieuwe FonQ koppeling toe
De FonQ API maakt gebruik van het Mirakl platform, wat betekent dat je een Mirakl-account nodig hebt om je producten naar FonQ te sturen.
Wanneer je een Mirakl FonQ account hebt, ga je naar "[Jouw bedrijf] instellingen menu (rechtsboven) > Koppelingen > Koppeling toevoegen". Klik op "+ Koppeling toevoegen" en dan krijg je een scherm te zien, waar je FonQ kunt selecteren. Vul het label voor je koppeling in, bijvoorbeeld: FonQ. En klik dan op ''Koppel met FonQ". Je wordt nu doorgestuurd naar de omgeving waar je kunt inloggen met je Mirakl-gegevens. Na het inloggen wordt je teruggeleid naar Channable waar de koppeling dan beschikbaar is.
Stap 2: Maak een nieuwe fonQ API in Channable
Ga nu naar het API-overzicht in je project en klik op "+ API koppeling toevoegen". Selecteer de fonQ koppeling die je zojuist aan hebt gemaakt en geef je nieuwe API een naam.
Selecteer het veld dat je wilt gebruiken voor Unieke ID per item (we raden het 'id' veld aan) en het Land waar je wilt verkopen. Je kan ook een master regel groep toevoegen als je dat wilt. Klik op "Volgende" om het aanmaken van je nieuwe fonQ API af te ronden.
Verschil tussen een Offer en een Product in de fonQ API
Voordat je jouw product advertenties op fonQ maakt is het belangrijk om het verschil te begrijpen tussen het versturen van een Offer en een Product via de fonQ API.
- Offer: Een offer bevat alleen de velden in de Opbouw-stap van de API.
- Product: Een product heeft meer informatie dan een offer zoals een ingevulde categorisatie en attributen-stap, en is nodig om aan te maken wanneer items onbekend zijn voor fonQ.
Als je geen NL winkel hebt en jouw producten zijn niet bekend bij fonQ, dan dien je een NL shop aan te maken en een Product API in te stellen voor deze onbekende producten. Je zult deze producten moeten categoriseren en doorsturen naar de NL winkel om deze producten aan te maken. Als dit gedaan is kun je een tweede API opzetten om BE Offers aan te maken, maar dit zal tot gevolg hebben dat er ook Offers in de NL winkel worden aangemaakt. Om dit te voorkomen zul je dus de NL API moeten wissen zodra de producten geaccepteerd zijn.
Stap 3: Bouw je productvermeldingen in Channable
Het bouwen van product vermeldingen gaat simpel en snel met onze standaard-template. Je kunt een productvermelding aanmaken door de volgende vier stappen in de fonQ API te volgen.
-
Categorieën
Wanneer je producten al bekend zijn bij fonQ, omdat je ze daar al verkoopt of verkocht hebt, kun je deze stap overslaan. Als de producten nog niet bekend zijn, krijg je de volgende foutmelding in de bekijk stap van de API: "mirakl_unknown_error_code".
-
Regels
Maak verschillende regels aan om je productvermeldingen te optimaliseren. Voor voorbeelden kun je naar ons helpcenter artikel gaan voor veel voorkomende regels.
-
Opbouw
Hier kun je standaard template vinden voor het aanmaken van productvermeldingen. Het enige wat je hoeft te doen is op de velden te klikken en de juiste te selecteren. Het veld 'Prijs' moet bijvoorbeeld de prijs van het product weergeven enzovoort. Wanneer je klaar bent met het opzetten van je productvermeldingen kun je deze opslaan door te klikken op ''Opslaan'' onderaan de pagina.
Tip! Let op het vraagteken achter elk veld. Wanneer je je muis op het vraagteken plaatst, zie je de beschrijving van het veld en suggesties voor mogelijke waarden. -
Attributen
Net als bij de Categorieën stap raden we aan om te proberen eerst producten te sturen zonder de attributen in te vullen. Als fonQ al bekend is met de EAN-codes van je producten, hoeft je deze stap niet te doen.
Stap 4: Stuur je advertenties naar fonQ
Bijna klaar, je kunt nu je producten naar fonQ sturen. Zorg ervoor dat je je project hebt geactiveerd in Channable door in de tool naar Setup > Projectconfiguratie te gaan en daarna op "Activeer project" te klikken. Ga daarna naar APIs > "fonQ API Naam" > Instellen en daarna op "Activeer API". Nadat je deze stap hebt voltooid, ga je terug naar het API's-overzicht en klik je op de blauwe knop "uitvoeren" om de productvermeldingen naar fonQ te versturen.
Stap 5: Controleer je productvermeldingen op fouten
Wanneer de advertenties naar fonQ zijn verstuurd, kun je in de Bekijk stap de voorvertoning van je fonQ-productvermeldingen zien. Klik op de tab 'Fouten'. Hier zie je welke advertenties fouten bevatten en niet op fonQ geplaatst zullen worden. Als je de foutmelding "mirakl_unknown_error_code" ziet, volg dan deze handleiding om de foutmelding op te lossen.