Przejdź do treści

Tłumaczenie może być nieaktualne – wersja niemiecka została w międzyczasie zmieniona. Wersja niemiecka

Rozwiązywanie problemów przy migracji z JTL

FAQOstatnio sprawdzono 21.10.2026

Odpowiedzi na typowe pytania i komunikaty błędów przy migracji z JTL-Wawi – połączenie, rejestracja aplikacji (Anwendungsregistrierung), przebieg testowy, protokół i zakończenie.

Tutaj znajdziesz rozwiązania najczęstszych przeszkód przy migracji z JTL-Wawi.

Połączenie

jtl-bridge zgłasza „Die Wawi-API … ist nicht erreichbar” (API Wawi jest nieosiągalne)

jtl-bridge nie może połączyć się z serwerem REST. Sprawdź: czy serwer REST działa? Czy port i nazwa bazy danych w adresie są poprawne? Port to ten, który ustawiono w Wawi dla serwera REST (np. 5883 lub 5885). Program sam szuka na starcie na portach od 5883 do 5890 i po nieudanej próbie pyta ponownie. Najprościej uruchomić jtl-bridge bezpośrednio na komputerze, na którym działa Twoja JTL-Wawi. Jeśli uruchamiasz go na innym komputerze, zapora Windows serwera musi dopuszczać ten port.

„Die Wawi-API lehnt den API-Schlüssel ab” (API Wawi odrzuca klucz API)

Aplikację usunięto w Wawi lub klucz jest nieprawidłowy. Po prostu uruchom jtl-bridge ponownie: zarejestruje wtedy allverto od nowa, Ty przejdziesz w Wawi kreator aż do Einrichtung abschließen, a nowy klucz zastąpi stary. Szczegóły: Konfiguracja API REST.

Jak zarejestrować allverto w Wawi?

Otwórz w JTL-Wawi Anwendungsregistrierungen → Anwendung registrieren (rejestracja aplikacji) i przejdź aż do Registrierung beginnen. Dopiero gdy pojawi się tam „Es wird auf die Übermittlung einer Registrierungsanfrage … gewartet” (oczekiwanie na żądanie rejestracji), naciśnij Enter w oknie jtl-bridge – wcześniej Wawi nie przyjmie żądania. Potem sprawdź Anwendungsinformationen, w Benutzer wybierz użytkownika Wawi, w Zugriffsverwaltung potwierdź uprawnienia (tylko odczyt) i kliknij Einrichtung abschließen.

Gdzie w Wawi znajdę klucz API?

Nigdzie – i tak ma być. Wawi nie pokazuje klucza i nie tworzy go na życzenie. Wydaje go tylko aplikacji, która właśnie o niego prosi. Robi to jtl-bridge i przekazuje klucz zaszyfrowany do allverto.

„Testuj połączenie” mówi, że test wykonuje jtl-bridge

Twój adres (np. localhost lub 192.168.…) jest dostępny tylko na Twoim serwerze lub w sieci firmowej, a nie z internetu. Uruchom jtl-bridge na serwerze i wklej kod konfiguracyjny – wynik pojawi się w kreatorze.

Okno zgłasza „Login failed” przy SQL Server

Chodzi o użytkownika i hasło SQL Server (zwykle sa), a nie o Twoje logowanie do JTL-Wawi. Po nieudanej próbie okno pyta ponownie – po prostu wpisz dane jeszcze raz. Szczegóły: Dostęp przez bazę danych JTL.

„Nur HTTPS ist erlaubt” (dozwolony jest tylko HTTPS)

Ze względów bezpieczeństwa jtl-bridge przesyła dane tylko przez https://. Skopiuj kod konfiguracyjny ponownie z allverto – zawiera on właściwy adres.

„Pobierz dane bezpośrednio teraz” nie działa

Działa to tylko wtedy, gdy Twój serwer Wawi jest dostępny z internetu i otwiera port dla serwerów allverto (2.31.70.120, 2.31.74.112, 2.31.72.228). Sprawdź adres przyciskiem Testuj połączenie. Przy API Wawi musi być też zapisany klucz API (Wyślij rejestrację z allverto). Jeśli Twój serwer jest dostępny tylko w Twojej sieci, użyj jtl-bridge na komputerze, na którym działa Twoja JTL-Wawi.

„Dein REST-Server antwortet nur über HTTPS” (Twój serwer REST odpowiada tylko przez HTTPS)

Twój serwer REST przyjmuje tylko połączenia przez https://. W wyniku testu kliknij Zmień adres na https://. allverto zapisze adres i przetestuje ponownie.

allverto prosi o potwierdzenie certyfikatu

Twój serwer REST używa samodzielnie utworzonego certyfikatu. allverto pokazuje odcisk (SHA-256), wystawcę i ważność. Porównaj odcisk z certyfikatem na serwerze i kliknij Ufaj temu certyfikatowi. Potem allverto łączy się tylko z dokładnie tym certyfikatem. Jeśli allverto zgłosi później inny certyfikat, potwierdź go tylko wtedy, gdy sam go odnowiłeś.

Dane i przebieg testowy

Ilości w „Znalezione dane” nie zgadzają się z moją Wawi

Jeśli wpisano dzień przejścia, uwzględniane są tylko dokumenty do tego dnia. Przy drodze przez API brakuje subskrypcji i faktur zakupowych, jeśli opcja Uzupełnij brakujące dane z bazy danych jest wyłączona.

Co oznaczają wyniki w protokole?

Dla każdego rekordu widzisz, czy został utworzony, zaktualizowany, pominięty (niezmieniony lub nieobsługiwany) czy odrzucony – z powodem. Filtruj według wyniku i rodzaju danych, a w razie potrzeby pobierz protokół jako CSV.

Dlaczego niektóre atrybuty są „pominięte”?

API Wawi dostarcza atrybuty artykułów tylko jako identyfikator bez nazwy. Z opcją Uzupełnij brakujące dane z bazy danych jtl-bridge uzupełnia nazwy.

Czy dane zostaną utworzone podwójnie, jeśli przejmę je kilka razy?

Nie. allverto zapamiętuje dla każdego rekordu JTL, co z niego powstało. Niezmienione rekordy są pomijane, zmienione aktualizowane.

Dlaczego przejęte faktury nie pobierają nowego numeru?

Dokumenty przychodzą 1:1 z oryginalnym numerem z JTL. Dlatego najpierw przejmujesz zakresy numeracji – dzięki temu po migracji numeracja jest kontynuowana od następnego wolnego numeru.

Zakończenie

Czy po zakończeniu mogę jeszcze raz zaktualizować dane?

Nie. Po Zakończ przejście kod konfiguracyjny traci ważność, a dane tymczasowe zostają usunięte. Dlatego w dniu przejścia najpierw uruchom przebieg delta i sprawdź protokół.

Czy protokoły zostają zachowane?

Tak. Przejęte dane, przypisania i protokoły zostają zachowane także po zakończeniu.

Powiązane tematy