Zum Hauptinhalt springen
csv2zugferd

docs

Fehlerbehandlung

Typische Fehler und Diagnose bei csv2zugferd.

Typische Fehlerquellen:

  • CSV-Trennzeichen passt nicht zur Konfiguration
  • Spaltenname fehlt oder ist anders geschrieben
  • globale Rechnungsfelder im columns-Modus sind falsch als Positionsspalten konfiguriert oder umgekehrt
  • Zahlenformat passt nicht zur erwarteten Kultur
  • Pflichtfelder für die Rechnung fehlen
  • PDF-Datei ist nicht lesbar oder nicht vorhanden
  • PDF und XML enthalten fachlich abweichende Rechnungsdaten
  • lokaler Build erfolgt mit einem zu alten .NET SDK statt mit .NET 10

Schnelle Diagnose
#

Für Konfigurationsfehler ist --verbose der erste Schritt. In der Debug-Ausgabe sieht man unter anderem:

  • erkannte CSV-Header
  • aktiven lineItems-Modus
  • aufgelöste Feldfragmente im columns-Modus
  • erkannte Positionswerte inklusive MwSt

Fehler melden
#

Bug Reports sollen über GitHub Issues erfolgen. Keine echten Rechnungen, Kundendaten oder vertraulichen Dateien öffentlich hochladen.

Weiterführend: YAML-Konfiguration – Felddefinitionen und Modus-Übersicht.