Import-SalesOrderSimulation

ÜBERSICHT

Simuliert den Import eines EULANDA-META-XML Auftrags und ergänzt die XML um Adressdaten, Artikeldaten, Preise, Summen und Metadaten. Es werden keine Datenbankänderungen durchgeführt, jedoch eine Connection zur Datenbank.

SYNTAX

Import-SalesOrderSimulation [-XmlFile] <string> [-Conn] <__ComObject> [[-OutputXmlFile] <string>]
    [[-SpecialSearch] <int>] [-Force] [<CommonParameters>]

BESCHREIBUNG

Die Funktion liest eine Auftrags XML im EULANDA META Format ein und qualifiziert Liefer und Rechnungsadresse anhand eindeutiger Felder. Fehlende Felder werden aus dem Stamm übernommen. Positionen werden über ARTNUMMER, ARTMATCH oder GTIN aufgelöst, Preise über Get SalesPrice ermittelt und als VKVRAB, VKRAB, VKGES geschrieben. Die Summe aller VKGES wird als VKBASIS und VKNETTO in den AUFTRAG Knoten geschrieben. METADATA und VERKAEUFER werden ergänzt, die Währung wird auf EUR gesetzt, falls nicht vorhanden. Die Ausgabe ist eine sortierte und angereicherte XML Datei. Dieses ist dann konform zur XSD-Datei.

Die Adressauflösung setzt auf eindeutige Treffer. Es gilt eine feste Priorität der Suchfelder, typischerweise MATCH vor GLN vor USTID vor EMAIL vor FIBUKONTO vor FREMDREFNR. Werden keine eindeutigen Treffer gefunden, fühern mehrdeutige Treffer zu einem Fehler. SpecialSearch 1 berücksichtigt GLN und MATCH Paare mit LIEFERUNG LIEFER LIEF am Ende des Feldes MATCH und leitet daraus die Rechnungsvariante mit RECHNUNG oder RECH ab.

PARAMETER

-XmlFile

Type: string

Pfad zu einer EULANDA META XML Datei mit einem AUFTRAG Dokument. Die Datei sollte mindestens Käufer und Positionen mit Schlüsseln enthalten.

-Conn

Type: __ComObject

Aktive ADO Verbindung auf die EULANDA Datenbank. Wird zum Lesen der Adress- und Artikeldaten sowie Preise verwendet.

-OutputXmlFile

Type: string

Optionaler Ausgabepfad. Wenn nicht gesetzt, wird neben der Eingabedatei eine Datei mit der Extension .qualified.xml geschrieben.

-SpecialSearch

Type: int

Steuert die GLN basierte MATCH Logik. Wert 1 aktiviert die Suche Lieferadresse per GLN und MATCH Endung LIEFERUNG LIEFER LIEF. Der Präfix vor der Endung wird für die Rechnungsadresse mit RECHNUNG oder RECH kombiniert. Standard 1.

-Force

Type: switch

Überschreibt vorhandene Inhalte in der XML. Ohne Force werden nur leere oder 0 Werte ersetzt.

AUSGABEN

nullable[int]

Rückgabewert ist null. Die qualifizierte XML wird als Datei ausgegeben.

BEISPIELE

# Liest eine rohe Orders XML, qualifiziert Adressen und Positionen und schreibt die Ausgabe
Import-SalesOrderSimulation -XmlFile 'C:\Temp\orders.xml' -Conn $Conn

# Wie oben, aber mit explizitem Ausgabepfad und aktivierter SpecialSearch Logik
Import-SalesOrderSimulation -XmlFile 'C:\Temp\orders.xml' -OutputXmlFile 'C:\Temp\orders.qualified.xml' -Conn $Conn -SpecialSearch 1

# Überschreibt vorhandene Felder in der Eingabe XML, etwa wenn Stammdaten Vorrang haben sollen
Import-SalesOrderSimulation -XmlFile 'C:\Temp\orders.xml' -Conn $Conn -Force

HINWEISE

Voraussetzungen

1. Valide EULANDA META Auftrags XML.

2. Gültige ADO Verbindung.

3. Hilfsfunktionen wie Get AddressId, Get CompanyMasterData, Get SalesPrice, Get SortedXmlString sind verfügbar.