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.
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.
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:
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.
Onder Statische waarden voor verzendklasse staan 3 waarden. In de onderstaande tabel vind je deze waarden en hun 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
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: Opbouw-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
Laatst bijgewerkt
Was dit nuttig?