JTL-Ameise CMD automatisieren: So richtest du zeitgesteuerte Imports und Exporte ein

Auf einen Blick

• ✓Die JTL-Ameise CMD-Version startet automatisch im Batch-Modus, sobald du mindestens einen Parameter übergibst — die grafische Oberfläche öffnet sich dann nicht mehr. Vlarom E-Commerce Agentur setzt das bei Lieferanten-Datenabgleichen und nächtlichen Preisexporten regelmäßig ein.
• ✓Pflicht-Parameter sind Datenbankverbindung (`-s`, `-d`, `-u`, `-p`), Vorlagen-ID (`-t`) und je nach Richtung entweder Eingabe- (`-i`) oder Ausgabedatei (`-o`). Alle weiteren Parameter wie `–loglevel` oder `–no_workflows` sind optional, aber für automatisierte Setups sinnvoll.
• ✓Mit dem Windows-Aufgabenplaner lässt sich jede Batch-Datei minutengenau oder täglich starten — vollständig unbeaufsichtigt. Unsere Erfahrung: wer das einmal eingerichtet hat, fragt sich warum er es nicht früher gemacht hat. Die Vlarom E-Commerce Agentur richtet solche Setups regelmäßig für Händler ein.

Wir sind JTL Service Partner Gold und arbeiten täglich mit der JTL-Ameise — im Kundenbetrieb und in eigenen Automatisierungsprojekten. Was hier steht, kommt nicht aus der Doku allein, sondern aus echten Setups bei Händlern: Lieferanten die täglich neue Bestandsdateien per FTP liefern, Marktplatz-Händler die Preise automatisch einpflegen, Logistik-Setups die Lagerplätze über Nacht synchronisieren. Vlarom E-Commerce Agentur begleitet Händler bei genau diesen Automatisierungsprojekten — von der ersten Batch-Datei bis zum stabilen Produktivbetrieb. Die CMD-Automatisierung ist kein Nischen-Feature, sondern der nächste logische Schritt für jeden der die Ameise regelmäßig benutzt.

Der Aufbau folgt immer demselben Muster: zuerst die Importvorlage in der GUI anlegen, dann den CMD-Befehl zusammensetzen, eine Batch-Datei schreiben, testen und zuletzt in den Aufgabenplaner einhängen. Das klingt nach viel, ist für einen einzelnen Import-Use-Case aber schnell erledigt. Wenn du mehrere Vorlagen oder FTP-Quellen einbindest, plane mehr Zeit ein.

Bevor du die CMD-Version nutzen kannst, muss die Importvorlage in der grafischen Oberfläche existieren. Öffne dazu die JTL-Ameise normal, lege eine neue Vorlage an und speichere sie. Jede Vorlage bekommt dabei eine eindeutige ID — Importvorlagen beginnen typischerweise mit IMP, Exportvorlagen mit EXP (zum Beispiel IMP01 oder EXP_ARTIKEL). Diese ID brauchst du im nächsten Schritt als Pflichtparameter. Der häufigste Fehler den wir sehen: Händler versuchen einen CMD-Import direkt zu starten, ohne die Vorlage vorher in der GUI gespeichert zu haben — das schlägt mit einem Fehler fehl und gibt keine hilfreiche Fehlermeldung. Solange die Vorlage in der GUI funktioniert, funktioniert sie auch per CMD. Umgekehrt gilt das aber auch: wenn der Import in der GUI Fehler produziert, bringt der CMD-Betrieb keine Verbesserung.

Die CMD-Version der JTL-Ameise folgt einer festen Syntax. Ein vollständiger Import-Befehl sieht so aus: `JTL-wawi-ameise.exe -s (local)\\JTLWAWI -d eazybusiness -u sa -p DeinPasswort -t IMP01 -i C:\\Import\\artikel.csv`. Die Parameter im Überblick: `-s` ist der SQL-Datenbankserver, `-d` der Datenbankname, `-u` und `-p` sind Datenbanknutzer und Passwort, `-t` die Vorlagen-ID, `-i` die Eingabedatei beim Import und `-o` die Ausgabedatei beim Export. Für Exports mit Datumsstempel in den Dateinamen kannst du Platzhalter nutzen: `%y` für Jahr, `%m` für Monat, `%d` für Tag, `%H` für Stunde. Wichtig: In Batch-Dateien muss `%` als `%%` geschrieben werden, sonst interpretiert Windows die Zeichen als eigene Batch-Variablen und der Import schlägt ohne klare Fehlermeldung fehl. Die vollständige Parameterübersicht findest du in der JTL-Ameise CMD-Dokumentation auf guide.jtl-software.com.

Öffne einen Texteditor und lege eine `.bat`-Datei an. Ein typisches Grundgerüst für einen automatischen Import: erste Zeile `@echo off`, dann ein `cd` in den Ordner mit der Import-CSV, danach der vollständige Ameise-Befehl mit allen Parametern. Für Logging nutzen wir `–log C:\\Logs\\ameise_%%y%%m%%d.log` — so entsteht pro Tag eine eigene Logdatei. Wer Workflow-Aktionen während des Imports verhindern will, etwa damit keine automatischen E-Mails an Kunden ausgelöst werden, setzt zusätzlich `–no_workflows`. Für reine Fehler-Protokollierung gibt es außerdem `–log_errors` und `–log_warnings` als separate Logdateien. Vor dem Einhängen in den Aufgabenplaner: Batch-Datei einmal manuell im CMD-Fenster ausführen und die Ausgabe prüfen. Läuft der Import ohne Fehler durch, ist der Testlauf bestanden. Sinnvoll ist außerdem ein Testlauf mit dem Parameter `–mode test`, der die Daten prüft ohne sie tatsächlich zu importieren.

Viele Lieferanten stellen ihre Datendateien täglich per FTP oder HTTP bereit. In diesem Fall erweiterst du die Batch-Datei um einen Download-Schritt. Das geht entweder mit dem eingebauten Windows-FTP-Client über eine `.ftp`-Skriptdatei oder mit `wget` für FTP- und HTTP-Quellen: `wget ftp://server.de/artikel.csv –user=nutzername –password=passwort`. Das Ergebnis landet dann in dem Ordner, den der Ameise-Import-Befehl als Eingabedatei aufruft. Wer mehrere Dateien aus einem Ordner importieren will, kann in der Batch-Datei eine FOR-Schleife einbauen: `For /R \“C:\\Import\“ %%f IN (*.csv) do (\“JTL-wawi-ameise.exe\“ … –inputfile=\“%%f\“)`. Ein Händler im JTL-Forum beschrieb genau diesen Ansatz als die einfachste Lösung für tägliche Lieferantendaten-Abgleiche. Wir setzen das regelmäßig bei Kunden mit mehreren Lieferanten ein, die ihre Bestands-CSVs nachts hochladen. Damit läuft der komplette Zyklus von FTP-Download bis Wawi-Import vollautomatisch durch. Wer solche Abläufe über die Ameise hinaus orchestrieren möchte — etwa mit einem Workflow-Tool wie n8n — findet in unserem Vergleich der vier Wege, JTL-Wawi mit n8n zu verbinden die passende Methode.

Öffne den Windows-Aufgabenplaner (`taskschd.msc`), klicke auf „Aufgabe erstellen“ und gib der Aufgabe einen sprechenden Namen, zum Beispiel „JTL Ameise – Artikel-Import täglich“. Unter „Trigger“ legst du fest, wann die Aufgabe laufen soll — täglich um 02:00 Uhr ist ein klassisches Setup für Händler mit Lieferanten-Nachtlieferungen. Unter „Aktionen“ trägst du den vollständigen Pfad zur Batch-Datei ein. Wichtig: Setze „Ausführen unabhängig davon, ob der Benutzer angemeldet ist“ damit der Task auch ohne aktive Windows-Session startet. Deaktiviere außerdem „Aufgabe nur starten, wenn Computer mit Wechselstrom verbunden ist“ wenn der Server dauerhaft läuft. Teste abschließend über „Ausführen“ im Aufgabenplaner und prüfe das Log. Weitere Hinweise zur zeitgesteuerten Automatisierung findest du in der JTL-Ameise Übersicht auf guide.jtl-software.com. Wir prüfen die erste Woche täglich das Log — in dieser Zeit tauchen die meisten Konfigurationsprobleme auf.

Autor

Alexander Luft

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