Export Invoice
Zuletzt geändert: 12.04.2026 17:53

Übersicht

Export-Invoice #

ÜBERSICHT #

Exportiert eine EULANDA-Rechnung als XRechnung (CII-XML), UBL/Peppol (UBL-XML) oder ZUGFeRD-PDF gemäß EN16931.

SYNTAX #

Export-Invoice [[-Conn] <__ComObject>] [[-ConnStr] <string>] [[-Udl] <string>] [[-InvoiceNo]
    <nullable[int]>] [[-InvoiceId] <nullable[int]>] [-OutputXml] <string> -Ubl [-InputPdf] <string>
    [-OutputPdf] <string> [[-BankIBAN] <string>]

BESCHREIBUNG #

Die Funktion ‘Export-Invoice’ exportiert Rechnungen aus einer EULANDA-Datenbank entweder als XRechnung-konformes XML-Dokument oder als ZUGFeRD-konformes PDF mit eingebetteter XML-Datei. Dabei stehen drei Modi zur Verfügung:

  • XmlExport: erzeugt ein reines EN16931-konformes CII-XML (XRechnung).
  • UblExport: erzeugt ein UBL 2.1-konformes XML (Peppol BIS Billing 3.0).
  • PdfExport: bettet das XML in ein bestehendes PDF ein (z. B. mit Firmenbriefpapier).
  • DirectPdfExport: erstellt das PDF direkt über die EULANDA-OLE-Schnittstelle, erzeugt eine XRechnung-XML und bettet diese anschließend ein.

Die Verbindung erfolgt wahlweise über eine bereits geöffnete ADODB.Connection (-Conn), eine Verbindungszeichenfolge -ConnStr oder eine Udl-Datei -Udl. Die Rechnung selbst wird über -InvoiceId oder -InvoiceNo bestimmt.

PARAMETER #

-Conn #

Type: __ComObject

Eine bereits geöffnete ADODB.Connection-Instanz. Hat Vorrang vor -ConnStr und -Udl. Wird vom Aufrufer gehalten und am Ende NICHT geschlossen (Caller-owns-Connection). Spart pro Aufruf einen Connection-Open (~200 ms VPN, ~50 ms lokal) und ist der bevorzugte Weg, wenn mehrere Funktionen dieselbe Verbindung benutzen.

-ConnStr #

Type: string

Eine vollständige ADO-Verbindungszeichenfolge zur EULANDA-Datenbank. Alternativ kann -Udl oder -Conn verwendet werden.

-Udl #

Type: string

Pfad zu einer Udl-Datei, die die Verbindung zur EULANDA-Datenbank definiert. Alternativ kann -ConnStr oder -Conn verwendet werden.

-InvoiceId #

Type: nullable[int]

Interne Rechnungs-ID. Entweder -InvoiceId oder -InvoiceNo muss angegeben werden.

-InvoiceNo #

Type: nullable[int]

Rechnungsnummer laut EULANDA. Entweder -InvoiceId oder -InvoiceNo muss angegeben werden.

-OutputXml #

Type: string

Pfad zur Zieldatei für den XML-Export, in den ParameterSets XmlExport und UblExport.

-Ubl #

Type: switch

Schalter für den UBL/Peppol-Modus. Erzeugt ein UBL 2.1-konformes XML gemäß Peppol BIS Billing 3.0 statt des CII-Formats. Nur im ParameterSet UblExport verfügbar.

-InputPdf #

Type: string

Pfad zur bestehenden PDF-Datei, in die das XML eingebettet werden soll, nur im ParameterSet PdfExport möglich.

-OutputPdf #

Type: string

Pfad zur Zieldatei für das generierte oder modifizierte PDF, Pflicht in PdfExport und DirectPdfExport.

AUSGABEN #

string

Gibt den vollständigen Pfad zur erzeugten Zieldatei (XML oder PDF) zurück.

BEISPIELE #

# Exportiert die Rechnung 12345 als XRechnung-kompatibles CII-XML nach 'rechnung.xml'.
Export-Invoice -Udl 'C:\Daten\Eulanda.Udl' -InvoiceNo 12345 -OutputXml 'C:\Temp\rechnung.xml'

# Exportiert die Rechnung 12345 als Peppol-konformes UBL-XML nach 'rechnung-ubl.xml'.
Export-Invoice -Udl 'C:\Daten\Eulanda.Udl' -InvoiceNo 12345 -OutputXml 'C:\Temp\rechnung-ubl.xml' -Ubl

# Bettet die Rechnung mit ID 42 als ZUGFeRD-XML in die Datei 'briefpapier.pdf' ein und speichert sie als 'rechnung.pdf'.
Export-Invoice -Udl 'C:\Daten\Eulanda.Udl' -InvoiceId 42 -InputPdf 'briefpapier.pdf' -OutputPdf 'rechnung.pdf'

# Erstellt das PDF direkt über OLE, erzeugt automatisch das XML, bettet es ein und speichert alles als 'rechnung.pdf'.
Export-Invoice -ConnStr 'Provider=SQLOLEDB;Data Source=...' -InvoiceNo 9876 -OutputPdf 'rechnung.pdf'

# Conn-Reuse: bestehende Verbindung verwenden, kein Connection-Open-Overhead.
$conn = Get-ConnByUdl -Udl 'C:\Daten\Eulanda.Udl'
Export-Invoice -Conn $conn -InvoiceNo 12345 -OutputXml 'C:\Temp\rechnung.xml'
$conn.Close()

HINWEISE #

  • Teil der EulandaXtools-Suite. Unterstützt den Export gemäß EN16931 als XRechnung (CII), UBL/Peppol (UBL 2.1) bzw. ZUGFeRD (PDF/A-3 mit CII-XML).