Zum Hauptinhalt springen

Umgang mit Fehlermeldungen beim Artikelimport

Häufige Fehlermeldungen und ihre Behebung

Mara F. avatar
Verfasst von Mara F.
Vor über einer Woche aktualisiert

Nach dem Import erhalten Sie eine E-Mail "Datenimport abgeschlossen", diese finden Sie im Postfach Ihrer Login E-Mail Adresse. Sollten Sie keine E-Mail erhalten haben, kontrollieren Sie auch Ihren Spam-Ordner.

Beim Import von Artikeldaten in Lexware Office kann es zu Fehlermeldungen kommen, wenn die übermittelten Werte nicht den erwarteten Vorgaben entsprechen. In diesem Artikel erhalten Sie eine Übersicht der häufigsten Validierungsfehler beim Artikelimport, inklusive Ursachen, Anforderungen je Feld und den dazugehörigen Fehlermeldungen in Spalte I und Spalte J der Importdatei.


Feldübersicht mit Fehlerquellen

Feldname

Max. Länge

Besonderheiten / Prüfungen

Spalte I

Fehlerursache

Spalte J

Fehlercode

Artikelnummer

18 Zeichen

Hinweis: Wird ohne Artikelnummer gearbeitet, entstehen bei erneutem Import Dubletten.

Artikelnummer
Der eingegebene Wert hat eine unzulässige Länge.

invalid_size: materialNumber

Bei Duplikaten erfolgt kein Import.

Artikelnummer ist bereits vergeben

material_number_

already_exists: materialNumber

GTIN/EAN

8, 12, 13, 14 Ziffern

Muss gültige Prüfziffer enthalten

Die eingegebene GTIN/EAN ist ungültig

invalid_gtin: gtin

Bezeichnung

Pflichtfeld

100 Zeichen

Muss mindestens 1 Zeichen enthalten

Bezeichnung

Darf nicht leer sein
Der eingegebene Wert hat eine unzulässige Länge.

missing_entity: title
invalid_size: title

Beschreibung

2000 Zeichen

Keine Pflicht – nur Längenprüfung

Beschreibung
Der eingegebene Wert hat eine unzulässige Länge.

invalid_size: description

Notiz

1000 Zeichen

Keine Pflicht – nur Längenprüfung

note

Der eingegebene Wert hat eine unzulässige Länge.

invalid_size: note

Einheit

Pflichtfeld

Muss mindestens 1 Zeichen enthalten

Einheit

Darf nicht leer sein

missing_entity: unit

Steuerart

Pflichtfeld

Nur folgende Werte zulässig:
- USt 19%
- USt 7%
- USt 0%

Bruttopreis
Darf nicht leer sein

Steuerart:

Darf nicht leer sein

missing_entity: taxRate

Brutto-/Nettopreis

Pflichtfeld

(je nach Einstellung)

Nur numerische Werte erlaubt
Keine Währungszeichen
Import erfolgt gemäß Systemkonfiguration (Brutto oder Netto)

leadingPrice

Darf nicht leer sein
Nettopreis:

Darf nicht leer sein

Bruttopreis:

Darf nicht leer sein

missing_entity: grossPrice
missing_entity: netPrice
missing_entity: leadingPrice

Hinweise zur Dublettenvermeidung bei Artikelnummern

Wenn eine Artikelnummer mehrfach im Import enthalten ist oder bereits im System existiert, wird der betroffene Artikel nicht erneut importiert. Es erfolgt keine automatische Aktualisierung bestehender Artikel.

Wichtig: Wird auf Artikelnummern verzichtet, kann es beim wiederholten Import zu Dubletten kommen, da die eindeutige Zuordnung fehlt.


Beispiel für korrekte Formatierung in CSV-Datei

Artikel-nummer

GTIN/EAN

Bezeich-nung

Beschrei-bung

Notiz

Einheit

Steuerart

VK (Netto)

*

*

Produkt 01

*

*

Stück

USt 19%

15,95

*

*

Produkt 02

*

*

Stück

USt 7%

14,35

*

*

Produkt 03

*

*

Stück

USt 0%

13,40

* keine Pfilchtangabe

  • Achten Sie auf die vollständige Konformität Ihrer Importdatei mit den Feldanforderungen, um fehlerfreie Ergebnisse zu erhalten.


Feld: Artikelnummer

Anforderungen

  • Die Artikelnummer ist optional, kann aber für eine bessere Identifizierung verwendet werden.

  • Maximale Länge der Artikelnummer: 18 Zeichen.

  • Das System prüft auf Dubletten, Artikel mit bereits vorhandenen Artikelnummern werden nicht importiert.

Falls die Nummer länger ist, wird der Artikel nicht importiert und Sie erhalten folgende Fehlermeldung:

  • Spalte I (Fehlerursache): Artikelnummer

    Der eingegebene Wert hat eine unzulässige Länge.

  • Spalte J: invalid_size: materialNumber

Falls die Artikelnummer bereits vergeben ist, erhalten Sie folgende Fehlermeldung:

  • Spalte I (Fehlerursache): Artikelnummer

    Artikelnummer ist bereits vergeben

  • Spalte J: material_number_already_exists: materialNumber

Lösung

  • Prüfen Sie die Zeichenanzahl

  • Prüfen Sie die Artikelnummer und editieren diese

Zusätzliche Hinweise

Das System prüft, ob die Artikelnummer bereits existiert. Falls ja, wird der Artikel nicht importiert. Artikel können nicht überschrieben bzw. aktualisiert werden.

Wenn Sie keine Artikelnummern verwenden, können bei einem erneuten Import Dubletten entstehen.

Das System vergibt keine Artikelnummer, da diese optional sind.


Feld: GTIN/EAN

Anforderungen

  • Das Feld ist optional und kann leer bleiben.

  • Die GTIN/EAN muss eine Länge von 8, 12, 13 oder 14 Ziffern haben.

    Die letzte Ziffer ist eine Prüfziffer, die korrekt sein muss.

Falls die GTIN/EAN ungültig ist oder fehlerhaft aufgebaut wurde, wird der Artikel nicht importiert. Sie erhalten folgende Fehlermeldung:

  • Spalte I (Fehlerursache):

    Die eingegebene GTIN/EAN ist ungültig.

  • Spalte J (Fehlercode):

    invalid_gtin: gtin

Lösung

  • Prüfen Sie Ihre eingegebenen Ziffern

  • Das Feld GTIN/EAN leer lassen


Feld: Bezeichnung

Anforderungen

  • Dieses Feld ist ein Pflichtfeld und muss mindestens 1 Zeichen enthalten.

  • Maximale Länge der Bezeichnung: 100 Zeichen.

Falls die Anforderungen nicht erfüllt werden, erscheinen folgende

Fehlermeldungen:

  • Spalte I (Fehlerursache):

    Darf nicht leer sein

  • Spalte J (Fehlercode):

    missing_entity: title

  • Spalte I (Fehlerursache):

    Der eingegebene Wert hat eine unzulässige Länge.

  • Spalte J (Fehlercode):

    invalid_size: title

Lösung

  • Stellen Sie sicher, dass Sie eine Bezeichnung eingegeben haben

  • Prüfen Sie die Anzahl der Zeichen


Feld: Beschreibung

Anforderungen

  • Die Beschreibung ist optional.

  • Maximale Länge des Feldes: 2.000 Zeichen.

Falls die Zeichenanzahl überschritten wird, erscheint folgende Fehlermeldung:

  • Spalte I (Fehlerursache)

    Der eingegebene Wert hat eine unzulässige Länge.

  • Spalte J (Fehlercode):

    invalid_size: description

Lösung

  • Prüfen Sie die Anzahl der eingegebenen Zeichen


Feld: Notiz

Anforderungen

  • Die Notiz ist optional.

  • Maximale Länge des Feldes: 1.000 Zeichen.

Falls die Zeichenanzahl überschritten wird, erscheint folgende Fehlermeldung:

  • Spalte I (Fehlerursache):

    Der eingegebene Wert hat eine unzulässige Länge.

  • Spalte J (Fehlercode):

    invalid_size: note

Lösung

  • Prüfen Sie die Anzahl der eingegebenen Zeichen


Feld: Einheit

Anforderungen

  • Dieses Feld ist ein Pflichtfeld und muss mindestens 1 Zeichen enthalten.

Falls das Feld leer bleibt, erscheinen folgende Fehlermeldungen:

  • Spalte I (Fehlerursache):

    Darf nicht leer sein.

  • Spalte J (Fehlercode):

    missing_entity: unit

Lösung

  • Prüfen Sie ob alle angegebenen Einheiten im Account hinterlegt wurden.
    Standardmäßig sind in Lexware Office die Einheiten Stunde und Stück angelegt.

  • Prüfen Sie auch die Groß- und Kleinschreibung der Einheiten und
    passen Sie die Einheiten in Ihrer CSV-Datei der Schreibweise in Ihrem Account an.


Feld: Steuerart

Anforderungen

  • Dieses Feld ist ein Pflichtfeld.

  • Nur folgende Werte sind erlaubt:

    USt 19%

    USt 7%

    USt 0%

Falls das Feld leer ist oder falsche Werte eingegeben werden, erscheinen folgende Fehlermeldungen:

  • Spalte I (Fehlerursache):

    Darf nicht leer sein.

  • Spalte J (Fehlercode):

    missing_entity: taxRate

Lösung

  • Prüfen Sie, ob die Steuerart korrekt eingegeben wurde

  • Groß- und Kleinschreibung beachten


Feld: Bruttopreis oder Nettopreis

Anforderungen

  • Es dürfen nur numerische Werte eingegeben werden, ohne Währungssymbole.

  • Werte müssen basierend auf Ihrer Systemeinstellung als VK (Netto) oder VK (Brutto) importiert werden.

Falls das Feld leer bleibt, die Formatierung inkorrekt ist, z.B. Währungszeichen oder es wurden mehr als 4-Nachkommastellen eingegeben.

  • Spalte I (Fehlerursache):

    - Nettopreis:

    * Der eingegebene Wert ist keine gültige Nummer oder liegt außerhalb des vorgeschriebenen Wertebereichs.

    - Beschreibung:

    * Der eingegebene Wert hat eine unzulässige Länge.

    - Bruttopreis:

    * Der eingegebene Wert ist keine gültige Nummer oder liegt außerhalb des vorgeschriebenen Wertebereichs.

  • Spalte J (Fehlercode):

    missing_entity: grossPrice, missing_entity: netPrice oder missing_entity: leadingPrice

Lösung

  • Die Spalte darf keinesfalls als Währungsspalte markiert/aktiviert sein.

  • Es können max. 4 Nachkommastellen importiert werden

  • Prüfen Sie, ob in den "Allgemeinen Einstellungen" Brutto oder Netto Preise hinterlegt sind. Spaltenüberschrift Brutto = VK (Brutto), Netto = VK (Netto)


Was tun bei Fehlermeldungen?

  1. Fehlercode identifizieren: Prüfen Sie den Prüfbericht auf Fehlercodes.

  2. Angaben ergänzen bzw. anpassen: Ergänzen Sie fehlende Angaben entsprechend den Hinweisen oben.

  3. Import erneut versuchen: Speichern Sie die Änderungen und führen Sie den Import erneut aus.


Übermitteln des Prüfberichts an den Lexware Support

Wenn beim Artikelimport wiederholt Fehlermeldungen auftreten und Sie diese nicht eigenständig beheben können, wenden Sie sich an den Lexware Support. Bitte teilen Sie uns folgende Informationen direkt im Support-Chat mit:

  • die verwendete Importdatei

  • Prüfbericht

  • Beschreibung der bereits unternommenen Schritte

Dadurch kann eine gezielte Analyse und schnelle Hilfestellung erfolgen.

Hat dies Ihre Frage beantwortet?