Przejdź do głównej zawartości

JTL-Wawi

Sprawdzarka odczytuje artykuły i ceny z JTL-Wawi przez oficjalne REST API JTL-Wawi (JTL-Wawi API). Pokazuje nazwę artykułu i cenę brutto: cenę sprzedaży netto artykułu powiększoną o stawkę VAT, którą wylicza dla niego JTL-Wawi.

W odróżnieniu od Subiekta czy Optimy sprawdzarka nie łączy się z bazą SQL – rozmawia z serwerem REST Twojej instalacji JTL-Wawi i loguje się tokenem wydanym przez JTL-Wawi.

Zanim zaczniesz​

  • JTL-Wawi z JTL-Wawi API. Serwer REST jest częścią JTL-Wawi (zalecana wersja 1.10 lub nowsza). Instancję API zakłada się w JTL-Administrator albo programem JTL.Wawi.Rest.exe; może działać jako usługa Windows. Zależnie od umowy z JTL moduł JTL-Wawi API może wymagać wykupienia w JTL-Kundencenter – aktualne warunki sprawdź w JTL.
  • Serwer API jest uruchomiony i osiągalny z sieci sklepu. Domyślny port to 5883. Zezwól na połączenia przychodzące na tym porcie w zaporze Windows na serwerze (JTL-Administrator może sam utworzyć regułę).
  • Sprawdzarka jest w tej samej sieci co serwer JTL-Wawi API (albo łączy się z nim przez VPN).
  • Administrator może zalogować się do JTL-Wawi – sprawdzarka rejestruje się jako aplikacja, a rejestrację trzeba potwierdzić w JTL-Wawi.

Adres JTL-Wawi API​

Adres składa się z adresu IP serwera, portu API i ścieżki /api/eazybusiness/:

https://192.168.1.10:5883/api/eazybusiness/
  • Podaj adres IP komputera, na którym działa JTL-Wawi API, a nie jego nazwę.
  • Użyj http:// albo https:// tak, jak skonfigurowano instancję API. Przy HTTPS API ma zwykle certyfikat samopodpisany – wtedy odznacz Sprawdź certyfikat SSL (patrz niżej).
  • eazybusiness to nazwa bazy danych JTL-Wawi. Jeśli baza Twojej firmy nazywa się inaczej, wpisz w ścieżce jej nazwę.

Adres możesz sprawdzić w przeglądarce na komputerze w tej samej sieci: https://<adres>:5883/swagger powinien otworzyć stronę z dokumentacją API.

Konfiguracja krok po kroku​

  1. Otwórz ustawienia, zakładka Źródło.
  2. Wybierz z listy JTL-Wawi.
  3. Wypełnij pola Adres, Id aplikacji i Wersja aplikacji (patrz tabela niżej).
  4. Naciśnij Generuj token. Pojawi się okno: Potwierdź rejestrację aplikacji w JTL-Wawi (Admin → Rejestracja aplikacji).
  5. W JTL-Wawi otwórz Admin → App-Registrierung (dostępne w nowym interfejsie JTL-Wawi). Czeka tam prośba od HDWR Price Checker (dostawca HDWR Global, uprawnienie do odczytu artykułów). Potwierdź ją.
  6. Sprawdzarka co kilka sekund sprawdza, czy rejestracja została potwierdzona. Po potwierdzeniu wypełnia pole Token i pokazuje Token wygenerowany pomyślnie.
  7. Sprawdź pozostałe pola (firma, kraje, przełączniki wyszukiwania) i naciśnij Test połączenia.
  8. Zapisz ustawienia i zeskanuj kilka artykułów.
PoleCo wpisaćPrzykład
AdresAdres JTL-Wawi API, patrz wyżej.https://192.168.1.10:5883/api/eazybusiness/
Id aplikacjiDowolna nazwa, pod którą sprawdzarka będzie widoczna jako aplikacja w JTL-Wawi. Wymagane przed wygenerowaniem tokena.hdwr-pricechecker
Wersja aplikacjiDowolne oznaczenie wersji, wymagane przed wygenerowaniem tokena.1.0
TokenWypełnia go Generuj token. Możesz też wkleić klucz API wydany w JTL-Wawi dla tego samego Id aplikacji.wypełniane automatycznie
Sprawdź certyfikat SSLZostaw zaznaczone przy zaufanym certyfikacie; odznacz przy samopodpisanym certyfikacie API.✓
Szukaj po kodzie produktu (SKU)Wyszukiwanie po numerze artykułu JTL (Artikelnummer). Domyślnie włączone.✓
Szukaj po kodzie EANWyszukiwanie po GTIN/EAN artykułu. Domyślnie wyłączone.✓
Id firmyFirma (Firma) w JTL-Wawi, której ustawienia VAT są używane. Zwykle 1.1
Kraj nadania (ISO)Kraj, z którego sprzedawany jest towar – dwuliterowy kod ISO.DE
Kraj wysyłki (ISO)Kraj klienta – w sklepie stacjonarnym ten sam co kraj sklepu.DE
Nie zmieniaj Id aplikacji po wygenerowaniu tokena

Token jest wydawany dla podanego Id aplikacji i Wersji aplikacji. Jeśli zmienisz którekolwiek z nich, JTL-Wawi odrzuci token – zobaczysz JTL-Wawi odrzucił token. Sprawdź Id i wersję aplikacji albo wygeneruj nowy token. Wygeneruj wtedy token ponownie i potwierdź nową rejestrację.

Jeśli token jest już wpisany, Generuj token najpierw pyta, czy go nadpisać. Jeśli aktualny token działa, nowy nie jest potrzebny.

Cena i wyszukiwanie​

  • Na ekranie widać cenę brutto: cenę sprzedaży netto artykułu z JTL-Wawi pomnożoną przez stawkę VAT i zaokrągloną do dwóch miejsc po przecinku.
  • Stawkę VAT wylicza JTL-Wawi dla podanej firmy, kraju nadania i kraju wysyłki – sklep w Niemczech dostanie np. 19 % albo 7 %, zależnie od klasy podatkowej artykułu. Artykuły z opodatkowaniem marży (Differenzbesteuerung) mają stawkę 0 %, więc wyświetla się cena netto.
  • Cena to standardowa cena sprzedaży artykułu. Ceny grup klientów, cenniki i ceny specjalne nie są brane pod uwagę.
  • Szukaj po kodzie produktu (SKU) porównuje zeskanowany kod z numerem artykułu; wielkość liter nie ma znaczenia.
  • Szukaj po kodzie EAN porównuje zeskanowany kod z GTIN artykułu dokładnie.
  • Jeśli oba przełączniki są wyłączone, aplikacja szuka po numerze artykułu.

Czas odpowiedzi​

Każdy skan to bieżące zapytanie do JTL-Wawi, więc zmiana ceny jest widoczna od następnego skanu. JTL-Wawi API odpowiada wyraźnie wolniej niż zapytanie do bazy – zwykle kilka sekund na skan, bo API zwraca wszystkie artykuły pasujące do kodu, a aplikacja wybiera dokładne dopasowanie.

Przy krótkich kodach, które występują w wielu artykułach (np. trzycyfrowa liczba będąca też częścią innych numerów artykułów i nazw), aplikacja przerywa wyszukiwanie po około 40 sekundach albo 500 wynikach i pokazuje Zbyt wiele wyników - kod niejednoznaczny. Zeskanuj kod EAN albo używaj dłuższych numerów artykułów.

Komunikaty dotyczące JTL-Wawi​

KomunikatPrzyczyna i rozwiązanie
JTL-Wawi odrzucił token. Sprawdź Id i wersję aplikacji albo wygeneruj nowy token.Token nie pasuje do Id lub wersji aplikacji albo rejestracja została usunięta w JTL-Wawi. Wygeneruj nowy token.
Serwer JTL-Wawi odpowiedział błędem …Adres prowadzi do serwera, ale nie do JTL-Wawi API, np. brakuje ścieżki /api/eazybusiness/ albo nazwy bazy.
Certyfikat serwera nie jest zaufany. …API używa certyfikatu samopodpisanego. Odznacz Sprawdź certyfikat SSL.
Nie można połączyć się z … Sprawdź adres, port i czy REST API JTL-Wawi jest uruchomione.Błędny adres IP lub port, instancja API jest zatrzymana albo zapora blokuje port 5883.
Błąd pobierania podatkuArtykuł został znaleziony, ale JTL-Wawi nie zwrócił stawki VAT – sprawdź Id firmy i oba kody krajów.
Generowanie tokena nie powiodło się (albo komunikat z JTL-Wawi)Rejestracja została odrzucona albo JTL-Wawi zwrócił błąd. Sprawdź adres i to, czy rejestrację (App-Registrierung) otwierasz w nowym interfejsie JTL-Wawi.

Ogólne komunikaty opisuje strona Rozwiązywanie problemów.

Aktualizacja z wcześniejszej wersji aplikacji dla JTL-Wawi​

Część klientów otrzymała wcześniejszą wersję aplikacji, przeznaczoną wyłącznie dla JTL. Po zainstalowaniu na niej aktualnej wersji ustawienia JTL-Wawi (adres, Id aplikacji, token, kraje) są przejmowane automatycznie i sprawdzarka działa dalej bez ponownej konfiguracji. Kod EAN pod ceną pozostaje ukryty, jak we wcześniejszej wersji – możesz go włączyć w zakładce Ogólne.

JTL-Wawi — najczęstsze pytania

Jak sprawdzarka cen HDWR łączy się z JTL-Wawi?
Przez oficjalne REST API JTL-Wawi, domyślnie na porcie 5883, pod adresem w rodzaju https://192.168.1.10:5883/api/eazybusiness/. Sprawdzarka rejestruje się jako aplikacja, administrator potwierdza ją w JTL-Wawi w menu Admin, App-Registrierung, a sprawdzarka otrzymuje token do odczytu artykułów.
Jaką cenę z JTL-Wawi pokazuje sprawdzarka?
Cenę brutto: cenę sprzedaży netto artykułu powiększoną o stawkę VAT, którą JTL-Wawi wylicza dla ustawionej firmy, kraju nadania i kraju wysyłki. Ceny grup klientów i ceny specjalne nie są używane.
Czy sprawdzarka potrzebuje dostępu do bazy SQL JTL-Wawi?
Nie. Komunikuje się wyłącznie z JTL-Wawi API i prosi tylko o uprawnienie do odczytu artykułów. Login SQL nie jest potrzebny.
Dlaczego skan przy JTL-Wawi trwa kilka sekund?
JTL-Wawi API wyszukuje wszystkie artykuły pasujące do kodu i zwraca je ze szczegółami, co trwa dłużej niż bezpośrednie zapytanie do bazy. Aplikacja najpierw prosi o krótką listę, więc typowy skan trwa kilka sekund. Bardzo krótkie kody pasujące do setek artykułów kończą się komunikatem Zbyt wiele wyników - kod niejednoznaczny.
Test połączenia zgłasza błąd certyfikatu. Co zrobić?
JTL-Wawi API zwykle używa samopodpisanego certyfikatu HTTPS. Odznacz Sprawdź certyfikat SSL w ustawieniach źródła JTL-Wawi i uruchom test ponownie.