JTL Ameise Datenimport: So importierst du Massendaten richtig — Importtypen, Spalten-Mapping und typische Fallstricke

Auf einen Blick

• ✓JTL Ameise ist das Massendaten-Importwerkzeug in JTL-Wawi — Wir setzen es bei fast jeder Kundenmigration ein, um Artikel, Preise und Bestände strukturiert zu übertragen statt sie manuell einzutippen.
• ✓Das Tool akzeptiert CSV- und Excel-Dateien und erwartet Semikolon als Trennzeichen sowie UTF-16 als Zeichenkodierung. Wer das ignoriert, bekommt Importfehler oder korrumpierte Umlaute.
• ✓Die sechs häufigsten Fehler aus der unserer Praxis: fehlende Pflichtfelder, falsche Identifizierungsspalte, JTL-Worker nicht gestoppt, kein Trockenlauf, mehrstufige Kategorien und kein Datenbank-Backup vor dem Import.

Wir wissen: Ein Massendaten-Import ist kein Routine-Klick — es ist ein Eingriff direkt in deine Wawi-Datenbank. Mit einem sauberen Spalten-Mapping, einem Trockenlauf und einem Backup davor läuft er reibungslos. Ohne diese drei Schritte wird aus einem 20-Minuten-Job schnell ein halber Tag Schadensbegrenzung.

Die Artikelstammdaten-Vorlage in JTL Ameise hat 473 Spalten. Davon sind nur vier Pflichtfelder: Artikelnummer, Artikelname, ein Preisfeld und der Steuersatz. Die Lieferantenartikel-Vorlage hat 48 Spalten. Die Kundenstammdaten-Vorlage hat 63 Spalten mit Kundennummer als Pflichtfeld. Wer alle optionalen Spalten ignoriert und nur die Pflichtfelder befüllt, kann einen ersten Test-Import in wenigen Minuten aufsetzen.

Quelle unsere Projektdaten: Bei einer typischen Erstbefüllung mit 500 Artikeln dauert das Mapping-Setup einmalig 30 bis 60 Minuten. Jeder folgende Import mit derselben Vorlage läuft in unter 5 Minuten durch — vollständig ohne manuelle Eingriffe.

Diese Importvorlagen nutzen wir am häufigsten in Kundenprojekten:

• →Artikelstammdaten (473 Spalten): Komplett-Import von Artikelnummer, Name, Preis, Gewicht, Abmessungen, Beschreibung, Lagerbestand und Versandklasse in einem Durchlauf
• →Lieferantenartikel und EK-Preise (48 Spalten): Wöchentliche Preislisten vom Lieferanten mit Staffeln und Mindestabnahmemengen — spart täglich Handarbeit
• →Lagerbestände (eigene Vorlage): Reiner Bestandsabgleich ohne Artikelstammdaten anzufassen — nützlich bei externem Lagersystem parallel
• →Kundenstammdaten (63 Spalten): Migration kompletter Kundenstämme aus dem Altsystem mit Kundengruppe, Adresse, Zahlungsart und Zahlungsziel

Die zentrale Regel: Vorlage einmal sauber aufsetzen, danach immer wiederverwenden. Das ist der Hebel — nicht die Geschwindigkeit des einzelnen Imports.

Aus hunderten Ameise-Durchläufen in Kundenprojekten sehen wir zwei Muster, die immer wieder zu Problemen führen:

1

Falsche Dateikodierung

Fast alle Ameise-Importvorlagen erwarten UTF-16. Das ist ungewöhnlich — die meisten CSV-Tools exportieren standardmäßig UTF-8. Wer diese Einstellung vergisst, sieht statt Umlauten nur Fragezeichen oder unleserliche Zeichenfolgen.

Dazu kommt das Trennzeichen: Ameise erwartet Semikolon. Wer eine Komma-getrennte Datei liefert, bekommt im besten Fall Importfehler — im schlechtesten Fall landen alle Daten in einer einzigen Spalte.

2

Fehlende Pflichtfelder bei Aktualisierungen

Ein Händler im JTL-Forum hat eine Aktualisierungsliste mit nur Kundennummer, Zahlungsart und Zahlungsziel eingespielt — ohne Nachnamen. Die Ameise hat daraufhin etwa 900 Kundendatensätze gelöscht statt sie zu aktualisieren.

Gegenmaßnahme: Immer alle Pflichtfelder in die CSV aufnehmen, auch wenn nur einzelne Werte aktualisiert werden sollen. Beim Kundendaten-Import ist der Nachname ein Pflichtfeld — fehlt er, löscht Ameise den Datensatz.

Wöchentliche Preispflege in unter 5 Minuten

Ein Händler (anonymisiert) aus dem Elektronik-Zubehör bekommt wöchentlich eine neue Preisliste vom Lieferanten als Excel-Datei. Wir haben einmalig ein Spalten-Mapping aufgesetzt und als Vorlage gespeichert. Seither lädt der Händler die Datei, ruft die Vorlage auf und startet den Import — fertig in unter 5 Minuten statt 2 Stunden manueller Arbeit.

Erstbefüllung bei der Migration ohne Copy-Paste-Fehler

Bei fast jeder JTL Migration nutzen wir den Ameise Datenimport. Wechselt ein Händler von Lexware oder Shopware zu JTL, liegen die Artikeldaten meist als CSV oder Excel vor. Mit Ameise gehen diese Rohdaten direkt in die Wawi — ohne Abtippen, ohne Copy-Paste-Fehler, ohne Duplikate.

So läuft ein sauberer Import in der unserer Praxis ab — von der Vorbereitung bis zum Live-Einspiel.

„CSV mit Semikolon als Trennzeichen und UTF-16 als Zeichenkodierung speichern. Enthält ein Beschreibungsfeld Semikolons oder Zeilenumbrüche, muss das Feld in Anführungszeichen stehen. Häufigster Fehler: UTF-8 statt UTF-16 — danach zeigt Ameise Fragezeichen statt Umlauten.“

„Importvorlage in Ameise wählen (Artikelstammdaten, Preise, Lagerbestände oder Kundenstammdaten). Danach jede CSV-Spalte dem passenden JTL-Datenbankfeld zuordnen. Identifizierungsspalte festlegen — standardmäßig die Artikelnummer, alternativ EAN/GTIN oder HAN. Mapping als Vorlage speichern für spätere Imports. Für Details: JTL-Guide Artikeldaten importieren.“

„Vor jedem Massenimport den JTL-Worker deaktivieren. Läuft er parallel, entstehen Konflikte — besonders wenn der Connector gleichzeitig Daten in den Shop überträgt. Tipp: Worker nach dem Import wieder starten und prüfen, ob er sauber durchläuft.“

„Die Ameise hat einen Simulationsmodus. Er zeigt, was der Import tun würde, ohne dass Daten geschrieben werden. Vor jedem größeren Import sollte ein Trockenlauf stehen. Er deckt Probleme mit dem Spalten-Mapping und fehlende Pflichtfelder auf, bevor Schaden entsteht.“

„Vor dem Live-Import eine Sicherung der JTL-Wawi-Datenbank anlegen. Geht ein Import schief — wegen falsch zugeordneter Spalten oder fehlender Pflichtfelder — ist ein sauberes Backup der einzige zuverlässige Weg zurück. Danach Import starten, Importprotokoll prüfen, JTL-Worker wieder aktivieren.“