Get-OrderData #

ÜBERSICHT #

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

SYNTAX #

Get-OrderData [[-Conn] <__ComObject>] [[-OrderId] <nullable[int]>] [[-OrderNo] <nullable[int]>]
    [<CommonParameters>]

BESCHREIBUNG #

Die Funktion liest alle relevanten Kopf- und Adressinformationen eines Auftrag 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 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.

-OrderId #

Type: nullable[int]
Default: $null

Gibt die ID des Auftrag an. Dies ist der Primärschlüssel in ‘Auftrag’. Hat Vorrang, sollte auch ‘-OrderNo’ gesetzt sein.

-OrderNo #

Type: nullable[int]
Default: $null

Gibt die Auftragsnummer des Datenbankfeldes ‘KopfNummer’ an. Wird auch ‘-OrderId’ übergeben, hat die Id Vorrang.

AUSGABEN #

hashtable

Hashtable mit strukturierten Auftragsdaten zur Weiterverarbeitung.

BEISPIELE #

# Lädt alle strukturierten Auftragsdaten zur Auftrags-ID 12345.
Get-OrderData -Conn $db -OrderId 12345

# Lädt alle Auftragsdaten zur Auftragsnummer 20231234.
Get-OrderData -Conn $db -OrderNo 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.