Een vtwonen API instellen
UI-update: Er is een nieuwe kanaalselectiepagina en overzicht voor Feeds en Marktplaatsen (voorheen API's genoemd)! Sommige visuals en instructies zijn mogelijk niet up-to-date.
Stap 1: Maak een nieuwe koppeling aan
Ga naar [Jouw project] > Kanalen.
Klik +Add new API. Je wordt naar de koppelingenpagina van je bedrijf doorverwezen.
Op de koppelingenpagina selecteer je +Voeg een nieuwe koppeling toe.
Zoek de koppeling "vtwonen" door door de pagina's te klikken en selecteer deze door erop te klikken.
Voeg een label toe.
Klik Maak aan. Je wordt doorgestuurd naar vtwonen voor de volgende stap.
Zodra je bent doorgestuurd, log in met je vtwonen-inloggegevens.
Na succesvol inloggen is de koppeling met vtwonen klaar. Vervolgens word je teruggenavigeerd naar de API‑instellingen.
Stap 2: Maak de API aan
Nadat je je koppeling hebt aangemaakt, moet je je nieuwe vtwonen‑koppeling selecteren en je API‑instellingen configureren:
In de Naam veld, voer een naam in voor je API.
Kies de Uniek ID per item uit het dropdownmenu. We raden het 'id' veld aan.
Selecteer de Taal voor je API.
Klik Doorgaan om je vtwonen API aan te maken.
Stap 3: Maak je productvermeldingen aan
Volg deze stappen om je kanaal in te stellen.
Categorieer je producten
Om je productgegevens in te stellen, wijs je categorieën toe aan je producten.
AI-productcategorisering: Wijs automatisch productcategorieën toe via ons algoritme.
Handmatige categorisering: Wijs productcategorieën handmatig toe met custom regels. Je kunt gedetailleerde filters maken om elk product aan de juiste categorie te koppelen.
Niet-gecategoriseerde items: Producten die nog moeten worden gecontroleerd en gecategoriseerd
Stel regels in
Regels helpen je snel je productgegevens te optimaliseren voor de marktplaats waarop je wilt verkopen.
Regel-templates: Veelgebruikte regels die je kunt aanpassen aan jouw situatie.
Regels instellen: Stel regels in om je productgegevens te verfijnen. Dit kan het filteren, aanpassen of verbeteren van velden omvatten zodat ze voldoen aan de marktplaatsvereisten.
Bouw je vermeldingen
De Bouwen stap is waar je je productvermeldingen configureert zodat ze voldoen aan de marktplaatsvereisten. Het is een essentiële stap om je producten live te krijgen en fouten te voorkomen.
Verplichte en optionele velden:
Verplichte velden : Vereist om je producten op deze marktplaats te vermelden
Aanbevolen : Aanbevolen om fouten te voorkomen
Optioneel : Niet vereist om te vermelden
Gedeelde attributen
Gedeelde attributen zijn de gemeenschappelijke velden die voor al je producten gelden, zoals EAN, prijzen en titels. Deze stap zorgt voor uniformiteit in basisproductinformatie over je vermeldingen heen.
Gebruik statische of dynamische waarden:
Statische waarden: Vaste waarden die niet veranderen (bijv. merknaam, fabrikant)
Dynamische waarden: Velden die automatisch veranderen op basis van gekoppelde data (bijv. voorraad, prijzen)
Categorie-specifieke attributen
Categori-specifieke attributen zijn velden die specifiek gelden voor de categorie van je producten. Deze stap helpt je listings te verfijnen zodat ze voldoen aan de categorieregels van de marketplace.
Vul attributen in die specifiek zijn voor de geselecteerde categorie (bijv. maat voor kleding of afmetingen voor meubels).
Tip: Klik Velden automatisch toewijzen om automatisch te mappen met informatie uit je andere kanalen of vergelijkbare instellingen. Meer informatie.
Controleer de kwaliteit van je setup
De Kwaliteit stap geeft feedback over je kanaal voordat je het activeert. Het benadrukt verplichte en optionele fouten zodat je productgegevens voldoen aan de vereisten van de marktplaats.
Los fouten op, met prioriteit voor verplichte fouten.
Acties:
Bekijk items: Zie producten met specifieke problemen.
Bekijk in opbouw: Verwijst naar de Bouwen stap om ontbrekende informatie te mappen.
Categorieën instellen: Verwijst naar de Categorieën stap om items te categoriseren.
Bron tonen: Beschikbaar voor ID-velden. Verwijst naar de Instellingen stap.
Voorvertoning voordat je activeert
De Voorbeeld stap toont de attributen die je gemapt hebt in de Bouwen stap, zodat je kunt controleren of alles correct is geconfigureerd door je een overzicht te geven van je producten en mogelijke fouten.
Filteren:
Filter op fout: Klik op de Alle dropdown en selecteer of je wilt filteren om alleen producten met fouten of producten met een specifieke fout te tonen.
Filter op categorie: Klik op de Alle categorieën dropdown en selecteer de categorie waarop je wilt filteren.
Voordat je verdergaat:
Controleer gedeelde attributen: Zorg dat alle verplichte gedeelde attributen zijn ingevuld.
Controleer categorie-specifieke attributen: Zorg dat alle verplichte categorie-specifieke attributen zijn ingevuld.
Controleer op fouten: Corrigeer velden die rood gemarkeerd zijn.
Aanvullende vereisten voor vtwonen
Deze attribuutvereisten zijn specifiek voor vtwonen en gelden voor de attributen in het Bouwen stap.
Tabblad Gedeelde attributen
Verzendklasse (logistieke klasse): De logistieke klassen bepalen de bijbehorende verzendkosten voor je items. Vul de logistieke klasse van je product in.
Verwerkingstijd voor verzending: De verwerkingstijd geeft aan hoe lang het duurt voordat het pakket is overgedragen aan de vervoerder. Geef de verzendtijd in dagen aan.
Vereisten voor titel
Producttitels moeten uit het volgende bestaan:
Merk
De merknaam zoals deze geregistreerd staat
Producttype
De productcategorie, bijvoorbeeld "bank". Dit moet in kleine letters worden geschreven
Serie/productnaam
De serie- of productnaam die helpt de variant van het product te identificeren. Elk woord moet met een hoofdletter beginnen
Attributen
De onderscheidende kenmerken van het product, bijvoorbeeld kleur, afmetingen of materiaal
Structuur: Merk Producttype Naam - Kenmerken
Voorbeeld: vtwonen hanglamp Titan - zwart.
Productbeschrijving
De productbeschrijvingen voor je vtwonen API moeten:
de klant aanspreken (“je” en “jouw”)
in een vriendelijke, behulpzame en respectvolle toon zijn geschreven
jargon of technische termen vermijden, indien niet relevant voor de doelgroep
de productkenmerken en de voordelen en beleving beschrijven
relevante zoekwoorden gebruiken
geen afkortingen bevatten
Productbeschrijvingen moeten bestaan uit het volgende:
Korte beschrijving
Een overzicht van het product om de belangrijkste kenmerken te benadrukken. HTML is niet toegestaan
Opsommingstekens
De belangrijkste kenmerken en voordelen van het product. Minimaal 3 en maximaal 5 punten
Lange beschrijving
Gedetailleerde informatie over de producteigenschappen, specificaties, materialen en gebruik. Ook styling- en onderhoudstips. HTML is toegestaan (vet en lijsten)
Afbeeldingsvereisten
Minimale resolutie
800 x 800 px
Maximale resolutie
4472 x 4472 px
Ondersteunde formaten
JPEG, PNG, WebP, GIF
Stijl
Geen watermerken, logo's of tekstcomponenten
Videovereisten
Duur
Tussen 30 sec. en 2 min
Resolutie
1080p of hoger
Ondersteunde formaten
.mp4, .mov, .avi, .flv
Stijl
Geen randen, schetsen, watermerken, logo's, labels of prijzen
Beste praktijken
Meerdere attributenwaarden toevoegen: Wanneer je meerdere waarden toevoegt in een attribuutveld voor Mirakl Marketplaces, scheid je elke waarde met een pijp-teken "|" zodat ze correct worden gedetecteerd en verwerkt.
Product ID van verkoper voor enkele/eenvoudige producten: Er zijn twee attributen genaamd 'SellerArticleId' en 'SellerProductId'. 'SellerProductId' verwijst naar de Parent ID, terwijl 'SellerArticleId' verwijst naar de variantitems. Voor enkele producten moeten beide attributen met dezelfde waarde worden ingevuld.
Voor meer informatie over Mirakl-marktplaatsfouten, handleidingen en best practices, bekijk onze speciale handleiding.
Stap 4: Verstuur je productvermeldingen naar vtwonen
Zodra je productvermeldingen klaar zijn, moet je ze naar vtwonen sturen:
Als je je project nog niet hebt geactiveerd, ga dan naar [Je project] > Instellingen en klik Project activeren.
In [Je project] > Api's, ga naar [Je vtwonenAPI] > Instellingen.
Klik Activeer API.
Zodra je de API hebt geactiveerd, ga terug naar Api's.
Klik op de Nu uitvoeren knop in de kolom 'Status' om je productvermeldingen naar vtwonen te sturen.
Laatst bijgewerkt
Was dit nuttig?