Hier mal ein Überblick über den derzeitigen Status eines BMCat konverters für die Wawi mit ETIM Klassen.
Sollte wer noch zusätzlich Wünsche oder Anregungen haben, bitte melden.
BEST BMEcat-Konverter V1.8
Funktionsbeschreibung und Anwenderhandbuch
Version 1.8 – November 2026
1. Zweck des Programms
Der BEST BMEcat-Konverter dient zur automatisierten Aufbereitung von Hersteller-Produktkatalogen im BMEcat-XML-Format für die Warenwirtschaft JTL-Wawi.
Das Programm vergleicht Herstellerartikel mit bereits vorhandenen JTL-Artikeln, erkennt neue Artikel und ergänzt technische Produktinformationen um deutsche ETIM-Bezeichnungen.
Die Ergebnisse werden als CSV-Dateien für die weitere Verarbeitung mit JTL-Ameise ausgegeben.
Wichtig: Das Programm verändert keine Daten direkt in JTL-Wawi.
2. Funktionsübersicht
| Funktion | Beschreibung |
|---|
| BMEcat-Import | Einlesen von Herstellerkatalogen im XML-Format |
| JTL-Artikelabgleich | Identifikation über die eindeutige Artikelnummer |
| Artikelaktualisierung | Vorbereitung geänderter Artikelbezeichnungen und Beschreibungen |
| Neuartikelerkennung | Erkennung bisher nicht vorhandener Artikel |
| ETIM 9 und 10 | Erkennung der im BMEcat angegebenen ETIM-Version |
| Deutsche ETIM-Daten | Zuordnung deutscher Klassen-, Merkmals- und Wertbezeichnungen |
| ETIM-Datenbankauswahl | Auswahl einer ZIP-Datei oder eines entpackten Ordners |
| Pflichtfeldprüfung | Kontrolle von Artikelnummer und Artikelbezeichnung |
| Einkaufspreisprüfung | Separate Ausgabe der im BMEcat gefundenen Preiskandidaten |
| CSV-Export | Semikolon-getrennte UTF-8-Dateien für JTL-Ameise |
| Fehlerprotokoll | Dokumentation von fehlenden und mehrdeutigen Daten |
| Einstellungen | Speicherung der zuletzt verwendeten Dateipfade |
3. Installation und Programmstart
- Das Programmarchiv BEST_BMEcat_Konverter_V1_8_JTL_Pflichtfelder.zip in einen eigenen Ordner entpacken.
Eine direkte Verbindung zur JTL-SQL-Datenbank ist in dieser Version nicht erforderlich.
4. Bedienungsanleitung
Schritt 1 – Herstellerkatalog auswählen
Auf
„Auswählen …“ neben „BMEcat-Katalog (.xml)“ klicken und die XML-Datei des Herstellers auswählen.
Derzeit ist eine BMEcat-XML-Datei als Eingabe vorgesehen. ZIP-Archive mit Herstellerkatalogen müssen vorher entpackt werden.
Schritt 2 – JTL-Artikelstamm auswählen
Den aktuellen Artikelstamm des Heerstellers/Lieferant über JTL-Ameise als CSV exportieren.
Anschließend diese CSV-Datei im Konverter auswählen.
Der Export muss mindestens die Spalten Artikelnummer und Artikelname enthalten. Die Artikelnummern müssen vollständig und unverändert sein.
Schritt 3 – ETIM-Datenbank auswählen
Über
„Auswählen …“ die Datei BEST_ETIM_V5_Korrigiert.zip auswählen.
Alternativ kann der entpackte ETIM-Datenbankordner verwendet werden.
Das Programm lädt die deutschen Übersetzungen für ETIM 9 und ETIM 10. Die jeweils passende ETIM-Version wird anhand der Herstellerdaten ausgewählt.
Schritt 4 – Ausgabeordner auswählen
Einen Ordner festlegen, in dem die erzeugten CSV-Dateien gespeichert werden.
Empfehlung: Für jeden Hersteller und jeden Importlauf einen eigenen Ausgabeordner verwenden.
Schritt 5 – Abgleich starten
Auf
„Abgleich starten (nur Vorschau)“ klicken.
Das Programm liest den BMEcat-Katalog ein, vergleicht die Artikelnummern mit dem JTL-Export, prüft die Pflichtfelder und erstellt die Ergebnisdateien.
Nach Abschluss erscheint eine Meldung mit der Anzahl der erkannten Aktualisierungen und Neuartikel.
5. Erzeugte Dateien
| Dateiname | Inhalt |
|---|
| 01_ABGLEICH_VORSCHAU.csv | Gesamtübersicht mit UPDATE, NEU und PRÜFEN |
| 02_JTL_UPDATE_TESTIMPORT.csv | Vorbereitete Aktualisierungen bestehender Artikel |
| 03_JTL_NEU_TESTIMPORT.csv | Vorbereitete Neuanlagen |
| 04_ETIM_DE.csv | Deutsche ETIM-Klassen, Merkmale und Merkmalswerte |
| 05_PRUEFPROTOKOLL.csv | Fehlende Pflichtfelder und weitere Auffälligkeiten |
| 06_BERICHT.json | Technische Zusammenfassung des Importlaufs |
| 07_EK_NUR_PRUEFUNG.csv | Einkaufspreiskandidaten zur gesonderten Kontrolle |
6. Regeln für den Artikelabgleich
Die
Artikelnummer ist das einzige Identifikationsmerkmal für den Abgleich.
- UPDATE: Die Artikelnummer ist im JTL-Export eindeutig vorhanden.
- NEU: Die Artikelnummer ist im JTL-Export nicht vorhanden.
- PRÜFEN: Ein Problem verhindert die eindeutige oder zulässige Verarbeitung.
Die EAN/GTIN wird nicht als Abgleichschlüssel verwendet.
Pflichtfelder
Artikelnummer und Artikelbezeichnung dürfen in den Importdateien nicht leer sein.
Fehlt bei einem bestehenden Artikel die neue BMEcat-Bezeichnung, wird die vorhandene JTL-Bezeichnung übernommen.
Fehlt bei einem Neuartikel die Bezeichnung, wird der Artikel vom Import ausgeschlossen und im Prüfprotokoll erfasst.
Leere oder doppelte Artikelnummern werden ebenfalls nicht in die Importdateien übernommen.
7. Verwendung mit JTL-Ameise
Die Dateien 02_JTL_UPDATE_TESTIMPORT.csv und 03_JTL_NEU_TESTIMPORT.csv enthalten:
- Artikelnummer
- Artikelname
- Kurzbeschreibung
- Beschreibung
Vor dem Import ist die Feldzuordnung in JTL-Ameise zu kontrollieren.
Besonders wichtig: Es muss geprüft werden, ob leere Beschreibungsfelder bestehende JTL-Inhalte löschen würden.
Verkaufspreise, Lagerbestände und Lieferanten-Einkaufspreise sind in diesen beiden Importdateien nicht enthalten.
Die Einkaufspreiskandidaten werden ausschließlich in einer separaten Prüfdatei ausgegeben.
8. CSV-Format
Die Dateien werden mit folgenden Einstellungen erzeugt:
- Zeichensatz: UTF-8 mit BOM
- Feldtrennzeichen: Semikolon
- Textbegrenzungszeichen: doppelte Anführungszeichen
- Artikelnummern: unveränderte Zeichenfolgen
Achtung: CSV-Dateien nicht mit Excel öffnen und anschließend einfach wieder speichern. Excel kann Artikelnummern, führende Nullen oder GTINs verändern.
Die CSV-Dateien sollten direkt in JTL-Ameise eingelesen werden.
9. Grenzen der aktuellen Version
Die Version 1.8 ist eine Test- und Vorbereitungsversion.
Noch nicht vollständig umgesetzt sind:
- Direkter SQL-Abgleich mit JTL-Wawi
- Automatischer JTL-Ameise-Import
- Fachliche Freigabe sämtlicher maschinell übersetzter ETIM-Bezeichnungen
Vor dem produktiven Import sind die CSV-Feldzuordnung und das Verhalten bei leeren Feldern anhand weniger Testartikel zu prüfen.
