Wissen · Grundlagen

JTL-Wawi: Lesezugang für n8n einrichten

Die Baupläne lesen Artikel und Bestellungen direkt aus der Datenbank deiner JTL-Wawi. Dafür bekommt n8n einen eigenen Login, der nur lesen darf. Hier steht, wie du ihn anlegst, wie n8n den SQL-Server erreicht und welche anderen Wege es gibt.

Geprüft am 02.11.2026. Grundlage sind JTL-Guide, Microsoft-Doku zu SQL Server und die n8n-Doku zum Microsoft-SQL-Zugang.

01 · Wege

Zwei Wege zu den Daten der Wawi

Weg 1, nutzen die Baupläne

SQL-Login nur zum Lesen

n8n verbindet sich mit dem Microsoft-SQL-Knoten direkt mit der Datenbank eazybusiness und liest per SELECT. Schnell eingerichtet, braucht aber Netzwerkzugang zum SQL-Server.

Weg 2

JTL-Wawi REST-API

Die offizielle Schnittstelle von JTL zum Lesen und Ändern von Aufträgen, Artikeln, Kunden, Rechnungen und Beständen. Die App wird in der Wawi unter „Admin“, „App-Registrierung“ freigegeben. n8n spricht sie über den Knoten „HTTP Request“ an. Prüf vorher bei JTL, was für deine Wawi-Version gilt.

Meine RegelLesen über einen reinen Lesezugang, schreiben nur über die offizielle Schnittstelle der Wawi, nie direkt in die Tabellen. Direktes Schreiben umgeht die Prüfungen der Wawi. Die Baupläne schreiben deshalb gar nicht in die Wawi.
02 · Warum nur lesend

Was ein reiner Lesezugang schützt

Die feste Datenbankrolle db_datareader darf laut Microsoft alle Daten aus allen Benutzertabellen und Sichten lesen, sonst nichts. Ein Login nur mit dieser Rolle kann nichts einfügen, ändern oder löschen, auch wenn ein Ablauf einen Fehler hat. Lesen kann er aber alles, auch Kunden- und Bestelldaten. Schütz das Passwort deshalb gut.

Nimm nie den Login, mit dem die Wawi selbst arbeitet, und nie den Administrator sa. Der Wawi-Login hat laut JTL-Guide db_owner-Rechte auf allen Wawi-Datenbanken.

03 · Login anlegen

SQL-Login anlegen, der nur lesen darf

Das erledigt, wer den SQL-Server betreut, im SQL Server Management Studio als Administrator:

  1. Neue Anmeldung. Im Objekt-Explorer „Sicherheit“, Rechtsklick auf „Anmeldungen“, „Neue Anmeldung“.
  2. SQL-Server-Authentifizierung wählen. Einen eigenen Namen vergeben, zum Beispiel n8n_lesen, und ein langes, zufälliges Passwort.
  3. Serverrollen. Nur public.
  4. Benutzerzuordnung. Die Datenbank eazybusiness anhaken, bei mehreren Mandanten auch deren Datenbanken. Als Rollen nur db_datareader und public.
    Geklappt, wenn: Mit OK ist der Login angelegt.

Oder als SQL-Befehl, Passwort selbst einsetzen. Bei mehreren Mandanten die letzten drei Zeilen für jede Mandanten-Datenbank wiederholen:

CREATE LOGIN n8n_lesen WITH PASSWORD = '<langes Passwort>';
USE eazybusiness;
CREATE USER n8n_lesen FOR LOGIN n8n_lesen;
ALTER ROLE db_datareader ADD MEMBER n8n_lesen;
04 · Netzwerk

Wie n8n den SQL-Server erreicht

Die Wawi-Datenbank läuft meist in der Instanz JTLWAWI auf einem Windows-Rechner im Büro oder auf einem Server. n8n muss diesen Rechner über das Netz erreichen:

  1. TCP/IP einschalten. Im SQL Server Configuration Manager unter „SQL Server-Netzwerkkonfiguration“, „Protokolle für JTLWAWI“ das Protokoll TCP/IP aktivieren.
  2. Festen Port vergeben. In den Eigenschaften von TCP/IP, Reiter „IP-Adressen“, ganz unten bei „IPAll“ einen festen TCP-Port eintragen und „Dynamische TCP-Ports“ leeren. Benannte Instanzen nutzen sonst wechselnde Ports.
  3. SQL-Server-Dienst neu starten. Damit der Port gilt. Das unterbricht die Wawi kurz, also außerhalb der Arbeitszeit.
  4. Firewall freigeben. In der Windows-Firewall eine eingehende Regel für diesen TCP-Port anlegen.
Den Port nicht für das ganze Internet öffnenErlaube den Zugriff nur für deinen n8n-Server, am besten über ein VPN oder ein gemeinsames Netz. Einen anderen Port als 1433 zu wählen, schützt laut Microsoft nicht wirklich, weil Port-Scanner offene Ports finden.
05 · Zugang in n8n

Zugang „Microsoft SQL“ in n8n anlegen

Server

Name oder Adresse des Rechners mit dem SQL-Server. Bei einer benannten Instanz steht laut n8n-Doku der Host vor dem Instanznamen, also HOST\JTLWAWI. Hast du in Abschnitt 04 einen festen Port vergeben, trägst du nur den Rechnernamen ein und den Port im Feld Port.

Database

Die Wawi-Datenbank, meist eazybusiness.

User und Password

Der eben angelegte Login, zum Beispiel n8n_lesen.

Port

Der feste Port aus Abschnitt 04. Standard bei SQL Server ist 1433.

Domain

Leer lassen. Die Domain brauchst du nur für Windows-Anmeldung, der Lesezugang nutzt SQL-Anmeldung.

TLS und TDS Version

TLS nach Einstellung deines Servers. Die TDS-Version passend zur SQL-Server-Version wählen, 7_4 gilt laut n8n für SQL Server 2012 bis 2019. Passt sie nicht, handelt die Verbindung eine andere aus.

06 · Test

Test und Fertig-Check

Leg in n8n einen Knoten „Microsoft SQL“ mit der Aktion „Execute Query“ an und führ diese Abfrage aus:

SELECT DB_NAME() AS datenbank,
       IS_ROLEMEMBER('db_datareader') AS darf_lesen,
       IS_ROLEMEMBER('db_datawriter') AS darf_schreiben,
       IS_ROLEMEMBER('db_owner') AS ist_owner;
Geklappt, wennDie Abfrage liefert eazybusiness, darf_lesen 1, darf_schreiben 0 und ist_owner 0. Dann steht der Zugang und er darf nur lesen. Danach zeigt Ablauf 00 eines Bauplans die Zahl der Artikel.
07 · Baupläne

Welche Baupläne das brauchen

Alle drei Baupläne lesen aus der Wawi und brauchen diesen Zugang:

Lieber machen lassen? Ich verbinde Wawi, Shop und Tools, siehe Marketing-Automatisierung.

08 · Quellen

Quellen

Erstgespräch

Lieber machen lassen?

In einem kostenlosen 20-Minuten-Gespräch klären wir, was du brauchst und ob ich der Richtige dafür bin.

Erstgespräch anfragen →

Für ein kostenloses Erstgespräch (20 Minuten über Google Meet) schreib mir kurz über das Kontaktformular. Ich schlage dir dann einen Termin vor.