ConvertTo-ZugferdPdf #

ÜBERSICHT #

Erzeugt aus einer bestehenden PDF-Datei eine PDF/A-3-konforme ZUGFeRD-PDF mit eingebetteter XML-Rechnungsdatei per inkrementellem Update.

SYNTAX #

ConvertTo-ZugferdPdf [-InputPdf] <string> [-ZugferdXml] <string> [[-OutputPdf] <string>]
    [[-Attachments] <hashtable[]>] [<CommonParameters>]

BESCHREIBUNG #

Die Funktion nimmt eine vorhandene PDF-Datei und eine ZUGFeRD-konforme XML-Datei (EN16931, XRechnung, Factur-X) und bettet die XML als Anhang in die PDF ein. Die Ausgabe ist eine PDF/A-3-kompatible Datei mit eingebetteter Rechnung (Attachment-Name: factur-x.xml).

Die Original-PDF wird per inkrementellem PDF-Update (ISO 32000-1, Kap. 7.5.6) erweitert. Die Original-Bytes bleiben vollständig erhalten, neue Objekte werden am Ende angehängt.

Optional können weitere Dateien (z.B. Arbeitsnachweise) über den Parameter -Attachments eingebettet werden.

PARAMETER #

-InputPdf #

Type: string

Pfad zur bestehenden PDF-Datei, die als Basis für die ZUGFeRD-Konvertierung dient.

-ZugferdXml #

Type: string

Pfad zur XML-Datei im ZUGFeRD-/XRechnung-Format, die in die PDF eingebettet werden soll.

-OutputPdf #

Type: string

Optionaler Pfad für die Ausgabe-PDF. Wenn nicht angegeben, wird eine Datei mit dem Suffix ‘-zugferd’ neben der Eingabe erzeugt.

-Attachments #

Type: hashtable[]

Optionale zusätzliche Anhänge als Array von Hashtables: @{ Path=’…’; Name=‘nachweis.pdf’; Description=’…’; Relationship=‘Supplement’; MimeType=‘application/pdf’ }

AUSGABEN #

string

Gibt den Pfad zur erzeugten ZUGFeRD-PDF zurück.

BEISPIELE #

ConvertTo-ZugferdPdf -InputPdf "rechnung.pdf" -ZugferdXml "factur-x.xml"

ConvertTo-ZugferdPdf -InputPdf "rechnung.pdf" -ZugferdXml "factur-x.xml" -OutputPdf "zugferd-rechnung.pdf"

$att = @{ Path='nachweis.pdf'; Name='nachweis.pdf'; Description='Arbeitsnachweis'; Relationship='Supplement'; MimeType='application/pdf' }
ConvertTo-ZugferdPdf -InputPdf "rechnung.pdf" -ZugferdXml "factur-x.xml" -Attachments @($att)