JTL-Connector Lizenz erstellen: Was du im Kundencenter tun musst — bevor der Shop abgleicht

Auf einen Blick

• ✓Die Vlarom E-Commerce Agentur sieht regelmäßig, dass Händler die Lizenz an der falschen Stelle suchen: Sie gehört ins JTL-Kundencenter unter „Shop-Connectoren“, nicht in den Shop-Adminbereich oder in JTL-Wawi selbst.
• ✓Trial-Lizenzen für den JTL Connector sind in der Regel einmalig verfügbar. Läuft die Trial ab und du hast keine Vollizenz gebucht, bricht der Abgleich mit der Fehlermeldung „Die Connector-Lizenz ist abgelaufen“ ab — ohne Vorwarnung.
• ✓Die häufigste Fehlerursache beim Lizenz-Check ist eine falsch eingetragene Domain: Die URL muss ohne „https://“, ohne Unterverzeichnis und ohne „/jtlconnector/“ am Ende eingetragen werden.

Wir bei Vlarom wissen: Der Lizenz-Schritt klingt trivial — ist er aber nicht. In gut einem Drittel der Connector-Einrichtungen die wir begleiten, liegt ein Lizenz- oder Domain-Problem vor, bevor der erste Abgleich überhaupt gestartet wird. Entweder wurde die Trial nicht rechtzeitig in eine Vollizenz umgewandelt, die Domain stimmt nicht mit der Shop-URL überein, oder die Lizenz wurde für den falschen Connector-Typ (z.B. WooCommerce statt Shopware) erstellt. Als JTL Service Partner Gold mit Sitz in Ahrensfelde bei Berlin sehen wir diese Muster quer durch alle Shopsysteme — bei Kunden aus dem gesamten DACH-Raum.

Der JTL Connector ist in der Einrichtung kein besonders kompliziertes Werkzeug, solange die Voraussetzungen stimmen. Die Lizenz ist eine davon, und sie wird häufiger zur Fehlerquelle als man erwarten würde. In unseren Einrichtungsprojekten geht es dabei fast nie um ein technisches Problem, sondern um einen Schritt der übersprungen oder falsch ausgeführt wurde.

Aus unseren Projektdaten (JTL Service Partner Gold): In rund einem Drittel der Connector-Einrichtungen, die wir begleiten, ist der erste blockierende Fehler ein Lizenzproblem — falsche Domain, abgelaufene Trial oder Lizenz für den falschen Shop-Typ.

Die drei häufigsten Lizenz-Fehler, die wir in der Praxis sehen:

• →Falsche oder fehlende Domain: Die Lizenz ist erstellt, aber die URL im Kundencenter stimmt nicht mit der tatsächlichen Shop-Domain überein. Folge: Der Abgleich startet, schlägt dann aber mit einem Domain-Mismatch-Fehler fehl.
• →Trial-Ablauf nicht bemerkt: Die Trial-Lizenz läuft ohne automatische Erinnerung ab. Der Abgleich bricht plötzlich ab, obwohl er vorher funktioniert hat. Viele Händler suchen den Fehler zuerst im Connector oder in JTL-Wawi.
• →Falscher Connector-Typ gewählt: Wer einen WooCommerce-Shop hat und versehentlich eine Shopware-Connector-Lizenz anlegt, bekommt beim Abgleich keine sinnvolle Fehlermeldung — die Verbindung schlägt schlicht fehl.

Die gute Nachricht: Alle drei Fehler sind vermeidbar, wenn du die Lizenz einmal sauber im Kundencenter anlegst. Wie das geht, zeigt der folgende Ablauf.

Die Ursachen liegen selten an der Technik. Meistens liegt es daran, dass das Kundencenter und die Shop-Installation zwei getrennte Welten sind und der Zusammenhang zwischen beiden nicht immer klar ist.

primary

Das Kundencenter ist getrennt vom Shop

JTL-Wawi, JTL-Shop und das Kundencenter sind drei verschiedene Systeme. Die Lizenz lebt im Kundencenter: nicht im Shop-Adminbereich, nicht in JTL-Wawi. Wer die Lizenz dort sucht, sucht vergebens.

Besonders bei Händlern, die den Connector zum ersten Mal einrichten, ist das Kundencenter noch unbekanntes Terrain. Der Weg dorthin führt über kundencenter.jtl-software.de — mit denselben JTL-Zugangsdaten die auch für das Forum und andere JTL-Dienste gelten.

warning

Domain-Eingabe ist nicht selbsterklärend

Das Kundencenter fragt nach der Shop-Domain, allerdings in einem Format, das viele Händler falsch eingeben. Richtig ist: die Domain ohne ‚https://‘, ohne ‚www.‘ (wenn der Shop ohne ‚www.‘ erreichbar ist) und ohne jegliches Unterverzeichnis.

Ein häufiger Fehler im JTL-Forum: Händler tragen die vollständige Connector-URL ein, also z.B. ‚mein-shop.de/jtlconnector/‘. Das System schneidet den Pfad normalerweise automatisch ab — passiert das nicht, muss man die Eingabe wiederholen. Laut JTL-Support: ‚Sollte die URL im Kundencenter mit jtlconnector enden, bitte noch einmal neu eingeben.‘

highlight

Trial-Lizenz läuft ohne Hinweis ab

Die Trial-Lizenz für den JTL Connector ist in der Regel einmalig verfügbar und auf einen bestimmten Zeitraum begrenzt. Wenn sie abläuft, erscheint in JTL-Wawi die Meldung: ‚Die Connector-Lizenz ist abgelaufen. Onlineshop-Abgleich beendet.‘

Es gibt keine automatische Verlängerung und keinen E-Mail-Hinweis kurz vor Ablauf. Wer die Trial zu Testzwecken genutzt hat und dann in den Produktivbetrieb geht, muss die Vollizenz aktiv im Kundencenter buchen. Laut JTL-Dokumentation läuft die Aktualisierung dann innerhalb weniger Minuten durch.

muted

Domain-Änderung nur alle 24 Stunden möglich

Wenn du die Domain im Kundencenter nachträglich ändern musst (etwa weil du sie zunächst falsch eingetragen hast), gilt eine Sperre: Änderungen sind nur alle 24 Stunden möglich.

Das bedeutet im Ernstfall: Du trägst die falsche Domain ein, merkst es sofort, kannst aber erst am nächsten Tag korrigieren. Der Abgleich bleibt in der Zwischenzeit blockiert. Prüfe die Domain daher genau, bevor du das Formular zum ersten Mal absendest.

Erster Abgleich läuft ohne Fehlersuche durch

Wer die Lizenz einmal sauber im Kundencenter anlegt (richtige Domain, richtiger Connector-Typ, Vollizenz statt Trial), startet den ersten Abgleich ohne Unterbrechung. Kein Domain-Mismatch, kein Lizenz-Fehler, kein Debugging. In unseren Projekten ist das der Unterschied zwischen einem Einrichtungstag ohne Verzögerung und einem bei dem die Lizenz erst nachträglich korrigiert werden muss — mit allem was dazugehört.

Kein Produktivausfall durch abgelaufene Trial

Wer die Trial rechtzeitig in eine Vollizenz umwandelt, hat keinen erzwungenen Stopp im Shop-Abgleich. Klingt einfach, in der Praxis passiert es trotzdem regelmäßig. Ein Händler im JTL-Forum beschreibt es so: ‚Ich hab erst gemerkt dass die Trial weg war als plötzlich keine Bestellungen mehr reinkamen.‘ Mit einer Vollizenz und der Bestätigung im Kundencenter bleibt der Abgleich durchgängig stabil.

Der folgende Ablauf gilt für alle gängigen JTL Connector-Typen: WooCommerce, Shopware 6, Magento 2, PrestaShop und andere. Die Schritte im Kundencenter sind für alle identisch — lediglich der Connector-Typ, den du auswählst, unterscheidet sich.

Gehe zu kundencenter.jtl-software.de und melde dich mit deinen JTL-Zugangsdaten an. Das sind dieselben Zugangsdaten die du auch für das JTL-Forum und andere JTL-Dienste verwendest. Falls du noch kein Konto hast, musst du es zunächst anlegen — ohne Kundencenter-Konto gibt es keine Connector-Lizenz.

Gehe nach der Anmeldung zu ‚Bestellungen & Lizenzen‘ und dann zu ‚Shop-Connectoren‘. Du siehst dort eine Übersicht aller verfügbaren Connector-Typen. Wähle den Typ aus, der zu deinem Shopsystem passt — also z.B. ‚JTL-Connector für WooCommerce‘ wenn du einen WooCommerce-Shop betreibst. Ein Händler im JTL-Forum: ‚Ich hab ewig gesucht, bis ich gemerkt hab dass ich einfach den falschen Connector-Typ gewählt hatte.‘

Klicke auf ‚Connector einrichten‘ beim gewählten Connector-Typ. Das System fragt nach der Domain deines Shops. Trage dort die exakte Shop-URL ein — ohne führendes ‚https://‘, ohne Unterverzeichnis, ohne ‚/jtlconnector/‘ am Ende. Beispiel: ‚mein-shop.de‘ oder ’shop.mein-unternehmen.de‘. Akzeptiere die AGB und bestätige mit ‚Jetzt erstellen‘. Die vollständige Anleitung zur Lizenz-Erstellung findest du auch in der JTL-Guide Lizenz-Dokumentation.

Öffne JTL-Wawi und gehe zu ‚Hilfe/Lizenzen‘ und dann zu ‚Lizenzen‘. Unter ‚Meine Lizenzen für JTL-Wawi‘ sollte die neue Connector-Lizenz erscheinen. Wenn sie noch nicht angezeigt wird: Klicke auf ‚Lizenzen aktualisieren‘. Laut JTL-Dokumentation werden neue Lizenzen alle 5 Minuten synchronisiert — bei Änderungen kann es bis zu 20 Minuten dauern. Weitere Details zum Sync-Verhalten findest du in den JTL-Kundencenter-FAQ zu Lizenzen.

Starte in JTL-Wawi einen manuellen Abgleich mit dem Shop. Wenn die Lizenz korrekt hinterlegt ist und die Domain stimmt, läuft der erste Abgleich ohne Lizenz-Fehlermeldung durch. Falls JTL-Wawi die Meldung ‚Die Lizenzdaten sind ungültig‘ oder ‚Domain stimmt nicht überein‘ meldet: Prüfe die eingetragene Domain im Kundencenter zeichengenau. Beachte auch: Firewall und VPN können den Lizenz-Abgleich blockieren — teste bei Problemen über eine direkte Verbindung.

Autor

Alexander Luft

JTL Service Partner Gold · Vlarom E-Commerce Agentur · Ahrensfelde bei Berlin