Import-SalesOrder

ÜBERSICHT

Importiert einen EULANDA-Auftrag aus einer XML-Datei in die Warenwirtschaft.

SYNTAX

Import-SalesOrder [-XmlFile] <string> [-Conn] <__ComObject> [-CreateAddress] [-CreateArticle]
    [<CommonParameters>]

BESCHREIBUNG

Diese Funktion verarbeitet eine EULANDA-konforme AUFTRAG-XML-Datei und legt den Auftrag mit Kopf- und Positionsdaten über die `COM-API` in der EULANDA-Datenbank an. Dabei erfolgt zunächst die Adressauflösung über `MATCH`, `GLN`, `USTID` oder `EMAIL`. Falls keine Adresse gefunden wird aber `-CreateAddress` gesetzt ist, wird diese implizit angelegt.

Gleiches gilt für Artikelinformationen, wenn kein Artikel gefunden wird und `-CreateArticle` gesetzt ist, wird der Artikel anhand der Positionsdaten im Artikelstamm neu angelegt.

Mengen- und Preisinformationen werden berücksichtigt, sowie `BRUTTOFLG` worüber festgelegt wird ob `VK` mit oder ohne MwSt. zu handhaben ist.

PARAMETER

-XmlFile

Type: string

Pfad zur EULANDA-AUFTRAG-XML-Datei.

-Conn

Type: __ComObject

Eine gültige COM-Connection zur EULANDA-Datenbank (z.B.. via VBScript oder PowerShell COM).

-CreateAddress

Type: switch

Legt die Adresse automatisch neu an, wenn keine anhand der übergebenen Kriterien gefunden wird.

-CreateArticle

Type: switch

Legt Artikel automatisch neu an, wenn keine passende Artikelnummer oder GTIN gefunden wird.

AUSGABEN

nullable[int]

Gibt die interne ID des in EULANDA erstellten Auftrags zurück. Falls ein Fehler auftritt, erfolgt kein Rückgabewert und es wird eine Ausnahme ausgelöst.

BEISPIELE

$eulanda = New-Object -ComObject "Eulanda.Client"
$eulanda.Connect("...")
$salesOrderId = Import-SalesOrder -XmlFile "auftrag.xml" -Conn $eulanda -CreateAddress -CreateArticle
Write-Host "Angelegter Auftrag mit ID: $salesOrderId"

HINWEISE

• Die Funktion prüft intern auf Mussfelder und eindeutige Zuordnungen.
• Fehler führen zu einem sofortigen Abbruch.
• Die Verarbeitung ist vollständig transaktionslos - Commit-Logik muss ggf. extern erfolgen.