Een Worten API instellen
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.
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.
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?