JTL Ameise CSV Import Fehler: Warum der Import stoppt — und wie du ihn wieder zum Laufen bringst

Auf einen Blick

• ✓Die häufigste Ursache für JTL Ameise CSV Import Fehler ist ein Semikolon im Beschreibungsfeld — Vlarom sieht das regelmäßig bei Händlern, die ihre Produkttexte direkt aus Excel exportieren.
• ✓Leerwerte statt „0“ bei Preis- und Lagerspalten sowie vertauschte Parent-Child-Reihenfolge sind Fehler Nummer zwei und drei — beide lassen sich mit einer einzigen Korrektur in der CSV beheben.
• ✓Bekannte JTL-Bugs (WAWI-72789, WAWI-73031) betreffen Bilder-Import per URL und Merkmal-Import — Vlarom dokumentiert beide Workarounds in diesem Beitrag.

Alexander Luft, Inhaber von Vlarom und JTL Service Partner Gold aus Ahrensfelde bei Berlin, erklärt: Der CSV-Import über JTL Ameise läuft zuverlässig — aber nur, wenn die Datei exakt das Format liefert, das das Importprofil erwartet. Eine fehlende Null, ein unerwartetes Sonderzeichen oder eine falsche Importreihenfolge reichen aus, um den gesamten Import zu stoppen. Aus hunderten Kundenprojekten haben wir gelernt: Die Fehler wiederholen sich. Wer die fünf häufigsten kennt, löst 90 Prozent aller Importprobleme ohne fremde Hilfe. (Quelle: Vlarom-Projektdaten, über 300 betreute Kunden)

JTL Ameise erlaubt den Import von Artikeln, Kunden, Aufträgen, Lagerbeständen und Preislisten per CSV — alles über konfigurierbare Importprofile. Das klingt flexibel, ist es auch. Aber Flexibilität hat einen Preis: Die Fehlertoleranz ist gering. Eine einzige falsch formatierte Zeile bricht den gesamten Import ab. Aus unserer Projektarbeit mit über 300 Kunden wissen wir: Bei jedem fünften Erstimport gibt es mindestens einen Fehler, der den Durchlauf stoppt.

Quelle Vlarom-Projektdaten (Stand: Projektjahre 2022–2025, n > 300 Kunden): Bei Neukunden, die ihren ersten CSV-Artikel- oder Auftragsimport über JTL Ameise einrichten, müssen wir in mindestens 60 Prozent der Fälle die CSV-Quelldatei vor dem ersten erfolgreichen Import korrigieren. Die häufigsten Korrekturen: Trennzeichen-Konflikt (Semikolon im Feld), Leer- statt Nullwert bei Pflichtfeldern und falsche Importreihenfolge bei Varianten-Artikeln.

Diese fünf Faktoren sind für den Großteil aller CSV-Importfehler verantwortlich:

• →Trennzeichen im Feldinhalt: Ein Semikolon in der Produktbeschreibung bricht das CSV-Parsing — weil Ameise Semikolon als Spaltentrenner interpretiert. Betrifft vor allem Exporte aus alten ERP-Systemen.
• →Leerwert statt Null bei Pflichtfeldern: Preis- und Lagermengenspalten erwarten bei fehlenden Werten eine ‚0‘, nicht einen leeren Zellinhalt. Ein leeres Feld erzeugt einen Konvertierungsfehler, der den Import stoppt.
• →Falsche Importreihenfolge bei Varianten: Parent-Artikel müssen vor Child-Artikeln importiert werden. Wer alles in einer Datei gemischt hat und die Reihenfolge nicht sortiert, bekommt Zuordnungsfehler oder Duplikate.
• →Gleiche Artikelnummer für Parent und Child: Wenn Parent-Artikel und Child-Varianten dieselbe Artikelnummer tragen, entstehen Duplikate in der Datenbank. Das passiert typisch bei automatisierten Exporten aus anderen Systemen.
• →Bugs in bestimmten JTL-Versionen: WAWI-72789 betrifft den Bilder-Import per URL mit falscher Sortierung, WAWI-73031 importiert Merkmale trotz inaktivem Artikelimport. Beide Probleme sind in neueren Versionen behoben. (Quellen: JTL-Bugtracker, JTL-Forum)

Die gute Nachricht: Fast alle dieser Fehler lassen sich beheben, ohne die Importprofile neu aufzubauen. Eine korrigierte CSV-Datei reicht in der Regel aus.

Aus unserer Arbeit mit Händlern, die regelmäßig per CSV importieren, kristallisieren sich zwei Muster heraus. Zusammen verantworten diese zwei Muster den Großteil aller Supportanfragen zum Thema:

1

Dateiformat-Probleme aus der Quelle

Die meisten CSV-Dateien kommen nicht aus JTL selbst, sondern aus einem anderen ERP, aus Excel oder aus einem automatisierten Export-Tool. Jedes dieser Systeme hat eigene Konventionen für Trennzeichen, Zeichenkodierung und Leerfelder. Was dort korrekt aussieht, kann für JTL Ameise ungültig sein.

Das klassische Beispiel: Ein Händler exportiert seine Artikeldaten aus Lexware als CSV. In der Beschreibungsspalte stehen Produkttexte, die Semikolons enthalten — für lesbare Sätze. Ameise interpretiert jedes davon als Spaltengrenze und verliert die Datenstruktur vollständig. Die Lösung ist ein Anführungszeichen als Textbegrenzer (Qualifier) im Importprofil, oder das Ersetzen der Semikolons durch einen anderen Trenner.

2

Falsche Reihenfolge bei Varianten-Artikeln

Varianten-Artikel bestehen aus einem Parent (dem Hauptartikel) und mehreren Child-Einträgen (den Ausprägungen, z.B. Größen oder Farben). JTL Ameise muss den Parent kennen, bevor es den Child zuordnen kann. Wer beide in einer Datei mischt, ohne die Reihenfolge zu prüfen, bekommt Zuordnungsfehler.

Noch problematischer: Wenn Parent und Child dieselbe Artikelnummer haben — das passiert bei manchen Exporten — legt Ameise Duplikate an. Das lässt sich nicht per Korrekturimport rückgängig machen. Wir sehen das regelmäßig nach Migrationen aus Systemen, die keine echte Varianten-Hierarchie kennen. Die Lösung ist konsequente Datenvorbereitung vor dem ersten Import.

Massendaten in Minuten statt Stunden

Ein Händler (anonymisiert, Zubehör-Versand) hat nach unserem CSV-Setup 3.400 Artikel in einem einzigen Ameise-Durchlauf importiert — inklusive Preisen, Lagerbeständen und Variantenzuordnungen. Vorher hat das manuelle Einpflegen Wochen gedauert. Mit einer sauber konfigurierten CSV-Vorlage und dem richtigen Importprofil läuft das in unter 10 Minuten.

Automatisierte Updates ohne manuelle Nacharbeit

Wer den CSV-Import einmal sauber eingerichtet hat, kann ihn als wiederkehrenden Prozess nutzen — zum Beispiel für tägliche Preisanpassungen oder Lagerbestandsabgleiche. Ein Onlinehändler aus unserem Kundenstamm aktualisiert so täglich über 800 Artikelpreise automatisch über n8n, ohne eine einzige Zeile manuell anzufassen.

Dieser Plan deckt die häufigsten JTL Ameise CSV Import Fehler ab. Er basiert auf unserer Projektarbeit und auf bekannten Tickets aus dem JTL-Bugtracker. Geh die Schritte der Reihe nach durch — in den meisten Fällen findest du die Ursache bereits in Schritt 1 oder 2.

Öffne die CSV-Datei in einem Texteditor (nicht in Excel). Prüfe, ob das Trennzeichen (Standard: Semikolon) in Feldinhalten vorkommt — besonders in Beschreibungs- und Titelfeldern. Wenn ja: Felder in Anführungszeichen einschließen (Qualifier setzen) oder das Trennzeichen in der Datei durch ein Komma ersetzen und das Importprofil anpassen. Gleichzeitig: Zeichenkodierung prüfen. JTL Ameise erwartet UTF-8. Umlaute aus Windows-1252-kodierten Dateien erzeugen Zeichensalat, der im Import als Fehler erscheint.

Öffne die CSV in Excel oder LibreOffice Calc. Filtere alle Spalten für Preis, Lagerbestand, Mindestbestellmenge und ähnliche numerische Felder. Ersetze alle leeren Zellen durch ‚0‘. JTL Ameise interpretiert Leerfelder bei Pflicht-Nummernfeldern als Konvertierungsfehler und stoppt den Import. Das ist der zweithäufigste Fehler, den wir sehen — und am schnellsten behoben. Nutze in Excel die Funktion ‚Suchen & Ersetzen‘ und lass gezielt leere Zellen im selektierten Bereich durch 0 ersetzen.

Wenn du Varianten-Artikel importierst: Sortiere die CSV so, dass alle Parent-Zeilen vor den zugehörigen Child-Zeilen stehen. Am sichersten ist ein zweistufiger Import — erst eine CSV nur mit Parent-Artikeln, dann eine zweite nur mit Child-Varianten. Prüfe außerdem, ob Parent und Child unterschiedliche Artikelnummern haben. Gleiche Nummern erzeugen Duplikate, die manuell bereinigt werden müssen. Laut JTL-Ameise Dokumentation auf guide.jtl-software.com ist die Eltern-Kind-Reihenfolge beim Variantenimport zwingend.

Wenn du Artikel-Bilder per URL importierst und der Import stockt: Prüfe die JTL-Version. WAWI-72789 beschreibt einen Fehler in der Tabelle tArtikelbildplattform bei falsch sortierter Bild-URL-Reihenfolge. Dieser Bug ist in aktuellen Versionen behoben. Wenn du Merkmale importierst und merkst, dass Merkmale importiert werden, obwohl du den Artikelimport in den Ameise-Einstellungen deaktiviert hast: Das ist WAWI-73031. Workaround: Merkmale separat in einem eigenen Importprofil mit aktiviertem Artikelimport einlesen. Beide Bugs sind im JTL-Forum dokumentiert.

Bevor du hunderte oder tausende Artikel importierst: Schneide 5 repräsentative Zeilen aus der CSV heraus und mach einen Testlauf. Prüfe danach in JTL Wawi, ob die Daten korrekt ankamen — Preis, Bestand, Variante, Bild. Wenn der Testlauf sauber ist, läuft der Vollimport in der Regel problemlos durch. Das spart Zeit, weil du Fehler findest, bevor sie sich auf tausend Datensätze auswirken. Den Testlauf kannst du im selben Importprofil machen — einfach die Quelldatei temporär durch die 5-Zeilen-Datei ersetzen.

Autor

Alexander Luft

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