BISpicy kann sich vollständig in eine bestehende JTL-Wawi integrieren — bidirektionaler Datenabgleich, POS-Verkäufe als JTL-Aufträge und automatische Rechnungsstellung über JTL-Workflows.
Im typischen Setup behält JTL-Wawi die führende Rolle für Buchhaltung, OP-Verwaltung, DATEV-Export und Rechnungsdruck. BISpicy übernimmt die operativen Aufgaben (Artikelpflege via BISView, Lagerstandsabgleich, Multi-Channel-Listings) und schreibt jeden POS-Verkauf als regulären JTL-Auftrag.
Rechnungskauf an der Kasse
Wenn ein Kunde an der BISpicy POS-Kasse auf Rechnung kauft, druckt JTL die Rechnung automatisch per Workflow — ohne dass jemand SQL anfassen oder etwas manuell anstoßen muss. Die Einrichtung dauert ca. 5 Minuten und ist unten Schritt für Schritt beschrieben.
Voraussetzungen
JTL-Wawi 1.8 oder 2.0+ mit Zugriff auf die MSSQL-Datenbank (empfohlener Weg „SQL-Direkt“). Der frühere Weg über die JTL REST API ist stillgelegt (seit 7. November 2026). BISpicy erkennt beide Schema-Varianten selbst (in 2.0 liegen die Auftrags-Tabellen im Verkauf.-Schema, in 1.x unter dbo.).
BISConnect (Windows) auf dem Rechner mit der JTL-Datenbank. BISConnect ist die kostenlose Brücke zwischen Ihrer lokalen JTL-Datenbank und BISpicy; den Download finden Sie auf der Download-Seite und direkt im Verbindungs-Assistenten.
Die JTL-Anbindung braucht keine Zusatzlizenz. Zum Einrichten braucht der Benutzer das Recht, Schnittstellen anzulegen und zu bearbeiten.
Für den Rechnungskauf-Workflow: JTL-Wawi-Workflow „Rechnung Drucken“ oder gleichwertig (siehe weiter unten).
Verbindung einrichten
Verbunden wird mit dem Assistenten „Mit JTL verbinden“. Für den empfohlenen Weg SQL-Direkt tragen Sie die Zugangsdaten der JTL-Datenbank in BISConnect ein, nicht in BISpicy; einen API-Key brauchen Sie nicht. Die ausführliche Anleitung zur Kasse steht zusätzlich in der POS-Dokumentation: bispos.app/docs/jtl-integration.html.
1JTL-Wawi in den Einstellungen öffnen
Öffnen Sie Einstellungen → Verkaufskanäle & Anbindungen → JTL-Wawi. Ohne Verbindung steht dort der Kasten „JTL-Wawi verbinden“. Klicken Sie auf Mit JTL verbinden.
Einstellungen → Verkaufskanäle & Anbindungen → JTL-Wawi, noch ohne Verbindung (Demo-Diner, BISpicy 0.0.0.1336).
2Verbindung über SQL-Direkt einrichten
Der Assistent richtet die Verbindung über SQL-Direkt ein: direkte Verbindung zur JTL-Datenbank, schneller Abgleich, auch bezahlt- und geliefert-Status. Der frühere Weg über die REST API ist stillgelegt: Er gleicht nicht mehr ab, und der Assistent bietet ihn nicht mehr an. Eine bestehende REST-Verbindung zeigt einen Hinweis und lässt sich mit „Auf BISConnect (SQL) umstellen“ auf SQL-Direkt umstellen.
3BISConnect installieren und mit dem Token verbinden
Der Assistent zeigt „SQL-Direktverbindung einrichten“ mit dem Verbindungsnamen (Vorgabe „JTL-Wawi (SQL)“) und vier Schritten:
BISConnect herunterladen (Link im Kasten) und auf dem Rechner mit der JTL-Datenbank installieren.
Token generieren und in BISConnect einfügen. Der Token ist nur einmal sichtbar; kopieren Sie ihn sofort.
In BISConnect unter Einstellungen die MSSQL-Daten eintragen: SQL-Server-Host, Port, Instanz (falls vorhanden), Datenbank (meist eazybusiness), Benutzer und Passwort. Mit „Verbindung testen“ prüfen.
BISConnect verbinden und im Assistenten auf Status aktualisieren klicken.
„SQL-Direktverbindung einrichten“: Token erzeugen, in BISConnect eintragen, Status aktualisieren.
Die MSSQL-Zugangsdaten bleiben in BISConnect und werden beim Verbinden an BISpicy übermittelt. Fertig wird erst klickbar, wenn BISConnect online ist; die Seite prüft das alle paar Sekunden. Danach erscheint „Verbindung hergestellt!“, und der erste Datenabgleich startet von selbst.
4Lager und Sync-Richtungen prüfen
Die neue Verbindung erscheint als Karte mit Status, Host, JTL-Version und letztem Abgleich. Neu angelegt gilt: Artikel und Kategorien kommen aus JTL, Bestellungen gehen nach JTL, Bestand läuft in beide Richtungen, Kunden sind aus, automatischer Abgleich alle 5 Minuten. Passen Sie das in der Sync-Konfiguration an (siehe nächster Abschnitt) und wählen Sie unter „Datenhoheit“ das Lager für den Bestandsabgleich (Vorgabe: alle Läger). Über „Manuell verbinden“ legen Sie eine Verbindung ohne Assistent an; mit „Testen“ auf der Karte prüfen Sie sie jederzeit.
BISConnect-Status und Ausfall-Alarm
Alles, was zwischen BISpicy und Ihrer JTL-Wawi läuft (Kassenbons, Bestandsbuchungen, Artikel), geht über BISConnect auf Ihrem JTL-Rechner. Ist dieser Rechner aus oder BISConnect beendet, kommt in JTL nichts mehr an. BISpicy merkt das und sagt Ihnen Bescheid.
1Status ansehen
Öffnen Sie Einstellungen → Verkaufskanäle & Anbindungen → JTL-Wawi und scrollen Sie zur Karte „BISConnect (Verbindung zu Ihrer JTL-Wawi)“ (dieselbe Karte steht im Kundencenter unter Anbindungen → JTL-Wawi). Früher hieß sie „BISConnect Relay“. Oben rechts steht „Online“ oder „Offline“. Im grünen Feld „Verbunden: BISConnect on ‹Rechner›“ sehen Sie, auf welchem Rechner BISConnect läuft, wann er sich zuletzt gemeldet hat, die BISConnect-Version und wie viele Aufträge noch für JTL ausstehen.
Die Karte unter Einstellungen → Verkaufskanäle & Anbindungen → JTL-Wawi, hier mit zwei Installationen (Demo-Betrieb mit JTL-Anbindung, BISpicy 0.0.0.1097, 23.10.2026).
BISConnect auf mehreren Rechnern? BISConnect brauchen Sie nur einmal je Firma. Ist es doch auf mehreren Rechnern installiert, zeigt die Karte gelb „BISConnect ist für diese Verbindung auf mehreren Rechnern installiert“ und listet jeden Rechner. Genutzt wird nur einer, er ist mit „wird genutzt“ markiert. Die anderen stehen auf „wird nicht genutzt – kann deinstalliert werden“. Sie bekommen keine Aufträge und ändern nichts an der Verbindung, auch wenn dort eine andere Server-Angabe eingetragen ist. Deinstallieren Sie BISConnect auf diesen Rechnern. Zu jedem Rechner steht, wann er zuletzt online war und wann zuletzt ein Abgleich gelang („noch kein erfolgreicher Abgleich“ heißt: er hat nie Aufträge erledigt).
Gelber Hinweis „BISConnect ist veraltet – bitte aktualisieren“? Dann läuft auf dem genutzten Rechner eine ältere BISConnect-Version als die empfohlene. Die Verbindung funktioniert weiter, ältere Versionen haben aber bekannte Fehler, die in neueren behoben sind. So geht es: Auf „Neue Fassung herunterladen“ klicken (öffnet die Downloadseite auf bispos.app), BISConnect auf demselben Rechner über die bestehende Installation installieren. Danach ist in BISpicy und im Kundencenter nichts weiter zu tun. Die empfohlene Version nennt der Hinweis selbst. Ist BISConnect auf mehreren Rechnern installiert, zählt nur der genutzte.
Der Hinweis in der BISConnect-Karte, hier im Kundencenter unter Anbindungen → JTL-Wawi, in BISpicy gleich (Demo-Betrieb mit JTL-Anbindung, 25.10.2026).
2„BISConnect läuft dauerhaft (Server)“ einschalten, wenn der Rechner nie ausgeht
Läuft BISConnect auf einem Server oder einem Rechner, der Tag und Nacht an ist, schalten Sie „BISConnect läuft dauerhaft (Server)“ ein. Dann meldet BISpicy jede Unterbrechung, die länger als 30 Minuten dauert. Ist der Schalter aus, meldet BISpicy nur, wenn seit der Unterbrechung etwas für JTL liegen bleibt, z. B. ein Kassenbon oder eine Bestandsbuchung. Ein Büro-PC, der abends ausgeschaltet wird, löst so keinen Alarm aus, solange nichts wartet.
3Bei einer Unterbrechung: BISConnect wieder starten
Nach 30 Minuten erscheint in BISpicy die Glocke „Verbindung zu JTL unterbrochen“, und Sie bekommen eine E-Mail an die E-Mail-Adresse aus Ihren Firmendaten (höchstens eine solche Mail in 24 Stunden). Starten Sie dann den Rechner bzw. BISConnect. Kassenbons und Bestandsbuchungen gehen nicht verloren: Sie bleiben in BISpicy und werden nach JTL übertragen, sobald BISConnect wieder läuft.
Läuft BISConnect wieder stabil, verschwindet die Glocke von selbst, und Sie bekommen eine Entwarnung an dieselbe Adresse.
Nach einem Neustart des Rechners
BISConnect startet derzeit erst, wenn sich jemand an Windows anmeldet. Startet der Rechner nachts neu (z. B. nach Windows-Updates), bleibt die Verbindung bis zur nächsten Anmeldung unterbrochen. Melden Sie sich nach einem Neustart an und prüfen Sie, ob die Karte wieder „Online“ zeigt.
Sync-Richtungen
Auf der Verbindungskarte stellen Sie in der Tabelle Sync-Konfiguration je Datentyp die Richtung ein: Aus, BISpicy → JTL, JTL → BISpicy oder Bidirektional. Lieferscheine, Rechnungen, Bilder und Angebote gibt es nur in Richtung JTL → BISpicy. Daneben stehen „Import ab“, letzter Abgleich und Status.
Die Sync-Konfiguration einer verbundenen JTL-Wawi: je Datentyp eine Richtung, bei Belegen ein Startdatum unter „Import ab“ (Demo-Betrieb, BISpicy 0.23.4.5).
Datentyp
Richtungen
Was passiert
Artikel
alle vier
Stammdaten in JTL pflegen, BISpicy übernimmt sie. Bei „Bidirektional“ oder „BISpicy → JTL“ legt BISpicy neue Artikel und Ausführungen auch in JTL an und gibt Löschen/Deaktivieren weiter, bei „JTL → BISpicy“ nie, siehe Artikel anlegen, löschen, deaktivieren. Führt JTL die Artikel („JTL → BISpicy“), übernimmt BISpicy seit Version 0.0.0.1077 auch keine Artikeländerungen von der Kasse mehr; die Kasse zeigt die Artikel dann nur zum Lesen. Ändern Sie Name, Preis oder Nummer in diesem Fall in JTL. Führt umgekehrt BISpicy die Artikel („BISpicy → JTL“), holt BISpicy seit Version 0.0.0.1345 gar keine Artikel mehr aus JTL; Gebinde- und Pfandangaben (Funktionsattribute) und EANs gehen weiter nach JTL.
Bestellungen
alle vier, mit „Import ab“
In Richtung JTL werden Kassenverkäufe in JTL als Aufträge angelegt — Voraussetzung für den Rechnungs-Workflow. In Richtung BISpicy kommen die Aufträge aus JTL ab dem Datum unter „Import ab“. Rechnungs- und Lieferadresse übernimmt BISpicy dabei getrennt aus dem JTL-Auftrag: Das Versandetikett trägt die Lieferadresse, Lieferschein-Mail und Versandbestätigung gehen an die E-Mail-Adresse der Lieferadresse (fehlt dort eine, an die der Rechnungsadresse), Rechnungsmails an die Rechnungsadresse. Bis BISpicy 0.23.1.1 konnten die beiden Adressen vertauscht ankommen, siehe Paket ging an die Rechnungsadresse.
Kunden
alle vier, mit „Import ab“
Neukunden der Kasse landen in JTL, JTL-Kunden in BISpicy für die Kasse. Einen Kunden, den es in JTL schon gibt, schreibt BISpicy nicht mit eigenen Standardwerten zurück: Rabatt, Zahlungsziel, USt-IdNr., Adresszusatz und Lieferadresse bleiben in JTL, wie Sie sie gepflegt haben. Änderungen an einem solchen Kunden an der Kasse erreichen JTL deshalb vorerst nicht (siehe unten). Eine neue Verbindung steht hier auf „Aus“.
Bestand
alle vier
Der Bestand kommt aus JTL, Kassenverkäufe mindern ihn in JTL. Welches JTL-Lager zählt, wählen Sie unter „Datenhoheit“. In JTL deaktivierte Läger zählen seit BISpicy 0.0.0.1297 nicht mehr mit, auch nicht im Gesamtbestand des Artikels, den Kasse, Shop und Marktplätze sehen.
Lagerplätze
alle vier
Nur für JTL-Lager mit Lagerplatzverwaltung (WMS); ein JTL-Standardlager führt keine Lagerplätze und wird nie beschrieben. Ab Werk „Aus“, damit nicht versehentlich tausende Plätze in JTL entstehen. Der Hinweis am Fragezeichen erklärt jede Richtung. Fehlen in einer Antwort aus JTL auffällig viele verknüpfte Plätze, löscht BISpicy keinen davon (mehr).
Kategorien
alle vier
Gleicht den Kategoriebaum ab; eine neue Verbindung holt ihn aus JTL. Liegt ein Artikel in JTL in mehreren Kategorien, zählt die für den Kassen-Kanal freigegebene (mehr).
Lieferscheine
Aus oder JTL → BISpicy, mit „Import ab“
Holt die Lieferscheine aus JTL nach BISpicy.
Rechnungen
Aus oder JTL → BISpicy, mit „Import ab“
Holt die Rechnungen aus JTL nach BISpicy, dazu laufend jede Einzelzahlung zu diesen Rechnungen (auch Teilzahlungen und Erstattungen). Als „bezahlt am“ gilt das Datum der letzten Zahlung, damit landet die Rechnung auf Ist-Basis im richtigen Monat. Die Rechnung selbst schreibt weiter JTL; BISpicy erstellt keine und ändert in JTL nichts. Ändern Sie eine Zahlung später in JTL, zieht BISpicy die Änderung nach; eine in JTL gelöschte Zahlung entfernt BISpicy nie von selbst (siehe Häufige Fragen).
Bilder
Aus oder JTL → BISpicy
Holt die Artikelbilder aus JTL.
Angebote
Aus oder JTL → BISpicy, mit „Import ab“
Holt in JTL geschriebene Angebote mit Positionen, Anschriften und Kunden nach BISpicy. Angebote ohne eindeutig zuordenbaren Kunden bleiben in JTL und werden im Protokoll benannt.
Sendungsdaten (Tracking)
alle vier, mit „Import ab“
„JTL → BISpicy“ holt die Trackingnummern aus JTL. Erst mit „BISpicy → JTL“ oder „Bidirektional“ erzeugt eine an der BISpicy Parcel Station (bisher Packtisch) abgeschlossene Sendung in JTL Lieferschein und Warenausgang; sonst bleibt der JTL-Auftrag offen. Der Lieferschein trägt seit BISpicy 0.7.2.1 die Versandart des JTL-Auftrags, wenn sie zum Versanddienst der Sendung passt (zum Beispiel „DHL Paket“ statt „DHL Paket International“). Pfand geht mit der gelieferten Ware in den Lieferschein.
Gutscheine
alle vier
Ab Werk „Aus“. „JTL → BISpicy“ übernimmt die Gutscheine aus JTL, sie sind dann auch an der Kasse einlösbar. In Richtung JTL gehen die Einlösungen zurück nach JTL.
Seriennummern
alle vier
„JTL → BISpicy“ holt die verfügbaren Einzelstücke, damit an der Kasse die konkrete Seriennummer gewählt oder gescannt werden kann. Erst mit „BISpicy → JTL“ oder „Bidirektional“ wird beim Verkauf genau dieses Stück in JTL ausgebucht.
Welche Kategorie ein Artikel bekommt: Liegt ein Artikel in JTL-Wawi in mehreren Kategorien, ordnen BISpicy und die Kasse ihn der Kategorie zu, die in JTL-Wawi für den Kassen-Kanal freigegeben ist. Beispiel: Ist für den Kassen-Kanal „Hundefutter“ freigegeben, „Katzenfutter“ aber nicht, steht ein Artikel aus beiden Kategorien in BISpicy und an der Kasse unter „Hundefutter“.
Unter mehreren freigegebenen Kategorien gewinnt die genaueste, also die am tiefsten im Kategoriebaum.
Haben Sie mehrere Kassen mit eigenen Kanälen, zählen die Freigaben aller Kassen-Kanäle zusammen.
Sind in JTL-Wawi keine Kategorie-Freigaben für die Kassen-Kanäle gepflegt, bleibt alles wie bisher.
Ein Artikel, der in keiner freigegebenen Kategorie liegt, behält seine bisherige Kategorie. Ein neu aus JTL-Wawi angelegter Artikel ohne freigegebene Kategorie bleibt ohne Kategorie und ist an der Kasse über die Suche zu finden.
Artikel anlegen, löschen, deaktivieren
Was BISpicy mit Artikeln in JTL tut, hängt allein an der Artikel-Richtung Ihrer JTL-Verbindung. Diese Einstellung wird nie umgangen.
Sie tun in …
Artikel-Richtung
Folge im anderen System
BISpicy: Artikel anlegen
bidirektional oder BISpicy → JTL
Der Artikel wird nach 10 Minuten Ruhe (keine weitere Änderung) auch in JTL angelegt, samt Ausführungen. Danach wird der Bestand in JTL auf den Bestand in BISpicy gesetzt, sofern auch der Bestand nach JTL geht.
BISpicy: Artikel löschen
bidirektional oder BISpicy → JTL
In JTL gelöscht, wenn der Artikel dort keine Belege, kein Lagerjournal und keinen Bestand hat, sonst nur deaktiviert.
BISpicy: Artikel deaktivieren
bidirektional oder BISpicy → JTL
In JTL deaktiviert.
JTL: Artikel löschen
bidirektional oder von JTL
In BISpicy deaktiviert (nicht gelöscht).
BISpicy: Artikel löschen, JTL führt
von JTL
Der Artikel bleibt in BISpicy deaktiviert und kommt beim nächsten Abgleich nicht zurück.
JTL: Artikel anlegen oder ändern, BISpicy führt
BISpicy → JTL
Kommt seit BISpicy 0.0.0.1345 nicht nach BISpicy: Der Abgleich holt bei dieser Richtung keine Artikel aus JTL, legt keine an und setzt einen in BISpicy deaktivierten Artikel nicht wieder aktiv. Pflegen Sie Artikel dann in BISpicy. Sollen auch in JTL angelegte Artikel herüberkommen, stellen Sie die Artikel-Richtung auf „Bidirektional“.
1Vor dem Anlegen: Pflichtangaben
Angelegt wird nur mit Artikelnummer, echtem Namen und eindeutiger Steuerklasse; ein Verkaufspreis von 0 € ist erlaubt (z. B. Pfand). Gibt es die Artikelnummer in JTL schon, verknüpft BISpicy nur, wenn auch EAN oder Name passen, sonst weder Verknüpfung noch Anlage. Artikel mit Stückliste werden noch nicht angelegt. Die automatische Anlage schaltet BISpicy je Betrieb ein; fragen Sie den Support, wenn neue Artikel nicht in JTL ankommen.
2Beim Löschen: Hinweis im Dialog
Ist der Artikel mit JTL verknüpft, sagt der Löschdialog vorher, was in JTL geschieht. Solange das Löschen in JTL für Ihren Betrieb noch nicht eingeschaltet ist, wird der Artikel in BISpicy deaktiviert und als „Löschen vorgemerkt“ geführt; JTL bleibt unverändert. Den Stand sehen Sie im Kundencenter unter Anbindungen → JTL-Wawi → Löschen/Deaktivieren.
Löschdialog bei einem mit JTL verknüpften Artikel (Demo-Betrieb mit JTL-Anbindung, BISpicy 0.23.4.5, 14. November 2026).
3Versehentlich gelöscht? Wieder aktivieren
Einen vorgemerkten Artikel einfach wieder auf aktiv setzen: Die Vormerkung entfällt, in JTL geschieht nichts. Ein Artikel im Status „Auslauf“ bleibt aktiv und an der Kasse verkäuflich, er wird weder gelöscht noch deaktiviert.
Zahlungsarten-Zuordnung
Im Kundencenter unter Anbindungen → JTL-Wawi → Zahlungsarten-Zuordnung (JTL ↔ POS) wird festgelegt, welche JTL-Zahlart welcher POS-Zahlart entspricht. Jede JTL-Zahlart, die an der Kasse direkt angeboten wird (Spalte „An Kasse"), kann zusätzlich als „Rechnungskauf" markiert werden — für diese Zahlarten ist das Häkchen das Signal, anhand dessen BISpicy einen POS-Verkauf als Rechnungskauf erkennt und entsprechend verarbeitet. Bei den Zahlarten, die Ihre Kasse selbst führt, legen Sie den Rechnungskauf an der Kassen-Zahlart selbst fest (Schritt 3). Der Name einer Zahlart entscheidet nie.
1JTL-Zahlarten abrufen
Auf „Zahlungsarten neu abrufen" klicken — BISpicy liest die Tabelle dbo.tZahlungsart live aus JTL und zeigt sie in der Tabelle.
2Mapping setzen
Jeder JTL-Zahlart (Bar, EC-Karte, Rechnung, Vorkasse …) ordnen Sie in der Spalte „Kassen-Zahlarten“ die Zahlarten Ihrer Kassen zu. Zur Auswahl stehen die Zahlarten, die Ihre Kassen tatsächlich führen, und die Werte der letzten 90 Tage mit der Zahl der Bons, also auch selbst angelegte Zahlarten wie „EC-Kartenterminal“. Eine zweite Gruppe ordnet einen ganzen Zahlungstyp zu; das geht nicht für „Sonstige“ und eigene Zahlarten. Einer JTL-Zahlart können mehrere Kassen-Zahlarten gehören, eine Kassen-Zahlart aber nur einer JTL-Zahlart. Sonst meldet die Maske „bereits vergeben“ und speichert nicht.
Unter der Tabelle steht, was noch fehlt, z. B. „Nicht zugeordnet: Bargeld (67 Bons / 90 Tage)“. Hat eine Kassen-Zahlart einen eigenen Namen, entscheidet dessen Zuordnung, sonst der Zahlungstyp. Die Rechnungs-Zahlart Ihrer Kasse ordnen Sie der JTL-Rechnungs-Zahlart zu (in JTL z. B. „Rechnung“ oder eine eigene Bezeichnung wie „Rechnung by Asia-In“). Bestehende Zuordnungen aus der Zeit vor der Umstellung wirken unverändert weiter.
Zahlarten, die die Kasse aus JTL übernommen hat (Spalte „An Kasse“), bucht BISpicy seit BISpicy 0.0.0.1370 direkt auf diese JTL-Zahlart – auch wenn Sie sie in JTL später umbenennen. Weicht diese Zahlart von Ihrer Zuordnung in der Tabelle ab, oder gibt es sie in JTL nicht mehr, steht im Sync-Protokoll eine Warnung, z. B. „Die Kassen-Zahlart „…“ trägt den JTL-Schlüssel …, aber es gibt keine aktive JTL-Zahlungsart mit dieser Nummer“. Dann prüfen Sie die Zuordnung hier (Schritt 2) und rufen die JTL-Zahlarten neu ab (Schritt 1). Verkäufe ohne solchen Schlüssel ordnet BISpicy wie bisher über Name bzw. Typ der Zahlart zu.
3Rechnungskauf markieren
Bei einer JTL-Zahlart, die an der Kasse direkt angeboten wird (Spalte „An Kasse"), das Häkchen „Rechnungskauf" in dieser Tabelle setzen. Bei einer Zahlart, die Ihre Kasse selbst führt und die Sie in Schritt 2 zugeordnet haben, setzen Sie das Häkchen an der Kassen-Zahlart: Kundencenter → Verkauf → Zahlungsarten, Spalte „Rechnungskauf" (oder Zahlart-Typ „Rechnung"). Das Häkchen in dieser Tabelle wirkt für solche Kassen-Zahlarten nicht. Ohne Häkchen wird der Verkauf als Sofortzahlung behandelt — der Rechnungs-Workflow läuft dann nicht. Das gilt auch, wenn „Rechnung" im Namen der Zahlart steht: Der Name entscheidet nie, nur das Häkchen.
Was BISpicy technisch macht
Bei Rechnungskauf-Verkäufen wird in JTL keintZahlung-Eintrag angelegt, nIstExterneRechnung bleibt auf 0, und die Positionen werden mit fAnzahlAufRechnung = 0 angelegt — damit der „Rechnung erstellen"-Workflow eine offene Menge findet.
Rechnungskauf-Workflow im Kundencenter
Unter Anbindungen → JTL-Wawi → Workflow für Rechnungskauf an der Kasse lässt sich aus einer Dropdown-Liste der JTL-Workflow auswählen, der nach jedem Rechnungskauf-Verkauf automatisch ausgelöst werden soll — typischerweise „Rechnung Drucken". Die Liste wird live aus Ihrer JTL geladen.
1Workflow wählen
Aus dem Dropdown den gewünschten JTL-Workflow auswählen (z. B. „Rechnung Drucken"). „— Kein Workflow —" deaktiviert das Feature; dann muss die Rechnung manuell in JTL erstellt werden.
2Verzögerung festlegen
Wählen Sie zwischen Sofort (empfohlen) und 1 Minute. Mit „1 Minute" hat JTL eine Pufferzeit, um alle Eckdaten zu indexieren, bevor der Workflow läuft. In den meisten Setups funktioniert „Sofort" zuverlässig.
3Speichern
Speichern. Ab dem nächsten Rechnungskauf-Verkauf legt BISpicy automatisch einen Eintrag in dbo.tWorkflowQueue an — JTL führt den Workflow aus.
Ablauf eines Rechnungskauf-Verkaufs (End-to-End)
1
An der Kasse: Kassierer wählt Zahlart „Rechnung". Kunde muss zugewiesen sein (kein Laufkunde).
2
POS → BISpicy: Bon wird in die Cloud gepusht mit isInvoicePayment = true.
3
BISpicy → JTL: Auftrag wird in Verkauf.tAuftrag angelegt — Plattform „BISpicy POS", offener Posten = Bruttobetrag, Positionen offen für Rechnung.
4
BISpicy → Workflow-Queue: Eintrag in dbo.tWorkflowQueue mit Event „Auftrag erstellt", konfigurierte Workflow-ID und Verzögerung.
5
JTL-Worker: Zieht den Queue-Eintrag, prüft Bedingungen, führt die Aktionen aus (Rechnung erstellen + Drucken).
6
Kunde nimmt die gedruckte Rechnung mit. Zahlungseingang wird in JTL über OP-Liste oder Bank-Import gebucht.
JTL-Workflow konfigurieren
In JTL-Wawi den Workflow unter Admin → Workflows → Aufträge → Auftrag - Erstellt anlegen. Empfohlene Konfiguration:
Eigenschaft
Wert
Erläuterung
Anlegen unter
Aufträge → Auftrag - Erstellt
In der Workflow-Übersicht links auf „Aufträge" klappen, „Auftrag - Erstellt" wählen, dann „Neuer Workflow".
Name
z. B. „Rechnung Drucken"
Frei wählbar. Dieser Name erscheint anschließend im BISpicy-Dropdown unter Workflow für Rechnungskauf an der Kasse.
Bedingung
Modus: Alle Bedingungen erfüllen
Pfad: Auftrag\Sonstiges\Plattform\Name
Operator: Enthält
Wert: BIS
Filtert auf alle BISpicy-POS-Aufträge (die Plattform heißt BISpicy POS, der Substring „BIS" matched zuverlässig). Damit feuert der Workflow nicht für Shop-Aufträge oder manuelle JTL-Aufträge.
Aktion 1
Rechnung erstellen → Rechnung erstellen
Erstellt das Dokument tRechnung aus den offenen Positionen.
Druckt auf den hinterlegten Drucker. Alternativ E-Mail oder PDF speichern.
Ausführungsplan
Zeitverzögert oder Sofort ausführen
„Zeitverzögert" läuft über die Workflow-Queue (passend zum BISpicy-Trigger mit 0/1-Minuten-Verzögerung). „Sofort ausführen" wird direkt vom Application-Code ausgeführt — beides ist kompatibel.
Aktiv
Häkchen „Workflow deaktivieren" leer lassen
Nur aktive Workflows erscheinen im BISpicy-Dropdown.
Workflow-Bedingung in der JTL-UI
Sonstiges.Plattform.Name enthält BIS
Im Bedingungs-Editor: Dropdown 1 = Auftrag\Sonstiges\Plattform\Name · Dropdown 2 = Enthält · Texteingabe = BIS
Wichtig: Bedingung nicht weglassen
Ohne die Plattform-Bedingung würde der Workflow für jeden neu erstellten Auftrag in JTL laufen — auch Shop-Aufträge und manuell angelegte. Die Bedingung filtert auf POS-Aufträge.
Zahlungseingang verbuchen
Nach dem Rechnungskauf bleibt die Rechnung in JTL als offener Posten in der OP-Liste stehen. Sobald der Kunde überweist, wird der Zahlungseingang in JTL gebucht — auf eine der drei üblichen Arten:
Bank-Import: CAMT/MT940-Datei aus dem Online-Banking in JTL importieren — JTL ordnet die Zahlung anhand der Verwendungszweck-Referenz (Rechnungsnummer) automatisch zu.
DATEV-Anbindung: Bei DATEV-Schnittstelle erfasst Ihr Steuerberater die Zahlung in DATEV; sie wird über die OP-Synchronisation an JTL zurückgespielt.
BISpicy greift nicht ein
Da der Auftrag mit nIstExterneRechnung = 0 angelegt wurde, ist die Rechnung eine reine JTL-Rechnung. BISpicy synchronisiert keine OPs zurück und ändert auch nichts an dieser Rechnung. JTL ist allein zuständig.
Häufige Fehler
Meldung „Es existieren keine offenen Positionen mehr"
Diese Meldung erscheint, wenn der Workflow „Rechnung erstellen" keine Position findet, für die noch keine Rechnung geschrieben wurde. Mögliche Ursachen:
BISpicy < Version 0.0.0.61 setzte fAnzahlAufRechnung fälschlich auf die volle Menge. Lösung: BISpicy aktualisieren.
Die Zahlart ist nicht als „Rechnungskauf" gekennzeichnet — bei einer Zahlart, die Ihre Kasse selbst führt, am Haken der Kassen-Zahlart (Kundencenter → Verkauf → Zahlungsarten), bei einer JTL-Zahlart, die an der Kasse direkt angeboten wird, in der Zahlungsarten-Zuordnung. BISpicy behandelt den Verkauf dann als Sofortzahlung und setzt fAnzahlAufRechnung = qty. Der Name der Zahlart reicht nicht.
Workflow läuft nicht / kein Druck
Steht der gewünschte Workflow im BISpicy-Dropdown auf aktiv? Nur aktive Workflows (nIstAktiv = 1) erscheinen in der Liste.
Ist die Workflow-Bedingung erfüllt? Prüfen Sie das Workflow-Log in JTL (Admin → Hintergrundprozesse → Workflow Log).
Läuft der JTL-Worker? Ohne Worker werden „Verzögert"-Workflows nicht abgearbeitet.
Auftrag landet als „Laufkunde" in JTL
Rechnungskauf braucht einen zugewiesenen Kunden im Bon. Ist niemand zugewiesen, fällt der Verkauf auf den POS-Laufkunden zurück und kann nicht auf Rechnung abgewickelt werden. Bitte vor dem Kassieren den Kunden im POS auswählen oder neu anlegen.
Kundenänderung an der Kasse kommt nicht in JTL an
Ursache: Seit BISpicy 0.0.0.1081 überschreibt BISpicy Kunden, die es in JTL schon gibt, nicht mehr. Vorher konnte ein Kassenverkauf Rabatt, Zahlungsziel, USt-IdNr. oder Lieferadresse in JTL mit Standardwerten ersetzen. Die gezielte Übertragung einzelner geänderter Felder folgt. Lösung: Anschrift, E-Mail oder andere Angaben eines JTL-Kunden in JTL ändern. Steht der Datentyp „Kunden“ auf „JTL → BISpicy“ oder „Bidirektional“, übernehmen BISpicy und die Kasse sie beim nächsten Abgleich. Neue Kunden, die an der Kasse angelegt werden, landen wie bisher in JTL, wenn die Richtung zu JTL eingeschaltet ist.
Hinweis „Der Kassen-Sync war ausgeschaltet: … nur als Beleg gespeichert“
Ursache: Solange unter POS-Synchronisation der Schalter „Synchronisation aktivieren“ aus war, hat BISpicy Kassenverkäufe nur als Beleg gespeichert, ohne Auftrag und ohne Bestandsbuchung. Diese Verkäufe gehen auch nicht an JTL-Wawi. Schalten Sie den Sync wieder ein, nennt BISpicy seit Version 0.0.0.1379 ihre Zahl und den Zeitraum. Das Einschalten holt sie nicht nach. Lösung: Prüfen Sie für den genannten Zeitraum, ob Bestand oder Aufträge in JTL-Wawi nachgetragen werden müssen. Die Kundenrechnung zu einem solchen Verkauf erzeugt BISpicy selbst, wie bei Betrieben ohne JTL, auch wenn sonst JTL die Rechnung schreibt; bei Kauf auf Rechnung zieht BISpicy die Kassenrechnung nach, damit der Umsatz in den Auswertungen nicht fehlt. Der Hinweis bleibt stehen, bis Sie ihn mit Schließen ausblenden.
Workflow druckt doppelt
Wenn der Workflow in JTL bereits eine Bedingung „Plattform = BISpicy POS" hat und in BISpicy zusätzlich ein Trigger gesetzt ist, kann es zu Doppel-Triggern kommen, falls JTL den Auftrag selbst als „neu erstellt" erkennt. In der Praxis tritt das nur auf, wenn der Workflow versehentlich auch für Connector-Imports konfiguriert ist. Lösung: Workflow-Bedingung auf Plattform und Zahlart einschränken.
Glocke oder Mail „Verbindung zu JTL unterbrochen“
BISConnect hat sich seit mehr als 30 Minuten nicht gemeldet. Meist ist der JTL-Rechner aus, BISConnect wurde beendet oder der Rechner hat neu gestartet und niemand hat sich an Windows angemeldet. Rechner bzw. BISConnect starten, dann zeigt die Karte „BISConnect Relay“ wieder „Online“. Was in der Zwischenzeit liegen geblieben ist, überträgt BISpicy danach selbst, siehe BISConnect-Status und Ausfall-Alarm.
Rechnungen oder Zahlungen aus JTL fehlen in BISpicy
Ursache: In der Sync-Konfiguration steht der Datentyp „Rechnungen“ auf „Aus“, oder das Datum unter „Import ab“ liegt nach der Rechnung. Lösung: „Rechnungen“ auf „JTL → BISpicy“ stellen und „Import ab“ so setzen, dass die gesuchten Rechnungen dahinter liegen. Mit dem nächsten Abgleich kommen die Rechnungen samt ihren Zahlungen; eine Zahlung, die JTL erst später einer Rechnung zuordnet, folgt, sobald die Zuordnung in JTL steht. Läuft gerade kein Abgleich, prüfen Sie den BISConnect-Status auf der Verbindungskarte.
Artikel steht nach dem JTL-Abgleich in einer anderen Kategorie
Ursache: Seit dem 31. Oktober 2026 zählt bei Artikeln in mehreren JTL-Kategorien die für den Kassen-Kanal freigegebene Kategorie. War vorher eine andere gewählt, hängt der erste Abgleich den Artikel um. Lösung: Gewünschte Kategorie in JTL-Wawi für den Kassen-Kanal freigeben bzw. die nicht gewünschte dort nicht freigeben; der nächste Abgleich übernimmt das (Regel). Ein Artikel ohne Kategorie bleibt an der Kasse über die Suche verkäuflich.
Kunde aus JTL steht mit der Kundennummer „JTL-…“ in BISpicy
Ursache: In JTL-Wawi tragen zwei Kunden dieselbe Kundennummer, oft dieselbe Person doppelt angelegt. Vor BISpicy 0.0.0.1413 scheiterte der zweite Kunde daran bei jedem Abgleich und fehlte in BISpicy. Seit dieser Version übernimmt BISpicy ihn unter der Ersatznummer „JTL-“ und seinem JTL-Kundenschlüssel (etwa „JTL-1234“), die echte JTL-Nummer bleibt beim Kunden hinterlegt. Bei einem schon vorhandenen Kunden bleibt nur die Nummer stehen, Name, Adresse und Kontakt werden weiter aktualisiert. Hängen an einem JTL-Kunden mehrere Kunden in BISpicy, wird immer derselbe aktualisiert. Zusammengeführt wird nichts automatisch. Auf der Seite JTL-Wawi steht im Abschnitt Sync-Protokoll einmal eine Warnung: „Kunden-Pull: JTL-Kunde … trägt die Kundennummer …, die in BIS ERP schon vergeben ist … In JTL zusammenführen oder umnummerieren; Dubletten unter CRM → Dubletten.“ Lösung: Die beiden Kunden in JTL-Wawi zusammenführen oder einem von ihnen eine eigene, freie Kundennummer geben. Ist die Nummer danach frei, übernimmt der nächste Abgleich sie auch in BISpicy. Mögliche Dubletten in BISpicy selbst finden Sie unter CRM → Dubletten. Sagt die Warnung „der Kunde wurde NICHT angelegt“, legt BISpicy bewusst nichts an, damit kein Doppel entsteht. Meist trägt die Nummer dann in BISpicy ein Kunde ohne JTL-Verknüpfung, etwa ein an der Kasse angelegter. Prüfen Sie diesen Kunden oder schreiben Sie dem Support.
In JTL gelöschte Lagerplätze bleiben in BISpicy stehen
Ursache: Steht „Lagerplätze“ auf „JTL → BISpicy“ oder „Bidirektional“, entfernt BISpicy Plätze, die es in JTL nicht mehr gibt. Fehlen in einer Antwort aus JTL aber auffällig viele der verknüpften Plätze (mehr als 20 und mehr als 10 %), löscht BISpicy in diesem Lauf keinen einzigen. So eine Antwort kann von einem anderen verknüpften BISConnect-Rechner oder aus einer anderen JTL-Datenbank stammen, und ohne diese Bremse wären alle betroffenen Plätze in BISpicy verschwunden. Im Sync-Protokoll der Verbindung (Kundencenter unter Anbindungen → JTL-Wawi) steht dann einmal am Tag die Meldung „WMS-Platz-Abgleich JTL-Lager …: sehr viele gemappte BIS-Lagerplätze fehlen in der JTL-Antwort … es wurde kein Lagerplatz in BIS ERP gelöscht“. Lösung: Haben Sie die Plätze in JTL absichtlich gelöscht, entfernen Sie sie in BISpicy von Hand. Haben Sie in JTL nichts gelöscht, schreiben Sie dem Support über ein Ticket im Kundencenter, damit er prüft, woher die Antwort kam.
In JTL-Wawi steht der Verkaufskanal der Kasse doppelt
Ursache: Fiel die Verbindung zwischen BISpicy und JTL-Wawi kurz aus, konnte BISpicy im Abgleich einen zweiten, leeren Verkaufskanal für die Kasse anlegen, mit demselben Namen wie der vorhandene (etwa „BISpicy POS - Kasse 1“). Seit BISpicy 0.0.0.1422 legt BISpicy bei einem Verbindungsfehler nichts mehr an und verwendet beim nächsten Lauf den vorhandenen Kanal weiter. Einen schon entstandenen zweiten Kanal löscht BISpicy nicht selbst. Es meldet ihn einmal am Tag im Sync-Protokoll der Verbindung (Kundencenter unter Anbindungen → JTL-Wawi): „Mehrere JTL-Kassen-Kanäle mit gleichem Namen … Kanal mit Artikeln behalten, den leeren nach Prüfung von Sonderpreisen in JTL-Wawi entfernen. BIS legt keinen weiteren an und löscht nichts.“ Lösung: Behalten Sie in JTL-Wawi den Kanal, dem Ihre Artikel zugeordnet sind. Steht in der Meldung „BIS ist an kShop … gebunden, diesen nicht entfernen“, nutzt BISpicy genau diesen Kanal. Prüfen Sie am leeren Kanal, ob Sonderpreise daran hängen, und richten Sie diese für den verbleibenden Kanal ein. Danach löschen Sie den leeren Kanal in JTL-Wawi. Sind Sie unsicher, welcher der beiden der richtige ist, schreiben Sie dem Support über ein Ticket im Kundencenter.
Paket ging an die Rechnungsadresse statt an die Lieferadresse
Ursache: Bis BISpicy 0.23.1.1 (13. November 2026) hat der Abgleich bei Aufträgen aus JTL-Wawi mit abweichender Lieferadresse Rechnungs- und Lieferadresse vertauscht übernommen. Das Versandetikett trug dann die Rechnungsadresse, und die Versandbestätigung ging an deren E-Mail-Adresse. Aufträge, bei denen Rechnungs- und Lieferadresse gleich sind, waren nicht betroffen. Lösung: Neue Aufträge kommen seit dieser Version richtig an. Ältere Aufträge übernehmen die richtige Zuordnung, sobald sie sich in JTL-Wawi ändern; die übrigen korrigieren wir nach Prüfung. Prüfen Sie vor dem Etikett im Auftrag unter Kunde & Adressen, ob die Lieferadresse der in JTL-Wawi entspricht. Steht ein offener Auftrag noch vertauscht da, schreiben Sie dem Support über ein Ticket im Kundencenter. Seit BISpicy 0.23.4.0 prüft BISpicy neue Aufträge aus JTL-Wawi laufend auf vertauschte Adressen und benachrichtigt bei einem Fund automatisch unseren Support.
Mehr Hilfe
Detaillierte Anleitung mit Screenshots zur JTL-Verbindung selbst: bispos.app/docs/jtl-integration.html. Bei spezifischen Fragen Support-Ticket im Kundencenter eröffnen.
Häufig gestellte Fragen
Mit dem Assistenten „Mit JTL verbinden“ unter Einstellungen → Verkaufskanäle & Anbindungen → JTL-Wawi (siehe Verbindung einrichten). Empfohlen ist SQL-Direkt: BISConnect läuft auf dem Rechner mit der JTL-Datenbank und hält deren Zugangsdaten, einen API-Key brauchen Sie nicht. Danach legen Sie in der Sync-Konfiguration je Datentyp fest, in welche Richtung abgeglichen wird.
Beim Rechnungskauf an der POS-Kasse wird statt einer Barzahlung eine Rechnung über JTL erzeugt: BISpicy legt einen Workflow-Eintrag in der JTL-Workflow-Queue an, woraufhin JTL die Rechnung automatisch druckt/versendet. Dadurch entsteht keine doppelte Erlösbuchung im POS-DATEV-Export.
Das legen Sie je Datentyp in der Sync-Konfiguration fest. Artikel, Bestellungen, Kunden, Bestand, Lagerplätze, Kategorien, Sendungsdaten, Gutscheine und Seriennummern können in beide Richtungen laufen; Lieferscheine, Rechnungen, Bilder und Angebote kommen nur aus JTL. Eine neue Verbindung gleicht den Bestand in beide Richtungen ab und schickt Bestellungen nach JTL.
Ja, wenn in der Sync-Konfiguration der Datentyp „Rechnungen“ auf „JTL → BISpicy“ steht. Dann kommen die Rechnungen ab dem Datum unter „Import ab“ nach BISpicy, dazu laufend jede Einzelzahlung zu diesen Rechnungen, auch Teilzahlungen und Erstattungen. Als „bezahlt am“ gilt das Datum der letzten Zahlung. BISpicy schreibt dabei keine eigene Rechnung und ändert in JTL nichts. Steht „Rechnungen“ auf „Aus“, holt BISpicy weder Rechnungen noch Zahlungen.
Eine geänderte Zahlung ja: Ändern Sie in JTL Betrag, Zahltag, Zahlart oder Text einer schon übernommenen Zahlung oder hängen Sie sie an eine andere Rechnung, übernimmt BISpicy das beim nächsten Rechnungsabgleich und vermerkt es im Protokoll der Rechnung.
Ausnahme: Liegt der alte oder der neue Zahltag in einem Zeitraum, der schon festgeschrieben oder an DATEV exportiert ist, und ändern sich Betrag, Zahltag oder Rechnung, übernimmt BISpicy die Änderung nicht von selbst. So weicht eine schon abgegebene EÜR, Anlage EKS oder Umsatzsteuer-Voranmeldung nicht unbemerkt ab.
Eine in JTL gelöschte Zahlung entfernt BISpicy nie von selbst. In beiden Fällen wenden Sie sich an den Support; er prüft die Zahlung und zieht sie nach.
BISConnect auf Ihrem JTL-Rechner meldet sich seit mehr als 30 Minuten nicht. Gemeldet wird, wenn in der Zeit etwas für JTL liegen bleibt oder wenn bei der Verbindung „BISConnect läuft dauerhaft (Server)“ eingeschaltet ist. Starten Sie den Rechner bzw. BISConnect; liegen gebliebene Kassenbons und Bestandsbuchungen überträgt BISpicy danach selbst, und Sie bekommen eine Entwarnung.
Auf dem Rechner, über den Ihre JTL-Wawi angebunden ist, läuft eine ältere BISConnect-Version als die empfohlene. Klicken Sie im Hinweis auf „Neue Fassung herunterladen“ und installieren Sie BISConnect auf demselben Rechner über die bestehende Installation. Danach ist in BISpicy nichts weiter zu tun.
Bis BISpicy 0.23.1.1 (13. November 2026) hat der Abgleich bei Aufträgen aus JTL-Wawi mit abweichender Lieferadresse Rechnungs- und Lieferadresse vertauscht übernommen. Das Versandetikett trug dann die Rechnungsadresse. Neue Aufträge kommen seitdem richtig an, ältere übernehmen die richtige Zuordnung, sobald sie sich in JTL-Wawi ändern; die übrigen korrigieren wir nach Prüfung. Prüfen Sie vor dem Etikett im Auftrag unter „Kunde & Adressen“ die Lieferadresse. Mehr unter Häufige Fehler.
