Get Invoice Line Item Data
Zuletzt geändert: 14.03.2026 05:56

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.