# So richtest du einen Hornbach-Kanal ein Hornbach ist eine deutsche Baumarktkette, die sich auf Heimwerken, Garten und DIY-Produkte spezialisiert hat. In diesem Artikel lernst du, wie du einen Hornbach-Kanal einrichtest, um deine Hornbach-Angebote in Channable zu erstellen, zu aktualisieren und zu verwalten. *** ### :memo-circle-check: **Bevor du startest** **Du brauchst** * [Ein Mirakl-Konto](https://www.miraklconnect.com/) * Eine Freigabe, um bei Hornbach zu listen\* * Ein Projekt in Channable mit deinen importierten Produkten * Produkte mit EAN-Codes **Gut zu wissen** * Aktuell unterstützt Hornbach Listings nur in **Deutschland**. * \*Das Hornbach-Partnerteam prüft alle Bewerbungen für Listings auf der Plattform. Du kannst eine Bewerbung über das [Marketplace Partner-Formular](https://forms.office.com/pages/responsepage.aspx?id=A5acU4BjPEKnDAGs1pyR1RoFDihP4cxKtIE31LhHMH9URUJFSTVPV0VKNEswQjVHN0lLVzdGME5QMy4u\&route=shorturl). * Hornbach nutzt die Mirakl-Plattform * Einige Attribute können Pflichtfelder sein, auch wenn sie für deine konkrete Situation nicht relevant erscheinen (z. B. ein Attribut für einen spanischen Titel, obwohl du nur in Deutschland verkaufst). Diese Attribute kannst du ungemappt lassen. ### **Schritt 1: Erstelle einen Hornbach-Kanal** 1. Gehe in Channable zu **Projekte > \[Dein Projekt] > Kanäle**. 2. Gib in die Suchleiste „Hornbach“ ein und wähle **Hornbach**. {% hint style="info" %} **Hinweis:** Wenn es nicht angezeigt wird, klicke auf **Löschen** um deine Filter zurückzusetzen. {% endhint %} 3. Lege deine Kanaleinstellungen fest: 1. Bei **Name**gib deinem Kanal einen Namen. 2. Bei **Eigene ID pro Item**wähle ein Feld mit den EAN-Codes deiner Produkte aus (z. B. `ean`, `id`) 3. Bei **Sprache**wähle die Sprache aus, in der deine Produktdaten vorliegen. 4. Bei **Masterregel-Gruppe nutzen**du kannst eine Regelgruppe festlegen, wenn du bereits eine hast, die du auf deinen Kanal anwenden möchtest. 5. Bei **Status**lass deine API vorerst deaktiviert. 4. Klicke auf **Speichern**. ### **Schritt 2: Erstelle Produktlistings** Folge diesen Unter-schritten, um deinen Kanal einzurichten. **Produkte kategorisieren** Richte deine Produktdaten ein, indem du deinen Produkten Kategorien zuweist. * **Intelligente Kategorisierung:** Ordnet Produktkategorien automatisch mit unserem Algorithmus zu. * **Manuelle Kategorisierung:** Weise Produktkategorien manuell mit benutzerdefinierten Regeln zu. Du kannst detaillierte Filter erstellen, um jedes Produkt der richtigen Kategorie zuzuordnen. * **Nicht kategorisierte Artikel:** Produkte, die noch geprüft und kategorisiert werden müssen. **Regeln einrichten** Regeln helfen dir, deine Produktdaten schnell für deinen Ziel-Marktplatz zu optimieren. * **Regelvorlagen:** Häufig verwendete Regeln, die du an deine Anforderungen anpassen und individualisieren kannst. * **Regeln einrichten:** Richte Regeln ein, um deine Produktdaten zu verfeinern. Mit Regeln kannst du Datenfelder filtern, anpassen und/oder ergänzen, damit sie den Marktplatzanforderungen entsprechen. **Erstelle deine Listings** Der **Build** Schritt ist der Bereich, in dem du deine Produktlistings so einrichtest, dass sie den Marktplatzanforderungen entsprechen. Das ist ein wichtiger Schritt, damit deine Produkte live gehen und Fehler vermieden werden. * **Pflichtfelder:** Erforderlich, um deine Produkte auf diesem Marktplatz zu listen * **Empfohlen:** Empfohlen, um Fehler zu vermeiden {% hint style="warning" %} **Wichtig:** Einige Attribute können Pflichtfelder sein, auch wenn sie für deine konkrete Situation nicht relevant erscheinen (z. B. ein Attribut für einen spanischen Titel, obwohl du nur in Deutschland verkaufst). Diese Attribute kannst du ungemappt lassen. {% endhint %} **Gemeinsame Attribute** Gemeinsame Attribute sind die Felder, die für alle deine Produkte gelten, wie EAN, Preise und Titel. Wenn du deine gemeinsamen Attribute zuordnest, stellst du einheitliche und konsistente Produktinformationen in deinen Listings sicher. Statische oder dynamische Werte verwenden: * **Statische Werte:** Feste Werte, die sich nicht ändern (z. B. Markenname, Hersteller). * **Dynamische Werte:** Felder, die sich automatisch auf Basis der verknüpften Daten aktualisieren (z. B. Bestand, Preise). **Kategoriespezifische Attribute** Kategoriespezifische Attribute sind Felder, die speziell für die Kategorien deiner Produkte gelten. Dieser Schritt hilft dir dabei, deine Listings fein abzustimmen, damit sie die Kategorieanforderungen des Marktplatzes erfüllen. Fülle Attribute aus, die für die ausgewählte Kategorie spezifisch sind (z. B. Größe bei Kleidung oder Maße bei Möbeln). {% hint style="success" %} **Tipp:** Klicke auf **Felder automatisch zuordnen** um automatisch Informationen aus deinen anderen Kanälen oder aus anderen ähnlichen Setups zuzuordnen.[ Mehr erfahren](https://channable-test.gitbook.io/channable-test-docs/list-advertise/list-on-marketplaces/auto-map-fields-for-marketplaces-apis). {% endhint %} **Best Practices für Mirakl-Marktplätze** Mehrere Attributwerte hinzufügen: Trenne mehrere Werte in einem Attribut mit dem Pipe-Zeichen „|“, damit sie korrekt erkannt und verarbeitet werden können. Seller's Product ID für einzelne/einfache Produkte: Es gibt zwei Attribute namens SellerArticleId und SellerProductId. SellerProductId ist die Parent-ID, während sich SellerArticleId auf Variantenartikel bezieht. Bei einzelnen Produkten müssen sowohl SellerArticleId als auch SellerProductId mit demselben Wert gefüllt sein. Weitere Informationen zu Mirakl-Marktplatzfehlern, Anleitungen und Best Practices findest du in[ unserem ausführlichen Leitfaden](https://helpcenter.channable.com/hc/en-us/articles/360012678720-Mirakl-guide-settings-and-solutions). #### **Prüfe die Qualität deines Setups** Der **Qualität** Der Schritt gibt dir Feedback zu deinem Kanal, bevor du ihn aktivierst. Er hebt Pflicht- und optionale Fehler hervor, damit deine Produktdaten die Anforderungen für Listings auf dem Marktplatz erfüllen. Behebe Fehler und priorisiere zuerst die Pflichtfehler. Aktionen: * **Artikel anzeigen:** Sieh dir Produkte mit bestimmten Problemen an. * **Im Aufbau-Schritt anzeigen:** Leitet dich zum **Build** Schritt weiter, damit du fehlende Informationen zuordnen kannst. * **Kategorien festlegen:** Leitet dich zum **Kategorien** Schritt weiter, um Artikel zu kategorisieren. * **Quelle anzeigen:** Für ID-Felder verfügbar. Leitet dich zum **Einstellungen** Schritt weiter. [Mehr über den Qualitätsschritt für Marktplätze erfahren](https://helpcenter.channable.com/hc/en-us/articles/19452435834642-Marketplaces-Quality-step) #### **Vor der Aktivierung Vorschau anzeigen** Der **Vorschau** Schritt zeigt dir die Attribute, die du im **Build** Schritt zugeordnet hast, und hilft dir zu prüfen, ob alles korrekt eingerichtet ist, indem er dir einen Überblick über deine Produkte und mögliche Fehler gibt. Filterung: * **Nach Fehler filtern:** Klicke auf das **Alle** Dropdown und wähle aus, ob nur Produkte mit Fehlern oder Produkte mit einem bestimmten Fehler angezeigt werden sollen. * **Nach Kategorie filtern:** Klicke auf das **All categories** Dropdown und wähle die Kategorie aus, nach der du filtern möchtest. [Mehr über den Vorschau-Schritt für Marktplätze erfahren](https://helpcenter.channable.com/hc/en-us/articles/19452509593746-API-s-Preview-step) **Bevor du fortfährst:** * **Gemeinsame Attribute prüfen:** Stelle sicher, dass alle Pflichtattribute ausgefüllt sind. * **Kategoriespezifische Attribute prüfen:** Stelle sicher, dass alle Pflichtattribute für die Kategorie ausgefüllt sind. * **Auf Fehler prüfen:** Korrigiere alle rot markierten Felder. \ ### **Zusätzliche Anforderungen für Hornbach** **GPSR- und DSA-Anforderungen erfüllen** Die Europäische Union (EU) hat neue[ GPSR- und DSA-Anforderungen](https://helpcenter.channable.com/hc/en-us/articles/22175644897042) für Online-Plattformen eingeführt, darunter auch Hornbach. Um diese Anforderungen zu erfüllen, musst du Informationen für mindestens die Attribute **Hersteller** und **Wirtschaftsbeteiligter** bereitstellen, die im Abschnitt **Allgemeine Produktsicherheitsinformationen** im **Build** Schritt weiter. \ ### **Schritt 3: Mit Hornbach über Mirakl verbinden** Um deine Listings an Hornbach zu senden, musst du deinen Kanal mit deinem Mirakl-Connect-Konto verbinden. **Wichtig:** Durch das Verknüpfen deines Kontos ändert sich nichts – vorhandene Listings bleiben genau so, wie sie sind, bis du aktivierst. 1. Melde dich in deinem Mirakl-Connect-Konto an. 2. In **\[deinem Hornbach-Kanal]**gehe zu **Einstellungen**. 3. Bei **Verknüpfte Verbindung**klicke auf **Verkäuferkonto auswählen**. 4. Wähle ein vorhandenes Verkäuferkonto aus oder klicke auf **+ Neue Verbindung hinzufügen** um ein neues Verkäuferkonto hinzuzufügen. 1. Wenn du ein neues Verkäuferkonto hinzufügst: 1. Bei **Label**: Benenne deine Verkäuferkonto-Verbindung. Das wird nur verwendet, um deine Verbindung innerhalb von Channable zu identifizieren. 2. Klicke auf **Mit Hornbach verbinden**. Du wirst zu Mirakl weitergeleitet, um dich in deinem Konto anzumelden. Das dient der Authentifizierung deiner Verbindung, damit Channable Produkte für dich listen kann. Nachdem du dich erfolgreich angemeldet hast, ist deine Verbindung bereit, und du wirst zurück zu deinem Kanal geleitet. ### **Schritt 4: Aktiviere deinen Kanal** Sobald deine Produktlistings fertig sind, kannst du sie an Hornbach senden: 1. Wähle den **Einstellungen** Schritt in **\[deinem Hornbach-Kanal]** aus und klicke auf **Aktiviere API**. 2. Klicke auf **Speichern**. 3. Klicke auf **Aktualisieren** um deine Produktlistings an Hornbach zu senden. ### **Schritt 5: Listings-Fehler prüfen und beheben** Gehe zum **Resultat** Schritt und klicke auf den Tab **Feedback** Diese Seite zeigt alle möglichen Verarbeitungsfehler an, die deine Produktdaten in diesem Moment haben. #### **Fehler beheben:** 1. In **Beschreibung**klicke auf den Fehlernamen. Du wirst dann zu einer Übersicht der Produkte mit diesem Fehler weitergeleitet. 2. In **ID**klicke auf die ID-Nummer und scrolle. Du solltest einen rot hervorgehobenen Hinweis in dem Abschnitt sehen, in dem der Fehler aufgetreten ist. Fahre mit der Maus über den Hinweis, um mehr Informationen zu erhalten. 1. Wenn es sich um einen Mapping-Fehler handelt, klicke auf **Im Aufbau-Schritt anzeigen** um zu dem Attribut zu gelangen, das du zuordnen oder neu zuordnen musst. Es ist blau hervorgehoben. 2. Für weitere Informationen über das Attribut und die erlaubten Werte fahre mit der Maus über . 3. Behebe den Fehler. #### **Häufige Fehler und Lösungen** #### **mirakl\_unknown\_error\_code** Dieser Fehler bezeichnet eine Fehlergruppe, die typischerweise auftritt, wenn Mirakl die EAN eines Produkts in der Mirakl-Datenbank nicht identifizieren kann. Das bedeutet, dass das Produkt entweder neu für Mirakl ist oder Attribute fehlen, damit es als Produkt erkannt werden kann. **Lösung**: 1. **Prüfe deine Kategorien:** Im **Kategorien** Schritt prüfst du, ob deine Produktkategorien korrekt zugeordnet sind. Wenn nicht, nimm dir einen Moment Zeit, um sie korrekt zuzuordnen. Detaillierte Anweisungen zu diesem Prozess findest du in[ unserem Artikel zum Zuordnen von Kategorien](https://helpcenter.channable.com/hc/en-us/articles/360020365580-What-are-categories-in-Channable). 2. **Prüfe dein Mapping:** Im **Build** Schritt prüfst du deine zugeordneten Felder und korrigierst alles, was falsch zugeordnet aussieht. Du kannst Regeln verwenden, um neue Felder zu erstellen und zu befüllen. Sobald du sowohl deine Kategorien als auch die zugeordneten Attribute geprüft hast, klicke auf **Aktualisieren** um deinen Kanal erneut auszuführen.