Een Allegro API opzetten

In dit artikel leggen we uit hoe je een Allegro API instelt in Channable, dit doen we aan de hand van onderstaande stappen:

• Voordat je begint
• Stap 1: Maak een Allegro-koppeling aan in Channable
• Stap 2: Maak een nieuwe Allegro-API aan
• Stap 3: Maak je product listings aan
• Stap 4: Verstuur je producten naar Allegro
• Stap 5: Controleer je productvermeldingen op fouten

Voordat je begint

Zoals vele andere platformen heb je om te verkopen op Allegro een verkopersaccount nodig. Dit kun je aanmaken via deze pagina.
Voordat je begint met je opzet, raden we je van harte aan om een blik te werpen op Allegro’s Help Center voor Internationale Sellers. Hierin vind je de basis over verkopen op Allegro; hoe je een account aanvraagt en opzet, en hoe je door je verkopersaccount navigeert. Je vindt er ook informatie over listing kosten en commissies op verkopen. 

Andere artikelen die we aanraden zijn de volgende: 

• Hoe werkt de Allegro Marketplace? 
• Wat is Allegro SMART?
• Wat is Allegro’s One Fulfillment programma? 

Als je toegang hebt tot een Allegro verkopersaccount, zorg er dan voor dat je het volgende hebt opgezet in het account: 

1. Een garantiebeleid (warranty policy)
2. Een retourbeleid (return policy) 
3. Bezorgingsinstellingen (delivery settings) 
4. Beleid voor klantklachten (customer complaint policy) 

Je kunt dit vinden in je account onder “Sales Settings”. Elk van deze vier instellingen moet een naam krijgen tijdens het opzetten. Deze namen heb je later in het proces nodig. 

Als het Allegro verkopersaccount ingesteld is, kun je beginnen aan het opzetten in Channable.

Stap 1: Maak een Allegro-koppeling aan in Channable

Om een nieuwe koppeling met je Allegro account aan te maken, ga je naar "[je naam rechtsboven] > Koppelingen > Koppeling toevoegen.” Wanneer je op “Koppeling toevoegen” klikt, krijg je het volgende scherm te zien:

Klik hier op het Allegro logo, en klik vervolgens op “Koppel met Allegro”. Hierna word je doorverwezen naar de Allegro verkopersomgeving, waar je in kunt loggen met de gegevens van je eigen Allegro account.

Stap 2: Maak een nieuwe Allegro-API aan

Ga nu naar het API-overzicht in je project en klik op "+ API koppeling toevoegen". Selecteer de Allegro koppeling die je zojuist aan hebt gemaakt en geef je nieuwe API een naam.

Selecteer het veld dat je voor Unieke ID per item wilt gebruiken (we raden het 'id' veld aan). Je kunt ook een master regel groep toevoegen als je dat wilt. Klik op "Volgende" om het aanmaken van je nieuwe Allegro API af te ronden.

Stap 3: Maak je product listings aan

Het bouwen van product voor Allegro doe je door de volgende stappen te volgen: 

1. Categorieën
   Voeg categorieën toe bij je producten door categorieën te genereren, of bouw zelf je categorieën volledig op. Als de EAN-codes van je producten al bekend zijn op Allegro en je geeft een andere categorie op dan bekend is op Allegro, zul je een ‘Category Mismatch’ error krijgen bij het activeren van de API. Om dit te voorkomen raden we je aan om de juiste categorie na te gaan op de Allegro.pl webwinkel.
   
   
2. Regels
   Maak regels aan om je productdata te optimaliseren. Als je voorbeelden zoekt, bekijk dan vooral ons artikel over veelvoorkomende regels.
   We raden je aan om minimaal de volgende drie regels op te zetten in je Allegro API: 
   
   
   1. Formatteren van omschrijvingen
      Allegro verwacht dat beschrijvingen gebruikmaken van HTML. Pas uw beschrijvingen hierop aan om fouten te voorkomen. De volgende HTML-tags zijn toegestaan op Allegro:
      1. <h1> </h1> voor een titel
      2. <h2> </h2 voor een ondertitel 
      3. <p> </p> voor een paragraaf
      4. <ul> </ul> voor opsommingstekens
      5. <ol> </ol> voor een genummerde lijst
      6. <li> </li> voor een item in de lijst
      7. <b> </b> voor dikgedrukt lettertype

Je kunt een gedetailleerde beschrijving maken met deze HTML-tags. Je kunt ook je hele beschrijving in één paragraaf samenvatten door deze regel te maken:

3. Opbouw
   Je kunt de informatie in het template invullen door op het veld te klikken en een geïmporteerd veld te selecteren of handmatig een waarde te typen. Je kunt bijvoorbeeld de titel van je geïmporteerde veld toewijzen aan het veld "Titel" van de template. Vul minimaal de verplichte velden in.
   

Verwerkingstijd
Allegro gebruikt specifieke formaten voor verwerkingstijd. Je kunt handmatig een vaste afhandelingstijd invullen voor al je producten in de Opbouw-stap. Als je verschillende afhandelingstijden hanteert, stel dan een regel in om dynamisch verschillende afhandelingstijden per item in te voeren.

Zie hieronder voor een lijst met geaccepteerde waarden: 

1. 1. PT0S: Onmiddellijk
   2. PT24H: 24 uur
   3. PT2D: 2 dagen
   4. P3D: 3 dagen
   5. P4D: 4 dagen
   6. P5D: 5 dagen
   7. P7D: 7 dagen
   8. P10D: 10 dagen
   9. P14D: 14 dagen
   10. P21D: 21 dagen
   11. P30D: 30 dagen
   12. P60D: 60 dagen

Verkoop policies
In de Opbouw-stap kun je de eerder genoemde policies indienen. Allegro koppelt je producten aan de verkoopvoorwaarden die je in hebt gesteld in je Allegro-verkoopaccount met behulp van de namen van deze policies. Om ervoor te zorgen dat elk product aan het juiste verkoopbeleid wordt gekoppeld, vul je de namen van elk van deze beleidsregels in de juiste velden in door een handmatige waarde in te stellen.

Als je meerdere verkoop policies gebruikt, voeg je nieuwe velden toe in de import mapping en je de namen van de verschillende policies in met behulp van dynamische regels. 

Het leeg laten van velden
Allegro vult zelf een specifieke set velden in als deze velden leeg zijn. Bijvoorbeeld: het veld 'Verkoopmodus formaat' zal worden ingesteld op "BUY_NOW" als het ingediende veld leeg is. Hieronder vind je een overzicht van al deze velden en welke waarde Allegro zal invoegen als het veld leeg is. Of het veld "startdatum publicatie" zal automatisch worden gelezen als "per direct publiceren".

Een parent-/child-structuur maken in Allegro
Allegro regelt dit anders dan andere platforms. In plaats van dat verkopers aangeven wat de varianten zijn, bepaalt Allegro dit zelf op basis van de productinformatie die is opgenomen in je listings. Dit betekent dat je niets hoeft in te stellen in Channable om gegroepeerde listings aan te maken.

4. Attributen
   Selecteer in het gedeelte "Attributen" eerst de categorie die je wilt optimaliseren. Voor elk attribuut kun je een statische waarde invullen of een veld gebruiken. Een meer gedetailleerde uitleg vind je in ons artikel over Attributen.

Stap 4: Verstuur je producten naar Allegro

Bijna klaar, je kunt nu je producten naar Allegro 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 > "Je Allegro API Naam" > Instellen en klik daarna op "Activeer API". Nadat je deze stap hebt voltooid, ga je terug naar het APIs-overzicht en klik je op de blauwe knop "uitvoeren" om de productvermeldingen naar Allegro te sturen.

Stap 5: Controleer je productvermeldingen op fouten

Wanneer de advertenties naar Allegro zijn verstuurd, kun je bij Resultaat de voorvertoning van je productvermeldingen zien. Klik op de tab 'Fouten'. Hier zie je welke advertenties fouten bevatten en niet geplaatst zullen worden. Klik op een specifieke fout om meer informatie te zien over de oorzaak van de fout.

Veelvoorkomende fouten en oplossingen

Om je te helpen bij het efficiënt afhandelen van veelvoorkomende fouten bij het gebruik van Channable met Allegro, hebben we hieronder een aantal typische fouten en hun oplossingen beschreven. Deze tabel biedt duidelijke, uitvoerbare stappen om deze problemen op te lossen.

Door deze richtlijnen te volgen en de bovenstaande tabel te gebruiken, kun je ervoor zorgen dat jouw Allegro listings goed geconfigureerd zijn en geen fouten bevatten, wat leidt tot een soepeler integratieproces met Channable.