Get-InvoiceLineItemData

ÜBERSICHT

Lädt strukturierte Rechnungspositionen aus der EULANDA-Datenbank.

SYNTAX

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

BESCHREIBUNG

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

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.

-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

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

BEISPIELE

# Lädt alle Positionen der Rechnung mit Kopf-ID 12345.
Get-InvoiceLineItemData -Conn $db -InvoiceId 12345

# Lädt die Positionsdaten der Rechnung mit KopfNummer 20231234.
Get-InvoiceLineItemData -Conn $db -InvoiceNo 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/XRechnung geeignet.