# Einrichten einer Obelink API 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. | | | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [![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) | ### 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: {% stepper %} {% step %} Unter **Statische Werte für Versandklasse** gibt es 3 Werte. In der Tabelle unten findest du diese Werte und ihre Erklärungen: | Code | Label | Erklärung | | ---- | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | 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 ](https://marketplace-obelink.mirakl.net/mmp/shop/account/channel)oder gehe zu Einstellungen > Partner > Kanäle {% endstep %} {% step %} ### 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: [marktplatze-schritt-erstellen](https://helpcenter.channable.com/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/erste-schritte-mit-marktplatzen/marktplatze-schritt-erstellen "mention") {% endstep %} {% endstepper %} ### 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 {% hint style="info" %} 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. {% endhint %} {% hint style="info" %} 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. {% endhint %} Für weitere Informationen zu Mirakl-Marktplatz-Fehlern, How-tos und Best Practices siehe den Mirakl-Guide: [mirakl-anleitung-einstellungen-und-losungen](https://helpcenter.channable.com/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/mirakl-marktplatze/mirakl-anleitung-einstellungen-und-losungen "mention") --- # Agent Instructions: 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: ``` GET https://helpcenter.channable.com/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/mirakl-marktplatze/einrichten-einer-obelink-api.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.