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

Auf einen Blick

• ✓Voelkner läuft über JTL SCX (Nachfolger der ninepoint-Anbindung) auf Basis der Mirakl-Plattform. Eingerichtet wird über eazyAuction, dafür braucht es eine SCX-Lizenz im JTL-Kundencenter.
• ✓Die drei häufigsten Fehler: Rendering-Fehler bei Attributen wenn GPSR-DotLiquid-Felder fehlen, fehlendes Pflichtattribut „ATT.Text.ProductTextLong“ (Werbetext aus Wawi-Langbeschreibung) und falsches Format der Versandlager-Adresse (seit April 2025 strukturierte Felder statt Freitext).
• ✓Vlarom-Erkenntnis: Das EAN-Matching bei Voelkner spart richtig Mapping-Aufwand, wenn die EANs in der Wawi sauber gepflegt sind. Bei lückenhaften EAN-Daten wird daraus schnell eine Fehlerquelle.

Wir sind JTL Service Partner Gold mit Sitz in Ahrensfelde bei Berlin und begleiten Händler beim Aufbau ihrer Marktplatz-Anbindungen via JTL SCX. Alexander Luft und das Vlarom-Team betreuen über 300 aktive JTL-Kunden — darunter zahlreiche Projekte mit Mirakl-basierten Kanälen wie Voelkner, Conrad und MediaMarktSaturn. Voelkner ist einer der technisch trickreichsten SCX-Kanäle. Nicht wegen der Verbindung selbst, sondern wegen der Attribut-Struktur und der Pflichtfelder, die so bei anderen Plattformen nicht existieren. Fehler zeigen sich oft erst beim zweiten oder dritten Abgleich.

Voelkner ist als Elektronik- und Technik-Marktplatz bekannt. Seit dem Ende der ninepoint-Infrastruktur läuft die Anbindung komplett über JTL SCX. Technisch sitzt die Plattform auf Mirakl auf, dem gleichen System wie Conrad und MediaMarktSaturn. Das bedeutet: ähnliche Fehlerbilder, ähnliche Anforderungen, ähnliche Lösungswege. Wer einen Mirakl-Kanal kennt, hat beim nächsten einen erheblichen Vorsprung. Offizielle Dokumentation: Voelkner auf guide.jtl-software.com.

Aus unserer Projektpraxis mit über 300 JTL-Kunden: Bei Voelkner scheitert eine Anbindung fast nie an der Verbindung selbst. Der Fehler steckt meistens im Attribut-Mapping. Werbetext nicht gemappt, GPSR-Felder leer, Versandlager-Adresse noch im alten Freitext-Format. Wer das vor dem ersten Abgleich prüft, spart sich Tage Fehlersuche.

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

• →JTL SCX — Lizenz im Kundencenter erforderlich: Voelkner läuft über JTL SCX. Die Lizenz wird im JTL-Kundencenter aktiviert, nicht als eazyAuction-Plugin. Sobald sie aktiv ist, taucht der Kanal in eazyAuction auf. Ohne aktive SCX-Lizenz keine Anbindung.
• →EAN-Matching reduziert Mapping-Aufwand: Voelkner bietet ein EAN-Matching: Artikel werden automatisch mit bestehenden Voelkner-Produktdaten verknüpft, sobald die EAN passt. Das spart eine Menge Mapping-Arbeit. Voraussetzung: EAN in der JTL-Wawi vollständig und eindeutig gepflegt. Anleitung: [EAN-Matching bei Voelkner](https://guide.jtl-software.com/jtl-eazyauction/auf-weiteren-marktplaetzen-verkaufen/ean-matching-beim-marktplatz-voelkner/).
• →Pflichtfeld voelknerProduktnummer: Voelkner verlangt ein eigenes Pflichtfeld ‚voelknerProduktnummer‘ für jeden Artikel. Das Feld steckt nicht in den Standard-Pflichtfeldern anderer Mirakl-Plattformen und wird gerne übersehen. Aus unserer Praxis: Dieses Feld ist in etwa einem Drittel der erstmaligen Voelkner-Einrichtungen die Ursache für abgelehnte Angebote.
• →Mirakl-Basis — gleiche Fehler wie Conrad und MMS: Weil Voelkner auf Mirakl läuft, gelten die gleichen Anforderungen wie bei Conrad und MediaMarktSaturn: strukturierte Produktdaten, EAN-basierte Zuordnung, GPSR-Compliance. Fehler die bei einem Mirakl-Kanal auftreten, sehen beim nächsten oft identisch aus.

Eine Besonderheit bei Voelkner: Das EAN-Matching ist einer der wenigen Mechanismen im JTL-Marktplatz-Ökosystem, der echte Zeitersparnis beim Einrichten bringt. Vorausgesetzt die Stammdaten passen. Bei Sortimenten mit lückenhaften EANs kippt der Vorteil und wird zur Fehlerquelle.

Diese Fehler tauchen im JTL-Forum und in unseren Kundenprojekten immer wieder auf. Wir haben Ursachen und Lösungswege zusammengefasst. Alle drei Fehlerbilder sind dokumentiert — mit Ticket-Nummern aus dem offiziellen JTL-Issue-Tracker.

1

‚Fehler beim Rendering der Attribute‘ — Index-Out-of-Bounds

Symptom: Beim Voelkner-SCX-Abgleich kommt die Meldung ‚Fehler beim Rendering der Attribute — Der Index lag außerhalb des Bereichs‘. Tritt auf, wenn GPSR-DotLiquid-Felder vorhanden sind, aber Pflichtattribute fehlen oder leer bleiben.

Ursache: Die GPSR-bezogenen DotLiquid-Felder werden nicht sauber verarbeitet, sobald Pflichtattribute nicht vollständig gefüllt sind. Lösung: GPSR-DotLiquid-Verknüpfungen für Voelkner in der Verkaufskanalverwaltung prüfen. Alle Pflichtattribute befüllen, vor allem den langen Werbetext (ATT.Text.ProductTextLong). Quellen: JTL-Forum Thread 233743 (Rendering-Fehler bei unvollständigen GPSR-Feldern) und Thread 217195 (Index-Out-of-Bounds bei SCX-Abgleich).

2

TRANSFORMATION_ERROR — Werbetext-Pflichtattribut fehlt

Symptom: Voelkner lehnt Angebote ab mit der Meldung ‚TRANSFORMATION_ERROR: The attribute ATT.Text.ProductTextLong (Werbetext) is required‘. Artikel werden nicht übertragen.

Ursache: Voelkner verlangt einen langen Werbetext als Pflichtattribut. Der kommt aus dem Wawi-Feld ‚Langbeschreibung‘ und muss per DotLiquid-Variable auf das Voelkner-Attribut gemappt werden. Lösung: In der JTL-Wawi für alle relevanten Artikel die Langbeschreibung pflegen. Im Verkaufskanal Voelkner unter Globale Felder > Werbetext die DotLiquid-Variable auf das Langbeschreibungs-Feld zeigen lassen. Dokumentiert in JTL-Wawi Ticket WAWI-73068 (Pflichtattribut ATT.Text.ProductTextLong nicht übertragen).

EAN-Matching spart Einrichtungsaufwand

Das EAN-Matching bei Voelkner ist einer der praktischsten Mechanismen im SCX-Ökosystem. Sobald die EANs vollständig gepflegt sind, verknüpft Voelkner Artikel automatisch mit den bestehenden Produktdaten. Wer Elektronik oder Technik-Zubehör vertreibt und saubere EAN-Daten hat, profitiert davon sofort.

Gleiche Basis wie Conrad — Wissen ist übertragbar

Voelkner und Conrad sitzen auf derselben Mirakl-Basis. Wer Voelkner eingerichtet hat, kann das Wissen direkt für Conrad nutzen. Attribut-Mapping, GPSR-Konfiguration und Versandlager-Einstellungen lassen sich übernehmen. Im JTL-Forum berichten Händler regelmäßig, dass die Conrad-Einrichtung nach Voelkner spürbar schneller geht.

So gehen wir die Voelkner-Anbindung in unseren Kundenprojekten an. Kein vollständiges Tutorial, sondern eine Übersicht der Phasen und worauf es jeweils ankommt.

„Im JTL-Kundencenter die SCX-Lizenz für Voelkner aktivieren. Ohne aktive Lizenz erscheint der Kanal nicht in eazyAuction. eazyAuction in einer aktuellen Version sicherstellen — ältere Versionen kennen das neue Versandlager-Adressformat (ab April 2025) noch nicht.“

„EANs für alle relevanten Artikel prüfen und vervollständigen. Langbeschreibung (Werbetext) in den Wawi-Artikelstammdaten pflegen — sie wird als Pflichtattribut ATT.Text.ProductTextLong an Voelkner übertragen. GPSR-Daten für alle Pflichtartikel sauber hinterlegen. voelknerProduktnummer als eigenes Pflichtfeld einplanen.“

„Verkaufskanal Voelkner in eazyAuction anlegen. Versandlager-Adresse in den strukturierten Feldern eintragen (Straße, Hausnummer, PLZ, Ort separat). Globale Felder > Werbetext: DotLiquid-Variable auf die Langbeschreibung mappen. EAN-Matching aktivieren. Offizielle Dokumentation: Voelkner auf guide.jtl-software.com.“

„Ersten Abgleich mit 5 bis 10 Artikeln testen, bevor das ganze Sortiment rübergeht. SCX-Protokoll im JTL-Kundencenter prüfen, nicht nur das lokale Log. Rendering-Fehler und TRANSFORMATION_ERROR direkt auflösen, bevor weitere Artikel folgen.“

„eazyAuction-Updates zeitnah einspielen — Mirakl bringt regelmäßig Plattformänderungen mit. EAN-Matching bei neu eingestellten Artikeln kontrollieren. Bei Abgleichfehlern: zuerst das Attribut-Mapping prüfen, dann das SCX-Protokoll.“