JTL-Wawi Integration - BISpicy POS | Artikel, Bestand, Kunden & Bestellungen synchronisieren

Ü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.

Bidirektionaler Sync

Produkte, Kunden, Bestand, Kategorien

Verkäufe übertragen

POS-Verkäufe als JTL-Aufträge

Kostenlos

Für alle BISpicy-Nutzer inklusive

Was wird synchronisiert?

Datentyp	Beschreibung	Richtung
Produkte	Artikelstammdaten (Name, SKU, EAN, Preise, Steuersätze, Beschreibungen)	Bidirektional
Bestellungen	POS-Verkäufe werden als Aufträge (Sales Orders) in JTL angelegt	Zu JTL
Kunden	Kundenstammdaten (Name, Adresse, E-Mail, Telefon, USt-IdNr.)	Bidirektional
Bestand	Lagerbestände und Bestandsbewegungen	Bidirektional
Kategorien	Warengruppen und Kategoriebäume	Bidirektional

Unterstützte JTL-Versionen

Version	Variante	Status
JTL-Wawi 1.9+	OnPremise (lokal installiert)	Unterstützt
JTL-Wawi 1.9+	Cloud	Unterstützt
JTL-Wawi < 1.9	Alle	Nicht unterstützt

Voraussetzungen

Bevor Sie die Integration einrichten, stellen Sie sicher, dass folgende Voraussetzungen erfüllt sind:

#	Voraussetzung	Details
1	JTL-Wawi 1.9+	Die REST API ist erst ab Version 1.9 verfügbar. Prüfen Sie Ihre Version unter Hilfe → Über JTL-Wawi.
2	REST API aktiviert	Die JTL REST API muss in den Einstellungen aktiviert und eine App-Registrierung angelegt sein.
3	BISpicy POS Account	Ein aktives BISpicy-Konto mit WaWi-Verbindung (BIS ERP oder Kundencenter).
4	Netzwerkzugang	Der BISpicy-Server muss die JTL-Wawi REST API erreichen können (Port freigegeben, ggf. VPN/Port-Forwarding bei OnPremise).

Hinweis: Die JTL REST API befindet sich derzeit noch im Beta-Stadium. Einige Endpunkte können sich in zukünftigen JTL-Versionen ändern. BISpicy passt die Integration laufend an neue JTL-API-Versionen an.

Kostenlos: Die JTL-Wawi Integration ist für alle BISpicy-Nutzer kostenlos verfügbar. Es ist kein Premium-Feature oder Zusatz-Abo erforderlich.

Einrichtung

Die Einrichtung erfolgt in 9 Schritten — alle der Reihe nach, ohne hin und her zu springen.

1JTL-Wawi REST API Server starten

Bevor Sie die Integration einrichten können, muss der REST API Server auf Ihrem JTL-Wawi-Rechner laufen. Sie haben zwei Möglichkeiten:

Option A: Manueller Start über Kommandozeile (CMD)

Öffnen Sie die Eingabeaufforderung (CMD) als Administrator
Navigieren Sie zum JTL-Installationsverzeichnis:
CMDcd "C:\Program Files (x86)\JTL-Software"
Starten Sie den REST API Server:
CMDJTL.Wawi.Rest.exe -w "Standard" -l 0.0.0.0 --port 5883 -d eazybusiness

Parameter	Beschreibung	Standard
`-w`	JTL-Wawi Profilname	`Standard`
`-l`	IP-Adresse, auf der der Server lauscht	`0.0.0.0` (alle Schnittstellen)
`--port`	Port für die REST API	`5883`
`-d`	Name der JTL-Datenbank	`eazybusiness`

IP-Adresse: 127.0.0.1 = nur lokaler Zugriff, 192.168.x.x = Zugriff im lokalen Netzwerk, 0.0.0.0 = alle Schnittstellen (lokal + Netzwerk + extern). Für die BISpicy-Anbindung muss der Server von außen erreichbar sein — verwenden Sie 0.0.0.0.

Option B: Automatischer Start als Windows-Dienst (empfohlen)

Ab JTL-Wawi 1.9 können Sie den REST API Server als Windows-Dienst installieren, sodass er automatisch mit Windows startet:

CMD (als Administrator)JTL.Wawi.Rest.exe install --instancename "JTL-Wawi API" -w "Standard" -l 0.0.0.0 --port 5883 -d eazybusiness

Der Dienst lässt sich über die Windows-Dienstverwaltung (services.msc) starten, stoppen und auf "Automatisch" setzen.

Wichtig: Falls der Server unerwartet stoppt, prüfen Sie ob der Editiermodus in JTL-Wawi aktiv ist — dieser kann den API-Server blockieren. Schließen Sie ggf. den Editiermodus.

CMD-Fenster nicht hochscrollen! Wenn Sie im CMD-Fenster nach oben scrollen, wird der Server pausiert und ist nicht mehr erreichbar. Stellen Sie sicher, dass Sie nach dem Scrollen mit der Enter-Taste wieder ganz nach unten scrollen. Andernfalls kommt es zu Fehlermeldungen, dass der Server nicht erreichbar ist.

JTL-Dokumentation: Die vollständige Anleitung finden Sie auch direkt bei JTL: JTL-Wawi API über Kommandozeile starten

2BISConnect einrichten (On-Premise)

Bei einer lokal installierten JTL-Wawi benötigen Sie BISConnect als Brücke zwischen dem BISpicy-Cloud-Server und Ihrem lokalen JTL-Server:

BISConnect für Windows herunterladen

BISConnect auf dem JTL-Server installieren und starten
In BISpicy unter JTL-Integration den BISConnect-Token generieren
Token und JTL-Wawi lokale URL (z.B. http://127.0.0.1:5883) in BISConnect eintragen
BISConnect verbinden, dann in BISpicy "Status aktualisieren" klicken

BISConnect Client — verbindet Ihren lokalen JTL-Server mit der BISpicy Cloud

JTL Cloud: Bei JTL Cloud ist kein BISConnect erforderlich — überspringen Sie diesen Schritt und verwenden Sie die von JTL bereitgestellte Cloud-URL.

3BISpicy Kundencenter → Verbindungsdaten eingeben

Navigieren Sie in BISpicy zur JTL-Integration:

BIS ERP: Menü → Integrationen → JTL-Wawi
Kundencenter: Menü → JTL-Wawi Integration

Klicken Sie auf "Mit JTL verbinden" und füllen Sie den Dialog aus:

BISpicy Verbindungsdialog — Server-URL, Datenbankname und Registrierung

Feld	Beschreibung	Beispiel
Verbindungsname	Frei wählbarer Name für diese Verbindung	`JTL-Wawi`
JTL-Wawi Server-URL	IP-Adresse Ihres JTL-Servers (Port wird automatisch ergänzt, Standard: `5883`)	`192.168.1.61`
JTL-Wawi On-Premise	Aktivieren, wenn JTL lokal installiert ist (nicht Cloud)	Ein / Aus
Datenbankname	Name der JTL-Datenbank (der gleiche wie beim Start des API-Servers, Parameter `-d`)	`eazybusiness`

Noch nicht auf "Registrierung starten" klicken! Zuerst muss in JTL-Wawi die Registrierung vorbereitet werden (nächster Schritt).

4JTL-Wawi → Registrierung beginnen

Wechseln Sie zur JTL-Wawi Desktop-Anwendung und öffnen Sie den Registrierungsdialog:

Öffnen Sie in JTL-Wawi: JTL-Wawi API → Anwendung registrieren
Klicken Sie auf "Registrierung beginnen"
JTL-Wawi zeigt: "Es wird auf die Übermittlung einer Registrierungsanfrage durch die zu registrierende Anwendung gewartet..."

JTL-Wawi API - Registrierungsanfrage entgegennehmen

JTL-Wawi wartet auf die Registrierungsanfrage von BISpicy

Lassen Sie dieses Fenster geöffnet und wechseln Sie zurück zu BISpicy (nächster Schritt).

5BISpicy → Registrierung starten

Klicken Sie jetzt in BISpicy auf "Registrierung starten". BISpicy sendet die Anfrage an Ihre JTL-Wawi.

Kein manuelles Kopieren nötig: Der API-Key wird automatisch zwischen JTL-Wawi und BISpicy ausgetauscht.

6JTL-Wawi → App bestätigen

In JTL-Wawi erscheint jetzt die erkannte Anwendung. Gehen Sie alle Schritte vollständig durch:

JTL-Wawi API - BISpicy POS & ERP erkannt

JTL-Wawi hat die BISpicy-App erkannt — klicken Sie auf "Weiter"

a) Anwendungsinformationen — prüfen und auf "Weiter" klicken.

b) Benutzer zuordnen — vergeben Sie einen Benutzernamen (z.B. BISpicy):

Benutzername für die BISpicy-App vergeben

c) Zugriffsverwaltung — alle fünf API-Scopes müssen erteilt sein:

all.read — Lesezugriff auf alle Daten (Artikel, Kunden, Bestand)
stock.stockadjustment — Bestandsänderungen durchführen
salesorder.createsalesorder — Kassenverkäufe als Aufträge anlegen
customer.createcustomer — POS-Barkauf-Kunden automatisch erstellen
customers.write — Kundendaten schreiben

Alle API-Scopes müssen als "Erteilen" angehakt sein

d) Einrichtung abschließen — Zusammenfassung prüfen und auf "Fertigstellen" klicken:

Zusammenfassung prüfen und auf "Fertigstellen" klicken

7BISpicy → Registrierung abschließen

Zurück in BISpicy: Aktivieren Sie die Checkbox "Einrichtung in JTL-Wawi abgeschlossen" und klicken Sie auf "Registrierung abschließen".

Erst aktivieren, wenn JTL-Wawi fertig ist! Die Checkbox darf erst angehakt werden, wenn alle Schritte in JTL-Wawi komplett abgeschlossen sind (inkl. Benutzer- und Rechtevergabe). Andernfalls kann der API-Key nicht abgerufen werden.

BISpicy - Einrichtung in JTL-Wawi abschließen

Checkbox aktivieren und "Registrierung abschließen" klicken

Nach dem Klick wird der API-Key automatisch abgerufen:

Verbindung erfolgreich — der API-Key wurde automatisch gespeichert

In der JTL-Wawi Übersicht erscheint die Checkbox "Registrierung abgeschlossen" automatisch als angehakt:

JTL-Wawi Übersicht — Registrierung abgeschlossen

8Sync-Richtung konfigurieren

Legen Sie für jeden Datentyp fest, in welche Richtung synchronisiert werden soll. Details dazu finden Sie im nächsten Abschnitt Sync-Konfiguration.

9Verbindung testen

Klicken Sie auf "Testen", um die Erreichbarkeit und Authentifizierung zu prüfen.

Status	Bedeutung
Verbunden	Verbindung erfolgreich. Sie können den ersten Sync auslösen.
Fehlgeschlagen	Prüfen Sie URL, API-Key und Netzwerk (siehe Fehlerbehebung).

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

Datentyp	Zu JTL	Von JTL	Bidirektional	Aus
Produkte
Bestellungen
Kunden
Bestand
Kategorien

Bestellungen nur "Zu JTL": POS-Verkäufe werden als Aufträge (Sales Orders) in JTL-Wawi angelegt. Eine Rücksynchronisierung von JTL-Aufträgen zur Kasse ist nicht vorgesehen, da die POS-App die Quelle aller Kassenverkäufe ist.

Konfliktauflösung bei bidirektionalem Sync: Wenn dasselbe Feld in beiden Systemen gleichzeitig geändert wird, gewinnt JTL-Wawi bei Konflikten. Stellen Sie sicher, dass Sie Stammdaten möglichst nur in einem System pflegen, um Konflikte zu vermeiden.

Empfohlene Konfigurationen

Szenario	Produkte	Bestand	Kunden	Bestellungen
JTL ist Hauptsystem Stammdaten werden in JTL gepflegt	Von JTL	Bidirektional	Bidirektional	Zu JTL
POS ist Hauptsystem Stammdaten werden in BISpicy gepflegt	Zu JTL	Bidirektional	Zu JTL	Zu JTL
Beide Systeme gleichberechtigt Änderungen in beiden Systemen möglich	Bidirektional	Bidirektional	Bidirektional	Zu JTL

Feld-Mapping

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

Produkte

BISpicy-Feld	JTL-Wawi-Feld	Hinweis
`sku`	`SKU`	Artikelnummer - dient als eindeutiger Schlüssel für den Abgleich
`name`	`Name`	Produktname
`shortDescription`	`ShortDescription`	Kurzbeschreibung
`ean`	`Identifiers.Gtin`	EAN/GTIN Barcode
`sellingPrice`	`ItemPriceData.SalesPriceNet`	Netto-Verkaufspreis
`purchasePrice`	`ItemPriceData.PurchasePriceNet`	Netto-Einkaufspreis
`taxRate`	`TaxClassId`	Steuersatz (wird über JTL Steuerklassen gemappt)
`stockQuantity`	`StorageOptions`	Lagerbestand
`category`	`Categories[].CategoryId`	Kategorie (wird per Name/ID aufgelöst)

Verkäufe (POS → JTL SalesOrders)

BISpicy-Feld	JTL-Wawi-Feld	Hinweis
`saleId`	`ExternalNumber`	Externe Belegnummer zur Referenz
`saleDateTime`	`SalesOrderDate`	Verkaufsdatum und -uhrzeit
`cashierName`	`Comment`	Kassierer-Name wird als Kommentar hinterlegt
`paymentMethod`	`PaymentMethodName`	Zahlungsart (Bar, Karte, SumUp, Zettle, etc.)
`items[].name`	`LineItems[].Name`	Positionsname
`items[].quantity`	`LineItems[].Quantity`	Menge (inkl. Dezimalmengen bei teilbaren Produkten)
`items[].unitPrice`	`LineItems[].SalesPriceNet`	Netto-Einzelpreis
`items[].taxRate`	`LineItems[].TaxRate`	Steuersatz der Position (z.B. 19, 7)

Artikel-Zuordnung: Positionen werden über die SKU (Artikelnummer) den JTL-Artikeln zugeordnet. Stellen Sie sicher, dass die SKUs in beiden Systemen übereinstimmen.

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:

BISpicy POS - Anmeldung im Einrichtungs-Wizard

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

BISpicy POS - Kundenkonto Login in den Einstellungen

Kundenkonto-Login in den App-Einstellungen

Welches Konto verwenden? Melden Sie sich mit dem gleichen Konto an, das auch im Kundencenter die JTL-Verbindung eingerichtet hat. Alternativ können Sie in der BISpicy Warenwirtschaft (BIS ERP) einen Systembenutzer speziell für die Kasse anlegen — so ist die Kassenapp nicht an ein persönliches Konto gebunden.

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

BISpicy POS - Kundenkonto verbunden mit Statusindikator

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:

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

Erster Sync kann einen Moment dauern: Je nach Artikelanzahl kann der initiale Abgleich zwischen JTL-Wawi und der Kassenapp einige Minuten in Anspruch nehmen. Danach werden nur noch Änderungen übertragen (Delta-Sync).

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

Intervall	Empfohlen für
1 Minute	Häufige Preisänderungen, Echtzeit-Bestand
5 Minuten	Aktiver Kassenbetrieb mit regelmäßigen Änderungen
15 Minuten (Standard)	Die meisten Betriebe
30 Minuten	Wenige Änderungen im Tagesverlauf
60 Minuten	Reine Stammdaten, selten aktualisiert

BISpicy POS - Sync-Intervall Einstellung

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

Wählen Sie das gewünschte Intervall für den automatischen Abgleich:

Intervall	Beschreibung	Empfohlen für
15 Minuten	Sehr häufiger Abgleich, nahezu Echtzeit	Hohe Transaktionsvolumen, Omnichannel
30 Minuten	Guter Kompromiss aus Aktualität und Last	Die meisten Betriebe
1 Stunde	Stündlicher Abgleich	Mittleres Transaktionsvolumen
6 Stunden	Mehrmals täglich	Wenige tägliche Änderungen
24 Stunden	Einmal täglich (nachts)	Reine Stammdaten-Synchronisation

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 JTL-Wawi Integration → 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

Zwei getrennte Sync-Intervalle beachten! Die Daten durchlaufen zwei Stationen:

JTL-Wawi ↔ Kundencenter — Intervall im Kundencenter (z.B. alle 5 Min). Hier werden Artikel, Bestand, Kategorien etc. zwischen JTL und der BISpicy Cloud abgeglichen.
Kundencenter ↔ Kassenapp — Intervall in der Kassenapp (Standard: 15 Min, einstellbar unter Einstellungen → Daten & Sicherung). Hier holt sich die Kasse die Daten aus der Cloud.

Das Kundencenter ist die Zentrale zwischen JTL-Wawi und Kassenapp. Beide Intervalle sind unabhängig voneinander konfigurierbar.

Delta-Sync: Es werden nur geänderte Datensätze synchronisiert (basierend auf updated_at Timestamps). Ein vollständiger Abgleich aller Daten ist nicht nötig und spart Bandbreite.

Bekannte Einschränkungen

Die JTL-Wawi REST API (v1) befindet sich noch im Beta-Stadium. Einige Funktionen sind derzeit eingeschränkt:

Aufträge: Bezahl- und Lieferstatus kann nicht über die API gesetzt werden

Die JTL REST API v1 unterstützt weder PATCH (Update) noch Workflow-Events für Aufträge. POS-Kassenverkäufe werden daher als "Nicht bezahlt" und "Ausstehend" in JTL-Wawi angelegt.

Empfohlener Workaround: JTL-Workflow einrichten

Erstellen Sie in JTL-Wawi unter Admin → JTL-Workflows einen automatischen Workflow:

Auslöser: Neuer Auftrag erstellt
Bedingung: Anmerkung enthält BISpicy POS
Aktionen:
- Bezahlstatus auf "Bezahlt" setzen
- Lieferstatus auf "Komplett geliefert" setzen

Stücklisten/BOM: Komponenten werden nicht automatisch verknüpft

Die JTL REST API v1 unterstützt keine Stücklisten-Verknüpfung in Auftragspositionen. Wenn ein Stücklistenartikel (z.B. ein 30er-Pack) über die Kasse verkauft wird, erscheint in JTL der Hinweis "Stückliste wurde ohne Komponenten erstellt". Die Komponenten müssen in JTL manuell aufgelöst oder über einen Workflow ergänzt werden.

Diese Einschränkungen werden automatisch behoben, sobald JTL-Software die REST API erweitert. BISpicy passt die Integration laufend an neue JTL-API-Versionen an.

Fehlerbehebung

Nachfolgend finden Sie Lösungen für die häufigsten Probleme bei der JTL-Integration.

"HttpListenerException: Format des Netzwerknamens ungültig"

Problem: Der REST API Server startet nicht und meldet System.Net.HttpListenerException: Das Format des angegebenen Netzwerknamens ist unzulässig.

Ursache: Windows kann den Server nicht auf die angegebene IP-Adresse binden — häufig nach einem Neustart, wenn Netzwerkadapter (WLAN, VPN) deaktiviert sind.

Lösung (der Reihe nach versuchen):

Stellen Sie sicher, dass die CMD als Administrator geöffnet ist
URL-Reservierung in Windows anlegen:
CMD (Admin)netsh http add urlacl url=http://+:5883/ user=Everyone
Falls die Reservierung bereits existiert — erst löschen, dann neu anlegen:
CMD (Admin)netsh http delete urlacl url=http://+:5883/ netsh http add urlacl url=http://+:5883/ user=Everyone
Falls weiterhin fehlschlägt: Starten Sie zunächst mit localhost zum Testen:
CMD (Admin)JTL.Wawi.Rest.exe -w "Standard" -l 127.0.0.1 --port 5883 -d eazybusiness

Hinweis: Mit 127.0.0.1 ist der Server nur lokal erreichbar. Für die BISpicy-Anbindung muss der Server von außen erreichbar sein. Prüfen Sie in diesem Fall, ob deaktivierte Netzwerkadapter (WLAN, VPN) das Binden auf 0.0.0.0 verhindern, und aktivieren Sie diese ggf. wieder.

"Verbindung fehlgeschlagen"

Problem: Der Verbindungstest schlägt fehl, die JTL-Wawi ist nicht erreichbar.

Lösung:

Prüfen Sie, ob die IP-Adresse und der Port korrekt eingegeben sind (Standard-Port: 5883)
Stellen Sie sicher, dass die Windows-Firewall auf dem JTL-Server den Port freigibt
Bei OnPremise: Prüfen Sie, ob der JTL-Server von außen erreichbar ist (Port-Forwarding, VPN)
Prüfen Sie, ob der JTL REST API Server auf dem Server läuft (siehe Schritt 1: REST API Server starten)

"401 Unauthorized"

Problem: Die Authentifizierung schlägt fehl.

Lösung:

Prüfen Sie, ob der API-Key korrekt kopiert wurde (keine Leerzeichen am Anfang/Ende)
Prüfen Sie, ob die App-Registrierung in JTL noch aktiv ist
Erstellen Sie ggf. eine neue App-Registrierung in JTL und verwenden Sie den neuen Key

"Timeout"

Problem: Die Verbindung wird hergestellt, aber die Anfrage läuft in ein Timeout.

Lösung:

Prüfen Sie die Netzwerkverbindung zwischen BISpicy-Server und JTL-Server
Bei großen Datenmengen: Reduzieren Sie ggf. die Batch-Größe beim initialen Sync
Prüfen Sie die Server-Auslastung des JTL-Servers (CPU, RAM)

"Produkte werden nicht synchronisiert"

Problem: Neue oder geänderte Produkte erscheinen nicht im jeweils anderen System.

Lösung:

Prüfen Sie die Sync-Richtung für Produkte (siehe Sync-Konfiguration)
Stellen Sie sicher, dass der Auto-Sync aktiv ist oder lösen Sie einen manuellen Sync aus
Prüfen Sie, ob die Produkte eine SKU (Artikelnummer) haben - ohne SKU ist kein Abgleich möglich

"Bestand stimmt nicht"

Problem: Der Lagerbestand in BISpicy weicht vom Bestand in JTL-Wawi ab.

Lösung:

Prüfen Sie, welcher Lagerort in JTL-Wawi für den Sync verwendet wird (Standard-Lager)
Stellen Sie sicher, dass die Bestandsführung in JTL auf dem korrekten Lagerort aktiv ist
Lösen Sie bei Abweichungen einen manuellen Vollsync aus, um die Bestände neu abzugleichen
Prüfen Sie, ob Reservierungen in JTL den verfügbaren Bestand reduzieren

Weitere Hilfe

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

In-App Support

Öffnen Sie ein Support-Ticket direkt in der BISpicy POS App unter Einstellungen → Support.

E-Mail

Schreiben Sie uns an [email protected] mit einer Beschreibung des Problems.