JTL-Wawi Integration

Übersicht

Die JTL-Wawi Integration verbindet Ihre JTL-Warenwirtschaft mit BISpicy POS. Artikelstammdaten, Lagerbestände, Kundendaten und Verkäufe werden automatisch synchronisiert, sodass beide Systeme stets auf dem aktuellen Stand sind.

Was wird synchronisiert?

Unterstützte JTL-Versionen

Welche Anbindung?

Die Verbindung zu Ihrer lokal installierten JTL-Wawi läuft über BISConnect — den JTL-Wawi-Bridge-Desktop-Client. BISConnect bietet zwei Verbindungsmodi, die Sie über einen Umschalter im Tab „Einstellungen" wechseln können. Wählen Sie zuerst Ihren Modus — die detaillierte Schritt-für-Schritt-Anleitung steht dann jeweils auf einer eigenen Seite.

SQL-Direkt und der stillgelegte REST-Weg im Vergleich

Voraussetzungen

Diese Voraussetzungen gelten für beide Anbindungsarten. Die modusspezifischen Voraussetzungen stehen jeweils im passenden Einrichtungs-Guide.

Einrichtung

Die Schritt-für-Schritt-Einrichtung hängt vom gewählten Verbindungsmodus ab (siehe Welche Anbindung?). Wählen Sie die zu Ihrem Modus passende Anleitung:

Sync-Konfiguration

Für jeden Datentyp können Sie die Sync-Richtung individuell festlegen. So behalten Sie die volle Kontrolle darüber, welches System die Datenhoheit hat.

Sync-Konfiguration — Richtung, letzter Sync und Status pro Datentyp

Verfügbare Sync-Richtungen

Empfohlene Konfigurationen

Feld-Mapping

Die folgende Tabelle zeigt, wie BISpicy-Felder auf JTL-Wawi-Felder abgebildet werden.

Produkte

Verkäufe (POS → JTL SalesOrders)

Kassenapp verbinden

Nachdem die JTL-Verbindung im Kundencenter eingerichtet ist, müssen Sie die BISpicy POS App mit dem gleichen Konto verbinden, damit die synchronisierten Artikel auf der Kasse erscheinen.

Anmeldung in der Kassenapp

Es gibt zwei Wege, sich mit Ihrem BISpicy-Konto in der Kassenapp anzumelden:

Option A: Im Einrichtungs-Wizard

Beim ersten Start der App erscheint der Einrichtungs-Wizard. Im Schritt "Ihr persönliches Kundencenter" können Sie sich direkt anmelden oder registrieren:

Login im Einrichtungs-Wizard der POS App

Option B: In den Einstellungen

Falls Sie den Wizard bereits abgeschlossen haben, finden Sie die Anmeldung unter:
Einstellungen → Steuern & Compliance → Kundenkonto & Lizenzen

Kundenkonto-Login in den App-Einstellungen

Verbindungsstatus prüfen

Nach der Anmeldung sehen Sie im gleichen Screen Ihre Kassen-Module und den Verbindungsstatus. Oben links neben dem Hamburger-Menü erscheint ein Statusindikator:

• ● Grün — Verbindung zum Kundencenter steht, Sync ist aktiv
• ● Rot — Noch keine aktive Sync-Verbindung

Angemeldet — grüner Punkt oben links zeigt aktive Verbindung

Artikel auf der Kasse prüfen

Nach der Anmeldung synchronisiert die Kassenapp automatisch die Artikel aus Ihrem Konto. So prüfen Sie, ob die JTL-Artikel angekommen sind:

1. Stellen Sie sicher, dass in der JTL-Integration "Artikel automatisch an Kasse" aktiviert ist
2. Lösen Sie ggf. einen manuellen Sync im Kundencenter aus (Button "Synchronisieren")
3. Öffnen Sie in der Kassenapp die Artikelübersicht — die JTL-Artikel sollten dort erscheinen
4. Erscheinen keine Artikel: Prüfen Sie unter Einstellungen → Sync ob die letzte Synchronisierung erfolgreich war

Sync-Intervall in der Kassenapp

Standardmäßig synchronisiert die Kassenapp alle 15 Minuten mit dem Kundencenter. Sie können das Intervall anpassen unter:

Einstellungen → Daten & Sicherung → Sync-Intervall

Sync-Intervall unter Einstellungen → Daten & Sicherung anpassen

Auto-Sync

Der automatische Sync läuft serverseitig im Hintergrund und hält beide Systeme ohne manuellen Eingriff synchron.

Feld-Zuordnung, Datenhoheit, Auto-Sync Intervall und BISConnect Relay Status

Sync-Intervall

Ist der Auto-Sync aktiviert, wählen Sie das Intervall für den automatischen Abgleich:

Daneben legen Sie den Vollabgleich fest: nur manuell, alle 6, alle 12 oder alle 24 Stunden. Darunter steht, wann der letzte Vollabgleich lief.

Status und manueller Sync

In der Integrationsübersicht sehen Sie jederzeit:

• Letzter Sync: Zeitpunkt des letzten erfolgreichen Abgleichs
• Status: Erfolgreich, Fehlgeschlagen oder Ausstehend
• Synchronisierte Datensätze: Anzahl der geänderten Produkte, Kunden, Bestellungen etc.

Über den Button "Jetzt synchronisieren" können Sie jederzeit einen manuellen Sync auslösen, unabhängig vom konfigurierten Intervall.

Sync-Protokoll prüfen

Im Kundencenter unter Anbindungen → JTL-Wawi → Sync-Protokoll können Sie detailliert nachvollziehen, welche Daten synchronisiert wurden. Das Protokoll zeigt:

• Letzte Sync-Läufe — Zeitpunkt und Anzahl der verarbeiteten Einträge
• Einzelne Datensätze — Typ (Produkt, Bestellung, etc.), Aktion (Pull/Push), Richtung, Name/SKU und Status
• Filter — Nach Typ, Status oder Suchbegriff filtern

Sync-Protokoll — detaillierte Übersicht aller synchronisierten Datensätze

Wie schnell Preise aus JTL an die Kasse kommen

Preise warten nicht auf das Intervall der Kassenapp. Seit BISpicy 0.17.3.4 (12. November 2026) gilt: Ändert ein Abgleich Sonderpreise, Staffelpreise oder Preise je Kundengruppe aus JTL-Wawi, stößt BISpicy danach sofort Ihre Kassen an. Eine eingeschaltete Kasse mit Internetverbindung holt die neuen Preise dann innerhalb von Sekunden. Eine Kasse, die gerade ausgeschaltet oder offline ist, holt sie nach, sobald sie wieder verbunden ist.

Sonderpreise, die Sie in JTL-Wawi abschalten oder löschen, entfernt BISpicy beim Abgleich ebenfalls; danach gilt an der Kasse wieder der Preis aus JTL. Vorher konnte ein neuer Sonderpreis an der Kasse fehlen, bis sich am Artikel etwas anderes änderte, und ein in JTL abgeschalteter Sonderpreis blieb an der Kasse stehen.

Kommt ein neuer Preis trotzdem nicht an? Prüfen Sie, ob die Kasse online ist, ob der Sonderpreis in JTL-Wawi aktiv ist und sein Zeitraum heute schon begonnen hat, und ob der letzte Abgleich im Sync-Protokoll ohne Fehler durchgelaufen ist.

Bekannte Einschränkungen

Die folgenden Einschränkungen gelten für die REST-API-Anbindung. Die JTL-Wawi REST API (v1) ist noch im Beta-Stadium, und über sie läuft nur ein Teil des Abgleichs. Wo immer Ihre JTL-Datenbank erreichbar ist, richten Sie deshalb SQL-Direkt ein.

Ob und wann JTL-Software die REST API erweitert, liegt bei JTL. Für den Betrieb empfehlen wir SQL-Direkt.

Rechnungskauf an der Kasse

Wenn ein Kunde an der Kasse auf Rechnung kauft (Ware sofort mitnehmen, später bezahlen), übernimmt JTL-Wawi anschließend die Rechnungserstellung, den Druck und die Verwaltung des Zahlungseingangs. BISpicy POS legt den Auftrag in JTL an — ein Workflow in JTL kümmert sich vollautomatisch um den Rest.

So läuft ein Rechnungskauf End-to-End ab

1. An der Kasse: Der Kassierer wählt die Zahlart „Rechnung" (oder eine eigene Bezeichnung wie z. B. „Rechnung by Asia-In"). Voraussetzung: der Kunde ist im Bon ausgewählt — ein Laufkunde kann keine Rechnung erhalten.
2. BISpicy POS → BIS ERP: Der Bon wird an die ERP-Cloud gepusht und enthält das Flag isInvoicePayment = true.
3. BIS ERP → JTL-Wawi: Der Auftrag wird in JTL angelegt mit kZahlungsart = die in der Zahlungsarten-Zuordnung gewählte JTL-Rechnungs-Zahlart, nIstExterneRechnung = 0 (JTL verwaltet die Rechnung selbst) und offenen Positionen (fAnzahlOffen = qty, fAnzahlAufRechnung = 0).
4. BIS ERP → JTL Workflow-Queue: Direkt nach dem Auftrags-Insert legt BIS ERP einen Eintrag in der JTL-Workflow-Queue (dbo.tWorkflowQueue) für den im Kundencenter gewählten Workflow ab (Event „Auftrag erstellt").
5. JTL-Worker: Der JTL-Worker zieht den Queue-Eintrag und führt den Workflow aus — typischerweise Rechnung erstellen und Drucken.
6. Kunde nimmt die gedruckte Rechnung mit. Der Zahlungseingang wird in JTL ganz normal über Bankkonto-Import / OP-Liste verbucht — BIS ERP greift hier nicht mehr ein.

Einrichtung im BISpicy-Kundencenter

Im Kundencenter unter Anbindungen → JTL-Wawi gibt es zwei Bereiche, die für Rechnungskauf eingerichtet werden müssen.

1. Zahlungsarten-Zuordnung

In der Sektion Zahlungsarten-Zuordnung (JTL ↔ POS) die JTL-Rechnungs-Zahlart (z. B. „Rechnung" mit kZahlungsart = 7 oder eine kundenspezifische wie „Rechnung by Asia-In") auf die POS-Zahlart „rechnung" mappen. Ob ein Verkauf ein Rechnungskauf ist, erkennt BIS ERP an einem Kennzeichen — nicht am Namen der Zahlart: Eine Zahlart, die nur „Rechnung" im Namen trägt, aber kein Kennzeichen hat, wird wie eine Sofortzahlung gebucht. Bei einer Zahlart, die Ihre Kasse selbst führt (wie „rechnung"), legen Sie das Kennzeichen an der Kassen-Zahlart fest: Kundencenter → Verkauf → Zahlungsarten, Häkchen „Rechnungskauf" (oder Zahlart-Typ „Rechnung"). Das Häkchen „Rechnungskauf" in der Zuordnungstabelle wirkt nur für JTL-Zahlarten, die an der Kasse direkt angeboten werden (Spalte „An Kasse").

2. Workflow für Rechnungskauf

In der Sektion Workflow für Rechnungskauf an der Kasse aus dem Dropdown den JTL-Workflow auswählen, der nach jedem Rechnungskauf-Verkauf ausgeführt werden soll (z. B. „Rechnung Drucken"). Die Liste wird live aus der eigenen JTL-Datenbank geladen — es muss nichts manuell eingetragen werden.

Optional kann eine Verzögerung von 0 (sofort) oder 1 Minute nach Auftragsanlage gewählt werden. Mit 1 Minute hat JTL Zeit, alle Eckdaten zu indexieren, bevor der Workflow startet — in der Praxis funktioniert „sofort" zuverlässig.

Workflow-Konfiguration in JTL-Wawi

Der ausgewählte Workflow muss in JTL-Wawi unter Admin → Workflows → Aufträge → Auftrag - Erstellt angelegt sein. Empfohlene Konfiguration:

Sonstiges.Plattform.Name enthält BIS

Was BIS ERP automatisch macht

• Auftrags-Anlage: POS-Auftrag wird in JTL als ganz normaler Auftrag eingetragen (Plattform „BISpicy POS", Versandart „Selbstabholung", Lieferstatus „komplett ausgeliefert").
• Offene Posten erhalten: Anders als bei Sofortzahlung wird tAuftragEckdaten.fOffenerWert auf den Bruttobetrag gesetzt und kein tZahlung-Eintrag erzeugt — JTL erkennt den Auftrag korrekt als „noch zu fakturieren".
• Positionen offen für Rechnung: tAuftragPositionEckdaten.fAnzahlAufRechnung = 0 bei Rechnungskauf. Damit findet der „Rechnung erstellen"-Workflow eine offene Menge zum Fakturieren.
• Workflow-Queue-Insert: Direkt nach dem Auftrag wird ein Eintrag in dbo.tWorkflowQueue mit nEvent = 1 (Auftrag erstellt), kBenutzer = 1, kWorkflow = der gewählten ID und dStartDate = jetzt oder +1 Min angelegt.

Was Sie in JTL nach jedem Rechnungskauf sehen

• Ein neuer Auftrag in der Auftrags-Übersicht mit Plattform „BISpicy POS" und der Auftragsnummer (z. B. 1462092026A).
• Im Workflow-Log (Admin → Hintergrundprozesse → Workflow Log): Einträge wie „starte Workflow mit: 1462092026A" → „Rechnung 889942026R wurde erstellt" → „Ausgabemodus: Drucken Formular: Rechnung" → „Der Workflow wurde erfolgreich beendet".
• Eine neue Rechnung in der Rechnungs-Übersicht mit offenem Betrag.
• Den Druck auf Ihrem konfigurierten Drucker.

Zahlungseingang verbuchen

Sobald der Kunde die Rechnung bezahlt, verbuchen Sie den Zahlungseingang ganz normal in JTL — entweder manuell über die OP-Liste oder automatisch über den Bank-Import / DATEV-Anbindung. BIS ERP greift hier nicht mehr ein, weil der Auftrag mit nIstExterneRechnung = 0 angelegt wurde („JTL verwaltet die Rechnung selbst").

Fehlerbild „keine offenen Positionen"

Falls beim Workflow „Rechnung erstellen" die Meldung „Es existieren keine offenen Positionen mehr" erscheint, prüfen Sie:

• Wurde der Verkauf wirklich als Rechnungskauf gepusht? In den BIS-ERP-Sync-Logs muss isInvoicePayment = 1 stehen.
• Ist die Zahlart als Rechnungskauf gekennzeichnet? Bei einer Zahlart, die Ihre Kasse selbst führt, am Haken „Rechnungskauf" der Kassen-Zahlart (Kundencenter → Verkauf → Zahlungsarten), bei einer JTL-Zahlart, die an der Kasse direkt angeboten wird, in der Zahlungsarten-Zuordnung. Der Name der Zahlart reicht nicht.
• BIS ERP ab Version 0.0.0.61 setzt fAnzahlAufRechnung = 0 bei Rechnungskauf korrekt — ältere Versionen hatten hier einen Bug. Falls Sie eine ältere Version einsetzen, bitte aktualisieren.

Fehlerbehebung

Nachfolgend finden Sie Lösungen für die häufigsten modusunabhängigen Probleme bei der JTL-Integration. Verbindungsprobleme sind im jeweiligen Einrichtungs-Guide beschrieben.

"Produkte werden nicht synchronisiert"

"Artikel steht an der Kasse in einer anderen Kategorie"

"Bestand stimmt nicht"

Weitere Hilfe

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