Een Walmart API opzetten

Walmart is één van de grootste Amerikaanse supermarktketens, met tegenwoordig meer dan 10.000 winkels in 27 landen.

De set-up van de Walmart API in Channable is vrij intuïtief, maar er zijn een paar aandachtspunten die we in dit helpcenter artikel bespreken. 

Stap 1 - Voeg een nieuwe Walmart koppeling toe

Allereerst moet er een Walmart client ID en secret worden aangemaakt. Deze kan je opvragen in het Walmart Developer Portal. Tijdens dit proces moet je aangeven met welke integrator je werkt, maar ook welke rechten je ons wilt geven. We hebben minstens de rechten nodig die in de onderstaande schermafbeelding zijn gemarkeerd (kies hier dan voor Access):

Nadat je ons de juiste rechten hebt gegeven, ontvangt je een client ID en een secret, die je kunt kopiëren/plakken in de koppeling in de Channable interface. Dus wanneer je het client ID en secret hebt ontvangen, ga je naar "[Je bedrijf] instellingen menu (in de rechterbovenhoek) > Koppelingen > + Koppeling toevoegen". Door hierop te klikken, krijg je een scherm te zien, waar je Walmart kunt selecteren. Vul het label voor je koppeling in, bijvoorbeeld: Walmart, en kopieer/plak de client-ID en secret die je van Walmart hebt ontvangen. Klik op "Maak aan" om het aanmaken van je Walmart-koppeling te voltooien.

Stap 2: Creëer een nieuwe Walmart API in Channable

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

Selecteer het veld dat je wilt gebruiken als Unieke ID per item (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 Walmart API af te ronden.

Stap 3: Bouw je productvermeldingen in Channable

Het bouwen van productvermeldingen gaat simpel en snel met onze standaard-template. Je kunt een productvermelding aanmaken door de volgende vier stappen in de Walmart API te volgen.

1. Categorieën
   Nu je de API hebt aangemaakt, is het tijd om de categorieën in te stellen. Hiermee kun je jouw eigen categorisatie converteren naar die van Walmart. Dit kan met behulp van de functie categorieën genereren, of door handmatig categorieën in te vullen.
   
   
2. Regels
   Maak verschillende regels aan om je productvermeldingen te optimaliseren. Voor voorbeelden kun je naar ons helpcenter artikel voor veel voorkomende regels gaan. 
   
   
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.
   
   In de opbouw-stap vind je ook het volgende optionele gedeelte voor het toewijzen van een Shipping template en Fulfillment Center aan de SKU van een artikel:
   
   
   
   Belangrijk! Om van deze optie gebruik te maken, moet je beide ID's invullen.
   Voor een uitgebreide uitleg over wat shipping templates zijn en hoe ze worden gebruikt, navigeer je naar de Seller Community van Walmart. In het kort komt het erop neer dat je speciaal aangepaste shipping templates voor verzendinformatie van producten kunt aanmaken. Het aanmaken en onderhouden van shipping templates dient te gebeuren op Walmart. Wanneer je klaar bent met het instellen van je template, genereert Walmart een Shipping Template ID (zie onderstaande schermafbeelding). Dit is het ID die we gebruiken om producten aan een specifieke shipping template te koppelen.
   
   Channable koppelt automatisch elk individueel product aan een specifiek shipping template met het bijbehorende ID. Als je specifieke producten aan verschillende shipping templates wilt toevoegen, kan je dat doen door een dynamisch veld voor de shipping template ID te maken en een regel in te stellen die je producten over deze verschillende shipping templates verdeelt.
   
   Nu moet je de fulfillment center ID invullen. Volgens dit Walmart Seller Helpcenter artikel geeft het fulfillment center aan vanaf welke in de VS gevestigde locatie je jouw bestellingen zult verzenden. Het proces is vergelijkbaar met het bovengenoemde. Het aanmaken en onderhouden van deze fulfillment centers moet ook op Walmart worden gedaan, waardoor je een ID krijgt die je in Channable kunt gebruiken.
   
4. Attributen
   Je bent er bijna! De volgende stap is om de velden in de Attributen stap te optimaliseren. Een voorbeeld van wat je in de Attributen stap zou moeten vinden, zie je in de afbeelding hieronder. Voor een uitgebreide uitleg van hoe je de attributen kan optimaliseren, kun je ons Attributen support helpcenter artikel doorlezen.De categorieën van Walmart zijn zeer algemeen (bijvoorbeeld "Baby Clothing"), maar je kunt in de attributen een diepere categorie aangeven - bijvoorbeeld door het veld "Pyjama Type" in te vullen voor Babykleding pyjama's, of het veld "T-shirt Type" voor Babykleding T-shirts.
   
   Varianten aanmaken
   Het beheren van artikelvarianten is bij Walmart een beetje anders dan bij andere APIs. Varianten maken deel uit van de attributen, wat betekent dat wanneer je niet categoriseert, je geen varianten kunt instellen. Bovendien kunnen velden die nodig zijn om varianten te maken niet beschikbaar zijn in specifieke categorieën waar Walmart geen varianten aanbiedt, waardoor het uiterst belangrijk is om de juiste categorieën te kiezen.
   
   Nadat je de juiste categorieën hebt geselecteerd, moet je de volgende drie waarden invullen:
   1. Een Variant group ID: een ID dat wordt gedeeld door alle varianten in een groep, bijvoorbeeld "parent_id" of "item_group_id".
   
   2. Een Variant Attribute Name: op welke waarde verschilt de variant groep (bijv. kleur, maat).
   
   3. Het veld dat bij de variantcode hoort.
   
   Door dit in te vullen kan je een variantgroep via onze API aanmaken. Je kunt meerdere variantcodes invullen door tussen elke code een "," te plaatsen (zie screenshot). Als je dit doet, geeft de attributenbouwer aan dat dit een onjuiste waarde is, maar Walmart accepteert dit wel.
   
   

Stap 4: Stuur je advertenties naar Walmart

Bijna klaar, je kunt nu je producten naar Walmart sturen. Zorg ervoor dat je het project in Channable hebt geactiveerd door in de tool naar Configuratie te gaan en daarna op "Activeer project" te klikken. Ga daarna naar APIs > "Walmart API Naam" > Instellen en klik daar op "Activeren". 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 Walmart te versturen. Nadat je producten naar Walmart zijn gestuurd, gaan deze door verschillende fases heen voordat je producten op Walmart te bestellen zijn.

Na de eerste run zie je waarschijnlijk succesvol doorgestuurde items, dat betekent dat de items succesvol zijn verstuurd en aangemaakt in Walmart. In deze fase missen de items nog prijs en voorraad informatie. In de volgende run zullen we de prijs en voorraad van een item instellen mits het item succesvol is aangemaakt. Pas na deze stap zijn de artikelen succesvol beschikbaar op Walmart en kunnen ze worden verkocht. Je kunt het Walmart Dashboard gebruiken om de publicatiestatus van een product te volgen.

Stap 5: Controleer je productvermeldingen op fouten

Wanneer de advertenties naar Walmart 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 op Walmart. Klik op een specifieke fout om meer informatie te zien over de oorzaak van de fout. Als je enkele fouten hebt opgelost door de instellingen of productinformatie te wijzigen, voer dan de Walmart API opnieuw uit om de nieuwe resultaten te zien.