↓ Zum Hauptinhalt springen
csv2zugferd

docs

csv2zugferd Dokumentation – ZUGFeRD aus CSV erzeugen

Vollständige Dokumentation für csv2zugferd: Installation, CLI-Parameter, YAML-Konfiguration, CSV-Modi und Beispiele für ZUGFeRD-Workflows.

Der Fokus der Dokumentation liegt auf reproduzierbaren CSV-Workflows: strukturierte Eingabedaten, YAML-Mapping und lokale Ausgabe von ZUGFeRD-Dateien.

Einstieg
#

BT-Felder
#

BT-13 Bestellnummer in ZUGFeRD richtig mappen BT-13 ist die Bestellnummer des Käufers in ZUGFeRD und XRechnung. So mappen Sie sie in csv2zugferd auf orderReference.orderNumber – mit CSV-Beispiel und typischen Fehlern. BT-131 Zeilennettobetrag in ZUGFeRD richtig berechnen BT-131 ist der Zeilennettobetrag einer Rechnungsposition. csv2zugferd leitet ihn aus netUnitPrice, billedQuantity und Rabatt ab – so vermeiden Sie widersprüchliche Summen. BT-152 Umsatzsteuersatz je Position in ZUGFeRD richtig mappen BT-152 ist der Umsatzsteuersatz je Position in ZUGFeRD und XRechnung. So mappen Sie ihn in csv2zugferd auf lineItems.fields.taxPercent – mit CSV-Beispiel und typischen Fehlern. BT-153 Positionsbezeichnung in ZUGFeRD richtig mappen BT-153 ist die Positionsbezeichnung (Artikelname) in ZUGFeRD und XRechnung. So mappen Sie sie in csv2zugferd auf lineItems.fields.name – mit CSV-Beispiel und typischen Fehlern. BT-155 Verkäufer-Artikelnummer in ZUGFeRD richtig mappen BT-155 ist die Verkäufer-Artikelnummer in ZUGFeRD und XRechnung. So mappen Sie sie in csv2zugferd auf lineItems.fields.sellerAssignedId – mit CSV-Beispiel und typischen Fehlern. BT-44 Käufername in ZUGFeRD richtig mappen BT-44 ist der Käufername in ZUGFeRD und XRechnung. So mappen Sie das Pflichtfeld in csv2zugferd auf buyer.name – mit CSV-Beispiel, YAML-Block und typischen Fehlern. BT-72 Lieferdatum in ZUGFeRD richtig mappen BT-72 ist das tatsächliche Liefer- bzw. Leistungsdatum in ZUGFeRD und XRechnung. So mappen Sie es in csv2zugferd auf delivery.actualDeliveryDate – mit CSV-Beispiel und Fehlern. BT-9 Fälligkeitsdatum in ZUGFeRD richtig mappen BT-9 ist das Fälligkeitsdatum (Zahlungsziel) in ZUGFeRD und XRechnung. So setzen Sie es in csv2zugferd über paymentTerms.dueDate – mit CSV-Beispiel und typischen Fehlern. BT-Felder in ZUGFeRD mit csv2zugferd Die wichtigsten BT-Felder für ZUGFeRD und XRechnung im Überblick – mit direkter Zuordnung zum YAML-Mapping von csv2zugferd, CSV-Beispielen und typischen Fehlern. Schnellstart – Demo-Paket herunterladen und ausführen csv2zugferd Demo-Paket: ZIP mit Exe, zwei Beispiel-Rechnungen und fertiger YAML-Konfiguration. Erklärung der config_demo.yml im Detail. ZUGFeRD Rechnung validieren – kostenlose Prüf-Tools ZUGFeRD-Dateien kostenlos validieren: ELSTER E-Rechnungsportal und e-rechnungs-checker.de prüfen die erzeugte XML-Datei auf Konformität. Batch-Verarbeitung – mehrere ZUGFeRD-Rechnungen per CLI csv2zugferd im Batch-Betrieb: mehrere Rechnungen per Skript erzeugen, PowerShell-Schleifen und Automatisierung für ZUGFeRD-Workflows. CSV-Modi – rows, columns-suffix und columns-prefix csv2zugferd unterstützt drei CSV-Modi: rows (eine Rechnung pro Zeile), columns-suffix und columns-prefix für spaltenbasierte Rechnungspositionen. csv2zugferd CLI-Parameter – alle Optionen im Überblick Alle CLI-Optionen von csv2zugferd: --csv, --pdf, --config, --output, --xml-only und --verbose – mit Erklärung, Pflichtparametern und Verwendungsbeispielen. csv2zugferd installieren – Setup und Voraussetzungen csv2zugferd installieren: Windows-x64-Exe von GitHub Releases herunterladen, Demo-Paket ausprobieren oder Exe direkt einsetzen. Kein .NET erforderlich. Fehlerbehandlung Typische Fehler und Diagnose bei csv2zugferd. KI-Hilfe für config.yml Prompt-Vorlagen für ChatGPT, Claude, Gemini, Copilot und andere KI-Modelle zur Erstellung einer csv2zugferd-config.yml. PDF-Vorlage Verwendung vorhandener Rechnungs-PDFs als Vorlage für ZUGFeRD-PDFs. YAML-Konfiguration – ZUGFeRD-Mapping mit csv2zugferd YAML-Mapping für csv2zugferd: CSV-Spalten auf ZUGFeRD-Pflichtfelder abbilden, rows- und columns-Modus konfigurieren und Rechnungsfelder zuweisen.