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://albohttps://tak, jak skonfigurowano instancję API. Przy HTTPS API ma zwykle certyfikat samopodpisany – wtedy odznacz Sprawdź certyfikat SSL (patrz niżej). eazybusinessto 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
- Otwórz ustawienia, zakładka Źródło.
- Wybierz z listy JTL-Wawi.
- Wypełnij pola Adres, Id aplikacji i Wersja aplikacji (patrz tabela niżej).
- Naciśnij Generuj token. Pojawi się okno: Potwierdź rejestrację aplikacji w JTL-Wawi (Admin → Rejestracja aplikacji).
- 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ą.
- Sprawdzarka co kilka sekund sprawdza, czy rejestracja została potwierdzona. Po potwierdzeniu wypełnia pole Token i pokazuje Token wygenerowany pomyślnie.
- Sprawdź pozostałe pola (firma, kraje, przełączniki wyszukiwania) i naciśnij Test połączenia.
- Zapisz ustawienia i zeskanuj kilka artykułów.
| Pole | Co wpisać | Przykład |
|---|---|---|
| Adres | Adres JTL-Wawi API, patrz wyżej. | https://192.168.1.10:5883/api/eazybusiness/ |
| Id aplikacji | Dowolna nazwa, pod którą sprawdzarka będzie widoczna jako aplikacja w JTL-Wawi. Wymagane przed wygenerowaniem tokena. | hdwr-pricechecker |
| Wersja aplikacji | Dowolne oznaczenie wersji, wymagane przed wygenerowaniem tokena. | 1.0 |
| Token | Wypełnia go Generuj token. Możesz też wkleić klucz API wydany w JTL-Wawi dla tego samego Id aplikacji. | wypełniane automatycznie |
| Sprawdź certyfikat SSL | Zostaw 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 EAN | Wyszukiwanie po GTIN/EAN artykułu. Domyślnie wyłączone. | ✓ |
| Id firmy | Firma (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 |
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
| Komunikat | Przyczyna 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 podatku | Artykuł 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.