JTL Ameise bleibt im Testlauf hängen: Warum der Import nicht in den Echtlauf wechselt

Läuft dein JTL-Ameise-Import ohne Fehlermeldung durch, wechselt aber nicht in den Echtlauf, steckt dahinter meist ein dokumentierter Bug in der Modus-Umschaltung zwischen Testlauf und echtem Import, kein CSV-Problem. Das typische Bild: Der Import läuft durch, am Ende steht trotzdem nur „X Datensätze könnten importiert werden“, und in JTL-Wawi hat sich nichts geändert. Wir zeigen, woran das liegt und wie du es löst.

Deine JTL Ameise zeigt nach dem Testlauf immer wieder nur eine Simulation an, egal was du einstellst?

In diesem Beitrag erklären wir den Unterschied zwischen Testlauf und echtem Import, den bekannten JTL-Bug dahinter (Ticket WAWI-81299) und den Workaround, mit dem du sofort weiterarbeiten kannst.

JTL Ameise Importvorgang-Dialog mit Testlauf-Anzeige, die trotz Klick auf Import starten nicht wechselt

Auf einen Blick

  • JTL Ameise wechselt nach einem Testlauf manchmal nicht mehr in den echten Import. Sie zeigt bei jedem weiteren Versuch wieder nur die Testlauf-Meldung „könnte importiert werden“, obwohl kein Fehler angezeigt wird. Das ist kein Datenproblem, sondern ein dokumentierter Programmfehler.
  • Laut JTL-Mitarbeiter Manuel Pietzsch im offiziellen JTL-Forum ist der Fehler unter Ticket WAWI-81299 erfasst und ab JTL-Wawi Version 1.10.14.0 behoben.
  • Der schnellste Workaround, den ein Nutzer im gleichen Forumsthread beschreibt: JTL Ameise komplett schließen und neu starten, dann direkt importieren, ohne vorher im selben Programmlauf einen Testlauf zu starten.

Wir sehen diesen Fall regelmäßig im Support: Ein Kunde meldet, der Import „tue nichts“, obwohl keine Fehlermeldung erscheint. Der Testlauf selbst ist dabei kein Fehler, sondern eine sinnvolle Funktion, die JTL in der eigenen Dokumentation vor jedem echten Import empfiehlt und die auch wir unseren Kunden entsprechend nahelegen. Das Problem, das dieser Beitrag beschreibt, betrifft nur einen Sonderfall. Die Software wechselt danach nicht mehr korrekt in den Schreibmodus. Stand 24.07.2026 ist der Fehler laut JTL-Forum ab Version 1.10.14.0 behoben; wer noch auf einer älteren Ameise-Version arbeitet, kann direkt betroffen sein.

Testlauf und echter Import: was JTL Ameise offiziell dazu sagt

Laut der offiziellen JTL-Dokumentation zum Aufbau der Import-Funktion öffnet die Schaltfläche „Import starten“ im Hauptfenster das Dialogfenster „Importvorgang“. Darin lassen sich zwei unterschiedliche Vorgänge auslösen: der Importtestlauf (Trockenlauf), bei dem die Datei Datensatz für Datensatz analysiert wird, ohne dass etwas in der JTL-Wawi-Datenbank verändert wird, und der eigentliche Import, der Daten tatsächlich schreibt. JTL empfiehlt im gleichen Dokument ausdrücklich, vor jedem echten Import zuerst einen Testlauf durchzuführen, um Probleme vorab zu erkennen.

Wortlaut aus der JTL-Dokumentation: „Wir empfehlen stets vor einem echten Import einen Testlauf durchzuführen. Ein Testlauf verändert nichts in der Datenbank von JTL-Wawi und zeigt Probleme auf, bevor der Import tatsächlich ausgeführt wird.“

Die zwei Modi im Importvorgang-Dialog laut Doku im Überblick:

  • Testlauf (Trockenlauf): Analysiert die Importdatei Zeile für Zeile, schreibt aber nichts in die JTL-Wawi-Datenbank. Kann jederzeit über ‚Testlauf abbrechen‘ gestoppt werden.
  • Import starten (echter Import): Verändert tatsächlich Daten in der JTL-Wawi-Datenbank. Kann über ‚Import Abbrechen‘ gestoppt werden, solange er läuft.
  • Der dokumentierte Fehlerfall: Laut Ticket WAWI-81299 wechselt Ameise in bestimmten Fällen nicht zwischen beiden Modi: Es wird immer die zuerst genutzte Funktion weiter angezeigt und ausgeführt, auch nach einem neuen Klick auf ‚Import starten‘.

Der Testlauf ist damit weder das Problem noch etwas, das man abschalten sollte. Er ist eine Sicherheitsfunktion, die JTL selbst empfiehlt. Das eigentliche Problem ist ein Fehler in der internen Umschaltung zwischen den beiden Modi.

Nicht zu verwechseln mit einem Import, der abbricht

Läuft dein Import gar nicht erst durch, sondern bricht mit einer Fehlermeldung ab, ist das ein anderes Problem: meist eine fehlerhafte CSV-Formatierung, ein Leerwert statt „0“ in einer Zahlenspalte oder eine falsche Parent-Child-Reihenfolge. Diesen Fall behandelt unser Beitrag zu [JTL Ameise CSV-Import-Fehlern](https://www.vlarom.de/jtl-ameise-csv-import-fehler/). Der hier beschriebene Fall ist anders: Der Import läuft fehlerfrei durch, verändert aber nichts in der Datenbank, weil er weiterhin im Testlauf-Modus steckt.

Warum JTL Ameise nach dem Testlauf nicht in den Echtlauf wechselt

Die Ursache ist kein Bedienfehler und kein Problem der Importdatei. Sie liegt in der Software selbst, belegt durch einen namentlich bekannten JTL-Mitarbeiter im offiziellen Forum und ein eigenes Ticket im JTL-Bugtracker:

1

Bekannter Programmfehler: Ticket WAWI-81299

Ein Nutzer meldete am 04.09.2025 im offiziellen JTL-Forum, dass Ameise nach einem Testlauf ‚immer nur Testlauf‘ sagt, egal welche Schaltfläche er anschließend klickt. Der JTL-Mitarbeiter Manuel Pietzsch antwortete am 06.09.2025 mit Verweis auf Ticket WAWI-81299 und bestätigte den Fehler als bekannt.

Der Tickettitel selbst beschreibt die technische Ursache genau: Ameise wechselt nicht zwischen Testlauf und Import, sondern führt immer die zuerst genutzte Funktion weiter aus und zeigt sie an. Wurde im aktuellen Programmlauf zuerst ein Testlauf gestartet, bleibt jeder weitere Klick auf ‚Import starten‘ im Testlauf-Modus gefangen, ohne Fehlermeldung, aber auch ohne einen einzigen geschriebenen Datensatz.

2

Behoben ab Version 1.10.14.0 (laut JTL-Forenaussage, nicht laut Changelog)

Nach Kritik an der Wartezeit präzisierte Pietzsch am 10.09.2025 im selben Thread, dass der Fix bereits in Version 1.10.14.0 eingeflossen ist. Ein Nutzer bestätigte im Thread danach die erfolgreiche Behebung auf dieser Version. Zur Einordnung: Das ist eine belegte Aussage eines JTL-Mitarbeiters im offiziellen JTL-Forum, keine Aussage aus einem öffentlich zugänglichen Changelog-Eintrag. Einen solchen Eintrag konnten wir zu diesem Fix nicht finden.

JTL-Ameise hat keine eigene Versionsnummer, sie läuft unter der JTL-Wawi-Version (Schema 1.10.x / 1.11.x). Wer prüfen will, ob er betroffen ist: Wawi-Version unter Hilfe > Info nachsehen. Alles unterhalb von 1.10.14.0 kann den Fehler zeigen, ab dieser Version laut JTL-Aussage nicht mehr.

Was du gewinnst, wenn Testlauf und Echtlauf wieder sauber getrennt sind

Kein verlorener Import-Vorlauf mehr

Wer Stunden mit einer Importdatei verbringt, nur um am Ende einen leeren Datenbankstand vorzufinden, verliert Zeit an der falschen Stelle. Sobald die Modus-Umschaltung wieder funktioniert, zeigt dir Ameise nach dem Testlauf zuverlässig an, was tatsächlich passiert, und der anschließende Echtlauf schreibt auch wirklich.

Testlauf bleibt das, was er sein soll: eine Kontrolle vor dem Risiko

Der Testlauf ist kein Umweg, sondern die von JTL selbst empfohlene Absicherung vor jedem größeren Import. Wenn er zuverlässig in den Echtlauf übergibt, kannst du ihn bei jedem Import ohne Bedenken vorschalten, statt ihn aus Frust zu überspringen.

Die Lektion

Aus unserer Praxis: Der Reflex vieler Händler ist, den Testlauf künftig zu überspringen, wenn er einmal „hängengeblieben“ ist. Das ist der falsche Schluss. Der Testlauf selbst funktioniert wie vorgesehen, nur die Umschaltung danach war fehlerhaft. Update oder Workaround lösen das Problem, ohne dass du auf die Sicherheitsfunktion verzichten musst. Wie der Übergang vom Trockenlauf zum Echtlauf regulär abläuft, beschreiben wir in unserem Beitrag zu Ameise-Import und -Export, einen Überblick über alle Ameise-Themen bietet unser JTL-Ameise-Hub.

JTL Ameise Testlauf-Problem lösen: 4 Schritte

Dieser Plan hilft, wenn dein Import ohne Fehlermeldung durchläuft, aber weiterhin nur „könnte importiert werden“ meldet. Bricht dein Import stattdessen mit einer Fehlermeldung ab, ist das ein anderer Fall. Dafür haben wir einen separaten Beitrag zu [CSV-Import-Fehlern](https://www.vlarom.de/jtl-ameise-csv-import-fehler/).

Symptom bestätigen (Schritt 1)

Prüfe die Abschlussmeldung nach dem Import genau. Steht dort weiterhin eine Formulierung wie ‚X Datensätze könnten importiert werden‘ statt einer Bestätigung tatsächlich veränderter Datensätze, und findest du in JTL-Wawi anschließend keine der erwarteten Änderungen, ohne dass eine Fehlermeldung erschien, dann liegt das hier beschriebene Testlauf-Bug-Muster vor.

JTL-Wawi-Version prüfen (Schritt 2)

Öffne in JTL-Wawi den Menüpunkt Hilfe > Info und notiere die Versionsnummer. Läuft deine Installation bereits auf Version 1.10.14.0 oder neuer, ist dieser konkrete Bug laut JTL-Forenaussage nicht die Ursache. Prüfe dann eher Benutzerrechte und Importprofil. Läuft sie darunter, ist ein Update die dauerhafte Lösung.

Sofort-Workaround anwenden (Schritt 3)

Nutzer-Tipp aus dem JTL-Forum, nicht offiziell von JTL bestätigt, aber technisch nachvollziehbar: JTL Ameise vollständig schließen (nicht nur das Import-Fenster) und neu öffnen. Importiere dann direkt über ‚Import starten‘, ohne vorher im selben Programmlauf noch einmal einen Testlauf zu starten. Damit umgehst du die fehlerhafte Modus-Umschaltung, ohne auf den Testlauf beim nächsten Programmstart verzichten zu müssen. Wichtig: Ein erneuter Klick auf ‚Import starten‘ im selben Programmlauf reicht nicht. Ohne kompletten Neustart bleibt Ameise im Testlauf-Modus.

Auf Version 1.10.14.0 oder neuer aktualisieren (Schritt 4)

Die endgültige Lösung ist laut JTL-Mitarbeiter Manuel Pietzsch im offiziellen Forum das Update auf JTL-Wawi 1.10.14.0 oder eine neuere Version. Plane das Update wie jedes JTL-Wawi-Update mit vorherigem Datenbank-Backup und außerhalb der Hauptgeschäftszeit ein.

Ergebnis kontrollieren (Schritt 5)

Führe nach Workaround oder Update einen echten Import mit wenigen Testdatensätzen aus und prüfe anschließend in JTL-Wawi, ob die Daten tatsächlich angekommen sind. Entscheidend ist die Abschlussmeldung: Steht dort weiterhin nur, wie viele Datensätze importiert werden könnten, läuft der Lauf immer noch als Simulation. Wurden die Datensätze geschrieben, ist die Modus-Umschaltung wieder intakt. Welche Felder eine Importvorlage überhaupt schreibt, zeigt die JTL-Ameise-Dokumentation im JTL-Guide.

Häufige Fragen zum JTL Ameise Testlauf-Problem

Das ist ein dokumentierter Programmfehler unter Ticket WAWI-81299: Ameise wechselt in bestimmten Fällen nicht zwischen Testlauf und echtem Import, sondern führt weiter die zuerst im aktuellen Programmlauf genutzte Funktion aus. Wurde zuerst ein Testlauf gestartet, bleibt jeder weitere Import-Versuch im Testlauf-Modus, ohne dass eine Fehlermeldung erscheint. Laut JTL-Forum ist der Fehler ab Version 1.10.14.0 behoben.
Nein. Bricht dein Import mit einer Fehlermeldung ab und werden Datensätze gar nicht oder nur teilweise verarbeitet, liegt das in der Regel an der Datenqualität der CSV-Datei. Dazu haben wir einen eigenen Beitrag zu JTL Ameise CSV-Import-Fehlern. Das hier beschriebene Problem zeigt keine Fehlermeldung, der Import läuft durch, schreibt aber trotzdem nichts in die Datenbank, weil die Software im Testlauf-Modus feststeckt.
Nein, das würde die von JTL empfohlene Sicherheitsfunktion aushebeln. Der von einem Nutzer im JTL-Forum beschriebene Workaround ist ein anderer: Ameise komplett schließen und neu starten, dann direkt importieren, ohne im selben Programmlauf vorher noch einmal einen Testlauf zu starten. Beim nächsten Programmstart kannst du wieder wie gewohnt zuerst testen.
WAWI-81299 ist das JTL-interne Ticket zu diesem Fehler. Der öffentlich sichtbare Tickettitel lautet sinngemäß: Ameise wechselt nicht zwischen Testlauf und Import, es wird immer die zuerst genutzte Funktion genutzt und angezeigt. Der vollständige Ticketinhalt liegt hinter einem Login, der Titel bestätigt aber die im JTL-Forum beschriebene Ursache.
Laut JTL-Mitarbeiter Manuel Pietzsch im offiziellen JTL-Forum ist der Fehler ab Version 1.10.14.0 behoben. Deine aktuelle Version findest du in JTL-Wawi unter Hilfe > Info. Plane das Update wie jedes JTL-Wawi-Update mit vorherigem Datenbank-Backup ein.
Öffne nach dem Import in JTL-Wawi die betroffenen Artikel, Kunden oder Aufträge direkt und prüfe stichprobenartig, ob die erwarteten Werte tatsächlich verändert wurden. Die Abschlussmeldung von Ameise allein reicht nicht als Nachweis. Im hier beschriebenen Fehlerfall zeigt sie weiterhin eine Testlauf-typische Formulierung, obwohl du ‚Import starten‘ geklickt hast.

JTL Service Partner Gold · Ahrensfelde bei Berlin

Ameise-Import hängt fest? Vlarom E-Commerce Agentur schaut sich das direkt an.

Ob Testlauf-Bug, Versions-Update oder ein grundsätzlich sauberes Import-Setup: Wir kennen die typischen JTL-Ameise-Stolperstellen aus der Projektpraxis. Ruf uns an unter +49 30 91473862, schreibe an info@vlarom.de oder nutze unser Kontaktformular.

AL

Alexander Luft

JTL Service Partner Gold · Vlarom E-Commerce Agentur · Ahrensfelde bei Berlin