Note I: In dit artikel gaan we er vanuit dat je producten al bekend zijn bij fonQ en dat je met deze producten al op fonQ hebt gestaan. Als je producten onbekend zijn en dus niet eerder op fonQ hebben gestaan, lees dan dit supportartikel over het toevoegen van onbekende EAN-codes aan fonQ.
Note II: EAN-codes zijn verplicht voor fonQ. Zorg er voor dat je producten geldige EAN-codes hebben! Zonder EAN-codes is het niet mogelijk om producten naar fonQ te sturen.
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.
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.