Stap 1: Genereer je API credentials in fonQ
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.
Voor het maken van de verbinding heb je een API-sleutel en een shop ID nodig. Login op je fonQ account en navigeer naar Mijn gebruikersinstellingen door op het e-mailadres rechts bovenin te klikken. Ga naar de API sleutel tab en klik op "Genereer een nieuwe sleutel", mits er nog geen API sleutel automatisch is verschenen. Als er wel al een sleutel automatisch is verschenen, hoef je geen nieuwe aan te maken. Kopieer de API key, deze zul je in de volgende stap nodig hebben.
Vervolgens kan je de Shop ID van jouw shop vinden onder My Account > Settings. Selecteer de shop waar je de fonQ producten naartoe wilt sturen en kopieer de Shop ID, je zult deze in de volgende stap nodig hebben.
Stap 2: Maak een nieuwe fonQ API in Channable
Ga naar Channable, open je project en ga naar APIs > API koppeling toevoegen. Een nieuw scherm met het API overzicht wordt geopend waar je kan klikken op de knop ''+ koppeling toevoegen''.
Je wordt doorgestuurd naar een overzicht waarin je ''fonQ'' kan selecteren om een nieuwe koppeling aan te maken. Vul hier onder ''Label'' een naam in voor de koppeling, we raden je aan de naam fonQ API te gebruiken. Vul de API sleutel en Shop ID die je in de vorige stap had gekopieerd in onder "API key" en "Shop ID", en klik op de "Maak aan" knop om de koppeling op te slaan.
Je wordt teruggeleid naar het API overzicht waar je de API een naam kan geven en op de knop ''Volgende'' kan klikken om de nieuwe fonQ API aan te maken.
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!
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 'Title' moet bijvoorbeeld de titel 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.