Een Worten 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.
Worten is een digitaal bedrijf met daarnaast 240 fysieke winkels, gericht op Portugal en Spanje. Ze verkopen huishoudelijke apparaten, IT-producten, telecommunicatie, geluid & beeld en entertainment. Recent hebben ze ook geïnvesteerd in speelgoed, beauty, wonen & gezondheid, sport, boeken, huis & decoratie, doe-het-zelf & tuin en zelfs producten voor huisdieren.
Voeg een nieuwe Worten-koppeling toe
De Worten API gebruikt het Mirakl-platform, wat betekent dat je een Mirakl-account nodig hebt om je productvermeldingen naar Worten te sturen.
Als je een Mirakl Worten-account hebt, ga naar "Connections > Add connection". Klik op "+ Add a new connection" en je ziet een scherm waar je Worten kunt selecteren. Vul het label voor je koppeling in, bijvoorbeeld Worten. Klik vervolgens op "Connect with Worten". Je wordt doorgestuurd naar de omgeving waar je kunt inloggen met je Mirakl-gegevens. Na het inloggen word je teruggeleid naar Channable en is de koppeling beschikbaar.
Voeg een nieuwe Worten API toe in Channable
Ga nu in je project naar het overzicht van API's. Klik op "+ Add new API", selecteer de Worten-koppeling die je zojuist hebt gemaakt en geef je nieuwe API een naam.
Selecteer het veld dat je wilt gebruiken voor Uniek ID per item (we raden het 'id'-veld aan), en de Taal waarin je categorisaties doet en attributen instelt. Klik op "Continue" om het aanmaken van de nieuwe Worten API te voltooien.
Belangrijk: Worten biedt in onze API de optie om Sales Channels te definiëren. Als je meer wilt weten over kanalen of hoe je dit instelt, volg dan de stappen in dit artikel. Het aanmaken van aparte Worten API's voor verschillende landen terwijl je dezelfde koppeling gebruikt werkt niet, omdat die API's elkaar zullen overschrijven.
Maak je productlistings in Channable
Zodra je de Worten API hebt aangemaakt, kun je je productgegevens instellen door de stappen van de API te volgen.
Categorieën
Voor het aanmaken van je productvermeldingen hebben je producten een categorie nodig. Voeg categorieën toe aan je producten door gebruik te maken van de genereer categorieën-functie of maak nieuwe categorieën helemaal zelf aan.
Regels
Maak verschillende regels om je productvermeldingen te optimaliseren.
Build - Gedeelde attributen
Gedeelde attributen zijn attributen die voor al je items gelden, zoals prijs en voorraad.
Begin met het koppelen van velden aan attributen die door de marketplace als verplicht zijn gemarkeerd.
Controleer de overige attributen en koppel velden aan de attributen die relevant zijn voor jouw bedrijf.
Klik Opslaan.
Build - Attributen per categorie
Categorie-attributen zijn attributen die gelden voor items uit specifieke categorieën, zoals batterij-informatie voor elektronische artikelen of maatinformatie voor kleding.
Begin met het koppelen van velden aan attributen die door de marketplace als verplicht zijn gemarkeerd.
Controleer de overige attributen en koppel velden aan de attributen die relevant zijn voor jouw bedrijf.
Klik Opslaan.
In vergelijking met andere Mirakl-API's heeft Worten geen 'title' in de build-stap. Er is een “Product Name Pt” dat door Worten verplicht is gesteld en een “Product Name Es” in de Attributes-stap van de API. De beschrijving voor beide talen moet wel ingevuld worden in de build-stap.
Tip: Houd je muis boven voor meer informatie over specifieke veldvereisten.
In de build-stap vind je ook het tabblad Sales channels waar je je prijsinformatie kunt invullen voor elk afzonderlijk verkoopkanaal op Worten. Meer informatie over deze Sales channels vind je hier: Mirakl-verkoopkanalen instellen
GPSR- en DSA-vereisten
De Europese Unie (EU) heeft nieuwe GPSR- en DSA-vereisten voor online platformen, inclusief marketplaces.
Voor je Worten API in Channable, zorg dat je de categorie-specifieke Attributen per categorie tab in de Bouwen stap invult:
E-mailadres van de verantwoordelijke in de EU: Voer het e-mailadres in van de persoon die verantwoordelijk is in de EU.
Postadres van de verantwoordelijke in de EU: Geef het postadres van de persoon die verantwoordelijk is in de EU.
Naam van de verantwoordelijke in de EU: Voer de naam in van de persoon die verantwoordelijk is in de EU.
Deze attributen zijn verplicht om te voldoen aan de EU GPSR- en DSA-verplichtingen voor marketplaces.
Stuur je producten naar Worten
Bijna klaar — je productvermeldingen zijn klaar om te versturen. Als je je project nog niet hebt geactiveerd, ga dan naar je projectinstellingen links in het scherm en klik op 'activate project'. Ga daarna terug naar het API-overzicht en ga naar "Your Worten API Name > Settings", waar je de API activeert door "Activate API" te selecteren. Nadat je deze stap hebt afgerond, ga je terug naar het API-overzicht en klik je op de blauwe knop "Run now" om je productvermeldingen naar Worten te sturen.
Controleer je productlistings op fouten
Nadat je je productvermeldingen naar Worten hebt gestuurd, ga je naar het tabblad Results van je Worten API. Filter op 'error'. Nu zie je welke productvermeldingen fouten hebben en niet geplaatst zijn. Klik op een specifieke fout om meer informatie te zien over wat de fout veroorzaakt. Als je fouten hebt opgelost door instellingen of productinformatie aan te passen, voer dan de Worten API opnieuw uit om de nieuwe resultaten te zien.
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 de verkoper voor single/simple producten: Er zijn twee attributen met de namen 'SellerArticleId' en 'SellerProductId'. 'SellerProductId' verwijst naar de Parent ID, terwijl 'SellerArticleId' verwijst naar de variant-items. Voor single producten moeten beide attributen met dezelfde waarde worden ingevuld.
Voor meer informatie over Mirakl-marktplaatsfouten, handleidingen en best practices, bekijk Mirakl-gids: instellingen en oplossingen
Laatst bijgewerkt
Was dit nuttig?