Get-OrderLineItemData

ÜBERSICHT

Lädt strukturierte Auftragspositionen aus der EULANDA-Datenbank.

SYNTAX

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

BESCHREIBUNG

Diese Funktion liest alle Positionsdaten eines Auftrag aus der Tabelle 'AuftragPos' und verknüpften Tabellen. Die Ausgabe ist ein Array von Hashtables unter dem Schlüssel 'AuftragPos'.

Die Positionsdaten werden dabei aufbereitet:

• Preise werden auf Einzelstückbasis normalisiert 'PreisEh = 1.0.
• Rabatte werden getrennt als Wert und Prozentsatz ausgewiesen.
• Sprachabhängige 'Langtexte' werden extrahiert und bereinigt.
• Die Felder 'VkVRab', 'VkRab', 'RabattBetrag' und 'RabattBetragGes' berücksichtigen die Preiseinheit.
• Die Mengeneinheit 'MengenEh' wird auf den UN/ECE-Code normalisiert.
• Die Steuerkategorie wird nach EN16931 Steuerschema (z.B.. „S“, „E“, „Z“) bestimmt.

Optional nicht gesetzte Rabattfelder und Aufschlagskennungen werden entfernt. XML-Felder werden geprüft und führen im Fehlerfall zu einem Abbruch mit Fehlermeldung.

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 Auftrags 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

Ein Dictionary mit einem Schlüssel 'AuftragPos', der ein Array strukturierter Positionsdaten enthält.

BEISPIELE

# Lädt alle Positionen des Auftrags mit Kopf-ID 12345.
Get-OrderLineItemData -Conn $db -OrderId 12345

# Lädt die Positionsdaten des Auftrag mit KopfNummer 20231234.
Get-OrderLineItemData -Conn $db -OrderNo 20231234

HINWEISE

• Die Funktion berechnet Rabatte und Preise stets auf Einzelbasis.
• Die Positionsbeschreibung 'Langtext' wird sprachsensitiv extrahiert.
• Felder wie GTIN, Kundenartikelnummer, Ursprung, Warennummer können bei Bedarf ergänzt werden.
• Diese Funktion ist für den Export in strukturierte XML geeignet.