Zum Hauptinhalt springen

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.exe an; 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:// oder https:// — 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).
  • eazybusiness ist 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​

  1. Öffnen Sie die Einstellungen, Tab Quelle.
  2. Wählen Sie in der Liste JTL-Wawi.
  3. Füllen Sie Adresse, App-ID und App-Version aus (siehe Tabelle unten).
  4. Tippen Sie auf Token generieren. Es erscheint ein Fenster: Bestätigen Sie die App-Registrierung in JTL-Wawi (Admin → App-Registrierung).
  5. Ö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.
  6. 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.
  7. Prüfen Sie die übrigen Felder (Firma, Länder, Suchschalter) und tippen Sie auf Verbindungstest.
  8. Speichern Sie die Einstellungen und scannen Sie einige Artikel.
FeldWas einzutragen istBeispiel
AdresseDie Adresse der JTL-Wawi API, siehe oben.https://192.168.1.10:5883/api/eazybusiness/
App-IDEin beliebiger Name, unter dem dieser Preisprüfer als App in JTL-Wawi erscheint. Vor dem Generieren des Tokens erforderlich.hdwr-pricechecker
App-VersionEine beliebige Versionsbezeichnung, vor dem Generieren des Tokens erforderlich.1.0
TokenWird 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üfenBei 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-CodeSuche nach der GTIN/EAN des Artikels. Standardmäßig deaktiviert.✓
Firmen-IDDie 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
App-ID nach dem Generieren des Tokens nicht ändern

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​

MeldungUrsache 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 SteuerDer 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.

JTL-Wawi — FAQ

Wie verbindet sich der HDWR-Preisprüfer mit JTL-Wawi?
Über die offizielle REST-API von JTL-Wawi, standardmäßig auf Port 5883, unter einer Adresse wie https://192.168.1.10:5883/api/eazybusiness/. Der Preisprüfer registriert sich als App, ein Administrator bestätigt sie in JTL-Wawi unter Admin, App-Registrierung, und der Preisprüfer erhält ein Token zum Lesen der Artikel.
Welchen Preis zeigt der Preisprüfer aus JTL-Wawi an?
Den Bruttopreis: den Netto-Verkaufspreis des Artikels zuzüglich des Mehrwertsteuersatzes, den JTL-Wawi für die eingestellte Firma, das Abgangsland und das Versandland ermittelt. Kundengruppenpreise und Sonderpreise werden nicht verwendet.
Benötigt der Preisprüfer Zugriff auf die SQL-Datenbank von JTL-Wawi?
Nein. Er kommuniziert nur mit der JTL-Wawi API und fordert ausschließlich die Berechtigung zum Lesen von Artikeln an. Ein SQL-Login ist nicht nötig.
Warum dauert ein Scan mit JTL-Wawi einige Sekunden?
Die JTL-Wawi API durchsucht alle zum Code passenden Artikel und liefert sie mit ihren Details zurück. Das dauert länger als eine direkte Datenbankabfrage. Die App fordert zuerst eine kurze Liste an, daher dauert ein typischer Scan einige Sekunden. Sehr kurze Codes, die auf Hunderte von Artikeln passen, enden mit der Meldung Zu viele Treffer - Artikel nicht eindeutig.
Der Verbindungstest meldet einen Zertifikatsfehler. Was tun?
Die JTL-Wawi API verwendet meist ein selbstsigniertes HTTPS-Zertifikat. Deaktivieren Sie SSL-Zertifikat prüfen in den Einstellungen der Quelle JTL-Wawi und starten Sie den Test erneut.