Split Zugferd Pdf
Zuletzt geändert: 14.03.2026 05:56

Split-ZugferdPdf #

ÜBERSICHT #

Teilt einen PDF-Ordner in drei Ströme auf: kein ZUGFeRD, erfolgreich extrahiert, Fehler.

SYNTAX #

Split-ZugferdPdf [-InputFolder] <string> [[-NoZugferdFolder] <string>] [[-ExtractedFolder]
    <string>] [[-ErrorFolder] <string>] [-NoXml] [-NoMetaXml] [-NoHtml] [[-Mask] <string>]
    [<CommonParameters>]

BESCHREIBUNG #

Die Funktion verarbeitet alle PDF-Dateien in einem Eingabeordner und sortiert sie in drei Zielordner:

  • NoZugferdFolder: PDFs ohne eingebettete ZUGFeRD/Factur-X-XML
  • ExtractedFolder: Erfolgreich extrahierte PDFs mit XML, EULANDA-XML und HTML
  • ErrorFolder: PDFs bei denen die Extraktion fehlgeschlagen ist (mit error.txt)

Für erfolgreich erkannte ZUGFeRD-PDFs wird standardmäßig die komplette Konvertierungskette durchlaufen: XML-Extraktion, Typenerkennung (CII/UBL), XSLT-Transformation in EULANDA-Meta-XML und HTML-Darstellung. Mit -NoXml, -NoMetaXml und -NoHtml können einzelne Ausgaben unterdrückt werden.

Relative Ordnerpfade werden relativ zum InputFolder aufgelöst.

PARAMETER #

-InputFolder #

Type: string

Der Quellordner mit den zu verarbeitenden PDF-Dateien.

-NoZugferdFolder #

Type: string
Default: 'no-zugferd'

Zielordner für PDFs ohne ZUGFeRD-XML. Standard: ’no-zugferd'.

-ExtractedFolder #

Type: string
Default: 'extracted'

Zielordner für erfolgreich verarbeitete PDFs. Standard: ’extracted'.

-ErrorFolder #

Type: string
Default: 'errors'

Zielordner für fehlgeschlagene PDFs. Standard: ’errors'.

-NoXml #

Type: switch

Unterdrückt die extrahierte ZUGFeRD-XML (factur-x.xml etc.) im Ausgabeordner.

-NoMetaXml #

Type: switch

Unterdrückt die EULANDA-Meta-XML. Impliziert -NoHtml, da die HTML-Darstellung die Meta-XML als Eingabe benötigt.

-NoHtml #

Type: switch

Unterdrückt die HTML-Darstellung.

-Mask #

Type: string
Default: '*.pdf'

Dateimaske für die PDF-Suche. Standard: ‘*.pdf’.

AUSGABEN #

PSCustomObject

Gibt ein Objekt mit den Eigenschaften InputFolder, Total, NoZugferd, Succeeded, Failed und Items (ArrayList mit Detailobjekten) zurück.

BEISPIELE #

# Verarbeitet alle PDFs im Ordner und sortiert sie in Unterordner.
$result = Split-ZugferdPdf -InputFolder 'C:\Rechnungen\Eingang'
Write-Host "Verarbeitet: $($result.Total), Erfolgreich: $($result.Succeeded)"

# Mit absoluten Zielpfaden.
$result = Split-ZugferdPdf -InputFolder 'C:\Eingang' -ExtractedFolder 'D:\Archiv\Extrahiert'

# Nur die ZUGFeRD-XML extrahieren, ohne Meta-XML und HTML.
$result = Split-ZugferdPdf -InputFolder 'C:\Eingang' -NoMetaXml

# Nur sortieren, keine Konvertierungsergebnisse behalten.
$result = Split-ZugferdPdf -InputFolder 'C:\Eingang' -NoXml -NoMetaXml