JTL-Connector, dbeS oder Onlineshop-Abgleich: drei Begriffe, drei Bedeutungen

Onlineshop-Abgleich ist die offizielle Bezeichnung für den Datenaustausch zwischen JTL-Wawi und einem Shop — in zwei Ausprägungen: einfacher Abgleich und Komplettabgleich. dbeS ist der interne technische Name der Schnittstelle im JTL-Shop. Der JTL-Connector ist etwas anderes: die Schnittstelle für Drittshops wie Shopware 6, WooCommerce, Shopify oder PrestaShop.

Stand am 7. September 2026: Alle Angaben zu Menüwegen, Feldern und Grenzen stammen aus dem offiziellen JTL-Guide, aus dem JTL-Forum und aus dem Quelltext-Repository von JTL-Shop. Wir haben jede Seite an diesem Tag selbst geladen und im Volltext gegengelesen; die Fundstellen stehen am Ende. Keine der zitierten Guide-Seiten trägt einen Versionsvermerk — eine Zusicherung, dass die Bezeichnungen in kommenden Versionen gleich bleiben, gibt der Hersteller allerdings auch nirgends. Prüfen Sie den Stand vor einer Umstellung erneut.

1. Die drei Begriffe nebeneinander

Die Verwirrung hat eine einfache Ursache: Die drei Wörter stehen nicht auf derselben Ebene. „Onlineshop-Abgleich" beschreibt einen Vorgang. „dbeS" und „JTL-Connector" bezeichnen Schnittstellen — und zwar zwei verschiedene, je nachdem, welches Shopsystem am anderen Ende hängt. Wer das einmal sortiert hat, liest Fehlermeldungen und Forenbeiträge deutlich schneller.

Der Satz, der die Sache auflöst, steht im JTL-Guide in einem Nebensatz, den kaum jemand zitiert: „Der Onlineshop-Abgleich aktualisiert sowohl angeschlossene JTL-Shops als auch Fremdsysteme, die über JTL-Connector angeschlossen sind." Der Vorgang ist also der Oberbegriff. Darunter liegen zwei technische Wege.

Daraus folgt eine Faustregel, die im Alltag viel Zeit spart: Wer einen JTL-Shop betreibt, braucht keinen JTL-Connector. Und umgekehrt: Wer über einen Drittshop spricht, sollte nicht von dbeS reden. Beides passiert trotzdem ständig — auch in Support-Anfragen, in denen dann zwanzig Minuten für die Klärung draufgehen, welches System überhaupt gemeint ist.

2. Einfacher Abgleich oder Komplettabgleich?

Der JTL-Guide formuliert die Unterscheidung klar: „Im Kontext von JTL-Shop gibt es zwei verschiedene Arten des Onlineshop-Abgleichs: den Komplettabgleich und den einfachen Onlineshop-Abgleich." Beide starten Sie am selben Ort — in JTL-Wawi über den Bereich Plattformen und die Schaltfläche Abgleich starten. Der Unterschied liegt darin, was übertragen wird.

• Der einfache Onlineshop-Abgleich überträgt laut Guide „in der Regel ausschließlich Änderungen und Bestellungen". Er läuft in beide Richtungen: Neue Bestellungen kommen aus dem Shop in die Warenwirtschaft, geänderte Artikel, Kategorien, Preise und Statusänderungen gehen den Weg zurück. Das ist der Vorgang, der im Betrieb permanent läuft.
• Der Komplettabgleich überträgt „alle (ausgewählten) Daten aus JTL-Wawi an den JTL-Shop, unabhängig davon, ob sich diese Daten seit dem letzten Abgleich verändert haben". Er ist damit einseitig gerichtet und ausdrücklich ein Reparaturwerkzeug, kein Regelbetrieb.

Wann Sie ihn brauchen, sagt JTL selbst: „In der Regel lohnt es sich einen Komplettabgleich durchzuführen, wenn Sie glauben, dass nicht alle Änderungen aus JTL-Wawi zu JTL-Shop übertragen wurden." Als konkrete Anlässe nennt der Guide geänderte Steuereinstellungen und GPSR-Informationen. Beides sind Felder, die an vielen Artikeln gleichzeitig hängen — genau der Fall, in dem eine reine Änderungsübertragung Lücken lässt.

Den Umfang legen Sie vorher fest, über das Menü Plattformen, dann Onlineshop, dann Komplettabgleich. Dort haken Sie die Objekte an, die erneut vollständig gesendet werden sollen; bei mehreren angebundenen Shops geht das je Shop getrennt. Der Guide verbindet das mit einer Warnung, die man ernst nehmen sollte: „Je mehr Objekte Sie aktivieren, desto länger dauert der Komplettabgleich. Aktivieren Sie nur die Objekte, die auf jeden Fall aktualisiert werden müssen."

Eine Dauer nennt JTL nirgends — weder in Minuten noch in Artikeln pro Zeiteinheit. Wir nennen deshalb ebenfalls keine. Was sich sagen lässt: Die Laufzeit hängt an der Objektauswahl, an der Sortimentsgröße und an der Leistung des Webservers, und ein Komplettabgleich über alle Objekte im laufenden Tagesgeschäft ist keine gute Idee.

Übrigens gilt der Komplettabgleich auch für Drittshops, obwohl die Guide-Seite ausschließlich von JTL-Shop spricht. Die Connector-Dokumentation verweist auf dieselbe Seite: Auf die Frage, wie man JTL-Wawi anweist, alle Artikel noch einmal zum Shop zu senden, lautet die Antwort schlicht, einen Komplettabgleich durchzuführen.

3. dbeS: der Name, den niemand erklärt

Kaum ein Begriff im JTL-Umfeld wird so oft verwendet und so selten definiert. Wir haben deshalb die Volltextsuche des JTL-Guides bemüht und den Detektor vorher an einem Positivfall geeicht: Die Suche nach „Komplettabgleich" liefert saubere Treffer mit Textauszügen, die Suche funktioniert also. Für „dbeS" liefert sie ausschließlich Treffer in Verzeichnispfaden, Beispiel-URLs und einem Code-Kommentar. Es gibt keine Guide-Seite, die den Begriff erklärt.

Aufgeschlüsselt sieht das so aus:

• Als Verzeichnis. In der Anleitung zur Shop-Installation stehen dbeS/tmp und dbeS/logs in der Liste der Ordner, die vom Webserver beschreibbar sein müssen. Wer eine Rechte-Fehlermeldung bekommt, liest den Namen also zuerst dort.
• Als Beispiel-URL. In der Beschreibung der Bildeinstellungen taucht die Bildschnittstelle als /dbeS/bild.php auf. Auch das ist ein Pfad, keine Erklärung.
• Als Code-Kommentar. In der FAQ zu JTL-Shop steht im Abschnitt Fehlerbehebung eine Konstante mit der Zeile darüber: „enables printing of warnings/infos/errors for the dbeS sync" — gemeint ist SYNC_LOG_LEVEL. Die zugehörige Tabelle ordnet dem zu analysierenden Bereich „JTL-Shop-Abgleich" genau diese eine Zeile zu.

Damit ist die Sache klar: dbeS ist der interne technische Name der Schnittstelle, die JTL-Shop selbst mitbringt — die Datenbank-Export-Schnittstelle. Sie ist kein Zusatzprodukt, keine Lizenz und kein Plugin, sondern Bestandteil des Shops. Deshalb braucht ein JTL-Shop keinen Connector.

Im offiziellen Quelltext-Repository von JTL-Shop liegt das Verzeichnis dbeS direkt im Wurzelverzeichnis. Wir haben es am 7. September 2026 abgefragt: Es enthält 41 Einträge, darunter Dateien wie Artikel_xml.php, Kategorien_xml.php, Kunden_xml.php, GetBestellungen_xml.php, GetZahlungen_xml.php, Bilder_xml.php und QuickSync_xml.php sowie die beiden Ordner logs und tmp. Dahinter liegen im Shop-Quelltext 19 Klassen mit sprechenden Namen: Products, Categories, Orders, Customer, Images, DeliveryNotes, Returns und weitere.

Die Testanleitung, die überall kursiert und ins Leere läuft

Ein Detail lohnt die ausdrückliche Erwähnung, weil es Zeit kostet. In vielen Foren- und Agenturbeiträgen steht, man könne die Schnittstelle über den Aufruf von ihre-domain.de/dbeS/mytest.php prüfen. Für JTL-Shop 5 stimmt das nicht mehr. Die Datei existiert zwar noch, enthält aber ausschließlich den Kommentar „removed in 5.0.0"; dasselbe gilt für die .htaccess im selben Verzeichnis. Wir haben beide Dateien im offiziellen Repository geöffnet und gelesen. Zum Testen nutzen Sie stattdessen die Schaltfläche Verbindung testen in der Registerkarte Webserver der Verkaufskanalverwaltung.

Genau dort liegen auch die Zugangsdaten. JTL nennt sie Synchronisierungsdaten: Im Shop-Backend finden Sie sie unter Administration, Benutzer & Rechte, Abgleich JTL-Wawi; in JTL-Wawi tragen Sie sie unter Plattformen, Verkaufskanäle, Registerkarte Webserver in die Felder Sync-Benutzername und Sync-Kennwort ein. Wer sie verloren hat, setzt sie im Shop-Backend neu.

4. JTL-Connector: die Schnittstelle für Drittshops

Der JTL-Guide führt den Connector in einer eigenen Rubrik, und deren Name sagt bereits alles: Drittshop-Anbindung. Die Beschreibung dort lautet: „Die Schnittstelle JTL-Connector ermöglicht Ihnen einen bi-direktionalen Austausch von Artikeln, Kategorien und Kundendaten zwischen JTL-Wawi und einem Drittshop-System."

Fertige Lösungen bietet JTL für vier Systeme an — und diese Liste sollte man nicht aus dem Gedächtnis ergänzen, weil sich das Feld verschoben hat:

• Shopware 6, laut Versionsseite ab 6.1 bis 6.7.9 unterstützt.
• WooCommerce, ab 3.0 bis 8.
• Shopify, als reines SaaS-System von JTL selbst gehostet und als Service angeboten.
• PrestaShop, ab 1.7.5 bis 8.1.

Für alle Connectoren gilt eine gemeinsame Mindestanforderung: Sie funktionieren ab JTL-Wawi-Version 1.0.4.1. Die selbst gehosteten Varianten für WooCommerce und PrestaShop verlangen mindestens PHP 8.1; bei den von JTL gehosteten Connectoren für Shopware 6 und Shopify kümmert sich JTL um die PHP-Version. Und es gibt einen Ausweg für alles andere: „Entwickler können Lösungen für noch nicht unterstützte Shop-Systeme programmieren."

Vier Connectoren sind abgekündigt — und was das konkret bedeutet

Für Gambio, modified, Oxid und Shopware 5 gibt es zwar noch Dokumentation, aber keine Zukunft. JTL formuliert die Folgen ungewöhnlich deutlich: Die Schnittstellen funktionierten zwar weiterhin, aber es würden „keine Supportleistungen oder Weiterentwicklungen mehr angeboten. Das umfasst auch Sicherheitsfixes und Bugfixes." Ergänzend heißt es, in der Entwicklung von JTL-Wawi würden die spezifischen Anforderungen dieser Schnittstellen nicht mehr berücksichtigt; eine reibungslose Nutzung bei neuen Wawi-Versionen sei deshalb nicht garantiert.

Wer eine dieser vier Anbindungen betreibt, hat damit ein datiertes Planungsthema, kein akutes. Aber die Kombination aus „keine Sicherheitsfixes" und „keine Garantie bei Wawi-Updates" ist ein guter Grund, den Wechsel nicht bis zum ersten Ausfall zu verschieben.

Ein Unterschied, der Geld kostet

Beim gehosteten Connector für Shopware 6 und Shopify kommt eine Größe hinzu, die es beim JTL-Shop nicht gibt: die Transaktion. JTL definiert sie im Guide so: „Eine Transaktion wird generiert, wenn ein Verkauf über den Shop stattgefunden hat und die Bestellung/der Auftrag über den SaaS-Connector an JTL-Wawi übertragen wird." Und weiter: „Jede übertragene Bestellung (Kundenrechnung) gilt als Transaktion."

Praktisch relevant wird das beim Umzug eines bestehenden Shops, denn auch Altbestellungen können als Transaktion zählen. JTL beschreibt dafür einen Hebel: Im Kundencenter lässt sich festlegen, ab welchem Datum Aufträge überhaupt in JTL-Wawi importiert werden. Beträge nennen wir hier bewusst nicht — die Preisangaben stehen auf einer Seite, die ihre Tabellen erst im Browser aufbaut, und aus solchen Seiten lassen sich Zahlen nicht zuverlässig zitieren. Fragen Sie den Stand im Kundencenter ab, bevor Sie kalkulieren. Wie sich das im konkreten Fall auswirkt, haben wir im Beitrag zur Shopify-Anbindung an JTL-Wawi mit zwölf weiteren Stolpersteinen aus der Herstellerdokumentation ausgeführt.

5. Was in welche Richtung läuft

Die Richtungsfrage klingt trivial und ist es nicht. Sie entscheidet, wo Sie ein Feld pflegen — und wo eine Pflege wirkungslos verpufft, weil sie beim nächsten Abgleich überschrieben wird. Der Guide beschreibt den einfachen Abgleich in einem Satz, der beide Richtungen enthält: „Während eines einfachen Onlineshop-Abgleichs werden neue Bestellungen aus Ihrem Onlineshop an JTL-Wawi gesendet. Parallel sendet JTL-Wawi geänderte Daten wie z. B. neue Artikel, Kategorien oder Preise sowie Statusänderungen an Ihren Onlineshop."

Aus den einzelnen Guide-Seiten lässt sich das weiter auffächern. Belegt ist Folgendes:

• Von JTL-Wawi in den Shop: neue und geänderte Artikel, Kategorien, Preise und Statusänderungen. Dazu die Sichtbarkeit — welche Kategorie und welcher Artikel im Shop überhaupt erscheinen, entscheiden Sie in der Warenwirtschaft. Auch Bildnamen und Alternativtexte für Bilder pflegen Sie laut Guide in den Artikelstammdaten und übertragen sie anschließend per Abgleich.
• Ebenfalls aus JTL-Wawi: die Meta-Angaben für Artikel, Kategorien und Hersteller. Das ist einer der häufigsten Irrtümer im SEO-Alltag. Der Guide sagt ausdrücklich, im Shop ließen sich Meta-Angaben nur „für alle Seiten, die ihre Meta-Angaben nicht aus JTL-Wawi beziehen", einrichten.
• Vom Shop in die Warenwirtschaft: neue Bestellungen. Und Kundendaten — allerdings nur in dieser Richtung. Auf die Frage, ob JTL-Wawi Kunden in den Onlineshop importieren könne, die dort noch nicht vorhanden sind, antwortet die Connector-Dokumentation knapp: „Nein, JTL-Wawi kann nur Kundendaten aktualisieren, die zuvor aus dem Onlineshop importiert wurden."

Für die Fein-Zuordnung im JTL-Shop gibt es einen aufschlussreichen Hinweis im Quelltext: Im Verzeichnis dbeS tragen mehrere Dateien ein vorangestelltes „Get" im Namen, etwa GetBestellungen_xml.php oder GetZahlungen_xml.php, während andere ohne dieses Präfix auskommen. Das legt nahe, dass die Warenwirtschaft diese Datenarten aus dem Shop abholt und die übrigen dorthin sendet. Das ist unsere Lesart der Dateinamen, keine Aussage des Herstellers — JTL dokumentiert die Zuordnung an keiner Stelle. Wir nennen sie trotzdem, weil sie beim Lesen von Logdateien hilft.

Eine harte Grenze zieht der Guide dagegen ausdrücklich: „Es werden ausschließlich die Daten übertragen, die der jeweilige Shop in seiner Basiskonfiguration unterstützt. Erweiterungen von JTL-Wawi werden im Regelfall nicht unterstützt." Wer also ein Feld in der Warenwirtschaft pflegt, für das der Shop keine Entsprechung hat, wartet vergeblich auf das Ergebnis. Wo Sie den Shop entsprechend erweitern können, zeigt unsere Übersicht der Plugins für JTL-Shop.

6. „JTL-Wawi ist das führende System": was das praktisch heißt

Diesen Satz hört jeder, der eine Anbindung einrichtet. Er ist keine Empfehlung, sondern eine Konstruktionsentscheidung. Die Connector-FAQ formuliert es auf die Frage, welches System federführend einzusetzen sei, unmissverständlich: „Der JTL-Connector wurde so programmiert, dass JTL-Wawi federführend ist."

Die Erste-Schritte-Seite übersetzt das in eine Arbeitsanweisung: „Ab dem initialen Datentransfer ist JTL-Wawi das führende System. Nehmen Sie alle Änderungen an Ihrem Datenbestand bitte ausschließlich in JTL-Wawi vor — und nicht mehr im Admin-Bereich Ihres Onlineshops." Dazu gehört eine Einschränkung, die im Guide direkt darunter steht und gern überlesen wird: Dieses Vorgehen gilt nur, wenn im Connector eingestellt ist, dass die Sortimentsdaten über JTL-Wawi gepflegt werden.

Für den Alltag heißt das drei Dinge. Erstens: Der Shop-Admin ist ab jetzt ein Anzeigewerkzeug für alles, was aus der Warenwirtschaft kommt. Wer dort einen Preis korrigiert, hat ihn beim nächsten Abgleich wieder verloren. Zweitens: Es braucht eine klare Absprache im Team, wer wo pflegt — die häufigste Ursache für „das System spinnt" ist nicht die Software, sondern eine zweite Person, die im Shop-Backend arbeitet. Drittens: Die Regel gilt nicht für alles. Bestellungen, Kunden und Zahlungen entstehen im Shop und wandern von dort in die Warenwirtschaft.

Beim JTL-Shop wirkt dasselbe Prinzip über einen anderen Hebel: die Wurzelkategorie. Beim Anlegen des Verkaufskanals wählen Sie eine Hauptkategorie aus; alle Kategorien und Artikel darin werden für den Shop aktiviert. Der Guide warnt aber ausdrücklich: „Bitte beachten Sie, dass alle Kategorien und Artikel, die sich außerhalb der Wurzelkategorie befinden, für JTL-Shop deaktiviert werden und nicht aktiviert werden können." Wer einen Artikel partout nicht in den Shop bekommt, sollte zuerst hier nachsehen — noch vor jeder Logdatei. Wie Verkaufskanäle grundsätzlich angelegt werden, beschreibt unsere Anleitung zur Einrichtung von JTL-Wawi.

7. Ohne JTL-Worker kein automatischer Abgleich

Manuell starten Sie den Abgleich über Plattformen und die Schaltfläche Abgleich starten. Damit er von selbst läuft, brauchen Sie den JTL-Worker — den Hintergrunddienst, der Aufgaben in JTL-Wawi anstößt. Ohne ihn passiert automatisch schlicht nichts.

Zwei Punkte werden dabei regelmäßig übersehen. Der erste steht in beiden Abgleich-Kapiteln des Guides: „Wenn Sie JTL-Worker 2.0 nutzen, starten Sie diesen neu, nachdem Sie einen JTL-Shop zu JTL-Wawi hinzugefügt haben. Erst dann ist ein automatischer Abgleich mit dem JTL-Worker möglich." Wer den Shop anlegt und sich wundert, dass tagelang nichts passiert, hat meistens genau diesen Neustart ausgelassen.

Der zweite betrifft das Intervall. JTL gibt kein festes Abgleichintervall vor. Jede Aufgabe im Menü Admin, Punkt JTL-Worker-Status, Registerkarte Aufgaben, trägt ihren eigenen Wert in der Spalte Intervall — angegeben in Tagen, Stunden, Minuten und Sekunden. Belegt ist genau eine Empfehlung: „Setzen Sie das Intervall auf mindestens 5 Minuten, damit die Serverbelastung minimiert wird." Eine Obergrenze, einen Standardwert oder eine Empfehlung je Datenart nennt der Hersteller nicht.

Dazu kommt eine Betriebsbedingung, die im Guide fett markiert ist: „Bitte beachten Sie, dass JTL-Worker immer geöffnet sein muss, damit JTL-Worker automatisch Abgleiche durchführen kann." Das gilt für den manuell gestarteten Worker; als Alternative beschreibt JTL die Einrichtung als Windows-Dienst. Empfohlen wird außerdem ein eigener Benutzer für den Worker, damit dessen Anmeldung nicht abreißt, sobald jemand sein persönliches Passwort ändert. Was der Worker sonst noch anstößt und warum er kein Zeitplaner ist, behandeln wir im Beitrag zu JTL-Workflows und dem JTL-Worker.

8. Fehlerbilder, die JTL selbst dokumentiert

Eine konsolidierte Troubleshooting-Seite zum Onlineshop-Abgleich gibt es bei JTL nicht — wir haben danach gesucht und keine gefunden. Die Hinweise sind stattdessen über die einzelnen Kapitel verstreut. Zusammengetragen ergibt das eine erstaunlich brauchbare Liste, in der acht der häufigsten Beschwerden eine dokumentierte Ursache haben.

Zwei Einträge verdienen eine Erläuterung. Der Fehler 500 bei der Übertragung hängt an den Übertragungsparametern: JTL-Wawi packt Daten in Archive und schickt sie an den Webserver, der sie anschließend verarbeiten muss. Über Anzahl der Dateien je Archiv und Archivgröße stellen Sie ein, wie groß diese Pakete werden. Der Guide sagt dazu: „Wenn bei der Übertragung ein 500 Fehler ausgegeben wird, müssen diese Werte nach unten korrigiert werden." Beruhigend ist der Zusatz, dass JTL-Wawi diese Werte ab Version 1.6 bei Problemen selbst schrittweise absenkt.

Der zweite ist der Access-Schutz. „Ein Access-Schutz (in der .htaccess auf dem Webserver) oder ein aktiver Wartungsmodus in Ihrem Shop, führen dazu, dass der JTL-Connector nicht funktioniert", schreibt JTL. Die passende Fehlermeldung liefert der Guide gleich mit: Meldet JTL-Wawi „Keine HTTP-Verbindung", ist der Adminbereich vermutlich per .htaccess geschützt. Dasselbe Muster greift bei allem, was sich sonst noch vor den Shop schiebt — ein vorgeschalteter Bot- oder DDoS-Schutz kann den Abgleich genauso blockieren, weil die Warenwirtschaft ohne Browser und ohne JavaScript anfragt. Was ein solcher Dienst überhaupt tut, erklären wir im Beitrag Was ist Cloudflare?; die passenden Ausnahmeregeln für den JTL-Shop finden Sie auf unserer Seite zum Cloudflare-Schutz für JTL-Shops.

Für Drittshops kommt ein Werkzeug hinzu, nach dem in der Suche auffällig oft gefragt wird: das Zurücksetzen des Connectors. Es liegt in der Onlineshop-Anbindung in der Registerkarte Zurücksetzen und Hilfen. Was dabei passiert, beschreibt JTL präzise: Die vom Connector in der Shopdatenbank angelegten Linkertabellen werden geleert, und beim nächsten Abgleich baut der Connector die Verknüpfungen erneut auf. Diese Tabellen verbinden die internen Schlüssel beider Systeme — sie sind der Grund, warum ein Shop nach dem Zurücksetzen erst wieder „zueinanderfinden" muss.

9. Wenn der Abgleich hängt: vier Prüfungen der Reihe nach

Die Reihenfolge ist bewusst gewählt: Sie beginnt mit den Einstellungen, die in Sekunden geprüft sind, und endet mit der Logdatei, die Zeit kostet. In der Praxis erledigt sich der Großteil der Fälle in den ersten beiden Schritten.

1. Sperre prüfen: Ist die Checkbox Datenübertragung sperren im Verkaufskanal gesetzt?
2. Verbindung testen: Registerkarte Webserver, Schaltfläche Verbindung testen benutzen.
3. Worker ansehen: Läuft die Aufgabe unter Admin und JTL-Worker-Status wirklich?
4. Log einschalten: Debug-Logs in JTL-Wawi aktivieren und den Fehler erneut auslösen.

Zum vierten Schritt noch ein Hinweis, weil er zwei Ebenen hat. Die Logdateien von JTL-Wawi schalten Sie im Menü Admin unter Globale Einstellungen in der Registerkarte Debug ein; dort sehen Sie unter Onlineshop-Abgleich auch, wohin sie geschrieben werden. Ist die Option aus, aktivieren Sie sie, wählen einen Pfad und lösen den Fehler erneut aus. Beim Drittshop gibt es zusätzlich die Logs des Connectors, die sich über einen Eintrag in dessen Konfigurationsdatei ausführlicher stellen lassen.

Beim JTL-Shop führt derselbe Weg über die Konstante SYNC_LOG_LEVEL in der Konfigurationsdatei des Shops. JTL beschreibt sie in der FAQ als Mittel gegen einen nichtssagenden Fehler 500 und verbindet das mit einer Bitte, die man befolgen sollte: „Nach erfolgreicher Fehleranalyse setzen Sie bitte alle Einträge wieder auf 0, um das Schreiben von Log-Dateien zu beenden." Ein dauerhaft aktives Debug-Logging füllt nicht nur die Platte, es zeigt im ungünstigen Fall auch Interna nach außen.

10. Wo die Dokumentation schweigt

Zur Ehrlichkeit gehört, die Grenzen der Quellenlage zu benennen. Diese Punkte haben wir gesucht und nicht belegen können — wer sie irgendwo als Fakt liest, sollte nachfragen:

• Keine Angaben zu Dauer und Durchsatz. Weder für den einfachen Abgleich noch für den Komplettabgleich nennt JTL Zeiten, Artikelzahlen oder Datenmengen. Die einzige quantitative Aussage ist die Warnung, dass mehr Objekte länger dauern.
• Keine Feldliste. Es gibt keine Übersicht, welche Felder in welche Richtung laufen. Der Guide sagt nur, es werde übertragen, was der jeweilige Shop in seiner Basiskonfiguration unterstützt — die Detailmatrix je Drittshop liegt in einem separaten Dokument.
• Keine offizielle Troubleshooting-Seite. Die Fehlerbilder in Abschnitt 8 stammen aus fünf verschiedenen Guide-Kapiteln. Eine konsolidierte Seite existiert nicht, weshalb Foren-Threads bei dieser Frage traditionell die erste Anlaufstelle sind.
• Kein Versionsstand auf den zitierten Seiten. Wir haben das geprüft: Der Vermerk „Stand: JTL-Wawi Version" existiert im Guide durchaus — auf einer Vergleichsseite haben wir ihn gefunden —, auf keiner der hier zitierten Seiten steht er. Das ist kein Beleg für Aktualität, sondern nur dafür, dass JTL zu diesen Kapiteln keine Version zusichert.

Und ein Hinweis in eigener Sache zur Zeitachse: JTL-Shop bewegt sich schneller als die Guide-Kapitel. Die Version 5.8.0 ist laut Releasepost im offiziellen JTL-Forum am 26. August 2026 erschienen. Menüwege und Feldnamen ändern sich damit nicht über Nacht, aber ein Blick auf den aktuellen Stand gehört vor jede Umstellung.

11. Fazit: drei Sätze, die die Verwirrung beenden

Der erste: „Onlineshop-Abgleich" ist der Vorgang, nicht die Technik. Er umfasst beide Wege — den nativen zum JTL-Shop und den über den Connector zum Drittshop. Wer den Begriff so verwendet, redet nie an der Sache vorbei.

Der zweite: dbeS ist kein Produkt, sondern ein Verzeichnisname. Er steckt im JTL-Shop und begegnet Ihnen fast nur in Pfaden und Logs. Wenn er in einer Fehlermeldung auftaucht, wissen Sie jetzt, dass es um den Shop-eigenen Abgleich geht — und nicht um eine Komponente, die Ihnen jemand verkaufen muss.

Der dritte: Der JTL-Connector gehört zum Drittshop. Vier Systeme sind fertig unterstützt, vier weitere abgekündigt. Wer die Begriffe trennt, sucht Fehler dort, wo sie entstehen — und stellt in der Beratung die richtige erste Frage, nämlich welches Shopsystem am anderen Ende hängt.

Wo Anbindungen in gewachsenen Systemen Probleme machen, liegt es nach unserer Erfahrung selten an der Schnittstelle selbst. Meist ist es die Kombination aus einer vergessenen Einstellung, einem nicht laufenden Worker und einer zweiten Person, die im Shop-Backend pflegt. Diese drei lassen sich an einem Vormittag auseinandersortieren — man muss nur wissen, in welcher Reihenfolge man hinsieht.

12. Häufige Fragen zum Onlineshop-Abgleich

Was ist der Unterschied zwischen dem JTL-Connector und dbeS?

Beide sind Schnittstellen, aber für verschiedene Zielsysteme. dbeS ist der interne technische Name der Schnittstelle, die im JTL-Shop selbst steckt. Der JTL-Connector verbindet JTL-Wawi mit Drittshops wie Shopware 6, WooCommerce, Shopify oder PrestaShop. Wer einen JTL-Shop betreibt, braucht keinen Connector.

Wofür steht die Abkürzung dbeS?

Der Begriff steht für die Datenbank-Export-Schnittstelle des JTL-Shops. JTL selbst schreibt die Abkürzung nirgends im Guide aus und erklärt sie auf keiner Hilfeseite. Sichtbar wird sie nur als Verzeichnisname im Shop-Verzeichnis und in einem Code-Kommentar zur Konstante SYNC_LOG_LEVEL. Genau deshalb kennen viele den Namen nur aus Fehlermeldungen.

Wann brauche ich einen Komplettabgleich statt des einfachen Abgleichs?

Wenn Änderungen aus JTL-Wawi im Shop nicht ankommen. JTL nennt als Anlass ausdrücklich geänderte Steuereinstellungen und GPSR-Informationen. Der Komplettabgleich sendet alle ausgewählten Objekte erneut, unabhängig davon, ob sie sich geändert haben. Wählen Sie dabei nur die Objekte aus, die wirklich aktualisiert werden müssen.

Welche Daten laufen vom Shop zurück in die Warenwirtschaft?

Vor allem neue Bestellungen. Der Guide beschreibt den einfachen Abgleich so, dass neue Bestellungen aus dem Onlineshop an JTL-Wawi gesendet werden. Kundendaten entstehen ebenfalls im Shop: JTL-Wawi kann laut Connector-Dokumentation nur Kundendaten aktualisieren, die zuvor aus dem Onlineshop importiert wurden.

Warum läuft der automatische Abgleich nicht?

Meist fehlt der laufende JTL-Worker. Ohne ihn findet gar kein automatischer Abgleich statt, denn er stößt die Aufgabe an. Nach dem Hinzufügen eines JTL-Shops verlangt JTL zusätzlich einen Neustart des Workers. Erst danach lässt sich im Menü Admin die Aufgabe mit einem Intervall starten.

Gibt JTL ein festes Abgleichintervall vor?

Nein. Jede Worker-Aufgabe trägt ihren eigenen Intervallwert in der Spalte Intervall, angegeben in Tagen, Stunden, Minuten und Sekunden. Belegt ist nur eine Empfehlung: Setzen Sie das Intervall auf mindestens fünf Minuten, damit die Serverbelastung gering bleibt. Eine Obergrenze nennt der Hersteller nicht.

Warum erscheint ein Artikel nach dem Abgleich nicht im Shop?

Dafür dokumentiert JTL drei Ursachen. Erstens muss die Kategorie des Artikels aktiviert sein, bevor der Artikel selbst aktiviert werden kann. Zweitens liegen Artikel außerhalb der Wurzelkategorie grundsätzlich außerhalb der Reichweite. Drittens blendet JTL-Shop im Standard Artikel ohne aktive Bestandsführung aus.

Was passiert, wenn ich den JTL-Connector zurücksetze?

Die Verknüpfungen werden gelöscht und neu gebildet. Beim Zurücksetzen leert JTL-Wawi die sogenannten Linkertabellen in der Shopdatenbank. Diese Tabellen verbinden die internen Schlüssel beider Systeme miteinander. Beim nächsten Abgleich baut der Connector die Verknüpfungen erneut auf. Der Weg führt über die Registerkarte Zurücksetzen und Hilfen.

13. Quellen & offizielle Dokumentation

Alle folgenden Quellen wurden am 7. September 2026 abgerufen und im Volltext gegengelesen; die zitierten Formulierungen stammen wörtlich daraus. Herstellerdokumentation ändert sich — bitte prüfen Sie den Stand vor einer Umstellung erneut. Externe Quellen öffnen in einem neuen Tab.

• JTL-Guide: Einfachen Onlineshop-Abgleich in JTL-Wawi durchführen — Die offizielle Bezeichnung, die beiden Ausprägungen, die Richtungen des einfachen Abgleichs und der Satz, dass der Onlineshop-Abgleich auch Fremdsysteme über den JTL-Connector aktualisiert.
• JTL-Guide: Komplettabgleich durchführen — Die Definition des Komplettabgleichs, die genannten Anlässe rund um Steuereinstellungen und GPSR sowie die Auswahl der Objekte je Shop.
• JTL-Guide: JTL-Shop an JTL-Wawi anbinden — Die Wurzelkategorie-Regel, die Sperr-Checkbox, die Warnung zu Nummernkreisen und die Übertragungsparameter samt Hinweis auf den Fehler 500.
• JTL-Guide: Synchronisierung mit JTL-Wawi einrichten — Woher die Synchronisierungsdaten kommen, wo sie im Shop-Backend liegen und in welche Felder der Verkaufskanalverwaltung sie gehören.
• JTL-Guide: Kategorien und Artikel für den Onlineshop aktivieren — Die Reihenfolge Kategorie vor Artikel und der Hinweis, dass JTL-Shop Artikel ohne aktive Bestandsführung im Standard ausblendet.
• JTL-Guide: FAQ zu JTL-Shop — Der Abschnitt Fehlerbehebung mit der Konstante SYNC_LOG_LEVEL und dem Kommentar, der sie ausdrücklich dem dbeS-Abgleich zuordnet.
• JTL-Guide: Seitentitel und Meta-Angaben pflegen — Der Beleg dafür, dass Meta-Angaben für Artikel, Kategorien und Hersteller aus JTL-Wawi stammen und nicht im Shop-Backend gepflegt werden.
• JTL-Guide: JTL-Connector, Dokumentation zur Drittshop-Anbindung — Die Einordnung als Drittshop-Anbindung, der bi-direktionale Austausch von Artikeln, Kategorien und Kundendaten und die vier fertigen Lösungen.
• JTL-Guide: Unterstützte Versionen von JTL-Connector — Die Versionsspannen je Shopsystem, die Mindestversion von JTL-Wawi und die PHP-Anforderung für die selbst gehosteten Connectoren.
• JTL-Guide: Abgekündigte Versionen von JTL-Connector — Die vier abgekündigten Connectoren und die ausdrückliche Aussage, dass auch Sicherheitsfixes und Bugfixes entfallen.
• JTL-Guide: FAQ zu den JTL-Connectoren — Der Satz zum federführenden System, die Linkertabellen, der Weg zu den Logdateien und die dokumentierten Fehlerbilder rund um .htaccess, Wartungsmodus und Redirects.
• JTL-Guide: FAQ Anbindung an JTL-Wawi — Die Kundendaten-Regel, das Zurücksetzen des Connectors und der Verweis auf den Komplettabgleich, der damit auch für Drittshops gilt.
• JTL-Guide: Erste Schritte mit JTL-Connectoren — Der Satz, dass JTL-Wawi ab dem initialen Datentransfer das führende System ist, samt der Einschränkung auf die Einstellung im Connector.
• JTL-Guide: Transaktionskosten bei Shopware 6 und Shopify — Die Definition der Transaktion beim gehosteten Connector und die Einstellung, ab welchem Datum Aufträge übernommen werden.
• JTL-Guide: Abgleiche mit JTL-Worker 2.0 automatisieren — Die Registerkarte Aufgaben, die Intervallspalte im Format Tage, Stunden, Minuten, Sekunden und die Empfehlung von mindestens fünf Minuten.
• JTL-Software: Quelltext-Repository von JTL-Shop — Das offizielle Repository. Dort liegen das Verzeichnis dbeS mit seinen Schnittstellendateien sowie die leer geräumte Datei mytest.php mit dem Vermerk zur Entfernung in Version 5.0.0.
• JTL-Forum: Releasepost zu JTL-Shop 5.8 — Der offizielle Releasekanal von JTL mit dem Veröffentlichungsdatum der Version 5.8.0 am 26. August 2026.