Open-Source-CLI für strukturierte Rechnungsdaten

csv2zugferd

CSV-Rechnungsdaten lokal in ZUGFeRD-konforme XML- und PDF-Dateien umwandeln. Automatisierbar, nachvollziehbar und ohne Cloud-Upload.

Veröffentlicht unter Apache-2.0.

Windows-Exe herunterladen Quellcode auf GitHub ansehen

Lokal ausführbar
CSV + PDF-Vorlage
YAML-Mapping
ZUGFeRD / Factur-X

Workflow von CSV und PDF-Vorlage zur ZUGFeRD-Rechnung

Entstanden aus einem echten Workflow

CSV und PDF sind schon da. ZUGFeRD fehlt.

csv2zugferd ist aus einem konkreten internen Bedarf entstanden: Ein CRM-System erzeugte bereits Rechnungsdaten als CSV und die passende Rechnungs-PDF. Gefehlt hat ein einfaches Werkzeug, das daraus eine ZUGFeRD-konforme PDF-Rechnung baut.

Viele ERP-, CRM- und Warenwirtschaftssysteme können CSV exportieren. Diese Daten sind strukturierter und zuverlässiger als eine nachträgliche PDF-Erkennung.

Ab 2025 gilt die E-Rechnungspflicht für B2B-Transaktionen – csv2zugferd erzeugt die dafür notwendigen ZUGFeRD-Dateien lokal und automatisierbar.

Positionierung

Kein PDF-KI-Ausleser. Kein Browser-Rechnungsgenerator. Ein lokales CLI für strukturierte Daten und wiederholbare Prozesse.

Ablauf

Für Automatisierung gebaut

1CSV exportieren

Rechnungsdaten aus CRM, ERP oder Excel bereitstellen.

2YAML-Mapping festlegen

Spalten und Rechnungsfelder nachvollziehbar zuordnen.

3PDF-Vorlage übergeben

Vorhandene Rechnungs-PDF als sichtbaren Beleg nutzen.

4ZUGFeRD erzeugen

XML oder PDF/A-3-Ausgabe lokal erstellen.

csv2zugferd --csv invoices.csv --pdf invoice.pdf --config config.yml --output out

Abgrenzung

Warum lokal statt Web-Upload?

Verarbeitung

lokal

Cloud oder Server

Eingabe

strukturierte CSV

PDF-Upload

Automatisierung

CLI, Skripte, Batch

meist manuell

Transparenz

Open Source

SaaS-Workflow

Ideal für

ERP-, CRM- und CSV-Workflows

Einzelrechnungen ohne Datenexport

Ausführlicher Vergleich: Lokales CLI vs. SaaS-Dienste →

Dokumentation CLI-Parameter, YAML-Konfiguration und CSV-Modi. Beispiele Rows, Columns mit Prefix/Suffix und PowerShell-Batch. Vergleich Lokales CLI gegen Online-Konverter sachlich einordnen. Artikel E-Rechnungspflicht, ZUGFeRD-Profile, GoBD-Archivierung und mehr.

Fragen & Antworten

Häufige Fragen zu csv2zugferd

Was macht csv2zugferd?

csv2zugferd wandelt CSV-Rechnungsdaten zusammen mit einer vorhandenen Rechnungs-PDF in eine ZUGFeRD-konforme PDF/A-3-Datei mit eingebettetem XML um – lokal, ohne Datei-Upload.

Ist csv2zugferd kostenlos?

Ja. csv2zugferd ist Open Source unter Apache-2.0 und kostenlos nutzbar.

Für wen ist csv2zugferd gedacht?

Für Unternehmen, IT-Abteilungen und Entwickler, die ZUGFeRD-Rechnungen automatisiert aus bestehenden CRM- oder ERP-CSV-Exporten erzeugen wollen.

Erzeugt csv2zugferd auch XRechnung?

Nein. csv2zugferd erzeugt ZUGFeRD bzw. Factur-X (hybrides PDF/A-3 mit eingebettetem XML). Reines XRechnung-XML wird nicht ausgegeben.

Prüfung bleibt notwendig.

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.

↑