JTL-Administrator Oberfläche mit geöffnetem Dialog zum Einrichten einer JTL-Wawi API-Instanz

JTL-Wawi API einrichten: Instanz anlegen, Anwendung anbinden, Zugangsdaten konfigurieren

Die JTL-Wawi API einrichten ist der erste Schritt für alles was über die Standardoberfläche hinausgeht: eigene Anwendungen anbinden, automatisierte Prozesse steuern, externe Systeme direkt mit der Warenwirtschaft verbinden. Seit JTL-Wawi 1.10 ist die REST-Schnittstelle fester Bestandteil der Software. Die Einrichtung hat aber ein paar Fallstricke die man kennen sollte, bevor man losläuft. Lizenz buchen, Instanz anlegen, Anwendung registrieren: diese drei Phasen bauen aufeinander auf, und ein übersprungener Schritt kostet im schlechtesten Fall mehrere Stunden Fehlersuche.

Du willst eine eigene Anwendung an die JTL-Wawi anbinden und weißt noch nicht genau wie der Ablauf aussieht?

Dieser Beitrag zeigt dir den vollständigen Ablauf: von der Lizenzaktivierung über die Instanz-Konfiguration im JTL-Administrator bis zur Anwendungsregistrierung und dem ersten API-Token.

Auf einen Blick

  • ✓Die JTL-Wawi API einrichten bedeutet drei Schritte: Lizenz im Kundencenter aktivieren, Instanz im JTL-Administrator anlegen, Anwendung über Admin > App-Registrierung anbinden. Bei Vlarom E-Commerce Agentur nutzen wir diesen Ablauf für alle eigenen API-Konnektor-Projekte.
  • ✓Die Instanz läuft auf einem frei wählbaren Port (Standard: 5883), per SSL absicherbar, und lässt sich sowohl manuell als auch als Windows-Dienst mit automatischem Start betreiben.
  • ✓Wichtig: Die App-Registrierung funktioniert nur in der neuen JTL-Wawi-Oberfläche. Als JTL Service Partner Gold sehen wir schon mehrfach, dass Händler vergeblich in der alten Ansicht suchen.

Wir entwickeln seit Jahren maßgeschneiderte API-Konnektoren für JTL-Wawi. Zum Beispiel für einen Dampfartikel-Händler, bei dem wir eine vollständige Produktdaten-Synchronisation über die REST-Schnittstelle realisiert haben. Die JTL-Wawi API ist unser täglich genutztes Werkzeug, nicht nur Theorie. Als Vlarom E-Commerce Agentur und JTL Service Partner Gold begleiten wir Händler bei der technischen Integration, von der ersten API-Instanz bis zum produktiven Einsatz. Was wir dabei immer wieder feststellen: Die technischen Hürden liegen seltener in der API selbst, sondern meist in der Vorbereitung. Wer Lizenz, Instanz-Konfiguration und App-Registrierung als zusammenhängenden Ablauf versteht, kommt deutlich schneller ans Ziel.

JTL-Wawi API einrichten: der vollständige Ablauf in 5 Schritten

Der folgende Ablauf basiert auf der offiziellen JTL-Dokumentation und unserer Projekterfahrung. Voraussetzung ist eine laufende JTL-Wawi-Installation ab Version 1.10. Für ältere Versionen gibt es eine Kommandozeilen-Alternative, aber ein Update auf eine aktuelle Version ist die stabilere Grundlage für API-Projekte. Die fünf Schritte sind so aufgebaut, dass du sie direkt am System nachvollziehen kannst, auch ohne Vorkenntnisse in REST-API-Entwicklung. Für die eigentliche Integration deiner Anwendung brauchst du zusätzlich die Developer-Dokumentation unter developer.jtl-software.com, aber der Einrichtungs-Ablauf selbst ist rein konfigurativ.

Lizenz im JTL-Kundencenter aktivieren

Die JTL-Wawi API ist kein automatischer Bestandteil jeder Wawi-Lizenz, du musst sie separat aktivieren. Melde dich im JTL-Kundencenter an und gehe zu Bestellungen & Lizenzen > Warenwirtschaft > Module. Dort buchst du das Modul JTL-Wawi API. Aktuell befindet sich die API noch in der Open-Beta-Phase und ist kostenfrei nutzbar. Der häufigste Fehler den wir sehen: Händler versuchen eine Instanz anzulegen bevor die Lizenz wirklich aktiv ist. Der JTL-Administrator zeigt dann schlicht keine API-Option an. Details zur Buchung: JTL-Guide zur API-Lizenz

Instanz im JTL-Administrator anlegen

Öffne den JTL-Administrator über das Windows-Startmenü. Klicke auf Anlegen und wähle Wawi-App. Jetzt konfigurierst du die Instanz: Instanzname (frei wählbar, z.B. MeinShop-API), Profil (Standard reicht für die meisten Anwendungsfälle), Mandant (üblicherweise eB-Standard in Standardinstallationen), Schnittstelle (127.0.0.1 für lokalen Zugriff, lokale IP für Netzwerkzugriff, 0.0.0.0 für alle Schnittstellen), Port (Standard 5883, sicherstellen dass kein anderes Programm diesen Port belegt) und Zertifikat (selbst-signiert generieren oder eigenes importieren). Für den automatischen Start als Windows-Dienst aktivierst du die entsprechende Option in den Service-Einstellungen. Vollständige Feldübersicht: JTL-Guide zur Instanz-Einrichtung

Instanz starten und Erreichbarkeit prüfen

Nach dem Speichern kannst du die Instanz direkt aus dem JTL-Administrator heraus starten. Wähle die angelegte Instanz in der Liste und klicke auf Starten. Der REST-Server läuft dann unter der konfigurierten IP und dem Port, zum Beispiel unter https://127.0.0.1:5883. Ein erster Funktionstest: Ruf die Swagger-UI im Browser auf (https://[IP]:[Port]/swagger). Wenn die interaktive API-Dokumentation erscheint, läuft die Instanz korrekt und du kannst die verfügbaren Endpunkte direkt im Browser erkunden. Hast du die Schnittstelle auf eine lokale Netzwerk-IP gesetzt, denke an die Firewall-Einstellungen. Der JTL-Administrator bietet eine Checkbox um die Windows-Defender-Regel automatisch anzulegen. Ohne diese Regel blockiert Windows den eingehenden Traffic auf dem API-Port, und die Anwendung auf einem anderen Rechner im Netzwerk bekommt keine Verbindung. Notiere dir nach dem Start die vollständige Basis-URL der Instanz: du brauchst sie bei der App-Registrierung im nächsten Schritt.

Anwendung über App-Registrierung anbinden

Die eigentliche Anbindung deiner Anwendung erfolgt in JTL-Wawi selbst, nicht im JTL-Administrator. Wechsle in die neue JTL-Wawi-Oberfläche (die App-Registrierung steht nur dort zur Verfügung) und öffne Admin > App-Registrierung. Klicke auf Hinzufügen um den Registrierungs-Assistenten zu starten. Der Assistent wartet darauf, dass deine Anwendung eine Registrierungsanfrage über die API schickt (details zur appRegistration-Anfrage findest du in der Developer-Dokumentation). Nach Eingang der Anfrage siehst du die Anwendungsdaten, vergibst einen dedizierten Benutzernamen (getrennt von deinem eigenen JTL-Wawi-Konto) und wählst die benötigten Berechtigungen (Scopes) aus. Die Scope-Auswahl ist wichtig: vergib nur die Rechte die deine Anwendung wirklich braucht. Lese-Scopes für reine Datenabrufe, Schreib-Scopes nur wenn die Anwendung Daten in JTL-Wawi zurückschreiben soll. Mit Fertigstellen schließt du die Registrierung ab und erhältst den API-Token, den deine Anwendung für alle weiteren API-Calls braucht.

Verbindung testen und Backup anlegen

Nach der Registrierung testest du die Verbindung mit einem einfachen API-Call aus deiner Anwendung heraus. Schlägt der erste Call durch, ist die Einrichtung abgeschlossen. Bevor du produktiv gehst, lege ein Backup der JTL-Wawi-Datenbank an. Schreibende Operationen über die API wirken direkt auf den Datenbestand. Ohne Backup gibt es keinen sicheren Rückweg wenn etwas schiefläuft. Wir sehen in unserer Projektarbeit regelmäßig, dass dieser Schritt übersprungen wird und dann bei Fehlern viel Zeit verloren geht. Die Integration zuerst in einer Test-Umgebung zu validieren, bevor du PUT-, POST- oder DELETE-Calls produktiv schaltest, hat sich in jedem Projekt bewährt.

Häufige Fragen zur JTL-Wawi API

Was ist die JTL-Wawi API und wofür brauche ich sie?

Die JTL-Wawi API ist eine REST-konforme Schnittstelle, die JTL-Wawi für externe Anwendungen und Drittsysteme öffnet. Du brauchst sie wenn du eigene Anwendungen entwickeln oder anbinden willst, die direkt mit der Warenwirtschaft kommunizieren, zum Beispiel für automatisierte Preisanpassungen, externe Dashboards, individuelle Marktplatz-Konnektoren oder eigene Synchronisationslogik. Ohne die API bist du auf die vorkonfigurierten JTL-Schnittstellen beschränkt; mit ihr lässt sich nahezu jedes Drittsystem technisch anbinden. Als Vlarom E-Commerce Agentur entwickeln wir genau solche maßgeschneiderten Anbindungen für Händler, von einfachen Datenabrufen bis zu vollautomatisierten Prozessen.

Die JTL-Wawi API ist ab Version 1.10 integriert und auch in JTL-Wawi 2.0 enthalten. Für ältere Versionen gibt es eine Kommandozeilen-Variante, die aber deutlich eingeschränkter ist und weniger Konfigurationsoptionen bietet. JTL-Wawi 2.0 basiert auf .NET 8 und bringt eine stabilere Grundlage für langlebige API-Integrationen. Welche Version für das eigene Setup passt, hängt von den eingesetzten Connectoren und der Systemkonfiguration ab — das klärt Vlarom E-Commerce Agentur im Erstgespräch gerne.

Der Standardport der JTL-Wawi API ist 5883. Du kannst ihn bei der Instanz-Einrichtung im JTL-Administrator frei anpassen, solange kein anderes Programm auf dem gleichen Port läuft. Prüfe vorher mit dem Windows-Befehl netstat -ano ob der Port frei ist. Für Netzwerkzugriff musst du außerdem die Firewall-Einstellungen beachten. Der JTL-Administrator bietet eine Checkbox um die entsprechende Windows-Defender-Regel automatisch anzulegen. Bei Zugriff von außerhalb des lokalen Netzwerks kommen zusätzlich Router-Konfiguration und SSL-Absicherung ins Spiel.

Die App-Registrierung liegt in der neuen JTL-Wawi-Oberfläche unter Admin > App-Registrierung. Den Menüpunkt findest du nur in der neuen Oberfläche, nicht in der klassischen Ansicht. Das ist eben einer der häufigsten Reibungspunkte bei der Einrichtung: Händler suchen den Dialog in der alten Oberfläche und finden ihn nicht.

Beim manuellen Start wird die API-Instanz nur aktiv wenn du sie explizit im JTL-Administrator startest, sinnvoll für Entwicklungsumgebungen oder Tests. Der automatische Start richtet die Instanz als Windows-Dienst ein, der beim Systemstart automatisch hochfährt. Für Produktivumgebungen ist der automatische Start die richtige Wahl, sonst riskierst du nach einem Server-Neustart eine nicht erreichbare API und stillstehende angebundene Anwendungen. Es gibt noch eine dritte Variante: den Start über die Kommandozeile, vor allem als Fallback für ältere Wawi-Versionen oder Server-Setups ohne grafische Oberfläche.

Ja, mehrere Instanzen sind möglich, jede auf einem eigenen Port. Das macht Sinn wenn du verschiedene Anwendungen mit unterschiedlichen Zugriffsrechten oder Mandanten-Zuordnungen betreiben willst. Wir nutzen das in Projekten zum Beispiel um Staging- und Produktiv-Instanzen auf demselben Server zu trennen, ohne zwei separate JTL-Wawi-Installationen zu brauchen. Jede Instanz hat ihren eigenen Namen, Port und Satz registrierter Anwendungen. Die Ressourcenlast auf dem Server steigt mit jeder zusätzlichen Instanz — laufende Instanzen auf das tatsächlich benötigte Minimum zu begrenzen ist daher technisch sinnvoll.

Ja, die JTL-Wawi API muss im JTL-Kundencenter unter Bestellungen & Lizenzen > Warenwirtschaft > Module aktiviert werden. Aktuell ist sie im Rahmen der Open-Beta-Phase kostenfrei nutzbar. Du musst dazu dem Pilotprogramm beitreten und die Datenschutzvereinbarung akzeptieren. Die Konditionen nach dem offiziellen Release können sich ändern, daher die aktuellen Lizenzinformationen direkt im Kundencenter prüfen. Nicht alle Wawi-Editionen werden die API in gleichem Umfang unterstützen.

Du entwickelst eine Anbindung an JTL-Wawi oder brauchst einen fertigen Konnektor?

Vlarom entwickelt deinen API-Konnektor: von der ersten Instanz bis zum produktiven Einsatz.

Vlarom E-Commerce Agentur ist JTL Service Partner Gold in Ahrensfelde bei Berlin und entwickelt seit Jahren maßgeschneiderte API-Konnektoren für JTL-Wawi. Ob Marktplatz-Anbindung, externe Systemintegration oder individuelle Automatisierung: ruf uns direkt an unter +49 30 91473862, schreib an info@vlarom.de oder nutze unser Kontaktformular für eine erste Einschätzung.

Autor

Alexander Luft

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