Was ist die JTL-Ameise?
Die JTL-Ameise ist das integrierte Import/Export-Tool von JTL-Wawi. Sie können damit CSV-Dateien importieren und exportieren — von Artikeln über Kunden bis zu Bestellungen.
Typische Anwendungsfälle:
- Migration von einem anderen System zu JTL
- Massenaktualisierung von Preisen oder Beständen
- Lieferanten-Updates automatisch einspielen
- Datenexport für externe Auswertungen
Importierbare Datentypen
| Datentyp | Dateiname | Felder | Schwierigkeit |
|---|---|---|---|
| Artikelstammdaten | Artikel.csv | ~50 Felder | Mittel |
| Artikelpreise | Preise.csv | ~15 Felder | Einfach |
| Lagerbestände | Bestand.csv | ~8 Felder | Einfach |
| Kundenstammdaten | Kunden.csv | ~40 Felder | Mittel |
| Kategorien | Kategorien.csv | ~20 Felder | Mittel |
| Bilder | Bilder.csv | ~10 Felder | Fortgeschritten |
Artikel importieren: Schritt für Schritt
Schritt 1: Vorlage exportieren
Exportieren Sie zuerst eine leere Vorlage mit allen Spalten:
- JTL-Wawi → Ameise → Export
- Wählen Sie "Artikeldaten"
- Exportieren Sie 1-2 Beispielartikel
- Die CSV-Datei zeigt alle verfügbaren Spalten
Schritt 2: CSV-Datei vorbereiten
Wichtige Regeln:
- • Encoding: UTF-8 (mit BOM) oder ANSI
- • Trennzeichen: Semikolon (;) — nicht Komma!
- • Dezimaltrennzeichen: Komma (1,99) — nicht Punkt
- • Pflichtfelder: Artikelnummer (cArtNr) ist immer Pflicht
Schritt 3: Feldmapping verstehen
Die wichtigsten Felder für einen Artikelimport:
| Feld | Beschreibung | Beispiel |
|---|---|---|
| cArtNr | Artikelnummer (Pflicht) | SKU-12345 |
| cName | Artikelname | T-Shirt Blau XL |
| fVKNetto | VK-Preis Netto | 19,90 |
| fEKNetto | EK-Preis Netto | 8,50 |
| cBarcode | EAN/GTIN | 4012345678901 |
| fLagerbestand | Lagerbestand | 100 |
| fGewicht | Gewicht in kg | 0,25 |
Schritt 4: Import durchführen
- JTL-Wawi → Ameise → Import
- Wählen Sie "Artikeldaten"
- Wählen Sie Ihre CSV-Datei
- Prüfen Sie die Vorschau — stimmen die Spalten?
- Aktivieren Sie "Testlauf" für den ersten Versuch
- Bei Erfolg: Deaktivieren Sie Testlauf und importieren Sie
Häufige Fehler und Lösungen
Umlaute werden falsch angezeigt (ä → ä)
Ursache: Falsches Encoding
Lösung: CSV in UTF-8 mit BOM speichern. In Excel: Speichern unter → CSV UTF-8.
Preise werden nicht übernommen
Ursache: Punkt statt Komma als Dezimaltrenner
Lösung: 19.90 → 19,90. Suchen/Ersetzen in Excel.
Artikel werden doppelt angelegt
Ursache: Artikelnummer nicht eindeutig oder fehlt
Lösung: cArtNr muss eindeutig sein. Bei Update: 'Aktualisieren' statt 'Neu anlegen' wählen.
Import bricht ab bei Zeile X
Ursache: Ungültige Zeichen oder leere Pflichtfelder
Lösung: Prüfen Sie Zeile X in der CSV. Sonderzeichen wie | oder " können Probleme machen.
Kategorien werden nicht zugeordnet
Ursache: Kategoriepfad nicht korrekt formatiert
Lösung: Format: Hauptkategorie > Unterkategorie > Unterunterkategorie (mit Leerzeichen um >)
Automatisierung mit JTL-Workflows
Die JTL-Ameise kann per Kommandozeile gesteuert werden — perfekt für automatische Imports:
JTLwawi.exe /Ameise /Import:Artikeldaten /Datei:"C:\Import\artikel.csv" /Vorlage:"MeineVorlage"
Typische Automatisierungs-Szenarien:
- Täglicher Bestandsimport vom Lieferanten (per Windows Task Scheduler)
- Stündliche Preisaktulisierung aus ERP-System
- Nächtlicher Export für BI-Auswertungen
Profi-Tipps
- Speichern Sie bewährte Imports als Vorlage — spart Zeit bei wiederkehrenden Aufgaben.
- Nutzen Sie den Testlauf IMMER bei neuen Imports — Fehler rückgängig machen ist aufwendig.
- Exportieren Sie vor großen Änderungen ein Backup — zur Sicherheit.
- Bei Bildern: Verwenden Sie relative Pfade und einheitliche Dateinamen.
- Für große Datenmengen (>10.000 Zeilen): Teilen Sie die CSV in kleinere Dateien.
Migration zu JTL?
Wir übernehmen Ihren Datenimport — von der Vorbereitung bis zur Validierung. Sauber, schnell, ohne Datenverlust.
Migrations-Beratung anfragen