ConvertFrom-ZugferdPdf

ÜBERSICHT

Extrahiert die eingebettete ZUGFeRD- oder Factur-X-XML aus einer PDF-Datei.

SYNTAX

ConvertFrom-ZugferdPdf [-Path] <string> [[-OutputXml] <string>] [<CommonParameters>]

BESCHREIBUNG

Die Funktion liest eine PDF-Datei und extrahiert die eingebettete XML-Datei (`factur-x.xml`, `zugferd-invoice.xml`, `xrechnung.xml` oder `ZUGFeRD-invoice.xml`). Dazu wird die PDF-Xref-Tabelle strukturell geparst, das Filespec-Objekt per Objektnummer lokalisiert und der zugehörige EmbeddedFile-Stream per Xref-Offset extrahiert und ggf. dekomprimiert. Unterstützt werden klassische Xref-Tabellen, XRef-Streams (PDF 1.5+), Hybrid-PDFs, linearisierte PDFs und Objekte in Object Streams (Type-2). Falls die Dateinamen-Suche im Rohtext fehlschlägt (z.B. bei komprimierten Filespec-Objekten in ObjStm), wird ein strukturelles Fallback-Parsing über den PDF-Catalog und EmbeddedFiles Name-Tree durchgeführt.

Zusätzlich werden die ZUGFeRD/Factur-X-Metadaten aus den XMP-Daten des PDF gelesen (Version, ConformanceLevel, DocumentType, DocumentFileName).

Das Ergebnis ist ein PSCustomObject mit den Eigenschaften Xml, FileName, Version, ConformanceLevel, DocumentType und OutputPath.

Bei `-OutputXml` mit einem Verzeichnispfad (oder einem Pfad der auf `\` bzw. `/` endet) wird der native eingebettete Dateiname verwendet.

PARAMETER

-Path

Type: string

Der vollständige Pfad zur PDF-Datei, aus der die XML extrahiert werden soll.

-OutputXml

Type: string

Optionaler Ausgabepfad für die extrahierte XML-Datei. Kann ein Dateipfad oder ein Verzeichnispfad sein. Bei einem Verzeichnis wird der eingebettete Dateiname (z.B. `factur-x.xml`) automatisch angehängt.

AUSGABEN

PSCustomObject

Gibt ein Objekt mit folgenden Eigenschaften zurück: Xml - Die extrahierte XML als String FileName - Eingebetteter Dateiname (z.B. "factur-x.xml") Version - ZUGFeRD/Factur-X Version (z.B. "1.0") ConformanceLevel - Profil (z.B. "EN 16931", "EXTENDED") DocumentType - Dokumenttyp (z.B. "INVOICE") OutputPath - Pfad der geschriebenen Datei (nur bei -OutputXml)

BEISPIELE

# Extrahiert die XML und gibt ein Objekt zurück.
$result = ConvertFrom-ZugferdPdf -Path 'C:\Rechnungen\zugferd.pdf'
$result.Xml              # XML-Inhalt
$result.FileName         # z.B. "factur-x.xml"
$result.Version          # z.B. "1.0"
$result.ConformanceLevel # z.B. "EN 16931"

# Extrahiert die XML und speichert sie in eine Datei.
$result = ConvertFrom-ZugferdPdf -Path 'C:\Rechnungen\zugferd.pdf' -OutputXml 'C:\Temp\factur-x.xml'
$result.OutputPath       # "C:\Temp\factur-x.xml"

# Speichert mit nativem Dateinamen in ein Verzeichnis.
$result = ConvertFrom-ZugferdPdf -Path 'C:\Rechnungen\zugferd.pdf' -OutputXml 'C:\Temp\'
$result.OutputPath       # z.B. "C:\Temp\factur-x.xml"