Das Hilfsprogramm jtl-bridge
jtl-bridge liest im Firmennetz die JTL-Wawi (Datenbank oder REST-API) und lädt die Daten verschlüsselt zu allverto hoch. Befehle, Optionen und Sicherheit.
jtl-bridge ist ein kleines Kommandozeilen-Programm für den Umzug. Es läuft auf einem Rechner in deinem Firmennetz – dort, wo die JTL-Wawi und ihr SQL Server erreichbar sind –, liest die Daten und lädt sie über eine verschlüsselte Verbindung zu allverto hoch. So musst du weder deine Datenbank noch den REST-Server der Wawi ins Internet stellen.
Wie jtl-bridge an seine Zugangsdaten kommt
Du hinterlegst Server, Benutzer und Passwort bzw. Adresse und API-Schlüssel im Umzugs-Assistenten. jtl-bridge meldet sich mit dem Import-Token bei allverto an und holt sich diese Angaben verschlüsselt ab. Alternativ setzt du Passwort und API-Schlüssel nur lokal (JTL_DB_PASSWORD, JTL_API_KEY).
Das Import-Token erzeugst du im Assistenten mit Import-Token erzeugen. Es wird nur einmal angezeigt und gilt 30 Tage, höchstens bis zum Abschluss des Umzugs. Mit Um 30 Tage verlängern verlängerst du es ab heute, mit Neues Import-Token wird das alte ungültig. Das Token gilt außerdem nur, solange die Person, die es erzeugt bzw. zuletzt verlängert hat, aktiv ist und „Umzug von JTL-Wawi durchführen“ darf.
Befehle
| Befehl | Wofür |
|---|---|
jtl-bridge check --url <allverto-Adresse> --token <Import-Token> | Verbindung und Datenbank-Struktur prüfen, Mengen zählen – lädt nichts hoch. |
jtl-bridge upload --url <allverto-Adresse> --token <Import-Token> | Daten lesen und hochladen. |
jtl-bridge register --api-url http://wawi-server:<port>/api/eazybusiness | allverto in der Wawi als App registrieren und den API-Schlüssel abholen (siehe REST-API einrichten). |
Den passenden upload-Befehl mit deiner Adresse zeigt der Assistent im Kasten Hilfsprogramm jtl-bridge – mit Knopf zum Kopieren.
Wichtige Optionen
| Option | Bedeutung |
|---|---|
--source db, --source api | Weg erzwingen (sonst gilt die Quelle aus allverto) |
--fill-from-db | Beim API-Weg: was die API nicht liefert, aus der Datenbank ergänzen |
--until JJJJ-MM-TT | nur Belege bis zu diesem Tag (Umstellungstag) |
--entities a,b,c | nur bestimmte Datenarten |
--no-pdfs | keine Rechnungs-PDFs holen |
--db-host, --db-instance, --db-port, --db-name, --db-user, --db-encrypt | Datenbank-Angaben lokal überschreiben |
--api-url | Adresse des REST-Servers lokal überschreiben |
Sicherheit
- jtl-bridge lädt nur über HTTPS hoch und bricht sonst ab („Nur HTTPS ist erlaubt (Daten verlassen das Firmennetz).“).
- Die Daten sind zusätzlich zur HTTPS-Verbindung mit einem Schlüssel verschlüsselt, der aus dem Import-Token abgeleitet wird.
- allverto speichert vom Import-Token nur einen Fingerabdruck, nie das Token selbst.
- Nach zehn ungültigen Tokens von derselben Adresse sperrt allverto weitere Versuche für einige Minuten.
- Nach Umstellung abschließen ist das Token ungültig und die zwischengespeicherten JTL-Daten werden gelöscht.
Typischer Ablauf
jtl-bridge check …– passt alles?jtl-bridge upload …– Daten hochladen.- In allverto: Zuordnungen → Probelauf → Übernahme.
- Vor dem Umstellungstag erneut
uploadund in allverto Delta-Lauf starten.