Fehlerbehebung beim CSV-Import¶

Sollte es beim Einlesen einer CSV-Datei zu Fehlermeldungen oder unerwarteten Ergebnissen kommen, helfen Ihnen die nachfolgenden Prüfschritte und Formatvorgaben bei der schnellen Behebung.

1. Technische Formatvorgaben (CSV-Dialekt)¶

Standard-CSV-Dateien für den Caspos Manager müssen folgenden Konventionen entsprechen:

Eigenschaft	Anforderung	Erläuterung / Beispiel
Zeichensatz (Encoding)	UTF-8	Verhindert fehlerhafte Umlaute (ä, ö, ü, ß) und Sonderzeichen (€).
Spaltentrennzeichen	Semikolon (`;`)	Felder werden durch Semikolons getrennt.
Dezimaltrennzeichen	Komma (`,`)	Geldbeträge verwenden ein Komma (z. B. `12,50`, nicht `12.50`).
Tausendertrennzeichen	Keine	Zahlen ohne Punkte für Tausender angeben (z. B. `1250,00`).
Textbegrenzer (Quoting)	Doppelte Anführungszeichen (`"`)	Texte, die Semikolons oder Zeilenumbrüche enthalten, müssen in `"` eingeschlossen werden (z. B. `"Pizza; Margherita"`).
Anführungszeichen maskieren	`""`	Ein Anführungszeichen im Text wird durch zwei Anführungszeichen dargestellt.

2. Empfohlene Importreihenfolge¶

Da Artikel auf Warengruppen und Steuersätze verweisen, müssen übergeordnete Stammdaten zuerst im System existieren. Halten Sie bei umfangreichen Neuinstallationen folgende Reihenfolge ein:

graph TD
    A[1. Steuersätze / MwSt.] --> B[2. Hauptwarengruppen]
    B --> C[3. Gänge & Beilagen]
    C --> D[4. Beilagengruppen]
    D --> E[5. Warengruppen]
    E --> F[6. Artikelstamm]
    G[7. Bediener & Kunden]

Mehrwertsteuersätze (MwSt.-IDs anlegen)
Hauptwarengruppen (z. B. Speisen, Getränke)
Gänge & Beilagen (für Restaurantbetriebe)
Beilagengruppen (Zusammenfassungen für Speisen)
Warengruppen (Zuordnung zu Hauptwarengruppen und MwSt.)
Artikel (Produkte mit Preisen und Warengruppenbezug)
Bediener & Kunden (können unabhängig importiert werden)

3. Typische Fehlermeldungen und Lösungen¶

Problem 1: Umlaute werden kryptisch dargestellt (z. B. `M�nchen` oder `K�se`)¶

Ursache: Die Datei wurde im Windows-1252- oder ANSI-Format statt UTF-8 gespeichert.
Lösung: Öffnen Sie die Datei in einem Texteditor (z. B. Notepad++ oder Excel) und speichern Sie sie explizit im Format *CSV UTF-8 (durch Trennzeichen getrennt) (.csv) ab.

Problem 2: Alle Spalten landen in einer einzigen Zeile¶

Ursache: Falsches Spaltentrennzeichen (z. B. Komma , statt Semikolon ;).
Lösung: Prüfen Sie das Profil im Caspos Manager und stellen Sie das Trennzeichen auf das in Ihrer Datei verwendete Zeichen um.

Problem 3: Preise werden mit Faktor 100 importiert (z. B. 250,00 € statt 2,50 €)¶

Ursache: Die CSV-Datei enthält Dezimalpunkte (2.50) statt Kommas (2,50).
Lösung: Passen Sie im Importprofil das Feld Dezimaltrennzeichen auf Punkt (.) an oder ersetzen Sie die Punkte in Ihrer Quelldatei.

Problem 4: Artikel kann wegen unbekannter Warengruppe nicht angelegt werden¶

Ursache: Die in der Spalte ProductGroupId angegebene Warengruppen-ID existiert noch nicht im Caspos Manager.
Lösung: Legen Sie die Warengruppe vor dem Artikelimport unter Produktdaten → Warengruppen an.

4. Beispiel für eine valide Artikel-CSV¶

Id;Name;Price1;ProductGroupId;VatId;ScanCodes
101;Espresso Single;2,80;1;1;4012345678901
102;Cappuccino Italiano;3,90;1;1;4012345678918
301;"Pizza Margherita; Tradizionale";11,50;3;2;
302;Caspos Bacon Cheeseburger;13,90;3;2;