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