Get-InvoiceData

ÜBERSICHT

Lädt strukturierte Rechnungsdaten aus der EULANDA-Datenbank in eine PowerShell-Hashtable.

SYNTAX

Get-InvoiceData [[-Conn] <__ComObject>] [[-InvoiceId] <nullable[int]>] [[-InvoiceNo]
    <nullable[int]>] [<CommonParameters>]

BESCHREIBUNG

Die Funktion liest alle relevanten Kopf- und Adressinformationen einer Rechnung sowie deren Mehrwertsteuergruppen. Sie bereitet die Daten in strukturierter Form auf, inkl. Käufer, Warenempfänger, Zahlungsbedingungen, Beträge, Steuersätze usw..

Die Ausgabe ist eine 'Hashtable', die z.B. für den Export in XML/XRechnung weiterverarbeitet werden kann.

Validierungs- und Aufräumlogik ist integriert, um redundante Daten zu entfernen, z.B. identische Lieferadresse, leere Kommunikationsfelder, Rabatt- oder Skontowerte von 0. Die Funktion berücksichtigt außerdem das richtige Vorzeichen je nach Belegart, also ob Rechnung oder Gutschrift.

PARAMETER

-Conn

Type: __ComObject

Eine aktive ADODB-Verbindung zur EULANDA-Datenbank. Das Connection-Objekt kann über 'Get-ConnByUdl' erstellt werden.

-InvoiceId

Type: nullable[int]
Default: $null

Gibt die ID der Rechnung an. Dies ist der Primärschlüssel in 'Rechnung'. Hat Vorrang, sollte auch '-InvoiceNo' gesetzt sein.

-InvoiceNo

Type: nullable[int]
Default: $null

Gibt die Rechnungsnummer des Datenbankfeldes 'KopfNummer' an. Wird auch '-InvoiceId' übergeben, hat die Id Vorrang.

AUSGABEN

hashtable

Hashtable mit strukturierten Rechnungsdaten zur Weiterverarbeitung.

BEISPIELE

# Lädt alle strukturierten Rechnungsdaten zur internen Rechnungs-ID 12345.
Get-InvoiceData -Conn $db -InvoiceId 12345

# Lädt alle Rechnungsdaten zur externen Rechnungsnummer 20231234.
Get-InvoiceData -Conn $db -InvoiceNo 20231234

HINWEISE

• Bei Gutschriften wird automatisch das Vorzeichen umgesetzt.
• Inkompatible Dokumenttypen (Storno, Korrektur) werden explizit ausgeschlossen.
• Enthält umfangreiche SQL-Logik inkl. Regeln zur Rabattverarbeitung und Steuergruppenzuordnung gemäß EN16931/XRechnung.