Przejdź do treści
/

Program pomocniczy jtl-bridge

DokumentacjaOstatnio sprawdzono 18.10.2026

jtl-bridge odczytuje JTL-Wawi (bazę danych lub API REST) w sieci firmowej i przesyła dane w postaci zaszyfrowanej do allverto. Polecenia, opcje i bezpieczeństwo.

jtl-bridge to mały program wiersza poleceń do migracji. Działa na komputerze w Twojej sieci firmowej – tam, gdzie dostępne są JTL-Wawi i jej SQL Server – odczytuje dane i przesyła je do allverto szyfrowanym połączeniem. Dzięki temu nie musisz wystawiać do internetu ani bazy danych, ani serwera REST Wawi.

Skąd jtl-bridge bierze dane dostępowe

Serwer, użytkownika i hasło lub adres i klucz API zapisujesz w kreatorze migracji. jtl-bridge loguje się do allverto tokenem importu i pobiera te dane w postaci zaszyfrowanej. Alternatywnie ustawiasz hasło i klucz API tylko lokalnie (JTL_DB_PASSWORD, JTL_API_KEY).

Token importu generujesz w kreatorze przyciskiem Wygeneruj token importu. Jest wyświetlany tylko raz i obowiązuje 30 dni, najdłużej do zakończenia migracji. Przyciskiem Przedłuż o 30 dni przedłużasz go od dziś, przyciskiem Nowy token importu stary token traci ważność. Token obowiązuje ponadto tylko tak długo, jak osoba, która go wygenerowała lub ostatnio przedłużyła, jest aktywna i ma uprawnienie „Przeprowadzenie migracji z JTL-Wawi”.

Polecenia

PolecenieDo czego
jtl-bridge check --url <allverto-Adresse> --token <Import-Token>Sprawdzenie połączenia i struktury bazy danych, zliczenie ilości – niczego nie przesyła.
jtl-bridge upload --url <allverto-Adresse> --token <Import-Token>Odczyt i przesłanie danych.
jtl-bridge register --api-url http://wawi-server:<port>/api/eazybusinessRejestracja allverto w Wawi jako aplikacji i pobranie klucza API (zobacz Konfiguracja API REST).

Odpowiednie polecenie upload z Twoim adresem kreator pokazuje w polu Program pomocniczy jtl-bridge – z przyciskiem do kopiowania.

Ważne opcje

OpcjaZnaczenie
--source db, --source apiwymuszenie sposobu (w przeciwnym razie obowiązuje źródło z allverto)
--fill-from-dbprzy drodze przez API: uzupełnienie z bazy danych tego, czego API nie dostarcza
--until JJJJ-MM-TTtylko dokumenty do tego dnia (dzień przejścia)
--entities a,b,ctylko wybrane rodzaje danych
--no-pdfsbez pobierania PDF faktur
--db-host, --db-instance, --db-port, --db-name, --db-user, --db-encryptlokalne nadpisanie danych bazy danych
--api-urllokalne nadpisanie adresu serwera REST

Bezpieczeństwo

  • jtl-bridge przesyła dane tylko przez HTTPS i w przeciwnym razie przerywa („Nur HTTPS ist erlaubt (Daten verlassen das Firmennetz).” – dozwolony jest tylko HTTPS, dane opuszczają sieć firmową).
  • Oprócz połączenia HTTPS dane są dodatkowo szyfrowane kluczem wyprowadzonym z tokenu importu.
  • allverto przechowuje z tokenu importu tylko odcisk, nigdy sam token.
  • Po dziesięciu nieprawidłowych tokenach z tego samego adresu allverto blokuje kolejne próby na kilka minut.
  • Po Zakończ przejście token traci ważność, a tymczasowo zapisane dane JTL zostają usunięte.

Typowy przebieg

  1. jtl-bridge check … – czy wszystko się zgadza?
  2. jtl-bridge upload … – przesłanie danych.
  3. W allverto: Przypisania → Przebieg testowy → Przejęcie.
  4. Przed dniem przejścia ponownie upload i w allverto Rozpocznij przebieg delta.

Powiązane tematy