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.

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.

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:

1

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 of ga naar instellingen > Partner > Kanalen

2

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: Marketplaces: Bouw-stap

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

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.

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.

Voor meer informatie over Mirakl Marketplace-fouten, handleidingen en best practices, zie de Mirakl-gids: Mirakl-gids: instellingen en oplossingen