JTL-Connector: Echtzeit-Synchronisation für Ihren E-Commerce

Die Einrichtung beginnt mit der Installation des Connectors als PHP-Anwendung auf Ihrem Server oder als Docker-Container. Anschließend tragen Sie im JTL-Wawi-Adminbereich die Zugangsdaten Ihres Shopsystems ein, für Shopify benötigen Sie den API-Key, für Shopware 6 den API-Zugang mit Admin-Rechten. Nach der Verbindung führen Sie einen initialen Datenabgleich durch, der je nach Artikelanzahl zwischen 30 Minuten und 2 Stunden dauert. Dabei werden Stammdaten wie Artikel, Kategorien und Kunden synchronisiert. Für Shopify empfehlen wir, vorab Collections und Metafelder im Shop zu definieren, um eine reibungslose Datenübertragung zu gewährleisten.

Der JTL-Connector überträgt standardmäßig folgende Daten bidirektional:

• Artikelstammdaten (Titel, Beschreibung, Bilder, Attribute)
• Lagerbestände und Preise
• Kundendaten (Adressen, Kundengruppen)
• Bestellungen und Bestellstatus
• Kategorien und SEO-Metadaten

Je nach Shopsystem können zusätzliche Felder wie Varianten, Rabatte oder Versandregeln synchronisiert werden. Bei Shopware 6 lassen sich beispielsweise auch dynamische Produktgruppen übertragen, während WooCommerce individuelle Produktattribute unterstützt.

Die Synchronisationsintervalle sind abhängig vom Shopsystem und der Connector-Konfiguration. Bei Shopware 6 und WooCommerce sind Intervalle von 30 Sekunden bis 5 Minuten üblich. In JTL-Wawi können Sie die Intervalle für verschiedene Datentypen separat einstellen:

• Bestände: alle 1–2 Minuten
• Preise: alle 5–10 Minuten
• Bestellungen: sofort bei Eingang

Für besonders zeitkritische Anwendungen (z. B. bei geringen Lagerbeständen) lässt sich das Intervall auf wenige Sekunden reduzieren. Beachten Sie jedoch, dass zu häufige Synchronisationen die Serverlast erhöhen können.

Professionelle JTL-Connector-Lösungen protokollieren alle Synchronisationsvorgänge und Fehler automatisch. Bei Fehlern erhalten Sie eine Benachrichtigung mit folgenden Informationen:

• Betroffener Datensatz (z. B. Artikelnummer, Bestell-ID)
• Fehlertyp (z. B. „Pflichtfeld fehlt“, „API-Timeout“)
• Zeitstempel des Fehlers

Die meisten Fehler lassen sich durch folgende Maßnahmen beheben:

• Manuelle Nachbearbeitung des fehlerhaften Datensatzes
• Anpassung der Feldzuordnungen zwischen JTL-Wawi und Shop
• Erweiterung der Server-Ressourcen bei Performance-Problemen
• Korrektur von Dateninkonsistenzen (z. B. doppelte EANs)

Zertifizierte JTL-Partner wie SmartSolution-4u bieten einen 24/7-Monitoring-Service, der Fehler automatisch erkennt und behebt, bevor sie sich auf Ihren Shop auswirken.

Ja, der JTL-Connector ist für Multi-Channel-Setups ausgelegt. Sie können mehrere Shopsysteme und Marktplätze an eine zentrale JTL-Wawi-Instanz anbinden. Typische Anwendungsfälle sind:

• Hauptshop (Shopware) + Amazon + eBay
• Shopify-Shop + WooCommerce-Blogshop
• PrestaShop + stationärer POS

Dabei steuert JTL-Wawi die Bestände kanalübergreifend, um Überverkäufe zu vermeiden. Preisänderungen werden an alle Kanäle weitergegeben, während Bestellungen aus allen Quellen in JTL-Wawi zusammenlaufen. Für Marktplätze wie Amazon oder eBay sind zusätzliche Plugins erforderlich, die die spezifischen API-Anforderungen dieser Plattformen unterstützen.

Der JTL-Connector verwendet verschlüsselte HTTPS-Verbindungen für die Datenübertragung. Zusätzlich gelten folgende Sicherheitsmaßnahmen:

• API-Zugänge mit begrenzten Rechten (nur notwendige Berechtigungen)
• Regelmäßige Sicherheitsupdates für den Connector
• DSGVO-konforme Datenverarbeitung (EU-Server-Standorte)
• Automatische Protokollierung aller Zugriffe

Für besonders sensible Daten (z. B. Kundendaten) können zusätzliche Verschlüsselungsmethoden implementiert werden. Zertifizierte JTL-Partner führen vor der Einrichtung eine Sicherheitsprüfung durch und empfehlen Maßnahmen zur Risikominimierung.

Ja, der JTL-Connector ist modular aufgebaut und lässt sich durch folgende Anpassungen erweitern:

• Individuelle Feldzuordnungen (z. B. für spezielle Produktattribute)
• Erweiterte Synchronisationslogik (z. B. für Staffelpreise oder Rabattaktionen)
• Anbindung zusätzlicher Systeme (z. B. ERP, PIM, Versanddienstleister)
• Automatisierte Workflows (z. B. Bestellbestätigungen, Retourenmanagement)

Für komplexe Anforderungen bietet JTL eine Entwickler-Dokumentation, die die Erstellung eigener Plugins ermöglicht. Zertifizierte Partner wie SmartSolution-4u entwickeln individuelle Lösungen, die exakt auf Ihre Geschäftsprozesse zugeschnitten sind, etwa für spezielle Branchenlösungen oder internationale Steuerregelungen.

Die Mindestanforderungen für den JTL-Connector sind:

• JTL-Wawi Version 1.9 oder neuer
• PHP 8.0 oder neuer (für den Connector-Server)
• MySQL 5.7 oder MariaDB 10.3
• Mindestens 4 GB RAM für den Connector-Server
• HTTPS-Zugang zum Shopsystem

Für Shopsysteme gelten folgende Voraussetzungen:

• Shopware 6: Version 6.4 oder neuer
• WooCommerce: Version 5.0 oder neuer
• Shopify: Aktuelle API-Version
• PrestaShop: Version 1.7.8 oder neuer

Bei Multi-Channel-Setups oder großen Artikelbeständen (> 50.000 Artikel) empfehlen wir dedizierte Server-Ressourcen, um Performance-Probleme zu vermeiden. Vor der Installation sollte eine Kompatibilitätsprüfung durchgeführt werden, die wir als zertifizierter Partner kostenlos anbieten.

Die Kosten für den JTL-Connector setzen sich aus folgenden Komponenten zusammen:

• Lizenzkosten: Einmalige Gebühr für die Connector-Software (ab 500 €, abhängig vom Shopsystem)
• Einrichtung: Kosten für Installation und Konfiguration (ab 1.500 €, abhängig von Komplexität)
• Support: Monatliche Gebühren für Wartung und Updates (ab 50 €/Monat)
• Anpassungen: Kosten für individuelle Erweiterungen (auf Anfrage)

Typische Preismodelle sind:

• Einmalige Lizenz + jährliche Wartungsgebühr (z. B. 20 % der Lizenzkosten)
• Monatliches Mietmodell (inkl. Updates und Support)
• Festpreis-Pakete für Standard-Installationen

Für Multi-Channel-Setups oder komplexe Anforderungen erstellen wir individuelle Angebote. Viele Händler amortisieren die Investition innerhalb von 6–12 Monaten durch die eingesparten Personalkosten für manuelle Datenpflege.

Die Einrichtung des JTL-Connectors dauert je nach Komplexität zwischen 2 Tagen und 4 Wochen:

• Standard-Installation: 2–5 Tage (für Shopware 6 oder WooCommerce mit < 10.000 Artikeln)
• Erweiterte Installation: 1–2 Wochen (für Multi-Channel-Setups oder > 50.000 Artikel)
• Individuelle Anpassungen: 2–4 Wochen (für komplexe Feldzuordnungen oder Workflows)

Der Prozess umfasst folgende Schritte:

1. Analyse der bestehenden Infrastruktur (1–2 Tage)
2. Installation und Grundkonfiguration (1–3 Tage)
3. Datenmigration und initialer Abgleich (1–5 Tage, abhängig von Artikelanzahl)
4. Testphase und Fehlerbehebung (3–10 Tage)
5. Schulung der Mitarbeiter (1 Tag)

Für dringende Projekte bieten wir Express-Installationen innerhalb von 48 Stunden an. Dabei werden zunächst nur die kritischsten Daten (Bestände, Preise, Bestellungen) synchronisiert, während weniger zeitkritische Daten (z. B. SEO-Metadaten) nachgeliefert werden.

Neben dem JTL-Connector gibt es folgende Alternativen für die Anbindung von Shopsystemen an JTL-Wawi:

• Native Plugins: Viele Shopsysteme bieten eigene JTL-Integrationen an (z. B. Shopware JTL-Plugin, WooCommerce JTL-Connector). Diese sind oft günstiger, aber weniger flexibel als der offizielle JTL-Connector.
• Middleware-Lösungen: Tools wie Make (ehemals Integromat) oder Zapier ermöglichen die Verbindung von JTL-Wawi mit Shopsystemen über vorgefertigte Workflows. Diese eignen sich für einfache Anwendungsfälle, stoßen aber bei komplexen Datenstrukturen an Grenzen.
• Custom-API-Integrationen: Individuelle Lösungen, die exakt auf Ihre Anforderungen zugeschnitten sind. Diese sind teurer in der Entwicklung, bieten aber maximale Flexibilität, etwa für spezielle Branchenlösungen oder internationale Steuerregelungen.
• ERP-Schnittstellen: Einige ERP-Systeme (z. B. Odoo, SAP) bieten eigene JTL-Integrationen an. Diese sind sinnvoll, wenn JTL-Wawi nicht als führendes System genutzt wird.

Der JTL-Connector bleibt jedoch die empfohlene Lösung für Händler, die JTL-Wawi als zentrales ERP nutzen. Er bietet die beste Kompatibilität, regelmäßige Updates und den Support durch zertifizierte Partner wie SmartSolution-4u.

Ein „X-CSRF-Token“-Fehler tritt bei Shopware 6 auf, wenn die Session abgelaufen ist, löschen Sie den Browser-Cache und erneuern Sie die Verbindung. Bei „Invalid Shopify connection credentials“ prüfen Sie, ob der API-Key noch gültig ist und ob die erforderlichen Berechtigungen (read_products, write_orders) gesetzt sind. 500er-Fehler entstehen oft durch PHP-Zeitlimits, erhöhen Sie die max_execution_time in der php.ini auf mindestens wenigen Sekunden. Für Shopify-spezifische Fehler wie „Collection not found“ überprüfen Sie, ob die Collection-ID im Shop existiert und ob der Connector die richtige API-Version (aktuell 2024-04) verwendet.

JTL-Wawi ist das führende System, alle Stammdaten wie Artikelnummern, Preise und Lagerbestände werden von dort an den Shop übertragen. Bestellungen fließen hingegen vom Shop in die Wawi, wo sie weiterverarbeitet werden. Der Abgleich erfolgt bidirektional, aber mit Prioritäten: Preisänderungen in der Wawi überschreiben Shop-Preise, während Kundenadressen aus dem Shop nur bei Neuanlage übernommen werden. Metafelder werden nur bei der Erstanlage synchronisiert, spätere Änderungen müssen manuell nachgezogen werden. Für Shopify gilt: Collections werden als Kategorien behandelt, während Shopware 6 mit nativen Kategorien arbeitet.

Zertifizierte JTL-Servicepartner wie SmartSolution-4u bieten direkten Support mit Reaktionszeiten von unter wenigen Stunden für kritische Fehler. Über das JTL-Kundencenter können Sie Tickets erstellen, halten Sie dabei Ihre Connector-Version (z.B. 1.9.4.1) und die genaue Fehlermeldung bereit. Für Shopify-spezifische Probleme benötigen Sie zusätzlich die Shop-ID und die API-Version. Bei komplexen Synchronisationsfehlern hilft ein Log-Export, den Sie über die Connector-Oberfläche generieren können. Beachten Sie, dass Support für ältere Versionen (vor 1.8) nur eingeschränkt verfügbar ist.

Ein Reset löscht alle Synchronisationsdaten zwischen Wawi und Shop, behält aber die Stammdaten in beiden Systemen bei. Die Linkertabellen (z.B. tLinkerArtikel) speichern die Verknüpfungen zwischen Wawi-Artikelnummern und Shop-IDs, nach einem Reset müssen diese neu aufgebaut werden. Vorsicht: Ein Reset kann bei großen Shops mehrere Stunden dauern und sollte nur außerhalb der Hauptgeschäftszeiten durchgeführt werden. Für Shopify-Shops empfiehlt sich vor dem Reset ein Export der Collection-Zuordnungen, da diese nicht automatisch wiederhergestellt werden.

Shopify unterstützt keine Teillieferungen, der Connector bucht hier immer die vollständige Menge als ausgeliefert. Für Variantenartikel wird in Shopify ein „Dummy-Vater“ angelegt, der im Shop nicht sichtbar ist, aber die Synchronisation steuert. Collections müssen vor der ersten Synchronisation manuell im Shop angelegt werden, da der Connector diese nicht automatisch erstellt. Bei Shopware 6 gibt es Einschränkungen bei Metafeldern: Nur vordefinierte Felder werden synchronisiert, benutzerdefinierte Felder erfordern eine manuelle Anpassung der Connector-Konfiguration. Für beide Systeme gilt: Rabattaktionen werden nur übertragen, wenn sie in der Wawi als Preisregeln hinterlegt sind.