Zum Hauptinhalt springen
csv2zugferd

docs

PDF-Vorlage

Verwendung vorhandener Rechnungs-PDFs als Vorlage für ZUGFeRD-PDFs.

csv2zugferd nutzt eine vorhandene Rechnungs-PDF als sichtbaren Beleg und bettet die erzeugten XML-Daten ein.

Das passt zu Systemen, die bereits eine korrekte PDF-Rechnung erzeugen, aber noch keine ZUGFeRD-konforme Hybridrechnung ausgeben.

Verhalten im CLI
#

Ohne --xml-only erzeugt das Tool:

  • eine XML-Datei
  • eine PDF-Datei mit eingebettetem ZUGFeRD-XML

Mit --xml-only wird nur die XML-Datei geschrieben. Der Parameter --pdf bleibt dennoch erforderlich, weil die CLI-Signatur konsistent bleibt und derselbe Aufruf leicht auf einen PDF-Lauf umgestellt werden kann.

Empfehlung
#

Für realistische Tests sollte eine echte Rechnungs-PDF verwendet werden, nicht nur eine leere Platzhalterdatei. Im Repository ist dafür zum Beispiel test\2483.pdf geeignet.

Wichtig
#

Die sichtbare PDF und die eingebetteten XML-Daten müssen fachlich zusammenpassen. Abweichungen zwischen PDF und XML können zu Problemen bei Empfängern, Prüfungen oder Folgeprozessen führen.