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.