Zuschlags-Berechnung

Einleitung

In Salesware werden die Zuschläge (z.B. Versandkosten) in Angeboten, Bestellungen und Warenkörben automatisiert ermittelt. Es kann aber auch notwendig sein, Zuschläge aufgrund individueller Vorgaben festzulegen, anzupassen oder zu entfernen.

Mit der Zuschlags-Berechnung erhält ein externer Dienst alle aktuell ermittelten Zuschläge der Entität und kann diese durch eine eigene Berechnung ersetzen.

Wählen Sie bitte den Aktionstyp „Zuschlags-Berechnung“ aus.

Auslöser

In der Karte „Ausführung bei“ können Sie festlegen, wann die Aktion ausgelöst wird.

Wenn Sie „Ermittlung von Zuschlägen“ (TriggeredBy = „additionCalculation“) aktivieren, wird die Aktion immer ausgeführt, wenn in einem Angebot, einer Bestellung oder einem Warenkorb die Zuschläge neu ermittelt werden.

Zudem können Sie es den Benutzern ermöglichen, die Aktion selbst auszulösen, indem Sie „Manuelle Ausführung“ (TriggeredBy = „manually“) aktivieren. Dann kann der Benutzer die Aktion im Kontext- oder Dreipunktemenü der übergeordneten Entität auswählen.

Sie können auch den Auslöser „Änderung Feldinhalt“ (TriggeredBy = „fieldChange“) aktivieren. Die Aktion wird dann ausgeführt, wenn Änderungen an den in der aufgeführten Tabelle hinterlegten Feldern festgestellt werden.

Die Aktion kann in diesen Entitäten ausgelöst werden:

• Angebot (offer)
• Bestellung (order)
• Warenkorb (shoppingCart)

Eingabeparameter

Neben den allgemeinen werden zusätzlich diese Parameter übergeben. Die Kopfdaten des Belegs stehen über die BusinessRecord-Eigenschaften zur Verfügung.

Key	Datentyp	Value
DeliveryAddressName1	string	Name1 der Lieferadresse
DeliveryAddressName2	string	Name2 der Lieferadresse
DeliveryAddressAddition	string	Adresszusatz der Lieferadresse
DeliveryAddressStreetAndHouseNumber	string	Straße und Hausnummer der Lieferadresse
DeliveryAddressZipCode	string	Postleitzahl der Lieferadresse
DeliveryAddressCity	string	Stadt/Ort der Lieferadresse
DeliveryAddressCountryCode	string	Ländercode der Lieferadresse, z.B. DE
DispatchKey	string	Die Versandart
DeliveryTerms	string	Die Lieferbedingung
PaymentCondition	string	Die Zahlungskondition
Additions	Dictionary<string,object>[]	Die aktuell ermittelten Zuschläge in der Reihenfolge der Entität (Aufbau siehe unten)
Positions	Dictionary<string,object>[]	Positionen

Zuschläge (Additions)

Jeder Eintrag des Additions-Arrays hat diesen Aufbau:

Key	Datentyp	Value
Key	string	Zuschlagsart-ID aus Sage 100
Amount	decimal	Betrag des Zuschlags

Ausgabeparameter

Es werden die allgemeinen Rückmeldungen erwartet.

Key	Datentyp	Value
Additions	Dictionary<string,object>[]	Die zu übernehmenden Zuschläge (Aufbau wie bei den Eingabeparametern)

Für die Auswertung der zurückgegebenen Zuschläge gelten folgende Regeln:

• Das Additions-Array ist nicht in der Rückgabe enthalten → die von Salesware ermittelten Zuschläge bleiben unverändert erhalten.
• Das Additions-Array ist leer → alle Zuschläge werden entfernt.
• Die Zuschläge werden in der Reihenfolge des Arrays übernommen.
• Ein Eintrag ist enthalten, aber ohne gesetzten Amount → der Zuschlag wird mit dem Betrag 0 übernommen.