Auf einen Blick
- ✓Ein spezialisierter E-Zigaretten-Fachhändler betrieb JTL Wawi, musste aber eine externe Plattform anbinden — mit Datenstrukturen und Branchenanforderungen, für die kein fertiger JTL-Connector existierte.
- ✓Vlarom hat einen individuellen JTL API Konnektor entwickelt, der Artikeldaten, Bestände und Auftragsstatus in Echtzeit synchronisiert und dabei branchenspezifische Felder wie Altersverifikation vollständig abbildet.
- ✓Manuelle Datenpflege, die vorher mehrere Stunden pro Woche gebunden hat, läuft jetzt vollständig automatisch — ohne Workarounds, ohne Doppelpflege.
Das Problem: JTL Wawi im Einsatz, externe Plattform ohne Anbindung
Ein Fachhändler für E-Zigaretten und Zubehör hatte JTL Wawi als zentrale Warenwirtschaft im Einsatz — Lager, Aufträge, Artikel. Parallel dazu lief eine externe Plattform mit eigener API, die das Kernsystem für einen spezifischen Vertriebskanal stellte. Diese beiden Systeme standen nebeneinander, nicht miteinander.
Das Ergebnis war manueller Aufwand in beide Richtungen: Artikeldaten mussten doppelt gepflegt werden, Bestände wurden per Hand abgeglichen, Auftragsstatus waren in keinem der beiden Systeme vollständig aktuell. Hinzu kamen branchenspezifische Anforderungen — Altersverifikation, besondere Produktkennzeichnungen, regulatorische Felder — die in keiner Standard-Lösung vorgesehen waren.
Der Markt bietet für diesen Fall keinen fertigen Connector. Die externe Plattform hat keine offizielle JTL-Unterstützung, der JTL Connector deckt sie nicht ab. Die Frage war also nicht: „Welches Plugin konfigurieren wir?“ — sondern: „Was muss gebaut werden?“
Die Ursache: Datenstruktur-Mismatch und fehlende offizielle Connector-Unterstützung
Zwei strukturelle Probleme lagen unter der Oberfläche. Erstens: Die externe Plattform dachte in anderen Kategorien als JTL Wawi. Variantenattribute, Preis- und Bestandsfelder, Statuscodes für Aufträge — überall lagen Bezeichnungen und Hierarchien vor, die sich nicht eins zu eins übertragen ließen. Ein Standard-Import über die JTL-Ameise wäre technisch möglich gewesen, hätte aber Transformationslogik erfordert, die in keinem konfigurierbaren Tool abbildbar ist.
Zweitens: Die Branchenanforderungen haben das Anforderungsprofil über das hinausgeführt, was generische Konnektoren abdecken. Altersverifikationsdaten müssen explizit im Datenfluss mitgeführt werden — nicht als Kommentar, sondern als strukturiertes Feld. Fehlt das, entstehen Compliance-Lücken. Für diesen Anforderungstyp gibt es kein Plugin, das man einfach kauft.
Der einzig saubere Weg war eine direkte Anbindung über die JTL Wawi REST-API, mit einer Transformationsschicht, die die Datenmodelle beider Systeme aufeinander abbildet. Das ist keine Konfigurations-, sondern eine Entwicklungsaufgabe.
Was Vlarom entwickelt hat
Vlarom hat zunächst beide Systeme vollständig dokumentiert — JTL Wawi auf der einen Seite, die externe Plattform auf der anderen. Jedes Feld, das zwischen den Systemen ausgetauscht werden musste, bekam eine Entsprechung oder eine Transformationsregel. Felder ohne direkte Entsprechung wurden als Klärungsbedarf markiert und gemeinsam mit dem Kunden abgenommen. Erst nach vollständigem Mapping hat die Entwicklung begonnen.
Der Konnektor selbst wurde gegen eine JTL-Testinstanz entwickelt — kein Experiment in der Produktion. Die Synchronisation läuft in Echtzeit für kritische Daten (Bestände, Auftragsstatus) und in definierten Intervallen für weniger zeitkritische Felder (Stammdaten, Beschreibungen). Fehlerbehandlung war von Anfang an Teil des Designs: Jeder Datensatz wird protokolliert, kritische Übertragungsfehler lösen sofort eine Benachrichtigung aus.
Die Testphase lief mit echten Produktdaten in einer abgeschirmten Umgebung. Synthetische Testdaten hätten die wirklichen Probleme nicht gezeigt — erst echte Datensätze mit realen Ausnahmen und historischen Sonderfällen bringen die Schwachstellen ans Licht. Auf Basis dieser Testläufe wurde die Fehlerbehandlungs-Logik des Konnektors verfeinert. Die Übergabe erfolgte mit vollständiger Dokumentation: Deployment-Anleitung, Konfigurationsparameter, Monitoring-Beschreibung. Detaillierte Informationen zur API-Einrichtung auf JTL-Seite bietet das offizielle JTL-Entwicklerportal.
Das Ergebnis
Nach Go-Live des Konnektors laufen Artikeldaten, Bestände und Auftragsstatus vollständig automatisiert zwischen beiden Systemen. Was vorher manuelle Arbeit war, passiert jetzt ohne Eingriff.
manuell
- ✗Artikeldaten wurden doppelt gepflegt
- ✗Bestandsabgleich per Hand, fehleranfällig
- ✗Auftragsstatus in keinem System vollständig aktuell
Echtzeit
- ✓Bestände synchronisieren automatisch zwischen JTL Wawi und externer Plattform
- ✓Auftragsstatus fließen in beide Richtungen ohne manuellen Eingriff
- ✓Branchenspezifische Felder vollständig im Datenfluss abgebildet
Die Lektion
Was du daraus mitnehmen kannst
Wer merkt, dass Standard-Konnektoren die eigenen Anforderungen nicht abdecken, sollte frühzeitig klären warum — nicht erst wenn der erste Produktivfehler passiert. Die häufigste Ursache ist kein technisches Versagen, sondern ein Datenstruktur-Mismatch: Das externe System liefert Daten in einer Form, die JTL Wawi so nicht erwartet. Das ist lösbar, kostet aber Zeit wenn man es erst spät erkennt.
Besondere Vorsicht gilt für Branchen mit regulatorischen Anforderungen. Altersverifikation, Kennzeichnungspflichten und branchenspezifische Felder müssen im Konnektor strukturell abgebildet sein — ein Workaround über freie Textfelder ist kein Ersatz. Eine saubere Anforderungsanalyse vor der Entwicklung spart mehr Zeit als jede Nachbesserung danach.
Weitere Lessons aus der Vlarom-Praxis:
