New-SalesOrder #

ÜBERSICHT #

Erstellt einen neuen Auftragskopf (AUFTRAG) in EULANDA über die interne API ‘cn_CreAf’.

SYNTAX #

New-SalesOrder [-InvoiceAddressId] <int> [[-BuyerOrderNo] <string>] [-IvaIncluded] [[-Fields]
    <hashtable>] [[-Conn] <__ComObject>] [<CommonParameters>]

BESCHREIBUNG #

Diese Funktion legt einen neuen Verkaufsauftrag in der Tabelle ‘AUFTRAG’ an. Voraussetzung ist eine gültige Rechnungsadresse (’$InvoiceAddressId’). Optional kann eine Käufer-Bestellnummer (’$BuyerOrderNo’) übergeben werden, die dann auf Eindeutigkeit geprüft wird.

Die Funktion verwendet Transaktionen, SNAPSHOT-Isolation, stellt sicher, dass ein Zahlungsziel gesetzt ist und ruft anschließend ‘cn_CreAf’ zur Neuanlage auf. Wenn das Flag ‘-IvaIncluded’ gesetzt ist, wird der Auftrag als Bruttopreisauftrag angelegt.

Mit dem Parameter ‘-Fields’ kann eine Hashtable mit zusätzlichen Kopf-Feldern übergeben werden, die im Anschluss an die Anlage per ‘UPDATE’ gesetzt werden.

PARAMETER #

-InvoiceAddressId #

Type: int

Die ID der Rechnungsadresse (Pflichtfeld). Muss auf einen existierenden ID einer Adresse zeigen.

-ConsigneeAddressId #

Die ID der Lieferadresse (Kannfeld). Muss auf eine existierende ID einer Adresse zeigen

-BuyerOrderNo #

Type: string
Default: $null

Optionale Bestellnummer des Käufers. Wenn vorhanden, wird die Eindeutigkeit geprüft. Bei Dubletten wird der Auftrag nicht neu angelegt und ‘$null’ zurückgegeben.

-IvaIncluded #

Type: switch

Schalter zur Kennzeichnung eines Brutto-Auftrags (B2C). Setzt das interne Flag ‘BruttoFlg’ in der EULANDA-Auftragslogik.

-Fields #

Type: hashtable
Default: $null

Hashtable mit optionalen Feldern (z.B.. ‘Bestelldatum’, ‘Lieferdatum’, ‘Vortext’), die per ‘UPDATE’ im Anschluss gesetzt werden.

-Conn #

Type: __ComObject

Ein ADO COM-Objekt mit aktiver Verbindung zur EULANDA-Datenbank.

AUSGABEN #

nullable[int]

Die ID des neu angelegten Auftrags. Gibt ‘$null’ zurück, wenn keine Anlage erfolgt, z.B. bei einer Dublette.

BEISPIELE #

$Fields = @{
  Bestelldatum = "2024-05-15 10:00:00"
  Lieferdatum  = "2024-05-18"
  Vortext      = "Online-Bestellung"
}
$id = New-SalesOrder -InvoiceAddressId 123 -BuyerOrderNo "4711-2024" -Fields $Fields -Conn $Conn

HINWEISE #

• Nutzt Transaktionen mit SNAPSHOT-Isolation.
• Führt Rollback bei Fehlern automatisch durch.
• Bei fehlendem Zahlungsziel wird ‘.MUSTER’ oder ein beliebiger Eintrag aus ‘KonZiel’ verwendet.