JTL-Anbindung über SQL-Direkt

Warum SQL-Direkt?

BISConnect — der JTL-Wawi-Bridge-Desktop-Client — bietet zwei Verbindungsmodi. Bei SQL-Direkt verbindet sich BISConnect unmittelbar mit der MSSQL-Datenbank Ihrer JTL-Wawi (Standard-Datenbank eazybusiness). Genau dafür ist dieser Modus in BISConnect als „SQL-Direkt (empfohlen)" gekennzeichnet.

In BISConnect lautet der Untertitel dieses Modus: „Direkte Verbindung zur JTL-Datenbank. Volle Kontrolle, schneller Sync." Für die meisten Betriebe ist SQL-Direkt die richtige Wahl — Sie müssen weder den JTL REST API Server starten noch eine App-Registrierung in JTL-Wawi anlegen.

SQL-Direkt im Überblick

Voraussetzungen

Bevor Sie die SQL-Direkt-Anbindung einrichten, stellen Sie sicher, dass folgende Voraussetzungen erfüllt sind:

SQL-Benutzer für BISConnect anlegen

Legen Sie für BISConnect einen eigenen SQL-Benutzer an — mit Lese-, Schreib- und Ausführungsrechten auf die JTL-Datenbank (eazybusiness), aber ohne die Rolle sysadmin. BISConnect liest und schreibt (Bestand, Bons, Wareneingang) und ruft gespeicherte Prozeduren von JTL auf. Ein Nur-Lese-Benutzer besteht den Verbindungstest, scheitert danach aber an jedem Schreibweg. Strukturänderungen an der Datenbank (Tabellen anlegen oder ändern) braucht BISConnect nicht.

Schritt für Schritt mit SQL Server Management Studio

1. Öffnen Sie SQL Server Management Studio (wird bei JTL nicht mitinstalliert, ist aber bei Microsoft kostenlos zu laden) und melden Sie sich mit einem Administratorkonto am SQL Server Ihrer JTL-Wawi an. Als Servername tragen Sie den Rechnernamen und die Instanz ein, z. B. MEIN-SERVER\JTLWAWI (derselbe Wert wie Host und Instanzname in Schritt 4). Ihr Systemadministrator oder JTL-Betreuer hilft Ihnen dabei.
2. Klicken Sie auf Neue Abfrage und fügen Sie den SQL-Block unten ein.
3. Ersetzen Sie HIER_EIGENES_STARKES_PASSWORT durch Ihr eigenes Passwort. Passt der Datenbankname nicht, ersetzen Sie eazybusiness durch den Namen Ihrer JTL-Datenbank. Bindet BIS mehrere JTL-Datenbanken an (z. B. eazybusiness_tm2), wiederholen Sie die Befehle ab USE (Schritt 2 bis 4 im Block) in jeder weiteren Datenbank; den Login (Schritt 1 im Block) legen Sie nur einmal an.
4. Klicken Sie auf Ausführen. Es sollte keine Fehlermeldung erscheinen.
5. Tragen Sie in BISConnect (Schritt 4) den Benutzernamen bisconnect und Ihr Passwort ein.

SQL-Block zum Kopieren

-- 1. Login auf dem SQL Server
CREATE LOGIN [bisconnect] WITH PASSWORD = N'HIER_EIGENES_STARKES_PASSWORT',
    CHECK_POLICY = ON, DEFAULT_DATABASE = [eazybusiness];
GO

-- 2. Benutzer in der JTL-Datenbank
USE [eazybusiness];
GO
CREATE USER [bisconnect] FOR LOGIN [bisconnect];
GO

-- 3. Lesen und Schreiben in allen Tabellen
ALTER ROLE [db_datareader] ADD MEMBER [bisconnect];
ALTER ROLE [db_datawriter] ADD MEMBER [bisconnect];
GO

-- 4. Gespeicherte Prozeduren ausführen (datenbankweit)
GRANT EXECUTE TO [bisconnect];
GO

Der letzte Befehl erlaubt das Ausführen der gespeicherten Prozeduren in allen Bereichen der JTL-Datenbank. Das ist nötig, weil JTL seine Prozeduren auf mehrere Bereiche verteilt (unter anderem dbo, Verkauf, Rechnung und Kunde) und neue JTL-Versionen weitere hinzufügen können. So müssen Sie die Rechte nach einem JTL-Update nicht nachziehen.

Einrichtung

Die SQL-Direkt-Anbindung richten Sie in BISConnect und im BISpicy-Verbindungsdialog ein — folgen Sie den Schritten der Reihe nach.

1BISConnect installieren und öffnen

BISConnect ist die Brücke zwischen Ihrer lokal installierten JTL-Wawi und der BISpicy-Cloud. Installieren Sie BISConnect auf dem JTL-Server (oder einem Rechner, der die JTL-Datenbank erreicht).

Nur einmal je Firma: BISConnect brauchen Sie nur einmal für Ihre Firma. Installieren Sie es auf dem Rechner, auf dem Ihre JTL-Datenbank liegt, oder auf einem Rechner, der immer eingeschaltet ist und die Datenbank erreicht. Auf weiteren Rechnern ist BISConnect nicht nötig. Ist es doch auf mehreren Rechnern installiert, listet die JTL-Seite im Kundencenter (Anbindungen → JTL-Wawi) und in BIS ERP jeden Rechner. Genutzt wird nur einer („wird genutzt“), die anderen bekommen keine Aufträge und können deinstalliert werden (Bild und Erklärung).

BISConnect für Windows herunterladen aktuelle Version: bispicy.com/downloads

Windows blockiert die Installation? Beim Öffnen der heruntergeladenen Datei meldet Windows unter Umständen: "Diese Datei stammt von einem anderen Computer. Der Zugriff wurde aus Sicherheitsgründen eventuell blockiert." Das ist bei heruntergeladenen Programmen normal und kein Hinweis auf Schadsoftware. So heben Sie die Blockierung auf:

1. Rechtsklick auf die Datei BISConnect-Setup.exe → Eigenschaften
2. Im Reiter Allgemein ganz unten im Bereich Sicherheit das Kästchen "Zulassen" anhaken
3. Mit OK bestätigen — danach lässt sich BISConnect normal installieren

Datei-Eigenschaften — unten rechts das Kästchen "Zulassen" anhaken

Starten Sie BISConnect. Die Kopfzeile zeigt den aktuellen Verbindungsstatus an („Verbunden" bzw. ein Button „Trennen"). Oben finden Sie die Tabs Status, Protokoll, Einstellungen und Kitchen-Bridge.

2BISConnect-Token in BISpicy generieren

Damit BISConnect weiß, zu welchem Konto es gehört, koppeln Sie es über einen Token mit Ihrem BISpicy-Konto. Den Token erzeugen Sie im BISpicy-Verbindungsdialog und fügen ihn in BISConnect ein.

Verbindungsdialog in BISpicy öffnen

Öffnen Sie die JTL-Integration in BISpicy:

• BIS ERP: Einstellungen → Verkaufskanäle & Anbindungen → JTL-Wawi (ausführlich mit Bild: JTL-Wawi in BIS ERP)
• Kundencenter: Anbindungen → JTL-Wawi

Klicken Sie auf "Mit JTL verbinden". Tragen Sie im Dialog den Verbindungsnamen und die Server-Adresse Ihrer JTL-Wawi ein und aktivieren Sie den Schalter "JTL-Wawi On-Premise" — die SQL-Direkt-Anbindung setzt eine lokal installierte JTL-Wawi voraus.

BISpicy Verbindungsdialog — im gelben Hinweisfeld der Button „Token generieren"

Token generieren und in BISConnect einfügen

Für eine On-Premise-Anbindung zeigt der Dialog den Hinweis „BISConnect Client nicht verbunden" mit einer kurzen Anleitung. Gehen Sie so vor:

1. Klicken Sie im Dialog auf "Token generieren".
2. Kopieren Sie den erzeugten Token.
3. Fügen Sie den Token in BISConnect ein.

Der Token verknüpft BISConnect fest mit Ihrem BISpicy-Konto. Lassen Sie den Verbindungsdialog geöffnet — nachdem BISConnect verbunden ist, kehren Sie für den Abschluss („Status aktualisieren", Schritt 6) hierher zurück.

3In BISConnect den Modus „SQL-Direkt" wählen

Wechseln Sie in BISConnect auf den Tab Einstellungen. Dort befindet sich oben ein Umschalter für den Verbindungsmodus für SQL-Direkt:

Umschalter-Option	Untertitel in BISConnect
SQL-Direkt (empfohlen)	Direkte Verbindung zur JTL-Datenbank. Volle Kontrolle, schneller Sync.

Wählen Sie „SQL-Direkt (empfohlen)". BISConnect blendet daraufhin den Konfigurationsbereich „MSSQL-Datenbank" ein.

BISConnect — Tab Einstellungen mit dem Modus „SQL-Direkt" (Benutzername im Bild bewusst ausgeblendet; was dort einzutragen ist, steht in Schritt 4)

App-Einstellungen in BISConnect

Im Tab Einstellungen finden Sie zusätzlich den Bereich „App-Einstellungen". Damit BISConnect die Anbindung im laufenden Betrieb zuverlässig aufrechterhält, empfehlen wir folgende Optionen:

Wie geht es weiter?

Sobald BISConnect verbunden ist, erfolgt die weitere Konfiguration unabhängig vom gewählten Anbindungsmodus. Die folgenden Themen sind auf der Einstiegsseite JTL-Wawi Integration beschrieben:

• Sync-Konfiguration — Sync-Richtung pro Datentyp festlegen
• Feld-Mapping — wie BISpicy-Felder auf JTL-Felder abgebildet werden
• Kassenapp verbinden — die POS-App mit demselben Konto anmelden
• Auto-Sync — Intervall und Sync-Protokoll
• Rechnungskauf an der Kasse — Rechnungsdruck über einen JTL-Workflow

Fehlerbehebung (SQL-Direkt)

Nachfolgend finden Sie Lösungen für die häufigsten Probleme der SQL-Direkt-Anbindung. Allgemeine Sync-Probleme (Produkte, Bestand) sind in der Fehlerbehebung der Einstiegsseite beschrieben.

"Verbindung fehlgeschlagen" (SQL-Direkt)

Verbindungstest erfolgreich, aber Schreibjobs scheitern

"BISConnect zeigt nicht ‚Verbunden'"

Weitere Hilfe

Wenn Sie ein Problem nicht lösen können, kontaktieren Sie unseren Support: