Auf einen Blick
- ✓innocigs.com betrieb JTL Wawi als Warenwirtschaft und musste eine externe Plattform anbinden, mit branchenspezifischen Anforderungen, für die kein fertiger JTL-Connector existiert.
- ✓Laut Vlarom-Projekterfahrung: Als JTL Service Partner Gold hat Vlarom einen individuellen API-Konnektor entwickelt. Artikel, Bestände und Auftragsstatus synchronisieren in Echtzeit, Felder für die Altersverifikation sind sauber abgebildet (Quelle: JTL-Software Partnerverzeichnis).
- ✓Was vorher mehrere Stunden manuelle Arbeit pro Woche gebunden hat, läuft nach Go-Live des Konnektors vollständig automatisch. Keine Workarounds, keine Doppelpflege.
Die Ausgangslage: zwei Systeme, kein Datenaustausch
innocigs.com ist einer der spezialisierten E-Zigaretten-Fachhändler in Deutschland. Mehrere tausend Produkte, über 25 Marken wie Elfbar, GEEKVAPE und SMOK, dazu ein aktiver B2B-Großhandelsbereich. JTL Wawi war als zentrales Warenwirtschaftssystem bereits im Einsatz: Lager, Aufträge, Artikelstamm.
Parallel dazu lief eine externe Plattform mit eigener API, die einen spezifischen Vertriebskanal abdeckte. Beide Systeme standen nebeneinander, nicht miteinander. Das Ergebnis: Artikeldaten wurden doppelt gepflegt, Bestände per Hand abgeglichen, Auftragsstatus in keinem der beiden Systeme aktuell.
Dazu kamen branchenspezifische Anforderungen. Im E-Zigaretten-Handel gibt es regulatorische Felder wie Altersverifikation oder besondere Produktkennzeichnungen, die in keiner Standard-Integration vorgesehen sind. Die Frage war nicht „welchen Connector konfigurieren wir?“, sondern „was muss gebaut werden?“
Die Ursache: Datenstruktur-Mismatch und fehlende Connector-Unterstützung
Zwei strukturelle Probleme lagen unter der Oberfläche. Erstens dachte die externe Plattform in anderen Kategorien als JTL Wawi. Variantenattribute, Preisfelder, Bestandsstrukturen, Statuscodes für Aufträge: überall lagen Bezeichnungen und Hierarchien vor, die sich nicht direkt übertragen ließen. Ein manueller Import über die JTL-Ameise wäre theoretisch möglich gewesen, hätte aber eine Transformationslogik erfordert, die in keinem konfigurierbaren Tool abbildbar ist.
Zweitens haben die regulatorischen Anforderungen das Profil über das hinausgetrieben, was generische Konnektoren abdecken. Altersverifikationsdaten müssen strukturiert im Datenfluss mitgeführt werden, nicht als Kommentar in einem Freitextfeld, sondern als definiertes Feld mit validiertem Inhalt. Fehlt das, entstehen Compliance-Lücken.
Der einzig saubere Weg war eine direkte Anbindung über die JTL Wawi REST-API — die offizielle Schnittstelle von JTL-Software GmbH — mit einer eigenen Transformationsschicht, die die Datenmodelle beider Systeme aufeinander abbildet. Das ist keine Konfigurations-, sondern eine Entwicklungsaufgabe.
Was wir entwickelt haben
Laut Vlarom-Projekterfahrung beginnt ein individueller API-Konnektor nicht mit dem ersten Codebaustein, sondern mit vollständiger Dokumentation beider Systeme. Jedes Feld das zwischen den Systemen übertragen werden musste, bekam entweder eine direkte Entsprechung oder eine Transformationsregel. Felder ohne klare Entsprechung wurden als offene Punkte markiert und gemeinsam mit innocigs abgenommen. Erst nach abgeschlossenem Datenmapping hat die Entwicklung begonnen.
Der Konnektor wurde gegen eine JTL-Testinstanz gebaut, kein Experiment in der Produktion. Die Synchronisation läuft in Echtzeit für kritische Felder (Bestände, Auftragsstatus) und in definierten Intervallen für Stammdaten und 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 Schwachstellen ans Licht. Auf Basis der Testläufe wurde die Fehlerbehandlung verfeinert. Die Übergabe erfolgte mit kompletter Dokumentation: Deployment-Anleitung, Konfigurationsparameter, Monitoring-Beschreibung. Technische Referenz für die API-Einrichtung auf JTL-Seite: JTL-Wawi API-Instanz einrichten (Quelle: JTL-Software Dokumentation).
Das Ergebnis
Laut Vlarom-Projekterfahrung: Nach Go-Live des Konnektors laufen Artikeldaten, Bestände und Auftragsstatus vollständig automatisiert zwischen beiden Systemen — ohne manuellen Eingriff. Was vorher mehrere Stunden manuelle Arbeit pro Woche gebunden hat, entfällt vollständig.
manuell
- ✗Artikeldaten 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 bidirektional ohne manuellen Eingriff
- ✓Regulatorische Felder (Altersverifikation) vollständig im Datenfluss abgebildet
Die Lektion
Was du daraus mitnehmen kannst
Laut Vlarom-Projekterfahrung: Wenn Standard-Konnektoren die Anforderungen nicht abdecken, lohnt es sich früh zu 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 deutlich mehr Zeit wenn man es spät erkennt.
Besondere Vorsicht gilt für Branchen mit regulatorischen Anforderungen. Altersverifikation, Kennzeichnungspflichten und branchenspezifische Pflichtfelder müssen im Konnektor strukturell abgebildet sein — ein Workaround über freie Textfelder ist kein Ersatz für ein sauber definiertes Datenmodell. Eine gründliche Anforderungsanalyse vor der Entwicklung spart mehr Zeit als jede Nachbesserung danach. Als JTL Service Partner Gold ist Vlarom auf genau diese Art von maßgeschneiderten Integrationen spezialisiert (Quelle: JTL-Software Partnerverzeichnis).
Weitere Lessons aus unserer Praxis:
