> For the complete documentation index, see [llms.txt](https://helpcenter.channable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.channable.com/list-advertise/list-and-advertise-nl/verkoop-op-marktplaatsen/mirakl-marktplaatsen/een-worten-api-instellen.md).
# Een Worten Api instellen
{% hint style="info" %}
**UI-update:** Er is een nieuwe kanaalselectiepagina en overzicht voor **Feeds** en **Marktplaatsen** (voorheen API's genoemd)! Sommige visuals en instructies zijn mogelijk niet meer actueel.
{% endhint %}
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.
{% stepper %}
{% step %}
### 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.
| [](https://helpcenter.channable.com/hc/article_attachments/13880231501842) | [](https://helpcenter.channable.com/hc/article_attachments/21020603799314) |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| {% endstep %} | |
{% step %}
### 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.
{% hint style="warning" %}
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](https://helpcenter.channable.com/hc/en-us/articles/11883675662482). Het aanmaken van aparte Worten API's voor verschillende landen terwijl je dezelfde koppeling gebruikt werkt niet, omdat die API's elkaar zullen overschrijven.
{% endhint %}
{% endstep %}
{% step %}
### 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.
{% stepper %}
{% step %}
#### Categorieën
Om je productvermeldingen te kunnen maken, hebben je producten een categorie nodig. Voeg Categorieën toe aan je producten door gebruik te maken van de [functie Genereer categorieën](/manage-improve-product-data/manage-product-and-improve-data-nl/producten-categoriseren/productcategorieen-aanmaken/gebruik-de-functie-genereer-categorieen.md) of [Maak aan nieuwe Categorieën vanaf nul](/manage-improve-product-data/manage-product-and-improve-data-nl/producten-categoriseren/productcategorieen-aanmaken/categorieen-handmatig-toevoegen.md).
{% endstep %}
{% step %}
#### Regels
Maak aan [verschillende regels](/manage-improve-product-data/manage-product-and-improve-data-nl/regels-in-bulk-bewerken-en-verrijken/regels-gebruiken.md) om je productvermeldingen te Optimaliseren.
{% endstep %}
{% step %}
#### Bouw - Gedeelde attributen
Gedeelde attributen zijn attributen die gelden voor al je Items, zoals prijs en voorraad.
1. Begin met het koppelen van velden aan attributen die door de marketplace als verplicht zijn gemarkeerd.
2. Controleer de overige attributen en koppel velden aan attributen die relevant zijn voor je bedrijf.
3. Klik op **Opslaan**.
{% endstep %}
{% step %}
#### Bouw - Attributen per categorie
Categorie-attributen zijn attributen die gelden voor Items uit specifieke Categorieën, zoals batterij-informatie voor elektronische Items of maatinformatie voor kleding.
1. Begin met het koppelen van velden aan attributen die door de marketplace als verplicht zijn gemarkeerd.
2. Controleer de overige attributen en koppel velden aan attributen die relevant zijn voor je bedrijf.
3. Klik op **Opslaan**.
{% endstep %}
{% endstepper %}
{% hint style="warning" %}
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.
{% endhint %}
{% hint style="success" %}
**Tip:** Ga er met je muis overheen :circle-question: voor meer informatie over de specifieke veldvereisten.
{% endhint %}
{% stepper %}
{% step %}
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](/list-advertise/list-and-advertise-nl/verkoop-op-marktplaatsen/mirakl-marktplaatsen/mirakl-verkoopkanalen-instellen.md)
{% endstep %}
{% endstepper %}
{% endstep %}
{% step %}
### GPSR- en DSA-vereisten
De Europese Unie (EU) heeft nieuwe [GPSR- en DSA-vereisten](/list-advertise/list-and-advertise-nl/verkoop-op-marktplaatsen/ga-aan-de-slag-met-marktplaatsen/wat-je-moet-doen-naar-aanleiding-van-gpsr-en-dsa-om-daaraan-te-voldoen.md) 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.
{% hint style="info" %}
Deze attributen zijn verplicht om te voldoen aan de EU GPSR- en DSA-verplichtingen voor marketplaces.
{% endhint %}
{% endstep %}
{% step %}
### 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.
{% endstep %}
{% step %}
### 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.
{% endstep %}
{% endstepper %}
### Beste praktijken
{% hint style="info" %}
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.
{% endhint %}
{% hint style="info" %}
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.
{% endhint %}
Voor meer informatie over Mirakl-marktplaatsfouten, handleidingen en best practices, bekijk [Mirakl-gids: instellingen en oplossingen](/list-advertise/list-and-advertise-nl/verkoop-op-marktplaatsen/mirakl-marktplaatsen/mirakl-gids-instellingen-en-oplossingen.md)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://helpcenter.channable.com/list-advertise/list-and-advertise-nl/verkoop-op-marktplaatsen/mirakl-marktplaatsen/een-worten-api-instellen.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.