Stap 1: Vraag de Winkelstraat.nl API-gegevens aan
Voor Winkelstraat heb je een Client ID en een Secret key nodig om een geldige API-verbinding te kunnen maken. Om deze gegevens te verkrijgen, dien je deze aan te vragen door een e-mail te sturen naar contentapi@winkelstraat.nl.
Wanneer je de inloggegevens van Winkelstraat hebt ontvangen, kun je de API verbinding aanmaken in Channable.
Stap 2: Maak een Winkelstraat.nl API verbinding aan in Channable
Om een nieuwe Winkelstraat verbinding aan te maken, ga je naar het project waarin je werkt en navigeer je naar het tabblad API's. Klik op "+ API koppeling toevoegen" en vervolgens op "+ Koppeling toevoegen". Je kunt nu Winkelstraat selecteren:
Geef na het selecteren van de Winkelstraat API de verbinding een label en vul je Client id en Secret key in.
Klik tenslotte op "Connect with Winkelstraat.nl" en de verbinding wordt gevalideerd en aangemaakt. Je kunt nu beginnen met het opzetten van je productenvermeldingen voor Winkelstraat.
Stap 3: Aanmaken van productvermeldingen
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 Bol.com API te volgen.
1. Categorieën
Stel Winkelstraat-categorieën in voor je producten door gebruik te maken van de functie categorieën genereren of creëer nieuwe categorieën vanaf nul.
2. Regels
Maak verschillende regels aan om je productgegevens te optimaliseren. Voor voorbeelden kun je naar ons helpcenter artikel gaan over veel voorkomende regels.
3. Opbouw
In de bouwstap vind je onze standaard template voor de productvermeldingen. Het enige wat je hoeft te doen is op de velden te klikken en de juiste te selecteren. Het veld 'Naam' moet bijvoorbeeld de titel van het product weergeven enzovoort.
Opmerking: het veld Item Group ID is verplicht om in te vullen. Meestal wordt het veld dat je hier kunt gebruiken 'item_group_id' of 'parent_id' genoemd.
4. Attributen
Vervolgens dien je in de Attributen stap de attributen per categorie in te vullen. Je moet in ieder geval de verplichte attributen invullen, deze worden rood weergegeven als ze leeg zijn of met een ongeldige waarde zijn ingevuld.
Voor een uitgebreide uitleg van hoe je de Attributen kan optimaliseren kan je ons Attributen support artikel doorlezen.
Let op: Op dit moment is het EAN-veld niet verplicht om je artikelen door Winkelstraat geaccepteerd te krijgen, maar het wordt door hen wel sterk aanbevolen om ze alsnog toe te voegen.
Let op II: De afbeeldingen en beschrijving dienen ook in de Attributen te worden toegevoegd. Hoewel ze niet als rode velden worden weergegeven als ze leeg zijn, zijn ze eigenlijk verplicht.
Stap 4: Stuur je productvermeldingen naar Winkelstraat.nl
Zodra je klaar bent met het configureren van de productvermeldingen, kan je beginnen met het versturen van de productvermeldingen naar Winkelstraat.nl. Als het project nog niet geactiveerd is, navigeer dan naar "Setup > Projectconfiguratie" en activeer het project. Ga vervolgens terug naar het tabblad API's, en ga daar naar 'Instellen' bij je Winkelstraat-API, klik vervolgens op 'Activeer API'. Nu de API geactiveerd is kun je de producten gaan versturen, dit doe je door in het API-overzicht bij de Winkelstraat API op ''Uitvoeren'' te klikken, nu worden je producten naar Winkelstraat.nl gestuurd!
Let op: Voor Winkelstraat is het niet mogelijk om producten uit je account te verwijderen, alleen om ze op voorraad=0 te zetten, wat het product op het platform deactiveert. Als je dus om welke reden dan ook je producten uit Winkelstraat wilt verwijderen, hoef je ze alleen maar opnieuw te versturen, maar dan met een voorraad van 0.
Stap 5: Controleer je productenvermeldingen in de Resultaat stap
Zodra de API klaar is met draaien, kan je de resultaten controleren in de Resultaat stap van de Winkelstraat-API. Je zult zien hoeveel artikelen succesvol zijn verzonden en of er fouten zijn opgetreden. De items met een fout zijn niet op Winkelstraat.nl geplaatst. Klik op een fout om te zien wat de foutmelding is en welke producten die fout hebben.
Je kunt proberen de fouten op te lossen door de productgegevens die je naar Winkelstraat stuurt verder te optimaliseren of te wijzigen in de Categorieën, Regels, Opbouw en Attributen. Voer na het optimaliseren de API opnieuw uit en controleer de resultaten.