Een Winkelstraat.nl API instellen

Winkelstraat.nl is een online platform met een breed aanbod aan luxe- en designmode van meer dan 600 high-end merken. Het biedt exclusieve items van premium boetieks in Nederland en België. In dit artikel leggen we uit hoe je een Winkelstraat.nl API kunt instellen in Channable.

1

Voorbereiding

• 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 maken. Vraag deze gegevens aan door een e-mail te sturen naar [email protected].

Wanneer je de gegevens van Winkelstraat hebt ontvangen, kun je de API-verbinding in Channable aanmaken.

2

Maak een nieuwe koppeling

Volg de onderstaande stappen om een nieuwe Winkelstraat.nl-koppeling aan te maken:

• Ga naar de API-pagina binnen je project en klik op "+Add new API". Je wordt doorgestuurd naar de koppelingenpagina van je bedrijf.

• Selecteer op de koppelingenpagina "+Add a new connection".

• Zoek naar de 'Winkelstraat.nl' koppeling. Nadat je deze hebt gevonden, vul je de volgende informatie in:

  • Label

  • Client ID

  • Secret

• Klik op "Connect with Winkelstraat.nl" — de koppeling wordt dan gevalideerd en aangemaakt.

3

API aanmaken

Kies je nieuwe Winkelstraat.nl-koppeling en ga verder met het instellen van je API.

• Configureer API-instellingen:

  • Geef je API een naam

  • Kies de unieke ID per item (aanbevolen: het 'id'-veld)

  • Selecteer de taal van je API

• Klik op "Continue" om de nieuwe Winkelstraat.nl API aan te maken.

4

Maak je productvermeldingen aan

Volg deze opeenvolgende sub-stappen om je productgegevens voor Winkelstraat.nl voor te bereiden en te mappen.

Categoriseer je producten

Wijs categorieën toe aan je producten met een van de volgende opties:

• Productcategorisering met AI: Wijst automatisch productcategorieën toe via een algoritme.

• Handmatige Categorieën: Wijs categorieën handmatig toe met custom regels en filters.

• Niet-gecategoriseerde items: Producten die nog review en categorisering nodig hebben.

Meer lezen over categoriseren voor marktplaatsen

Regels instellen

Regels helpen je productdata verfijnen en optimaliseren voor de marketplace.

• Regel templates: Vooraf gedefinieerde regels die je kunt aanpassen.

• Regels instellen: Filter, wijzig of verbeter gegevensvelden om aan de marketplace-eisen te voldoen.

Lees meer over het gebruik van regels voor marktplaatsen

Bouw je advertenties

In de Build-stap configureer je je listings zodat ze voldoen aan de vereisten van de marketplace.

• Verplichte velden: Vereist om je producten op deze marketplace te plaatsen.

• Aanbevolen: Aanbevolen om fouten te voorkomen.

• Optioneel: Niet verplicht om te kunnen plaatsen.

Gedeelde attributen: gemeenschappelijke velden voor producten (bijv. EAN, prijzen, titels).

• Gebruik statische of dynamische waarden:

  • Vaste waarden: Vast ingesteld (bijv. merk).

  • Dynamische waarden: Veranderen op basis van gekoppelde data (bijv. voorraad, prijzen).

Categorie-specifieke attributen: velden die alleen voor een bepaalde categorie gelden (bijv. maat voor kleding). Vul attributen in die specifiek zijn voor de geselecteerde categorie.

Tip: Klik Velden automatisch toewijzen om automatisch te mappen met informatie uit je andere kanalen of vergelijkbare instellingen. Meer informatie.

Lees meer over de Build-stap voor marketplaces

Controleer de kwaliteit van je setup

De Quality-stap geeft feedback voordat je activeert. Het toont verplichte en optionele problemen.

• Los fouten op, met prioriteit voor verplichte fouten.

Beschikbare acties:

• Bekijk items: Zie producten met specifieke problemen.

• Bekijk in build: Stuurt je naar de Build-stap om ontbrekende informatie te mappen.

• Categorieën instellen: Ga naar de Categorieën-stap om items te categoriseren.

• Toon bron: Beschikbaar voor ID-velden, stuurt je naar Instellingen.

Meer weten over de Quality-stap

Voorvertoning voordat je activeert

De Preview-stap toont de in Build gemapte attributen en geeft mogelijke fouten weer.

Filteren:

• Filter op fout: Gebruik de All-dropdown om alleen producten met fouten of specifieke fouttypes te tonen.

• Filter op categorie: Gebruik de All categories-dropdown om op categorie te filteren.

Voordat je doorgaat:

• Controleer Gedeelde attributen: Zorg dat alle verplichte gedeelde attributen zijn ingevuld.

• Controleer Categorie-specifieke attributen: Zorg dat alle verplichte categorie-attributen zijn ingevuld.

• Controleer op fouten: Corrigeer alle velden die rood gemarkeerd zijn.

Meer weten over de Preview-stap

5

Aanvullende vereisten voor Winkelstraat.nl

De volgende informatie is specifiek voor Winkelstraat.nl.

Item-tab

• Item group ID is verplicht: Meestal 'item_group_id' of 'parent_id' genoemd.

• EAN niet verplicht: EAN is momenteel niet vereist om items geaccepteerd te krijgen, maar Winkelstraat raadt sterk aan deze te leveren.

Attributen per categorie-tab

• Afbeeldingen en beschrijving: Deze velden zijn verplicht en moeten worden ingevuld in de Attributen per categorie-tab.

Aanvullende informatie

• Producten van het platform verwijderen: Het is niet mogelijk om producten volledig uit je Winkelstraat-account te verwijderen. Zet in plaats daarvan de voorraad van het product op '0' om het te deactiveren op het platform. Om je producten te verwijderen, stuur ze opnieuw met de voorraad op '0'.

6

Stuur je productvermeldingen naar Winkelstraat.nl

• Als je project niet geactiveerd is, ga naar Project Settings (linkermenu) en klik op "Activate project".

• Open in het APIs-overzicht [Your Winkelstraat.nl API] > Settings en klik op "Activate API".

• Ga terug naar het API-overzicht en klik op de blauwe knop "Run now" om je productvermeldingen naar Winkelstraat.nl te verzenden.

7

Controleer je productvermeldingen op fouten

• Ga naar de Result-pagina van de API > Feedback-tab om te zien welke productvermeldingen fouten bevatten.

• Klik een specifiek item aan om gedetailleerde informatie over de oorzaak van de fout te zien.