Winkelstraat.nl is een online platform met een breed aanbod aan luxe en designermode van meer dan 600 topmerken. Het biedt exclusieve items van top boetieken in Nederland en België. In dit artikel leggen we uit hoe je een Winkelstraat.nl API-kanaal in Channable kunt instellen.
Inhoudsopgave
- Voorbereiding
- Maak een Winkelstraat.nl connectie
- Maak een Winkelstraat.nl API-kanaal
- Maak je productvermeldingen aan
- Verstuur je productvermeldingen naar Winkelstraat.nl
- Controleer je productvermeldingen op fouten
Voorbereiding
- Vraag jouw Winkelstraat.nl API-referenties op: Voor Winkelstraat.nl heb je een Client ID en een Client secret nodig om een geldige API-verbinding te maken. Om deze gegevens te verkrijgen, dien je een e-mail te sturen naar contentapi@winkelstraat.nl. Zodra je jouw API-gegevens hebt ontvangen, kun je aan de slag met het aanmaken van je API-kanaal in Channable.
Stap 1: Maak een Winkelstraat.nl connectie
Volg onderstaande stappen om een Winkelstraat.nl connectie aan te maken.
- Navigeer naar de API-pagina binnen je project en klik op de 'API koppeling toevoegen'-knop;
- Selecteer 'Koppeling toevoegen' en selecteer de Winkelstraat.nl-knop;
- Geef je koppeling een naam (Label) en voer je Client ID en Client secret in;
- Klik vervolgens op 'Maak aan' om jouw koppeling te creëren.
Stap 2: Maak een Winkelstraat.nl API-kanaal
Je wordt doorgestuurd naar de 'Nieuwe API'-pagina voor je aangemaakte connectie. Om je API-kanaal op te zetten, volg je de stappen hieronder.
-
Configureer je API-instellingen:
- Geef je API-kanaal een naam;
- Kies een 'Unieke ID per item' (we raden het veld id aan);
- Selecteer de taal van je API-kanaal;
- Voeg optioneel een master regelgroep toe.
- API-kanaal maken: Klik op 'Volgende' om jouw Winkelstraat.nl API-kanaal te creëren.
Stap 3: Maak je productvermeldingen aan
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
Om je productgegevens aan te maken, hebben je producten een categorie nodig. Voeg categorieën aan je producten toe met de functie 'categorieën genereren' of maak nieuwe categorieën aan.
- Smart categorization: Deze functie wijst automatisch categorieën aan je producten toe op basis van vooraf gedefinieerde criteria, wat het categorisatie proces vereenvoudigt.
- Handmatige categorieën: Wijs handmatig categorieën toe aan je producten door specifieke regels in te stellen. Je kunt gedetailleerde filters maken om elk product aan de juiste categorie toe te wijzen.
- Niet-gecategoriseerde items: Controleer en categoriseer alle items die nog niet gecategoriseerd zijn om ervoor te zorgen dat alle producten goed gecategoriseerd zijn.
2. Regels
Maak verschillende regels om je productgegevens te optimaliseren. Raadpleeg voor voorbeelden ons helpcenter artikel voor algemene regels.
- Regels setup: Stel verschillende regels in om je productgegevens te verfijnen. Dit kan het filteren, wijzigen of verbeteren van datavelden omvatten om te voldoen aan de vereisten van de marketplace.
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
- 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.
- 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
-
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.
-
Gebruik statische of dynamische waarden:
Nadat je de gewenste waarden voor de gedeelde attributen hebt ingevuld, ga je verder met de categoriespecifieke attributen hieronder.
3.3 Categoriespecifieke attributen opgeven
- Selecteer een productcategorie: Kies de relevante categorie voor je product, zoals kleding of meubels.
- 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.
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.
6. Resultaat stap
Het tabblad Resultaat geeft een overzicht van de resultaten van je API-instelling, inclusief succesvolle uploads, fouten en een voorbeeld van de producten die worden weergegeven. Dit tabblad zorgt ervoor dat je productgegevens correct worden verwerkt en identificeert eventuele problemen die moeten worden opgelost.
- Overzicht: Het resultaat tabblad toont de status van je productvermeldingen en markeert fouten en problemen voor een gedetailleerd inzicht.
- Preview van producten: Toont een overzicht van producten die naar de marketplace moeten worden verstuurd, zodat kan worden gecontroleerd of attributen correct zijn ingevuld.
- Succesvol: Toont producten die met succes zijn verwerkt en klaar zijn om gelist te worden, en bevestigt dat ze voldoen aan de vereisten van de marketplace.
- Fouten: Identificeert fouten tijdens de verwerking en geeft gedetailleerde informatie om problemen op te lossen.
Optionele tabbladen zoals Repricer fouten, Repricer event geschiedenis, Voorraadupdates en Leveringstype updates verschijnen alleen als ze relevant zijn voor de API die je gebruikt. Klik hier om meer te lezen over de Resultaat stap.
Extra vereisten voor Winkelstraat.nl
De volgende informatie is specifiek voor Winkelstraat.nl. Hieronder beschrijven we per tab waar je op moet letten.
Item (Opbouw-stap)
- Item group ID (Verplicht): Het Item group ID-veld is verplicht om in te vullen. Doorgaans heet het veld dat je hier koppelt item_group_id of parent_id.
Attributen per categorie (Categorieën-stap)
- Afbeeldingen en beschrijving (Verplicht): Deze velden worden door Winkelstraat.nl verplicht en vul je in binnen de Attributen-stap.
- EAN code (Niet verplicht): Momenteel is het EAN-veld binnen de Attributen-stap niet verplicht voor je producten om deze geaccepteerd te krijgen door Winkelstraat.nl, maar we raden sterk aan deze alsnog mee te geven, indien je over deze data beschikt.
Additionele informatie
- Producten verwijderen van het platform: Voor Winkelstraat.nl is het niet mogelijk om producten volledig van je Winkelstraat.nl-account te verwijderen. Zet in plaats daarvan de voorraad van het product op '0' (binnen Channable) om het te deactiveren op het platform.
Stap 4: Verstuur je productvermeldingen naar Winkelstraat.nl
Je productvermeldingen zijn nu klaar om verzonden te worden. Als je jouw project nog niet hebt geactiveerd, navigeer dan naar je projectinstellingen via Configuratie, linksonder in je projectpagina, en klik op 'Activeer project'.
Ga daarna terug naar de APIs-pagina en open je Winkelstraat.nl API-kanaal > Instellingen, waar je de API activeert door op 'API activeren' te klikken.
Zodra je de API hebt geactiveerd, navigeer je terug naar het APIs-overzicht en klik je op de blauwe knop 'Uitvoeren' om je productvermeldingen door te sturen naar Winkelstraat.nl
Stap 5: Controleer je productvermeldingen op fouten
Om je verstuurde producten op fouten te controleren, navigeer je naar de Resultaat-pagina van het API-kanaal, waar je het tabblad Fouten opent. Hier vind je welke producten foutenmeldingen meekrijgen van Winkelstraat.nl. Door op het specifieke product te klikken, wordt meer informatie weergegeven over de oorzaak van de fout.