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.

Het opzetten van de Allegro-API 

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. <st> </st> 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:

2. De verwerkingstijd invullen
   Allegro gebruikt specifieke formaten voor verwerkingstijd. Zie hieronder voor een lijst met geaccepteerde waarden: 
   
   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

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.

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 "Title" van de template. Vul minimaal de verplichte velden in.
   

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

Hieronder leggen we de meestvoorkomende errors uit en hoe je deze kunt oplossen:

• VALIDATION_ERROR
  Dit is een melding die wordt gegenereerd door Channable zelf, om te voorkomen dat je de API steeds opnieuw moet uitvoeren totdat deze fouten zijn hersteld. Dit betekent dat deze foutmelding zal verschijnen voor instellingen waarvan we zeker weten dat ze fout zullen gaan - denk aan lege prijsvelden of verkeerde HTML-tags in je beschrijving. Je kunt dit oplossen door de bijbehorende gegevens in de foutmelding te corrigeren.
• PARAMETER_MISMATCH
  Deze foutmelding verschijnt wanneer de EAN-/GTIN-code al bekend is in Allegro en je een kenmerk hebt opgegeven dat niet overeenkomt met wat Allegro verwacht.
  Channable probeert het product bij te werken, maar kan dit niet vanwege deze fout. Het product zal nog steeds online zijn als de listing al was aangemaakt, maar met ongewijzigde voorraad-/prijswaarden. Je kunt deze fout oplossen door de waarde in het attribuut te wijzigen in de voorgestelde waarde van Allegro. Deze voorgestelde waarde wordt getoond in de foutmelding. 
• CATEGORY_MISMATCH
  Deze fout is vergelijkbaar met de eerder genoemde Parameter Mismatch, maar dan voor categorieën. Allegro verwacht dat een item in een bepaalde categorie past, maar er is een andere categorie ingevuld. JE kunt dit oplossen door je categorie-instellingen te wijzigen. De juiste waarde wordt getoond in de foutmelding.
• Attribute value in possible values
  Channable probeert een nieuwe toegestane waarde aan te maken voor een specifiek attribuut, maar Allegro geeft aan dat de waarde al bekend is in hun toegestane waarden. Er kan een verschil zijn in hoofdletters, kleine letters of spaties, wat de fout veroorzaakt.
  Om dit op te lossen moet je de waarde die je momenteel in de attributen hebt ingesteld wijzigen in de waarden die worden weergegeven in de lijst "toegestane waarden", inclusief hoofdletters, kleine letters, spaties en accenten. Als je bijvoorbeeld "Channable" als attribuut hebt ingesteld en Allegro toont "channable" als toegestane waarde, dan moet je deze waarde in de regels instellen op "channable".