csv2zugferd ist als Windows-x64-CLI verfügbar. Download über GitHub Releases. Der Quellcode ist unter Apache-2.0 veröffentlicht.
Neu in Version 1.2.1#
- Positionsrabatte und -zuschläge aus
allowanceChargewerden als ausgewiesener Positionsrabatt (BG-27/BG-28) geschrieben und mindern den Zeilennettobetrag. Bisher entstand ein Schemafehler und die Summen widersprachen EN-16931-Regeln. - Fehlen Lieferdatum und Lieferschein, wird das Rechnungsdatum als Leistungsdatum (BT-72) geschrieben, mit Warnung im Log. Der Lieferblock ist im Schema Pflicht.
- Alle Beispielkonfigurationen werden in der Testsuite mit Mustang-CLI validiert.
Details: BT-131 Zeilennettobetrag · BT-72 Lieferdatum · Validierung
Neu in Version 1.2.0#
- Rechnungstyp (BT-3) per
invoice.typeCode: Rechnung, Gutschrift oder Rechnungskorrektur, auch regelbasiert aus einer CSV-Spalte - Vorgängerrechnungen (BT-25/BT-26) für Storno und Korrektur
- Kunden- und Lieferantennummer per
buyer.idundseller.id - Kaufmännisch gerundete Zeilennettobeträge, damit Positions- und Kopfsummen exakt zusammenpassen
Details: YAML-Konfiguration
Neu in Version 1.1.0#
- Bankverbindung des Verkäufers (IBAN, BIC, Kontoinhaber) in der ZUGFeRD-Rechnung
- SEPA-Lastschrift mit Gläubiger-ID, Mandatsreferenz und IBAN des Käufers
- Zahlungsart pro Rechnung per Regel wählbar, zum Beispiel Überweisung oder Lastschrift
- Warnungen bei fehlenden Pflichtangaben und ungültiger IBAN-Prüfsumme
Details: Beispiel Bankverbindung und SEPA-Lastschrift
Release-Umfang#
- Windows-x64-Exe (self-contained, kein .NET erforderlich)
- SHA256-Prüfsumme pro Release-Datei
- Release Notes mit bekannten Änderungen
- Demo-Paket mit Beispiel-Rechnungen und fertiger YAML-Konfiguration
- Quellcode und Build-Hinweise auf GitHub
- Lizenz: Apache-2.0
Beispiel#
.\csv2zugferd-win-x64.exe --csv invoices.csv --pdf invoice.pdf --config config.yml --output outSignatur und Prüfsumme#
Zu jedem Release wird eine SHA256-Prüfsumme bereitgestellt. Eine Signatur bestätigt die Herkunft der Datei und die Integrität des Downloads — sie ist keine Garantie für die fachliche oder steuerliche Richtigkeit der erzeugten Rechnungen.
Systemanforderungen#
Windows x64. Die Exe ist self-contained — eine separate .NET-Installation ist nicht erforderlich. Für den MCP-Server gibt es zusätzlich das .NET-Tool-Paket csv2zugferd auf NuGet (ab Version 1.3.1, benötigt das .NET-10-SDK; Windows, Linux und macOS) sowie ein Dockerfile im Repository. Winget und Scoop werden geprüft.
Erzeugte Dateien prüfen#
Vor dem produktiven Einsatz empfiehlt sich eine Validierung der erzeugten XML- oder PDF/A-3-Datei. ELSTER und e-rechnungs-checker.de bieten dafür kostenlose Prüf-Tools an.
ZUGFeRD-Validierung: verfügbare Tools →
Haftungsausschluss#
csv2zugferd wird ohne Gewähr bereitgestellt. Die erzeugten XML- und PDF-Dateien müssen vor produktiver Nutzung fachlich und technisch geprüft werden. Das Tool ersetzt keine steuerliche, rechtliche oder fachliche Beratung.Für die Richtigkeit, Vollständigkeit und steuerliche Bewertung der Eingabe- und Ausgabedaten bleibt der Anwender verantwortlich. Die Bereitstellung erfolgt zu den Bedingungen der Lizenz Apache-2.0, die einen Gewährleistungs- und Haftungsausschluss enthält. Weitere Angaben finden Sie im Impressum und in der Datenschutzerklärung.