JTL-Wawi
Der Preisprüfer liest Artikel und Preise aus JTL-Wawi über die offizielle REST-API von JTL-Wawi (JTL-Wawi API). Angezeigt werden der Artikelname und der Bruttopreis: der Netto-Verkaufspreis des Artikels zuzüglich des Mehrwertsteuersatzes, den JTL-Wawi für diesen Artikel ermittelt.
Anders als bei Subiekt oder Optima verbindet sich der Preisprüfer nicht mit der SQL-Datenbank — er kommuniziert mit dem REST-Server Ihrer JTL-Wawi-Installation und meldet sich mit einem Token an, das JTL-Wawi ausstellt.
Bevor Sie beginnen
- JTL-Wawi mit der JTL-Wawi API. Der REST-Server ist Bestandteil von JTL-Wawi (empfohlen ab Version 1.10). Eine API-Instanz legen Sie im JTL-Administrator oder mit
JTL.Wawi.Rest.exean; sie kann als Windows-Dienst laufen. Je nach Ihrem JTL-Vertrag muss das Modul JTL-Wawi API im JTL-Kundencenter gebucht werden — die aktuellen Konditionen erfahren Sie bei JTL. - Der API-Server läuft und ist aus dem Netzwerk des Geschäfts erreichbar. Der Standardport ist 5883. Lassen Sie in der Windows-Firewall des Servers eingehende Verbindungen auf diesem Port zu (der JTL-Administrator kann die Regel für Sie anlegen).
- Der Preisprüfer befindet sich im selben Netzwerk wie der Server der JTL-Wawi API (oder erreicht ihn per VPN).
- Ein Administrator kann sich in JTL-Wawi anmelden — der Preisprüfer registriert sich als App, und diese Registrierung muss in JTL-Wawi bestätigt werden.
Adresse der JTL-Wawi API
Die Adresse besteht aus der IP-Adresse des Servers, dem API-Port und dem Pfad /api/eazybusiness/:
https://192.168.1.10:5883/api/eazybusiness/
- Verwenden Sie die IP-Adresse des Computers, auf dem die JTL-Wawi API läuft, nicht seinen Namen.
- Verwenden Sie
http://oderhttps://— so, wie die API-Instanz eingerichtet ist. Bei HTTPS hat die API meist ein selbstsigniertes Zertifikat; deaktivieren Sie dann SSL-Zertifikat prüfen (siehe unten). eazybusinessist der Name der JTL-Wawi-Datenbank. Hat die Datenbank Ihrer Firma einen anderen Namen, tragen Sie diesen im Pfad ein.
Die Adresse können Sie im Browser eines Computers im selben Netzwerk prüfen: https://<Adresse>:5883/swagger sollte die Seite mit der API-Dokumentation öffnen.
Einrichtung Schritt für Schritt
- Öffnen Sie die Einstellungen, Tab Quelle.
- Wählen Sie in der Liste JTL-Wawi.
- Füllen Sie Adresse, App-ID und App-Version aus (siehe Tabelle unten).
- Tippen Sie auf Token generieren. Es erscheint ein Fenster: Bestätigen Sie die App-Registrierung in JTL-Wawi (Admin → App-Registrierung).
- Öffnen Sie in JTL-Wawi Admin → App-Registrierung (verfügbar in der neuen Oberfläche von JTL-Wawi). Dort wartet die Anfrage von HDWR Price Checker (Anbieter HDWR Global, Berechtigung zum Lesen von Artikeln). Bestätigen Sie sie.
- Der Preisprüfer prüft alle paar Sekunden, ob die Registrierung bestätigt wurde. Nach der Bestätigung füllt er das Feld Token aus und zeigt Token erfolgreich generiert an.
- Prüfen Sie die übrigen Felder (Firma, Länder, Suchschalter) und tippen Sie auf Verbindungstest.
- Speichern Sie die Einstellungen und scannen Sie einige Artikel.
| Feld | Was einzutragen ist | Beispiel |
|---|---|---|
| Adresse | Die Adresse der JTL-Wawi API, siehe oben. | https://192.168.1.10:5883/api/eazybusiness/ |
| App-ID | Ein beliebiger Name, unter dem dieser Preisprüfer als App in JTL-Wawi erscheint. Vor dem Generieren des Tokens erforderlich. | hdwr-pricechecker |
| App-Version | Eine beliebige Versionsbezeichnung, vor dem Generieren des Tokens erforderlich. | 1.0 |
| Token | Wird von Token generieren ausgefüllt. Sie können auch einen in JTL-Wawi ausgestellten API-Schlüssel für dieselbe App-ID einfügen. | wird automatisch ausgefüllt |
| SSL-Zertifikat prüfen | Bei einem vertrauenswürdigen Zertifikat aktiviert lassen; bei einem selbstsignierten Zertifikat der API deaktivieren. | ✓ |
| Suche nach Artikelnummer (SKU) | Suche nach der JTL-Artikelnummer. Standardmäßig aktiviert. | ✓ |
| Suche nach EAN-Code | Suche nach der GTIN/EAN des Artikels. Standardmäßig deaktiviert. | ✓ |
| Firmen-ID | Die Firma in JTL-Wawi, deren Steuereinstellungen verwendet werden. Meist 1. | 1 |
| Abgangsland (ISO) | Land, aus dem die Ware verkauft wird — zweistelliger ISO-Code. | DE |
| Versandland (ISO) | Land des Kunden — im Ladengeschäft dasselbe Land wie das des Geschäfts. | DE |
Das Token wird für die angegebene App-ID und App-Version ausgestellt. Ändern Sie eines davon, lehnt JTL-Wawi das Token ab — Sie sehen dann JTL-Wawi hat den Token abgelehnt. Prüfen Sie App-ID und App-Version oder generieren Sie einen neuen Token. Generieren Sie in diesem Fall das Token neu und bestätigen Sie die neue Registrierung.
Ist bereits ein Token eingetragen, fragt Token generieren zuerst, ob es überschrieben werden soll. Funktioniert das aktuelle Token, brauchen Sie kein neues.
Preis und Suche
- Auf dem Bildschirm erscheint der Bruttopreis: der Netto-Verkaufspreis des Artikels aus JTL-Wawi multipliziert mit dem Mehrwertsteuersatz, gerundet auf zwei Nachkommastellen.
- Den Steuersatz ermittelt JTL-Wawi für die angegebene Firma, das Abgangsland und das Versandland — ein Geschäft in Deutschland erhält also z. B. 19 % oder 7 %, je nach Steuerklasse des Artikels. Artikel mit Differenzbesteuerung haben einen Satz von 0 %, daher wird bei ihnen der Nettopreis angezeigt.
- Verwendet wird der Standard-Verkaufspreis des Artikels. Kundengruppenpreise, Preislisten und Sonderpreise werden nicht berücksichtigt.
- Suche nach Artikelnummer (SKU) vergleicht den gescannten Code mit der Artikelnummer; Groß- und Kleinschreibung spielt keine Rolle.
- Suche nach EAN-Code vergleicht den gescannten Code exakt mit der GTIN des Artikels.
- Sind beide Schalter deaktiviert, sucht die App nach der Artikelnummer.
Antwortzeit
Jeder Scan ist eine Live-Abfrage an JTL-Wawi, sodass eine Preisänderung ab dem nächsten Scan sichtbar ist. Die JTL-Wawi API braucht spürbar länger als eine Datenbankabfrage — meist einige Sekunden pro Scan, weil die API alle zum Code passenden Artikel zurückgibt und die App daraus den exakten Treffer auswählt.
Bei kurzen Codes, die in vielen Artikeln vorkommen (z. B. eine dreistellige Zahl, die auch Teil anderer Artikelnummern und Namen ist), bricht die App die Suche nach etwa 40 Sekunden oder 500 Treffern ab und zeigt Zu viele Treffer - Artikel nicht eindeutig an. Scannen Sie dann den EAN-Code oder verwenden Sie längere Artikelnummern.
Meldungen speziell für JTL-Wawi
| Meldung | Ursache und Lösung |
|---|---|
| JTL-Wawi hat den Token abgelehnt. Prüfen Sie App-ID und App-Version oder generieren Sie einen neuen Token. | Das Token passt nicht zur App-ID oder App-Version, oder die Registrierung wurde in JTL-Wawi entfernt. Generieren Sie ein neues Token. |
| Der JTL-Wawi-Server hat mit dem Fehler … geantwortet. | Die Adresse führt zu einem Server, aber nicht zur JTL-Wawi API — z. B. fehlt der Pfad /api/eazybusiness/ oder der Datenbankname. |
| Das Zertifikat des Servers ist nicht vertrauenswürdig. … | Die API verwendet ein selbstsigniertes Zertifikat. Deaktivieren Sie SSL-Zertifikat prüfen. |
| Die Verbindung zu … ist fehlgeschlagen. Prüfen Sie Adresse und Port und ob die REST-API von JTL-Wawi läuft. | Falsche IP-Adresse oder falscher Port, die API-Instanz ist gestoppt, oder die Firewall blockiert Port 5883. |
| Fehler beim Herunterladen der Steuer | Der Artikel wurde gefunden, aber JTL-Wawi hat keinen Steuersatz geliefert — prüfen Sie die Firmen-ID und die beiden Ländercodes. |
| Token-Generierung fehlgeschlagen (oder eine Meldung von JTL-Wawi) | Die Registrierung wurde abgelehnt, oder JTL-Wawi hat einen Fehler zurückgegeben. Prüfen Sie die Adresse und ob Sie die App-Registrierung in der neuen Oberfläche von JTL-Wawi aufrufen. |
Die allgemeinen Meldungen sind unter Fehlerbehebung beschrieben.
Update von der früheren JTL-Wawi-Version der App
Einige Kunden haben eine frühere, ausschließlich für JTL bestimmte Version der App erhalten. Wenn Sie die aktuelle Version darüber installieren, werden die JTL-Wawi-Einstellungen (Adresse, App-ID, Token, Länder) automatisch übernommen, und der Preisprüfer arbeitet ohne neue Konfiguration weiter. Der EAN-Code unter dem Preis bleibt wie in der früheren Version ausgeblendet — Sie können ihn im Tab Allgemein einschalten.