JTL Hornbach anbinden: Einrichtung via JTL SCX und die häufigsten Fehler mit Lösung

Auf einen Blick

• ✓HORNBACH läuft via JTL SCX — seit April 2026 auf JTL-eigener Infrastruktur, kein externes Plugin mehr nötig. Die SCX-Subscription sollte vor dem Einrichtungsstart im JTL-Kundencenter gebucht sein.
• ✓Die häufigste Fehlerquelle ist die Credential-Beschaffung: Händler-ID und Token kommen aus dem HORNBACH-Verkäuferbereich, die Subscription aus dem JTL-Kundencenter, die Content-Richtlinien aus der Kick-off-E-Mail von HORNBACH. Alle drei Quellen sind Pflicht. Vlarom geht diesen Schritt gezielt durch, damit der erste Abgleich sitzt.
• ✓Nach dem Wawi-Update 1.9.6.1 bricht der HORNBACH-Abgleich mit GEN401 ab — gleichzeitig auch OBI und weitere SCX-Kanäle. Kein Workaround durch den Händler möglich. Vlarom erstellt in diesem Fall das JTL-Support-Ticket und überwacht den Fix.

Vlarom ist JTL Service Partner Gold (Quelle: JTL-Software Partnerverzeichnis) mit Sitz in Ahrensfelde bei Berlin. Wir richten JTL SCX-Kanäle für Händler ein — von der Credential-Beschaffung über das Attribut-Mapping bis zum ersten fehlerfreien Abgleich. HORNBACH ist einer der neueren SCX-Kanäle. Die Community-Erfahrung ist noch dünn, bekannte Fehlermuster sind aber bereits dokumentiert. Wer jetzt einrichtet, profitiert davon, dass die SCX-Infrastruktur seit April 2026 stabil läuft.

HORNBACH betreibt seit einigen Jahren einen eigenen Online-Marktplatz für den D-A-CH-Markt. Die Anbindung über JTL läuft heute vollständig über JTL SCX — die JTL-eigene Marktplatz-Infrastruktur, die zum 1. April 2026 das frühere ninepoint-Plugin abgelöst hat. Wer jetzt einrichtet, arbeitet direkt mit JTL-Technologie, ohne Abhängigkeit von einem Dritt-Anbieter. Die offizielle Extension findest du im JTL Extension Store.

Aus unserer Projektpraxis: Händler, die OBI bereits über JTL SCX angebunden haben, erkennen die HORNBACH-Einrichtung sofort wieder. Zielgruppe, Attributstruktur und Prozesslogik sind nahezu identisch. Was bei OBI läuft, lässt sich direkt übertragen.

Die wichtigsten technischen Grundlagen für die HORNBACH-Anbindung:

• →JTL SCX als Anbindungsweg — ab 19 EUR/Monat: Die Anbindung läuft über JTL SCX, ab 19,00 EUR/Monat (zzgl. MwSt.). Die Subscription wird im JTL-Kundencenter gebucht. Seit April 2026 läuft HORNBACH auf JTL-eigener Infrastruktur — das ninepoint-Plugin ist abgelöst.
• →Mindestanforderung: JTL-Wawi 1.8.3+ mit eazyAuction: Für die HORNBACH-Anbindung brauchst du JTL-Wawi 1.8.3 oder höher und die JTL Start-Edition mit eazyAuction-Plan. Wer noch eine ältere Wawi-Version fährt, muss vorher aktualisieren.
• →Zulassung durch HORNBACH erforderlich: Händler müssen von HORNBACH als Marktplatz-Partner zugelassen werden. Nach der Genehmigung schickt HORNBACH eine Kick-off-E-Mail mit Zugangsdaten und kategoriespezifischen Content-Richtlinien. Ohne diese E-Mail fehlt ein Teil der Credentials.
• →Drei Credential-Quellen für die Einrichtung: Die Einrichtung braucht Daten aus drei Quellen: Händler-ID und Token aus dem HORNBACH-Verkäuferbereich, die SCX-Subscription aus dem JTL-Kundencenter und die Content-Richtlinien aus der HORNBACH-Kick-off-E-Mail. Das ist der häufigste Stolperstein beim Onboarding.

HORNBACH lohnt sich vor allem für Händler, die im D-A-CH-Markt Baumarkt- und Heimwerken-Sortiment verkaufen und ihre Reichweite ausbauen wollen. Die technische Basis über JTL SCX ist die gleiche wie bei OBI. Wer einen der beiden Kanäle kennt, findet sich beim anderen sofort zurecht. Offizielle Marktplatz-Übersicht: eazyAuction Marktplatzübersicht auf guide.jtl-software.com.

Diese Fehlerbilder tauchen bei HORNBACH-Anbindungen immer wieder auf und sind im JTL-Forum dokumentiert.

1

Credential-Beschaffung unklar — drei Quellen, ein Ablauf

Symptom: Der Händler hat die HORNBACH-Zulassung, weiß aber nicht, woher Händler-ID, Token und Subscription kommen. HORNBACH verweist an JTL, JTL verweist zurück. Die Einrichtung kommt nicht voran.

Ursache und Lösung: Die Einrichtung braucht Daten aus drei getrennten Quellen. Händler-ID und Token kommen aus dem HORNBACH-Verkäuferbereich: Profil-Symbol > Einstellungen > API. Die SCX-Subscription wird separat im JTL-Kundencenter gebucht. Die kategoriespezifischen Content-Richtlinien und alle weiteren Zugangsdaten stehen in der Kick-off-E-Mail, die HORNBACH nach Genehmigung verschickt. Auf diese E-Mail warten und erst dann mit der Einrichtung starten. (Quelle: forum.jtl-software.de Thread 231913)

2

GEN401 nach Wawi-Update — HORNBACH und OBI gleichzeitig betroffen

Symptom: Nach einem Update auf JTL-Wawi 1.9.6.1 bricht der HORNBACH-Abgleich mit der Meldung ‚GEN401 — Nicht autorisiert‘ ab. Gleichzeitig trifft es OBI, CDiscount und Praktiker. Amazon, eBay und der JTL-Shop laufen weiter.

Ursache und Lösung: Serverseitiger Fehler in JTL-Wawi 1.9.6.1, der mehrere SCX-Kanäle gleichzeitig trifft. Kein Workaround durch den Händler möglich. Lösung: JTL-Support-Ticket erstellen und auf den serverseitigen Fix warten. Amazon und eBay bleiben außen vor, weil sie über eine andere API-Schicht laufen. (Quelle: forum.jtl-software.de Thread 227812)

Stabile Anbindung seit Dez. 2024 — wenn alle Credentials stimmen

Händler, die alle drei Credential-Quellen sauber eingetragen haben, berichten von stabilem Betrieb seit Ende 2024. Die Anbindung läuft durch, Bestandsabgleiche kommen an, Preise werden übertragen. Der häufigste Grund für Instabilität ist eine fehlerhafte oder unvollständige Credentials-Konfiguration — nicht JTL SCX selbst.

OBI-Wissen direkt übertragbar — gleiche Zielgruppe, gleiche Technik

Wer OBI bereits über JTL SCX angebunden hat, kennt die Logik: Attributstruktur, Abgleich-Intervalle, SCX-Protokoll-Monitoring. Das lässt sich direkt auf HORNBACH übertragen. Beide Kanäle zielen auf Baumarkt- und Heimwerken-Sortimente, die Content-Anforderungen sind ähnlich. Ein Händler im JTL-Forum: ‚Die HORNBACH-Einrichtung lief deutlich reibungsloser als erwartet, weil wir den OBI-Prozess bereits kannten.‘

So gehen wir die HORNBACH-Anbindung in Kundenprojekten an.

„JTL-Wawi 1.8.3 oder höher. JTL Start-Edition mit eazyAuction-Plan. HORNBACH-Händlerkonto vorhanden und genehmigt. SCX-Subscription für HORNBACH im JTL-Kundencenter gebucht. Kick-off-E-Mail von HORNBACH erhalten und bereitgelegt.“

„Händler-ID und Token aus dem HORNBACH-Verkäuferbereich: Profil-Symbol > Einstellungen > API. SCX-Subscription-Daten aus dem JTL-Kundencenter. Kategoriespezifische Content-Richtlinien aus der HORNBACH-Kick-off-E-Mail. Erst wenn alle drei Quellen vorliegen, mit der eazyAuction-Einrichtung starten.“

„Verkaufskanal HORNBACH in eazyAuction anlegen. Alle drei Credential-Sets eintragen. Kanaleinstellungen prüfen: Bestandsabgleich und Preisabgleich aktiv setzen. Erste Test-Synchronisation mit einem kleinen Artikel-Set. Offizielle Übersicht: eazyAuction Marktplatzübersicht auf guide.jtl-software.com.“

„Ersten Abgleich mit 5 bis 10 Artikeln testen. SCX-Protokoll auf Fehler prüfen. Preise und Bestandsdaten auf der HORNBACH-Seite kontrollieren. Worker-Status beobachten. Erst nach sauberem Pilot das gesamte Sortiment freigeben.“

„JTL SCX-Updates zeitnah einspielen — die JTL-eigene Infrastruktur bekommt Updates und Fixes automatisch. Bei GEN401-Fehlern nach Wawi-Updates sofort JTL-Support-Ticket erstellen. WebView2 Runtime bei Windows-Updates im Blick behalten. Bei ausbleibenden Bestandsupdates: Worker neu starten und SCX-Protokoll prüfen.“