JTL-Ameise automatisieren: Import und Export ohne Klick

JTL-Ameise ist das vorlagengesteuerte Import- und Export-Werkzeug von JTL-Wawi. Sie liest und schreibt CSV. Für den automatischen Nachtlauf reicht sie allein nicht: Es braucht eine in der Oberfläche gespeicherte Vorlage mit IMP- oder EXP-ID, den Kommandozeilen-Aufruf und den Windows-Aufgabenplaner. Die Batch-Fähigkeit hängt an Ihrer JTL-Edition.

Stand am 7. September 2026: Alle Angaben zu Funktionen, Parametern und Grenzen stammen aus dem offiziellen JTL-Guide und aus der Editionsübersicht auf der JTL-Preisseite. Wir haben jede Seite an diesem Tag selbst geladen und im Volltext gegengelesen; die Fundstellen stehen am Ende. Wichtig für die Einordnung: Die tragenden Guide-Seiten tragen im eingebetteten Datenblatt die Stände 23.02.2023 und 08.08.2024. Ob die Objektlisten in JTL-Wawi 2.0.x unverändert gelten, sagt JTL nicht — wir zitieren sie deshalb als Doku-Stand, nicht als tagesaktuellen Funktionsumfang.

1. Was JTL-Ameise ist — und was sie nicht ist

Die Ameise ist in JTL-Wawi das Werkzeug für alles, was in Mengen kommt. Der Guide beschreibt sie als „flexibles und vorlagengesteuertes Import- und Export-Werkzeug für JTL-Wawi". Beide Adjektive sind wörtlich zu nehmen und beschreiben zusammen ihr ganzes Prinzip.

Vorlagengesteuert heißt: Sie richten einen Lauf genau einmal ein. Sie sagen, welche Spalte Ihrer Datei auf welches Datenbankfeld gehört, welches Trennzeichen gilt und was mit Datensätzen passiert, die es noch nicht gibt. Diese Konfiguration speichern Sie als Vorlage. Jeder weitere Lauf lädt sie und übernimmt alle Einstellungen.

Flexibel heißt: Die Spalten Ihrer Datei müssen nicht in einer festgelegten Reihenfolge stehen. Sie können jeder Spalte automatisch ein Präfix oder Suffix mitgeben, und ein Importfilter lässt sich so bauen, dass nur ein Teil der Zeilen verarbeitet wird. Der Guide begründet das ausdrücklich damit, dass eine vorherige Überarbeitung der Datei in einer Tabellensoftware so entfällt.

Geöffnet wird sie in JTL-Wawi über das Menü Start und JTL-Ameise. Und sie ist kein Spielzeug: Die Kapitelseite des Guides — die einzige Ameise-Seite, die im eingebetteten Datenblatt einen Stand aus dem Jahr 2026 trägt — sagt unmissverständlich, dass das Werkzeug „solide Vorkenntnisse" erfordert und dass „bei Fehlbedienung gravierende Datenfehler erzeugt werden" können. Die Empfehlung, vor jedem Lauf die Datenbank zu sichern, steht gleich an drei Stellen im Kapitel.

Drei Dinge, die die Ameise nicht ist

Ebenso wichtig ist die Abgrenzung, weil sich daraus die halbe Projektarbeit ergibt. Die Ameise ist kein Excel-Importer: „Die Importdatei von JTL-Ameise muss immer das CSV-Format haben." Sie ist kein Zeitplaner: Der Guide verweist für Wiederholungen ausdrücklich auf Windows-Bordmittel. Und sie ist keine Ereignis-Automatisierung: Wer auf einen bezahlten Auftrag oder einen Statuswechsel reagieren möchte, ist bei JTL-Workflows richtig. Welche der beiden Welten Ihr Fall braucht, klären wir im Beitrag zur ereignisgesteuerten Automatisierung mit JTL-Workflows; dort steht auch die Abgrenzung zum JTL-Worker und zur Wawi-API.

Für Daten, die nicht nachts in Mengen, sondern laufend in kleinen Portionen aus einem Fremdsystem kommen, ist die JTL-Wawi API der offizielle Weg. Sie befand sich am 25. September 2026 laut JTL in der Open Beta; die Preisseite zeigt sie für JTL Start als nicht enthalten und für Advanced und Pro als Zusatzmodul. Wann sie die Ameise sinnvoll ergänzt, klärt unser Beitrag zur JTL-Wawi API und ihren Kosten.

2. Was sich importieren und exportieren lässt

Die Übersichtsseite des Guides listet den Leistungsumfang als Baum aus Ober- und Unterkategorien. Wir haben ihn am 7. September 2026 ausgezählt: zehn Oberkategorien für den Import, dreizehn für den Export. Interessant ist dabei weniger die Zahl als die Asymmetrie — mehrere Objekte gibt es nur in einer Richtung, und das entscheidet oft darüber, ob ein geplanter Ablauf überhaupt trägt.

Zwei Einträge in dieser Liste verdienen einen zweiten Blick. Unter den Buchungsdaten stehen zwei Positionen, die der Guide selbst als abgekündigt markiert: „DATEV: Rechnungen" und „DATEV: Rechnungskorrekturen". Wer einen Export für die Buchhaltung neu aufsetzt, sollte deshalb die eigene Oberkategorie „DATEV: Buchungsdaten" nutzen und nicht die alten Einträge. Wie der Weg von dort in die Finanzbuchhaltung weitergeht, haben wir im Beitrag zu DATEV Unternehmen online beschrieben.

Und dieser DATEV-Export ist zugleich die einzige dokumentierte Ausnahme vom CSV-Prinzip: Er erzeugt eine Datei im DATEV-Standard-Format. Für den Aufruf über die Kommandozeile hat das eine praktische Folge, die man beim ersten Mal garantiert übersieht — bei DATEV-Exporten und bei Artikelbildern muss der Ausgabeparameter ein Verzeichnis enthalten, keinen Dateinamen.

Eine Grenze dieser Liste sollten Sie mitdenken. Die Übersichtsseite trägt im eingebetteten Datenblatt den Stand 23. Februar 2023, und die abgekündigten DATEV-Einträge zeigen, dass sie sich seither verändert hat. Ob sie für JTL-Wawi 2.0.x noch vollständig ist, sagt JTL nirgends. Prüfen Sie den Baum deshalb vor einer Konzeption einmal in Ihrer eigenen Installation, statt sich auf die Doku zu verlassen.

3. Die Kette aus drei Teilen

Hier liegt der eigentliche Kern dieses Beitrags. Der Guide beschreibt alle Bausteine für den automatischen Lauf — aber verteilt auf drei Seiten mit drei verschiedenen Ständen, und nirgends als eine zusammenhängende Betriebsanleitung. Zusammengesetzt sieht die Kette so aus.

1. Die Vorlage in der Oberfläche. Ohne sie geht gar nichts. Der Guide formuliert es eindeutig: „Die CMD-Line-Version arbeitet mit Import- bzw. Exportvorlagen, die vorher in der grafischen Benutzeroberfläche erstellt werden müssen." Die Kommandozeile bringt keine eigene Konfigurationsmöglichkeit mit. Jede Vorlage bekommt beim Speichern eine eindeutige ID, die im Fenster angezeigt wird — notieren Sie sie sofort. Importvorlagen beginnen mit IMP, Exportvorlagen mit EXP.
2. Der Aufruf über die Kommandozeile. Wird JTL-Ameise ohne Parameter gestartet, öffnet sich die gewohnte Oberfläche. Sobald mindestens ein Parameter dabei ist, läuft die Kommandozeilen-Version — ohne Fenster, ohne Klick. Übergeben werden die Datenbankverbindung, die Vorlagen-ID und die Datei. Abschnitt 4 geht die Parameter einzeln durch.
3. Die Datei ins Haus holen. Der Guide beschreibt zwei Wege für den täglichen Abruf beim Lieferanten: ein klassisches FTP-Skript mit der Endung .ftp oder das Werkzeug wget, das der Guide empfiehlt, weil es schnell eingerichtet ist und keine Firewallfreigabe braucht. Beides ist Windows-Bordmittel-Ebene, kein Ameise-Feature.
4. Die Batch-Datei als Klammer. Sie reiht die Befehle untereinander: erst der Download, dann der Ameise-Aufruf. Der Guide nennt sie „Stapelverarbeitungsdatei" und zeigt ein vollständiges Beispiel. Achten Sie beim Speichern darauf, dass die Datei wirklich auf .bat endet und nicht auf .bat.txt — der Guide weist eigens darauf hin.
5. Der Windows-Aufgabenplaner. Er ist der eigentliche Taktgeber, und er macht genau eine Sache: „Im Windows-Aufgabenplaner wird lediglich die soeben erstellte Batch-Datei zu Ihren im Windows-Aufgabenplaner hinterlegtem Intervall ausgeführt." Für weitergehende Fragen zum Aufgabenplaner verweist JTL an dieser Stelle ausdrücklich auf die Microsoft-Dokumentation.

Fünf Bausteine, drei davon außerhalb von JTL. Das ist die entscheidende Einsicht für die Planung: Die Automatisierung ist zu zwei Dritteln ein Windows-Thema. Wer die Ameise beherrscht, aber keinen Zugriff auf den Server hat, auf dem sie laufen soll, kommt nicht ans Ziel. Auf welchem Rechner das sinnvollerweise passiert und welche Rolle der SQL-Server dabei spielt, beschreibt unser Beitrag zur Datenbank hinter JTL-Wawi.

Ein Hinweis zum Umgang mit Zugangsdaten

Das Batch-Beispiel im Guide übergibt den Datenbankbenutzer und dessen Kennwort im Klartext als Parameter. Das ist keine Herstellerempfehlung zur Sicherheit, sondern schlicht die Form, in der das Beispiel geschrieben ist — und es ist unsere eigene Beobachtung daran, keine Aussage von JTL. Behandeln Sie diese Datei trotzdem entsprechend: eigener Datenbankbenutzer mit genau den nötigen Rechten, Ablage in einem Verzeichnis mit eingeschränktem Zugriff, keine Kopie in einer Dateiablage, die das halbe Unternehmen sieht.

4. Die Kommandozeile im Detail

Die Hilfeausgabe der Kommandozeilen-Version steht vollständig im Guide. Sie trägt dort übrigens noch die Kopfzeile „JTL-Ameise 0.984 (c) 2019 JTL-Software-GmbH" — ein Hinweis darauf, dass dieser Programmteil seit Jahren stabil ist. Kurz- und Langschreibweise sind gleichwertig: -s bedeutet dasselbe wie --server=.

Zwei Details aus dieser Liste entscheiden im Betrieb über Ruhe oder Ärger. Das erste ist --mode=test. Damit läuft derselbe Aufruf als Trockenlauf, der die Datei Zeile für Zeile analysiert, ohne etwas in der Datenbank zu ändern. Das zweite ist --no_workflows. Ein Massenimport kann in JTL-Wawi eine Lawine auslösen, weil jeder geänderte Datensatz Workflow-Ereignisse erzeugt; JTL warnt in der Workflow-Dokumentation ausdrücklich vor spürbaren Leistungseinbrüchen. Dieser Schalter ist das dokumentierte Gegenmittel. Überlegen Sie vorher trotzdem genau, welche Workflows Sie damit stilllegen — manche sollen ja gerade auslösen.

Die Platzhalter und die Prozent-Falle

Dateinamen dürfen Variablen enthalten, und für Protokolle ist das entscheidend: %y Jahr, %m Monat, %d Tag, %H Stunde, %i Minute, %s Sekunde, dazu %db für die Datenbank und %id für die Vorlagen-ID. So bekommt jeder Nachtlauf sein eigenes Protokoll statt eine Datei, die sich selbst überschreibt.

Und hier lauert der Klassiker, an dem der erste Automatisierungsversuch fast immer scheitert: In einer Batch-Datei muss jedes Prozentzeichen verdoppelt werden. Der Guide sagt es in einem Nebensatz: „Bitte beachten, dass % in Batch Dateien zu %% gewandelt werden müssen." Aus %y%m%d wird also %%y%%m%%d. Wer das übersieht, bekommt keinen Fehler — er bekommt Protokolldateien mit verstümmelten Namen und wundert sich Wochen später.

Mit denselben Platzhaltern bekommt auch jede Exportdatei ihr Datum im Namen. Landen alle Dateien im selben Ordner, kann Power Query sie in Excel oder Power BI zu einer Tabelle kombinieren und beim Aktualisieren den neuen Monat mitnehmen. Worauf es dabei ankommt — Codierung, Dezimaltrenner und Artikelnummern als Text —, zeigt unser Beitrag Power Query für Händler mit drei Rezepten.

5. Die Editionsfrage: erst prüfen, dann bauen

Dieser Abschnitt gehört an den Anfang jeder Planung, nicht ans Ende. Der Guide setzt auf die Seite zur Kommandozeilen-Version einen Hinweis, den man leicht überliest: „Je nachdem, welche JTL-Edition/Paketkonfiguration Sie gebucht haben, steht Ihnen die CMD-Line-Version von JTL-Ameise möglicherweise nicht zur Verfügung." Welche Edition gemeint ist, sagt der Satz nicht.

Die Editionsübersicht auf der JTL-Preisseite führt zwei getrennte Zeilen zur Ameise. Wir haben sie am 7. September 2026 ausgelesen.

Die Botschaft ist klar: Import und Export über die Oberfläche bekommen Sie in jeder Edition. Die Batch Verarbeitung fehlt in JTL Start. Wer dort einen nächtlichen Lieferantenimport plant, plant an seiner Lizenz vorbei.

Eine Ehrlichkeit gehört dazu, und wir halten uns damit bewusst zurück, wo andere weiterreden: JTL sagt nirgends ausdrücklich, dass „JTL-Ameise Batch Verarbeitung" dasselbe ist wie die CMD-Line-Version. Die beiden Aussagen stehen auf zwei verschiedenen Seiten und benutzen zwei verschiedene Begriffe. Die naheliegende Deutung ist, dass sie sich decken — belegt ist sie nicht. Wenn an Ihrer Automatisierung ein Budget hängt, lassen Sie sich das vor der Buchung schriftlich vom JTL-Vertrieb oder von Ihrem Service Partner bestätigen. Das kostet eine E-Mail und erspart im Zweifel ein halbes Projekt.

6. Was ausdrücklich nicht geht

Der ehrlichste Teil einer Werkzeugbeschreibung sind die Grenzen. Die folgenden acht sind alle in der Herstellerdokumentation belegt und im laufenden Betrieb die häufigsten Ursachen für Überraschungen.

• Kein Excel. Der Import verlangt zwingend CSV. Der Guide empfiehlt für die Umwandlung sogar ein kostenloses Werkzeug eines Drittanbieters — und schreibt im selben Atemzug, dass JTL für die Benutzung von Drittanbieter-Software keine Gewähr übernimmt. Sauberer ist es, die Umwandlung in Ihrer Batch-Datei zu erledigen oder den Lieferanten um eine CSV zu bitten.
• Kein laufender JTL-Worker. Das ist die härteste Warnung im ganzen Kapitel: „Beim Import mit JTL-Ameise darf JTL-Worker nicht aktiv sein. Es kann hierbei zu Störungen und Datenverlust kommen." In einem automatisierten Ablauf müssen Sie ihn also vorher beenden und danach wieder starten — sonst laufen Import und Abgleich irgendwann in derselben Nacht.
• Keine geöffnete Datei. Eine CSV, die noch in einer Tabellensoftware offen ist, lässt sich nicht laden. Im automatisierten Betrieb heißt das: Der Ordner, in den der Download fällt, ist kein Arbeitsverzeichnis für Menschen.
• Kein Rollback nach einem Abbruch. „Die Daten, die bis zum Abbruch in der Datenbank verändert bzw. neu angelegt wurden, bleiben." Ein abgebrochener Lauf hinterlässt also einen halb importierten Datenbestand. Genau deshalb steht die Empfehlung zur Datensicherung so prominent im Guide.
• Kein verlässlicher Testlauf bei abhängigen Zeilen. Der Trockenlauf prüft zeilenweise gegen den Ist-Bestand. Legt Zeile 1 einen Artikel an, den Zeile 2 aktualisieren will, muss Zeile 2 im Test scheitern — der Guide beschreibt genau diesen Fall. Ein roter Testlauf ist damit nicht zwangsläufig ein Fehler in Ihrer Datei.
• Kein Standardwert für bestehende Datensätze. Standardwerte belegen ausschließlich neue Datensätze vor. Für Zeilen, die nur aktualisiert werden, gelten sie nicht. Wer sie als Sammelkorrektur missversteht, wundert sich über ausbleibende Änderungen.
• Kein harmloses Präfix auf der Identifizierungsspalte. Setzen Sie ein Suffix auf die Artikelnummer, sucht JTL-Wawi anschließend nach dem zusammengesetzten Wert. Aus der Suche nach „14" wird die Suche nach „14ABC" — und aus einer Aktualisierung wird stillschweigend ein Neuanlegen.
• Kein Filter im Export ohne Filtervorlage. Die Feinheit mit dem größten Schadenspotenzial im Nachtbetrieb: Eine Exportvorlage speichert einen eingestellten Filter nur dann mit, wenn dieser zusätzlich als Filtervorlage abgelegt wurde. Sonst läuft der geplante Export jede Nacht ungefiltert über das gesamte Sortiment.

Eine Grenze fehlt in dieser Liste, weil wir sie nicht belegen können: Mengen und Laufzeiten. Weder die Übersichts- noch die Import-, Export- oder Kommandozeilenseite nennt eine maximale Zeilenzahl, eine Dateigröße oder eine zu erwartende Dauer. Zahlen, die im Netz dazu kursieren, stammen aus Foren und Agenturbeiträgen. Wir nennen deshalb keine — belastbar ist nur ein Testlauf mit Ihrer echten Datei auf einem Testmandanten.

7. Der Eigene Export: SQL statt Vorlagenbaukasten

„JTL-Ameise Eigener Export" gehört zu den häufigsten verwandten Suchanfragen zum Thema, und in der Suchergebnisliste erklärt ihn niemand. Dabei ist er der stärkste Hebel des ganzen Werkzeugs.

Die Standard-Exportarten geben aus, was JTL vorgesehen hat. Der Eigene Export geht daran vorbei: Sie schreiben eine SQL-Abfrage in ein Textfeld, und die Ameise gibt deren Ergebnis als CSV aus. Der Guide beschreibt das Feature so, dass Sie damit „alle in JTL-Wawi hinterlegten Daten aus der Datenbank filtern und exportieren" können. Das Beispiel dort ist bewusst simpel und liest nur die Artikelnummern aus der Artikeltabelle.

Der Weg ist kurz: In der Menüleiste Export wählen, im Bereich „Daten exportieren" den Eintrag Eigener Export öffnen, auf Neuer Export klicken, einen Namen vergeben, die Abfrage einfügen und speichern. Anschließend verhält sich der eigene Export wie jede andere Vorlage — er bekommt eine EXP-ID und lässt sich damit auch nachts über die Kommandozeile ziehen.

Drei Dinge sollten Sie dabei wissen. Erstens ist das ein reiner Lesekanal: Der Guide beschreibt ausschließlich das Exportieren, nicht das Schreiben. Zweitens brauchen Sie Kenntnis des Wawi-Datenmodells; die Tabellen- und Spaltennamen sind nicht selbsterklärend, und JTL verweist für weitere Vorlagen aufs eigene Forum. Drittens bewegen Sie sich damit außerhalb der geführten Oberfläche — eine schlecht formulierte Abfrage auf einer großen Datenbank kann während der Geschäftszeit spürbar bremsen. Genau deshalb gehören solche Auswertungen in den Nachtlauf, und genau dafür lohnt die Kombination aus Eigenem Export und Aufgabenplaner: die Kennzahl liegt morgens als Datei bereit, ohne dass jemand die Warenwirtschaft dafür anfassen musste.

Der Eigene Export ist auch der sauberste Weg, Wawi-Zahlen in ein Dashboard zu bringen. Die CSV-Datei aus dem Nachtlauf landet in BigQuery, und Looker Studio zeigt daraus den Umsatz nach Retouren neben den Werbedaten. Die Datenbank direkt anzubinden, verlangt dagegen einen öffentlich erreichbaren SQL Server und eine Freigabe in der Firewall. Wie dieser Aufbau aussieht, beschreibt unser Beitrag zum Looker-Studio-Dashboard aus Shop- und Wawi-Daten.

8. Sechs Fehler, die uns in Projekten begegnen

Die folgenden Punkte tauchen so regelmäßig auf, dass sie eine eigene Liste verdienen. Keiner davon ist exotisch, und alle lassen sich an einem Vormittag abstellen.

1. Die Vorlage lebt nur auf einem Rechner im Kopf. Vorlagen-IDs werden beim Speichern angezeigt und danach nie wieder gebraucht — bis der automatische Lauf gebaut wird. Führen Sie eine kurze Liste: Vorlagenname, ID, Zweck, wer sie zuletzt angefasst hat. Ohne die ID ist der Aufruf nicht rekonstruierbar.
2. Der Worker läuft weiter. Der häufigste Fehler beim ersten automatisierten Import, weil die Warnung im Guide auf einer anderen Seite steht als die Anleitung zur Kommandozeile. Beenden und Starten des Workers gehören in dieselbe Batch-Datei wie der Import.
3. Kein Protokoll, keine Erkenntnis. Ohne --log und die zugehörigen Dateien passiert der Nachtlauf im Dunkeln. Mit Platzhaltern im Dateinamen haben Sie hinterher eine lückenlose Historie und sehen, ab wann sich das Verhalten geändert hat.
4. Kein Testlauf vor dem Umstieg auf Produktivbetrieb. --mode=test kostet einen Durchlauf und ist die einzige Gelegenheit, Zuordnungsfehler zu sehen, bevor sie im Datenbestand stehen. Danach hilft nur noch die Sicherung.
5. Der Export läuft ohne Filter. Wenn die nächtliche Preisliste plötzlich das gesamte Sortiment enthält statt einer Marke, liegt es fast immer daran, dass der Filter nicht als Filtervorlage gespeichert wurde. Prüfen Sie das einmal an einer bestehenden Vorlage nach.
6. Niemand merkt, wenn nichts passiert. Ein Aufgabenplaner meldet sich nicht, wenn die Lieferantendatei ausbleibt oder der Server neu gestartet hat. Bauen Sie eine einfache Kontrolle ein: Wer schaut morgens auf das Protokoll, und was passiert, wenn es fehlt? Diese Frage ist kein technisches, sondern ein organisatorisches Thema — und sie wird fast immer vergessen.

Ein Sonderfall verdient eine eigene Erwähnung, weil er im Bestand unserer Beiträge immer wieder auftaucht: die Ameise im Migrationsprojekt. Dort ist sie ein einmaliges Werkzeug für den Umzug, und die Arbeit steckt im Feld-Mapping, nicht in der Wiederholung. Wie das beim Wechsel aussieht, haben wir für den Umzug von Afterbuy zu JTL und für den Wechsel von plentymarkets zu JTL ausgeführt. Der Guide führt dafür übrigens dreizehn eigene Anleitungen zur Datenübernahme, unter anderem für Afterbuy, CAO-Faktura, Oxid, ePages, Sage und Lexware. Wer JTL-Wawi überhaupt erst aufsetzt, findet den Einstieg in unserer Anleitung zum Einrichten von JTL-Wawi.

9. Fazit: drei Merksätze für den Nachtlauf

Der erste: Die Ameise automatisiert nichts von allein. Sie ist der Motor, nicht die Zündung. Vorlage, Kommandozeile und Aufgabenplaner gehören zusammen, und zwei der drei Teile sind Windows-Themen. Wer das früh weiß, plant den Zugriff auf den richtigen Rechner gleich mit ein.

Der zweite: Die Edition steht vor der Konzeption. Ein Ablauf, den JTL Start nicht hergibt, ist keine Lösung, sondern eine Rechnung mit Folgekosten. Die Prüfung dauert fünf Minuten.

Der dritte: Die Grenzen sind wichtiger als die Funktionen. Kein Rollback, kein laufender Worker, kein Filter ohne Filtervorlage — diese drei Sätze erklären den Großteil dessen, was in Projekten schiefgeht. Sie stehen alle in der Herstellerdokumentation, nur eben auf drei verschiedenen Seiten.

Wie viel Handarbeit in Ihrer Datenpflege steckt, merkt man meist erst, wenn sie einmal ausfällt. Wenn Sie wissen möchten, welche Ihrer wiederkehrenden Importe und Exporte sich lohnen zu automatisieren und welche besser von Hand bleiben, sehen wir uns das mit Ihnen an — mit Blick auf Ihre Edition, Ihre Lieferantendateien und Ihren Serverzugang.

10. Häufige Fragen zu JTL-Ameise

Die offizielle FAQ-Seite zu JTL-Ameise enthält am 7. September 2026 genau eine Frage. Die folgenden Antworten stammen deshalb aus der übrigen Dokumentation und aus unserer Projektarbeit.

Was ist JTL-Ameise?

JTL-Ameise ist laut Herstellerdokumentation das flexible und vorlagengesteuerte Import- und Export-Werkzeug für JTL-Wawi. Sie öffnen es in der Warenwirtschaft über das Menü Start und JTL-Ameise. Eine Vorlage beschreibt, welche Spalte einer Datei auf welches Datenbankfeld gehört. Diese Vorlage lässt sich speichern und für jeden weiteren Lauf wiederverwenden.

Welche Dateiformate verarbeitet JTL-Ameise?

Nur CSV. Der JTL-Guide formuliert es eindeutig: Die Importdatei muss immer das CSV-Format haben, und der Export liefert ebenfalls CSV. Excel-Dateien gehen nicht direkt; die Dokumentation empfiehlt dafür ausdrücklich ein kostenloses Werkzeug eines Drittanbieters und schließt zugleich jede Gewähr dafür aus. Trennzeichen, Quote- und Escape-Zeichen sind frei einstellbar.

Wie automatisiere ich einen Import mit JTL-Ameise?

In drei Schritten. Erstens legen Sie den Import einmal in der Oberfläche an und speichern ihn als Vorlage; die Vorlagen-ID beginnt mit IMP. Zweitens rufen Sie JTL-Ameise mit dieser ID und den Datenbankparametern über die Kommandozeile auf. Drittens startet der Windows-Aufgabenplaner diesen Aufruf in Ihrem Intervall.

Brauche ich für die Automatisierung eine bestimmte JTL-Edition?

Vermutlich ja. Der Guide schreibt, die Kommandozeilen-Version stehe je nach gebuchter Edition möglicherweise nicht zur Verfügung. Die Preistabelle führt die Zeile JTL-Ameise Batch Verarbeitung mit einem Kreuz bei JTL Start und einem Haken bei Advanced, Pro und Enterprise. Import und Export über die Oberfläche sind dagegen in allen vier Editionen enthalten.

Darf JTL-Worker während eines Ameise-Imports laufen?

Nein. Der JTL-Guide warnt an dieser Stelle ungewöhnlich deutlich: Beim Import mit JTL-Ameise darf JTL-Worker nicht aktiv sein, sonst kann es zu Störungen und Datenverlust kommen. Für einen automatisierten Nachtlauf heißt das, dass Sie den Worker vorher beenden und danach wieder starten müssen.

Was passiert, wenn ich einen laufenden Import abbreche?

Die bereits geschriebenen Daten bleiben. Der Guide sagt es wörtlich: Was bis zum Abbruch in der Datenbank verändert oder neu angelegt wurde, bleibt erhalten. Es gibt also keinen Rollback über den gesamten Lauf. Deshalb empfiehlt der Hersteller vor jedem Import eine Datensicherung und vorab einen Testlauf.

Warum meldet der Testlauf Fehler, obwohl die Datei richtig ist?

Weil der Testlauf zeilenweise gegen den aktuellen Datenbestand prüft. Wird in Zeile 2 ein Artikel aktualisiert, den erst Zeile 1 anlegt, muss Zeile 2 im Testlauf scheitern. Der Guide beschreibt genau diesen Fall. Ein roter Testlauf ist damit nicht automatisch ein Fehler in Ihrer Datei.

Wofür ist der Eigene Export in JTL-Ameise gut?

Für Auswertungen, die keine Standardvorlage abdeckt. Der Guide beschreibt das Feature Eigene Exports so, dass Sie eigene SQL-Abfragen schreiben und damit alle in JTL-Wawi hinterlegten Daten filtern und exportieren. Das Beispiel im Guide liest die Artikelnummern aus der Artikeltabelle. Es ist ein reiner Lesekanal, kein Schreibweg.

Wie viele Datensätze schafft JTL-Ameise pro Lauf?

Das ist nicht dokumentiert. Weder die Übersichtsseite noch die Import-, Export- oder Kommandozeilenseite nennt eine maximale Zeilenzahl, eine Dateigröße oder eine Laufzeit. Wir nennen deshalb keine Zahl. Belastbar ist nur der Weg über einen Testlauf mit Ihrer echten Datei auf einem Testmandanten.

11. Quellen & offizielle Dokumentation

Alle folgenden Quellen wurden am 7. September 2026 abgerufen und im Volltext gegengelesen; die zitierten Formulierungen stammen wörtlich daraus. Herstellerdokumentation ändert sich — bitte prüfen Sie den Stand vor einer Umstellung erneut. Externe Quellen öffnen in einem neuen Tab.

• JTL-Guide: JTL-Ameise (Kapitelübersicht) — Die Kapitelstruktur des gesamten Werkzeugs samt der dreizehn Anleitungen zur Datenübernahme aus Fremdsystemen und der Warnung, dass Fehlbedienung gravierende Datenfehler erzeugen kann.
• JTL-Guide: Übersicht über JTL-Ameise — Definition, Aufruf über das Menü Start, die typischen Einsatzzwecke, die vollständigen Objektlisten für Import und Export sowie die Warnung zum JTL-Worker.
• JTL-Guide: Aufbau der Import-Funktion — Die CSV-Pflicht, Trenn-, Quote- und Escape-Zeichen, Standardwerte, die Wirkung von Präfix und Suffix auf die Identifizierung sowie die Semantik von Testlauf und Abbruch.
• JTL-Guide: Aufbau der Export-Funktion — Exportformat, Dezimal- und Tausendertrenner, Freispalten und der Hinweis, dass eine Exportvorlage den Filter nur mit abgelegter Filtervorlage speichert.
• JTL-Guide: CMD-Line-Version von JTL-Ameise — Der Editionshinweis, die vollständige Parameterliste, die Konvention der Vorlagen-IDs, die Platzhalter für Dateinamen und der Weg über FTP, Batch-Datei und Windows-Aufgabenplaner.
• JTL-Guide: Eigene SQLs exportieren mit JTL-Ameise — Der Weg vom neuen Export über das SQL-Textfeld bis zur gespeicherten Exportvorlage, samt der Beispielabfrage auf die Artikeltabelle.
• JTL-Guide: FAQ zu JTL-Ameise — Die offizielle Fragenseite. Sie enthält am 7. September 2026 genau eine Frage, nämlich die zur Artikelnummer mit vorangestelltem Rautezeichen.
• JTL-Software: Preise und Tarife — Die Editionsmatrix mit den beiden Zeilen zu JTL-Ameise. Import und Export sind überall enthalten, die Batch Verarbeitung fehlt in JTL Start.