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. 

Inhoudsopgave

1. Voorbereiding
2. De Walmart API-koppeling aanmaken
3. Creëer een nieuwe Walmart API in Channable
4. Bouw je productvermeldingen in Channable
5. Stuur je productvermeldingen naar Walmart
6. Controleer je productvermeldingen op fouten

Voorbereiding

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:

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.

Stap 1: De Walmart API-koppeling aanmaken

Om een nieuwe Walmart-koppeling te maken, volg je de onderstaande stappen:

1. Ga naar de API-pagina binnen je project en klik op de knop "+API koppeling toevoegen". Deze actie brengt je naar de 'Koppelingen' pagina van je account.
2. Op de 'Koppelingen' pagina, selecteer "+Koppeling toevoegen".
   
3. Zoek naar de 'Walmart'-koppeling door door de pagina's te klikken. Nadat je de 'Walmart' koppeling hebt gevonden, vul je de volgende gegevens in:
   

   Label Client ID Client Secret

4. Klik op "Maak aan" om je Walmart-koppeling te voltooien. Daarna word je teruggebracht naar de API-configuratie.

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

Wanneer je terug bent op het API-selectiescherm, kun je nu je nieuwe koppeling met Walmart selecteren en verder gaan met het instellen van je API.

1. API-instellingen configureren:
   • Geef je API een naam.
   • Kies het unieke ID per item veld. (We raden het 'ID' veld aan.)
     
2. API aanmaken: Klik op "Volgende" om de nieuwe Walmart API te maken.

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

Volg de onderstaande stappen om je API in te stellen. Klik op elke stap om deze uit te klappen en de gedetailleerde instructies te bekijken, die je door het hele proces zullen leiden.

1. Categorieën

2. Regels

3. Opbouw stap

Met de Opbouw stap in Channable kun je alle benodigde attributen voor je items configureren, zodat je productgegevens overeenkomen met de vereisten van de marketplace. Deze stap is cruciaal voor succesvolle product listings en het vermijden van fouten.

3.1 Overzicht

1. Ga naar de Opbouw stap: Begin met het openen van de gecentraliseerde interface van de Opbouw stap. Hier kun je alle productattributen beheren en in kaart brengen.
2. Identificeer verplichte en optionele velden: Verplichte velden zijn roze gemarkeerd om aan te geven dat ze essentieel zijn. Optionele velden zijn oranje gemarkeerd en kunnen worden ingevuld op basis van specifieke behoeften.

3.2 Gedeelde attributen vullen

1. Gedeelde attributen vullen: Voer algemene gegevens in die van toepassing zijn op alle producten, zoals EAN, prijzen en titels. Deze stap zorgt voor uniformiteit in de basisproductinformatie voor al je listings.
   • Gebruik statische of dynamische waarden:
     • Statische waarden: Direct waarden invoeren die constant blijven, zoals merknaam of fabrikant.
     • Dynamische waarden: Gebruik velden die automatisch worden bijgewerkt op basis van gekoppelde gegevens, ideaal voor variabelen zoals voorraadniveaus of prijzen.

Nadat je de gewenste waarden voor de gedeelde attributen hebt ingevuld, ga je verder met de categoriespecifieke attributen hieronder.

3.3 Categoriespecifieke attributen opgeven

1. Selecteer een productcategorie: Kies de relevante categorie voor je product, zoals kleding of meubels.
2. Invullen van categoriespecifieke attributen: Vul de attributen in die specifiek zijn voor de geselecteerde categorie, zoals maten voor kleding of afmetingen voor meubels. Deze stap helpt bij het afstemmen van je listings op de categorie vereisten. Ook hier kun je statische of dynamische waarden gebruiken.

Klik hier om meer te lezen over de Opbouw stap in een API.

4. Kwaliteitsstap

De kwaliteitsstap geeft direct feedback over de kwaliteit van de instellingen en markeert verplichte en optionele fouten om ervoor te zorgen dat je productgegevens voldoen aan de standaarden van de marketplaces.

Acties

• Bekijk items: Bekijk producten met specifieke problemen.
• Bekijk in de opbouw stap: Leidt je door naar de opbouw stap om ontbrekende informatie in kaart te brengen.
• Categorieën instellen: Hiermee ga je naar de Categorieën stap om items te categoriseren.
• Toon Bron: Beschikbaar voor ID-velden, hiermee ga je direct naar de instellen stap.

Klik hier om meer te lezen over de kwaliteitsstap in de API.

5. Bekijk stap

De Bekijk stap toont in kaart gebrachte attributen voor meerdere items en markeert fouten voordat er naar de marketplace wordt geëxporteerd.

Features

• Zoek & filter: Zoek specifieke producten of filter op foutmelding/categorie.
• Item overzicht: Toont alle items die geëxporteerd moeten worden; het kan filteren om alleen items met fouten te tonen.
• Gedetailleerd productoverzicht: Toont ontbrekende informatie en dynamische acties om fouten te corrigeren.

Checklist voor het afronden van attributen

• Gedeelde kenmerken bekijken: Zorg ervoor dat alle verplichte gedeelde attributen zijn ingevuld.
• Categoriespecifieke kenmerken bekijken: Zorg ervoor dat alle verplichte categoriespecifieke attributen zijn ingevuld.
• Contoleer op fouten: Corrigeer rood gemarkeerde velden.

Klik hier om meer te lezen over de Bekijk stap in een API.

6. Resultaat stap

Aanvullende vereisten voor Walmart

De volgende informatie is specifiek voor Walmart.

Shipping Template tabblad

• Shipping Template ID:
  Om je producten te koppelen aan specifieke verzendtemplates, moet je eerst de verzendtemplates voor je producten op Walmart maken, zoals uitgelegd in dit Walmart Seller Help-artikel. Nadat je een template hebt gemaakt, genereert Walmart een Verzendtemplate-ID. Je moet deze templates onderhouden of bewerken op het Walmart-platform.Elk template die je op Walmart maakt, genereert een unieke Shipping Template ID. Voer deze ID in, in de "Opbouw > Shipping template" sectie binnen Channable.
  
  Om verschillende Shipping Templates aan verschillende producten toe te wijzen, kan je gebruik maken van dynamische velden en regels in Channable, zodat elk product wordt gekoppeld aan het juiste Verzendtemplate-ID.

• Fulfillment center template ID:
  Dit ID vertegenwoordigt de locatie in de VS vanwaar je bestellingen worden verzonden. Net als bij Shipping templates, moet je je Fulfillment center template op Walmart instellen en onderhouden volgens dit Walmart Seller Helpcenter artikel om de Fulfillment-ID te genereren. Voer dit ID binnen Channable in om ervoor te zorgen dat je producten worden gekoppeld aan de juiste Fulfillment locatie.

Extra informatie

Varianten voor Walmart maken

Het beheren van productvarianten op Walmart vereist zorgvuldige categorie-selectie en specifieke instellingen van attributen:

1. Selecteer de juiste categorie: Begin met het kiezen van de juiste categorie voor je producten. Sommige categorieën ondersteunen geen varianten, dus het is essentieel om de juiste categorie te kiezen voor de variantenconfiguratie.

2. Configureer Variant-attributen: Na de categorie-selectie, stel je de Variant-attributen in door de volgende velden in te vullen:

   • Variant Groep ID: Gebruik een gemeenschappelijk identificatienummer voor alle varianten binnen een groep, zoals parent_id of item_group_id.

   • Variant Attribuutnaam: Specificeer het attribuut dat de varianten onderscheidt (bijv. kleur, maat).

   • Variant Codeveld: Wijs het veld toe dat wordt geassocieerd met de variantcode.

3. Voer Variantcodes in: Vul meerdere variantcodes in door elke code te scheiden met een komma (,). Hoewel dit een foutmelding in Channable kan veroorzaken, kun je deze negeren omdat Walmart de invoer correct zal verwerken. Eindig geen waarde met een komma, want Walmart zal het attribuut dan afwijzen.

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 "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 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 en 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 in de Resultaat- stap de voorvertoning van je productvermeldingen zien. Klik op de tab 'Fouten'. Hier zie je welke advertenties fouten bevatten en niet op Walmart geplaatst zullen worden. 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.