Obelink API einrichten
Obelink ist eines der größten Campinghäuser mit einem großen Sortiment an Zelten, Caravans, Wohnmobilen, Campingbedarf, Zubehör, Gartenmöbeln und Sportartikeln. In diesem Artikel werden die Schritte zum Einrichten einer Obelink-API innerhalb des Channable-Tools erklärt.
Neue Obelink-Verbindung hinzufügen
Die Obelink-API nutzt die Mirakl-Plattform, das heißt du brauchst ein Mirakl-Konto, um deine Produktangebote an Obelink zu senden.
Wenn du ein Mirakl-Obelink-Konto hast, gehe zu "[Deine Firma] > Einstellungen > Verbindungen > Verbindung hinzufügen". Klicke auf "+ Verbindung hinzufügen" und wähle Obelink. Fülle das Label für deine Verbindung aus (z. B. Obelink). Klicke dann auf "Mit Obelink verbinden". Du wirst in die Umgebung weitergeleitet, in der du dich mit deinen Mirakl-Zugangsdaten einloggen kannst. Nach dem Login wirst du zurück zu Channable geleitet, wo die Verbindung dann verfügbar ist.
Neue Obelink-API in Channable hinzufügen
Gehe in deinem Projekt zur API-Übersicht und klicke auf Neue API hinzufügen. Wähle die Obelink-Verbindung, die du gerade erstellt hast, und gib deiner neuen API einen Namen.
Wähle das Feld, das du als Eigene ID pro Item verwenden möchtest (wir empfehlen das Feld 'id'), und die Sprache, in der du Kategorisierungen und Attribut-Setups vornimmst. Du kannst hier auch eine Masterregel-Gruppe hinzufügen, wenn du möchtest. Klicke auf Weiter, um die neue Obelink-API zu erstellen.
Erstelle deine Produkt-Listings in Channable
Sobald du die Obelink-API erstellt hast, richte deine Produktdaten ein, indem du die Schritte der API befolgst:
Unter Statische Werte für Versandklasse gibt es 3 Werte. In der Tabelle unten findest du diese Werte und ihre Erklärungen:
SP
Kleines Paket
Max. Gewicht 3 kg; maximale Länge 50 cm und ein max. Umfang (2xB + 2xH + 1xL) von 111 cm
NP
Normales Paket
Max. Gewicht 31,5 kg; maximale Länge 175 cm und ein max. Umfang (2xB + 2xH + 1xL) von 300 cm
NSP
Nicht standardmäßiges Paket
Paket hat längere Länge oder Diagonale als 130 cm; und/oder Gewicht >35 kg; und/oder Paket ist instabil, unregelmäßige Form (Kugel, Zylinder, Rolle)
Wenn dieser Wert bei einigen Produkten abweicht, kannst du dieses Feld dynamisch befüllen.
Hinweise:
Obelink hat außerdem ein zusätzliches Angebotsfeld namens Supplier SKU. Einige Partner verlangen dieses Attribut, um die Bestellung abzuschließen. Dieses Feld wird im Build-Schritt als zusätzliches Angebotsfeld hinzugefügt. Wenn du eine Supplier SKU hast, fülle sie hier aus; andernfalls kannst du das Feld leer lassen.
Obelink hat mehrere Vertriebskanäle: obelink.nl, obelink.be und obelink.de. Sie unterstützen keine kanal-spezifischen Preise, daher werden das Kanal-Auswahl-Popup in den API-Einstellungen und der zusätzliche Tab im Build-Schritt nicht angezeigt. Kanäle müssen in deinem Mirakl-Backend aktiviert/deaktiviert werden. hier oder gehe zu Einstellungen > Partner > Kanäle
Attribute
Fülle die Felder im Schritt Attribute aus. Das ist wichtig beim Verkauf neuer Produkte, die noch nicht auf dem Marktplatz existieren — es hilft, den mirakl_unknown_error_code zu vermeiden. Wähle zuerst die Kategorie, die du optimieren möchtest.
Eine ausführlichere Erklärung, was im Attribute-Schritt zu tun ist, findest du hier: Marktplätze: Aufbau-Schritt
Sende deine Produkte an Obelink
Wenn du dein Projekt noch nicht aktiviert hast, gehe links zu Setup > Projekteinstellungen und klicke auf Projekt aktivieren. Gehe dann zurück zur API-Übersicht, öffne "Dein Obelink API-Name > Einstellungen" und aktiviere die API, indem du Aktiviere API auswählst. Danach geh zurück zur API-Übersicht und klicke auf den blauen "Aktualisieren"-Button, um deine Produktangebote an Obelink zu senden.
Prüfe deine Produkt-Listings auf Fehler
Nachdem du deine Produktangebote an Obelink gesendet hast, geh zum Reiter Ergebnisse deiner Obelink-API. Nutze den Filter auf 'error', um zu sehen, welche Produktangebote Fehler haben und nicht eingestellt wurden. Klicke auf einen spezifischen Fehler, um mehr Informationen zur Ursache zu erhalten. Wenn du Fehler durch Änderungen an Einstellungen oder Produktinformationen behebst, führe die Obelink-API erneut aus, um die aktualisierten Ergebnisse zu sehen. Das Anlegen neuer Produkte führt oft zu Fehlern im Reiter Ergebnisse, bis diese von Obelink genehmigt werden.
Best Practices
Mehrere Attributwerte hinzufügen: Wenn du bei Mirakl-Marktplätzen mehrere Werte in einem Attributfeld angibst, trenne jeden Wert mit einem senkrechten Strich "|", damit die Werte korrekt erkannt und verarbeitet werden.
Seller's Product ID für Einzel-/Simple-Produkte: Es gibt zwei Attribute namens SellerArticleId und SellerProductId. SellerProductId bezieht sich auf die Parent-ID, während SellerArticleId die Varianten-Artikel bezeichnet. Bei Einzelprodukten müssen beide Attribute mit demselben Wert gefüllt sein.
Für weitere Informationen zu Mirakl-Marktplatz-Fehlern, How-tos und Best Practices siehe den Mirakl-Guide: Mirakl Anleitung: Einstellungen und Lösungen
Zuletzt aktualisiert
War das hilfreich?