> 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-obelink-api-instellen.md). # Een Obelink Api instellen Obelink is een van de grootste kampeerwinkels met een enorm assortiment aan tenten, caravans, campers, kampeerbenodigdheden, accessoires, tuinmeubelen en sportartikelen. Dit artikel doorloopt de stappen om een Obelink API in te stellen binnen de Channable-tool. {% 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 %} ### Voeg een nieuwe Obelink-koppeling toe De Obelink API gebruikt het Mirakl-platform, wat betekent dat je een Mirakl-account nodig hebt om je productvermeldingen naar Obelink te sturen. Als je een Mirakl Obelink-account hebt, ga naar "\[Je bedrijf] instellingenmenu > Koppelingen > Koppeling toevoegen". Klik op "+ Koppeling toevoegen" en selecteer Obelink. Vul een label in voor je koppeling (bijvoorbeeld Obelink). Klik vervolgens op "Koppel met Obelink". Je wordt doorgestuurd naar de omgeving waar je met je Mirakl-gegevens kunt inloggen. Na het inloggen word je teruggeleid naar Channable waar de koppeling beschikbaar is. | | | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [![EN - Obelink API 1.jpg](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/y5flnQ9hLHMiHKpjkcJP/14526820787858)](https://helpcenter.channable.com/hc/article_attachments/14526820787858) | [![Sing in Mirakl - Oauth.png](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/w7Ia6J7Ic3G82F60MXJK/14526657327378)](https://helpcenter.channable.com/hc/article_attachments/14526657327378) | ### Voeg een nieuwe Obelink API toe in Channable Ga in je project naar het overzicht van API's en klik op Voeg nieuwe API toe. Selecteer de Obelink-koppeling die je zojuist hebt aangemaakt en geef je nieuwe API een naam Selecteer het veld dat je wilt gebruiken als Uniek ID per item (we raden het 'id'-veld aan) en de Taal waarin je categorisaties en attribuutinstellingen doet. Je kunt hier ook een master regel groep toevoegen als je dat wilt. Klik op Doorgaan om de nieuwe Obelink API aan te maken. ### Maak je productlistings in Channable Zodra je de Obelink API hebt aangemaakt, stel je je productdata in 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 %} {% step %} Onder **Statische waarden voor verzendklasse** staan 3 waarden. In de onderstaande tabel vind je deze waarden en hun uitleg: | Code | Label | Uitleg | | ---- | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | SP | Klein pakket | Maximaal gewicht 3 kg; maximale lengte 50 cm en een maximale omtrek (2xb + 2xh + 1xl) van 111 cm | | NP | Normaal pakket | Maximaal gewicht 31,5 kg; maximale lengte 175 cm en een maximale omtrek (2xb +2xh +1xl) van 300 cm | | NSP | Niet-standaard pakket | Pakket heeft een langere lengte of diagonaal dan 130 cm; en/of gewicht >35 kg; en/of het pakket is onstabiel, heeft een onregelmatige vorm (bol, cilinder, rol) | | | | | Als deze waarde voor sommige producten anders is, kun je dit veld dynamisch invullen. Opmerkingen: * Obelink heeft ook een extra aanbiedingsveld genaamd Supplier SKU. Sommige partners hebben dit attribuut nodig om de bestelling te verwerken. Dit veld wordt toegevoegd als extra aanbiedingsveld in de bouwstap. Als je een Supplier SKU hebt, vul deze dan hier in; anders kun je het leeg laten. * Obelink heeft meerdere verkoopkanalen: obelink.nl, obelink.be en obelink.de. Ze ondersteunen geen kanaalspecifieke prijzen, dus de kanaalselectie-pop-up op de API-instellingenpagina en het extra tabblad in de bouwstap worden niet weergegeven. Kanalen moeten in je Mirakl-backend worden in- of uitgeschakeld [hier ](https://marketplace-obelink.mirakl.net/mmp/shop/account/channel)of ga naar instellingen > Partner > Kanalen {% endstep %} {% step %} ### Attributen Vul de velden in bij de Attributen-stap. Dit is belangrijk bij het verkopen van nieuwe producten die nog niet op de marketplace staan — het helpt het mirakl\_unknown\_error\_code te voorkomen. Selecteer eerst de categorie die je wilt optimaliseren. Een meer gedetailleerde uitleg van wat je in de Attributen-stap moet doen vind je hier: [Marktplaatsen: Bouwstap](/list-advertise/list-and-advertise-nl/verkoop-op-marktplaatsen/ga-aan-de-slag-met-marktplaatsen/marktplaatsen-bouwstap.md) {% endstep %} {% endstepper %} ### Stuur je producten naar Obelink Als je je project nog niet hebt geactiveerd, ga naar Setup > Project settings aan de linkerkant van het scherm en klik op Activeer project. Ga daarna terug naar het overzicht van API's, open "Je Obelink API Naam > Instellingen" en activeer de API door Activeer API te selecteren. Ga daarna terug naar het API-overzicht en klik op de blauwe "Uitvoeren" knop om je productvermeldingen naar Obelink te sturen. ### Controleer je productlistings op fouten Na het versturen van je productvermeldingen naar Obelink, ga naar het Resultaten-tabblad van je Obelink API. Gebruik het filter op 'error' om te zien welke productvermeldingen fouten hebben en niet zijn geplaatst. Klik op een specifieke fout om meer informatie over de oorzaak te zien. Als je fouten oplost door instellingen of productinformatie aan te passen, voer dan de Obelink API opnieuw uit om de bijgewerkte resultaten te zien. Het aanmaken van nieuwe producten leidt vaak tot fouten in het Resultaten-tabblad totdat ze door Obelink zijn goedgekeurd. ### 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" %} Seller's Product ID voor enkelvoudige/simple producten: Er zijn twee attributen met de namen SellerArticleId en SellerProductId. SellerProductId verwijst naar de Parent ID, terwijl SellerArticleId verwijst naar de variantitems. Voor enkelvoudige producten moeten beide attributen met dezelfde waarde gevuld zijn. {% endhint %} Voor meer informatie over Mirakl Marketplace-fouten, handleidingen en best practices, zie de Mirakl-gids: [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-obelink-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.