Przejdź do treści

Rozwiązywanie problemów przy migracji z JTL

FAQOstatnio sprawdzono 15.10.2026

Odpowiedzi na typowe pytania i komunikaty błędów przy migracji z JTL-Wawi – połączenie, rejestracja aplikacji, 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 nazwa komputera, port i nazwa bazy danych w adresie są poprawne (http://wawi-server:<port>/api/eazybusiness)? Czy zapora komputera z Wawi przepuszcza ten port w sieci wewnętrznej? Czy jtl-bridge rzeczywiście działa w tej samej sieci?

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

Klucz został źle skopiowany albo rejestrację aplikacji usunięto w Wawi. Uruchom ponownie jtl-bridge register, potwierdź w Wawi i wpisz nowy klucz w allverto. Szczegóły: Konfiguracja API REST.

Nie mogę znaleźć rejestracji aplikacji w Wawi

Według naszych informacji w Wawi 2.2 ta pozycja nazywa się Admin → App-Registrierung (rejestracja aplikacji). W innych wersjach może się nazywać inaczej – szukaj w menu Admin haseł „App” lub „API”. Żądanie pojawia się dopiero po wysłaniu go przez jtl-bridge register.

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

Ze względów bezpieczeństwa jtl-bridge przesyła dane tylko przez https://. Sprawdź adres allverto w poleceniu.

„Pobierz dane bezpośrednio” nie działa

Działa to tylko wtedy, gdy Twoje API Wawi jest dostępne z internetu – co zwykle nie ma miejsca (i nie musi). Użyj jtl-bridge w sieci firmowej.

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 uruchomiono jtl-bridge bez --fill-from-db.

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 --fill-from-db i zapisaną bazą 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 token importu 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