Fehlerbehebung beim JTL-Umzug

Hier findest du Lösungen für die häufigsten Stolpersteine beim Umzug von JTL-Wawi.

#Verbindung

#jtl-bridge meldet „Die Wawi-API … ist nicht erreichbar“

jtl-bridge erreicht den REST-Server nicht. Prüfe: Läuft der REST-Server? Stimmen Rechnername, Port und Datenbankname in der Adresse (http://wawi-server:<port>/api/eazybusiness)? Lässt die Firewall des Wawi-Rechners den Port im internen Netz zu? Läuft jtl-bridge wirklich im selben Netz?

#„Die Wawi-API lehnt den API-Schlüssel ab“

Der Schlüssel ist falsch kopiert oder die App-Registrierung wurde in der Wawi entfernt. Starte jtl-bridge register erneut, bestätige in der Wawi und trage den neuen Schlüssel in allverto ein. Details: REST-API einrichten.

#Ich finde die App-Registrierung in der Wawi nicht

Laut unseren Unterlagen heißt der Punkt in Wawi 2.2 Admin → App-Registrierung. In anderen Versionen kann er anders heißen – such im Admin-Menü nach „App“ oder „API“. Die Anfrage erscheint erst, nachdem jtl-bridge register sie gesendet hat.

#„Nur HTTPS ist erlaubt“

jtl-bridge lädt aus Sicherheitsgründen nur über https:// hoch. Prüfe die allverto-Adresse im Befehl.

#„Daten direkt abholen“ schlägt fehl

Das geht nur, wenn deine Wawi-API aus dem Internet erreichbar ist – was meist nicht der Fall ist (und auch nicht sein muss). Nutze jtl-bridge im Firmennetz.

#Daten und Probelauf

#Die Mengen unter „Gefundene Daten“ passen nicht zu meiner Wawi

Hast du einen Umstellungstag eingetragen, werden nur Belege bis zu diesem Tag berücksichtigt. Beim API-Weg fehlen Abos und Eingangsrechnungen, wenn du jtl-bridge ohne --fill-from-db gestartet hast.

#Was bedeuten die Ergebnisse im Protokoll?

Je Datensatz siehst du, ob er neu angelegt, aktualisiert, übersprungen (unverändert oder nicht unterstützt) oder abgelehnt wurde – mit Grund. Filtere nach Ergebnis und Datenart und lade das Protokoll bei Bedarf als CSV herunter.

#Warum sind einige Attribute „übersprungen“?

Die Wawi-API liefert Artikel-Attribute nur als Kennung ohne Namen. Mit --fill-from-db und hinterlegter Datenbank ergänzt jtl-bridge die Namen.

#Werden Daten doppelt angelegt, wenn ich mehrmals übernehme?

Nein. allverto merkt sich zu jedem JTL-Datensatz, was daraus geworden ist. Unveränderte Datensätze werden übersprungen, geänderte nachgezogen.

#Warum ziehen übernommene Rechnungen keine neue Nummer?

Belege kommen 1:1 mit ihrer Original-Nummer aus JTL. Deshalb übernimmst du die Nummernkreise zuerst – so geht es nach dem Umzug mit der nächsten freien Nummer weiter.

#Abschluss

#Kann ich nach dem Abschluss noch einmal nachziehen?

Nein. Nach Umstellung abschließen ist das Import-Token ungültig und die Zwischenablage gelöscht. Starte deshalb am Umstellungstag zuerst einen Delta-Lauf und prüfe das Protokoll.

#Bleiben die Protokolle erhalten?

Ja. Übernommene Daten, Zuordnungen und Protokolle bleiben auch nach dem Abschluss erhalten.