Programmlogik

Aus Mauve System3 Handbuch
Zur Navigation springen Zur Suche springen

Einleitung

Programmlogik.png

Mittels des Reiters Programmlogik im Dialog Portoberechnung kann mit Hilfe der VersandkostenDSL ( Domain Specific Language ) jede Art von Versandkostenstruktur abgebildet werden.

  • Syntax prüfen Nach Klick auf diesen Button wird der in den Editor eingegebene Text einer Syntaxprüfung unterzogen. Das Ergebnis wird in dem Textfeld unterhalb des Programmeditors angezeigt.
  • Programmlogik
    • Das obere Textfeld in diesem Bereich ist der Programmeditor. In diesen geben Sie den Programmcode für die Portologik ein. Welche Optionen dafür zur Verfügung stehen finden Sie unter Sprachbeschreibung
    • Im den unteren Textfeld wird das Ergebnis der Syntax-Prüfung angezeigt.
  • Optionen
    • Portoartikel festlegen Hier bestimmen Sie mit Hilfe der Jokersuche den Portoartikel für die Programmlogik.
    • Erlöskonten für Portoartikel festlegen Legen Sie hier für jeden definierten Mehrwertsteuersatz für jedes freigeschaltete Land die Erlöskontengruppe.



Sprachbeschreibung

Allgemein

  • Eigene Variablen müssen immer erst mit "let" dekaliert werden
  • Anweisungen sind immer mit " ; " (Semikolon) zu beenden
  • Dezimal-Zahlen sind immer mit . (Punkt), nicht mit , (Komma) zu trennen
  • Anweisungen innerhalb einer Abfrage müssen immer innerhalb der Klammern { } stehen
  • Strings wie "Amazon" bei einer Abfrage if (VerkaufskanalName == "Amazon") sind immer in doppelte Anführungsstriche zu schreiben
  • Errechnete Portokosten müssen immer in den Beleg zurückgeschrieben werden
  • Liefer-Variablen enthalten immer die Lieferadresse, wenn diese leer ist, automatisch die Rechungsadresse
  • Um die berechneten Versandkosten in den Beleg zurückzuschreiben verwenden Sie die Anweisung Versandkosten = <Ergebnis der Berechnung>

siehe Code-Beispiele


Farben

Farbe Bedeutung Beispiel
rot Text / String "DE" , "AT" , "Amazon"
orange lesbare Variable BruttoGesamt, LieferlandIsoAlpha
blau Funktion let, if, else
grün Definition einer Variable Kommentar und beschreibbare Variable bspw. VersandArtid
schwarz Definition einer Variable Text in Kommentaren und eigene Variablen

Befehle

Befehl Bemerkung Beispiel
let Definition und Initialisierung einer Variablen let AnzahlArtikel = 0;
if (<Bedingung>){<Anweisungen>} Auswertung einer Bedingung. Die <Bedingung> muss wahr oder falsch als Ergebnis liefern.
Ist das Ergebnis wahr, werden die <Anweisungen> in den geschweiften Klammern ausgeführt.		 if (LieferlandIsoAlpha = "DE") {Anweisung};
else{<Anweisungen>} Ist nur mit einem vorangehenden if erlaubt, die in den geschweiften Klammern enthaltenen <Anweisungen> werden nur ausgeführt, wenn die <Bedingung> falsch ist. else {Anweisung};
else if (<Bedingung2>){<Anweisungen>} So wie else, nur das zusätzlich noch die <Bedingung2> hinter dem else if geprüft wird.
Die <Anweisungen> in den geschweiften Klammern werden nur ausgeführt, wenn <Bedingung> falsch und <Bedingung2> wahr ist.		 else if (LieferlandIsoAlpha = "AT") {Anweisung};
loop posten{<Anweisungen>} Geht die Posten eines Belegs in einer Schleife durch. Die <Anweisungen> in den geschweriften Klammern werden für jeden Posten des Belegs durchgeführt.
Variablen mit der Sichtbarkeit Postenschleife sind nur innerhalb der geschweiften Klammern gültig.		 loop posten {Anweisung};

Operatoren

Operator Bemerkung Beispiel
= Zuweisung eines Wertes porto = 3.99;
* Multiplikation porto = 0.49 * Stueck;
/ Division if (KundenKategorieId == 2) {porto = porto / 2;}
// Division mit Aufrundung des Ergebnisses if (KundenKategorieId == 2) {porto = porto // 2;}
% Modulo AnzahlPakete = AnzahlArtikel % 5.3;
+ Plus if (KundenKategorieName == "VIP") {porto = porto - 2;}
- Minus if (KundenKategorieName == "Ausland") {porto = porto + 2;}
<= Kleiner gleich Vergleich if (BruttoGesamt <= 100) {porto = 10;}
>= Größer gleich Vergleich if (BruttoGesamt >= 100) {porto = 0;}
< Kleiner Vergleich if (BruttoGesamt < 100) {porto = 10;}
> Größer Vergleich if (BruttoGesamt > 100) {porto = 0;}
== Gleich-Vergleich von Strings if (VerkaufskanalName == "Amazon")
!= Ungleich-Vergleich von Strings if (VerkaufskanalName != "Amazon")
&& UND-Verknüpfung von Abfragen if (VersandArtId == 2 && ZahlungsweiseId == 2)
|| Oder-Verknüpfung von Abfragen if (LieferlandIsoAlpha == "DE" || LieferlandIsoAlpha == "AT")
IN Wert in Bereich vorhanden if (LieferlandIsoAlpha IN ("DE","AT","NL","BE"))
/* */ Kommentar /* Portobrechnung Deutschland DHL Paket national */

Variablen

Name Bemerkung Typ Sichtbarkeit Zugriff
true Wahr Bool Global Lesbar
false Falsch Bool Global Lesbar
CurrentDay Aktueller Tag (1-31) Int Global Lesbar
CurrentMonth Aktueller Monat (1-12) Int Global Lesbar
CurrentYear Aktuelles Jahr (vierstellig) Int Global Lesbar
EnthaeltVerschreibungsPflichtige nur Apotheke Bool Global Lesbar
EnthaeltKuehlPflichtige nur Apotheke Bool Global Lesbar
BruttoGesamt Summe aller Posten-Bruttobeträge, die keine Versandkosten- oder Zahlungsweiseartikel enthalten, inkl. Posten- und Belegrabatt. Rabatte werden jedoch nicht auf rezeptpflichtige Artikel angewandt. Decimal Global Lesbar
BruttoGesamtOhneRabatt Summe aller Posten-Bruttobeträge, die keine Versandkosten- oder Zahlungsweiseartikel enthalten, ohne Posten- und Belegrabatt. Decimal Global Lesbar
NettoGesamt Summe aller Posten-Netttobeträge, die keine Versandkosten- oder Zahlungsweiseartikel enthalten, inkl. Posten- und Belegrabatt. Rabatte werden jedoch nicht auf rezeptpflichtige Artikel angewandt. Decimal Global Lesbar
NettoGesamtOhneRabatt Summe aller Posten-Nettobeträge, die keine Versandkosten- oder Zahlungsweiseartikel enthalten, ohne Posten- und Belegrabatt. Decimal Global Lesbar
LieferlandIsoAlpha 2-Stelliger IsoAlphaCode String Global Lesbar
LieferPlz String Global Lesbar
LieferPlzZone Erste Stelle der Postleitzahl String Global Lesbar
LieferPlzBereich Die ersten zwei Stellen der Postleitzahl String Global Lesbar
LieferStrasse String Global Lesbar
VersandArtName String Global Les- und Schreibbar
VersandArtId Int Global Les- und Schreibbar
PortoArtikelBezeichnung String Global Les- und Schreibbar
PortoArtikelBemerkung String Global Les- und Schreibbar
GesamtGewicht In kg. Decimal Global Lesbar
GesamtVolumen In cm³. Decimal Global Lesbar
KundenKategorieName String Global Lesbar
KundenKategorieId Int Global Lesbar
ZahlungsweiseName String Global Lesbar
ZahlungsweiseId Int Global Lesbar
BelegtypName String Global Lesbar
BelegtypId Int Global Lesbar
VerkaufskanalName Amazon, Mauve Webshopsystem, Unbekannt, Email etc. String Global Lesbar
VerkaufskanalId Int Global Lesbar
BelegSprache String Global Lesbar
VersandkostenSindNetto Gibt an ob die definierten Kosten netto oder brutto sind Bool Global Les- und Schreibbar
AnzahlEinnahmeBelege String Global Lesbar
SummeZahlungen Decimal Global Lesbar
UeberwiegenderMwStSatz Der Mehrtsteuersatz, dessen Posten die höchste Netto-Gesamtsumme besitzen. Grundlage der Mehrwertsteuerzuordnung ist die in den Posten hinterlegte Mehrwertsteuer. Decimal Global Lesbar
UeberwiegenderMwStSatzAufgrundArtikel Der Mehrtsteuersatz, dessen Posten die höchste Netto-Gesamtsumme besitzen. Grundlage der Mehrwertsteuerzuordnung ist die in der Artikelverwaltung hinterlegte Mehrwertsteuer. Decimal Global Lesbar
Stueck Int Postenschleife Lesbar
PostenNr String Postenschleife Lesbar
ArtikelNr String Postenschleife Lesbar
ArtikelGewicht Decimal Postenschleife Lesbar
VerschreibungsPflichtig nur Apotheke Bool Postenschleife Lesbar
ApothekenPflichtig nur Apotheke Bool Postenschleife Lesbar
KuehlPflichtig nur Apotheke Bool Postenschleife Lesbar
IsCustomKuehlPflichtig nur Apotheke Bool Postenschleife Lesbar
CustomKuehlPflichtigThreshold nur Apotheke Bool Postenschleife Lesbar
RezeptArt nur Apotheke (Kein, Kassenrezept, Privat, Kassenrezept(befreit), Sprechstundenbedarf, Praxisbedarf String Postenschleife Lesbar
ArtikelHoehe Decimal Postenschleife Lesbar
ArtikelBreite Decimal Postenschleife Lesbar
ArtikelLaenge Decimal Postenschleife Lesbar
ArtikelVolumen Decimal Postenschleife Lesbar
ArtikelWarengruppeID Hauptwarengruppe des Artikels Decimal Postenschleife Lesbar
IstAbdaArtikel nur Apotheke Bool Postenschleife Lesbar
Versandkosten Schreiben der errechneten Versandkosten in den Beleg
Versandkosten = porto;		 Decimal Global Nur Schreiben
BelegWerbeaktionId Int Global Lesbar
BelegWerbeaktionName String Global Lesbar
PostenWerbeaktionID Int Postenschleife Lesbar
PostenWerbeaktionName String Postenschleife Lesbar



Methoden

Name Bemerkung Rückgabe-Typ Parameter Beispiel
EnthaeltArtikelNr(string artikelNr) Prüft, ob der Beleg einen Posten mit der Artikel-Nr. artikelNr besitzt Bool
string artikelNr Die Artikel-Nr. des Artikels, nach dem im Beleg gesucht werden soll
if (EnthaeltArtikelNr("123456")) {<Anweisungen>}
GetPersonFreifeldText(string freifeldName) Liefert den Inhalt des Personen-Freifelds mit dem Namen freifeldName zurück String
string freifeldName Der Name des gesuchten Freifelds
let freifeld1 = GetPersonFreifeldText("Freifeld1");
GetPostenArtikelHauptwarengruppeId(int postenNr, int shopId) Ermittelt die Hauptwarengruppe des Artikels eines Postens für den angegebenen Shop Int
int postenNr Die Nummer des Postens, für den die Hauptwarengruppe ermittelt werden soll
int shopId Die Id des Shops, für den die Hauptwarengruppe ermittelt werden soll
let warengruppeId = GetPostenArtikelHauptwarengruppeId(1, 1);
IsPostenArtikelInWarengruppe(int postenNr, int warengruppeId) Prüft, ob ein Postenartikel zu einer bestimmten Warengruppe gehört Bool
int postenNr Die Nummer des Postens, für den die Warengruppenzugehörigkeit ermittelt werden soll
int warengruppeId Die Id der Warengruppe, auf dessen Zugehörigkeit der Posten geprüft werden soll
let inWarengruppe = IsPostenArtikelInWarengruppe(1, 1);
GetCurrentShippingCosts() Gibt die aktuell verbuchten Portokosten zurück Decimal
keine 
let porto = 0;
/*Verkaufskanal Amazon Marketplace*/
if (VerkaufskanalId == 4) 
{
	/*Portokosten aus Beleg wieder zurückgeben*/
	porto = GetCurrentShippingCosts(); 
}
else /*Mauve ApoShop etc.*/
{
	porto = 3.9;
	if (BruttoGesamt >= 100)
		{
		porto = 0;
		VersandartId = 1;
		}
}
Versandkosten = porto;
GetArtikelFreifeldText(int postenNr, string freifeldName) Liefert den Inhalt des Artikel-Freifelds für den Artikel des Postens mit der PostenNr postenNr und dem Namen freifeldName zurück String
int postenNr Die Nummer des Postens, für den das Freifeld ermittelt werden soll
string freifeldName Der Name des gesuchten Freifelds
let freifeld1 = GetArtikelFreifeldText(1, "Freifeld1");
StartsWithString(string WerbeaktionName, string x) Prüft ob der Name einer Werbeaktion mit einer bestimmten Zeichenfolge beginnt Bool
string WerbeaktionName Der Name der Werbeaktion
string x Die zu prüfende Zeichenkette
let beginntMitABC = StartsWithString(BelegWerbeaktionName, "ABC");


Code-Beispiel

Allgemeiner Code-Aufbau

/*Variablendeklaration*/
let porto = 0;

/*Abfragen / Anweisungen*/
if (LieferlandIsoAlpha == "DE")
{
	if (BruttoGesamt >= 100) /*Portofreigrenze von 100€*/
	{
		porto = 0;
	}
	else
	{
		porto = 3.95;
	}
}
	
/*Versandkosten zuweisen*/
Versandkosten = porto;

Beispiel-Logik 1

/*Portologik für Shop-Bestellungen*/
if (LieferlandIsoAlpha == "DE") /*Deutschland*/
{
	if (ZahlungsweiseId == 4 || VersandArtId == 5) /*Nachnahme*/
	{
		VersandArtId = 5; /*Automatisches Setzen der Versandart Nachnahme wenn ZW = Nachnahme*/
		PortoArtikelBezeichnung = "DHL Nachnahme";
		if (BruttoGesamt >= 100) /*Portofreigrenze*/
		{
			porto = 0;
		}
		else
		{
			porto = 4.95;
		}
	}
	else
	{
		if (VersandArtId == 6) /*Express*/
		{
			PortoArtikelBezeichnung = "UPS Express";
			porto = 9.95; 
		}
		else /*DHL Paket*/
		{
			VersandArtId = 2; /*Automatisches Setzen der Versandart DHL Paket, wenn kein Nachnahme und kein Express*/
			PortoArtikelBezeichnung = "DHL Paket";
			if (BruttoGesamt >= 100) /*Portofreigrenze*/
			{
				porto = 0;
			}
			else
			{
				porto = 4.95;
			}
		}
	}
}
else if (LieferlandIsoAlpha in ("CH")) /*Schweiz*/
{
	VersandkostenSindNetto = true;
	PortoArtikelBezeichnung = "DHL Europaket CH";
	VersandArtId = 7;
	porto = 10.85;
}
else if (LieferlandIsoAlpha in ("AT")) /*Österreich*/
{
	PortoArtikelBezeichnung = "DHL Regio AT";
	VersandArtId = 4;
	porto = 9.90;
}
else if (LieferlandIsoAlpha in ("BE","DK","FR","GB","LU","NL","HR","BG","BA"))
{
	PortoArtikelBezeichnung = "DHL Europaket";
	VersandArtId = 8;
	porto = 19.55;
}
else if (LieferlandIsoAlpha in ("US","MT","LT"))
{
	PortoArtikelBezeichnung = "DHL Premium International";
	VersandArtId = 3;
	porto = 59;
}
else if (LieferlandIsoAlpha in ("SI","NO"))
{
	PortoArtikelBezeichnung = "DHL Europaket";
	VersandArtId = 8;
	porto = 29.55;
}
else if (LieferlandIsoAlpha in ("FI","IE","GR","IT","PL","PT","SE","SK","ES","CZ","HU"))
{
	PortoArtikelBezeichnung = "DHL Europaket";
	VersandArtId = 8;
	porto = 14.90;
}
else
{
	PortoArtikelBezeichnung = "DHL Premium International";
	VersandArtId = 3;
	porto = 59.00;
}
Versandkosten = porto;



Siehe auch:
Portoberechnung Optionen
Portoberechnung
Abgerufen von „https://handbuch.mauve.de/index.php?title=Programmlogik&oldid=24276“