1. Channable
  2. API's
  3. Mirakl API

Artikelen in deze sectie

Zie meer

Een FonQ API opzetten

Wil je interactief alle basisprincipes leren met betrekking tot het maken van een API export, of wil je leren hoe je een geavanceerde API setup maakt in Channable? Leer via dit Helpcenterartikel hoe je een Channacademy-account aanmaakt in de Channable app en start met de Basic APIs of Expert APIs course.
Let op 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.
Let op 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: 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.

Koppeling_aanmaken.png FonQ_NL_1.png Sing_in_Mirakl_-_Oauth.png

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 Carrefour koppeling die je zojuist aan hebt gemaakt en geef je nieuwe API een naam.

FonQ_NL_2.png

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 Carrefour 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.
Let op: fonQ NL accepteert ALLEEN Product inzendingen van in Nederland gevestigde winkels. Als jouw winkel geen NL winkel is, dan dien je alleen Offers door te sturen, dit doe je door producten niet te categoriseren in de API.

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.

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

  2. Regels
    Maak verschillende regels aan om je productvermeldingen te optimaliseren. Voor voorbeelden kun je naar ons helpcenter artikel gaan voor veel voorkomende regels. 

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

    NL_-_fonQ_2.png

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