Software Dokumentation
MarkUp Kalkulation in Prozent






Auftraggeber: Railtour Suisse sa







Verfasser: Kerstin Freiß

Disclaimers
The information contained in this document is the proprietary and exclusive property of Bewotec GmbH except as otherwise indicated. No part of this document, in whole or in part, may be reproduced, stored, transmitted, or used for design purposes without the prior written permission of Bewotec GmbH.
The information contained in this document is subject to change without notice.
The information in this document is provided for informational purposes only. Bewotec specifically disclaims all warranties, express or limited, including, but not limited, to the implied warranties of merchantability and fitness for a particular purpose, except as provided for in a separate software license agreement.


Privacy Information
This document may contain information of a sensitive nature. This information should not be given to persons other than those who are involved in the "DaVinci" project or who will become involved during the lifecycle of this project.


General remark
The final dialog design/layout of the screens may vary, but the described functionality shall be integrated.




















Versionen

Inhaltsverzeichnis
1. Anforderung
2. Funktionsweise
2.1 MarkUp Filter
2.2 Übersteuerung Steuerschlüssel
2.3 Archiv
3. Beispiele
3.1 Produkt MarkUp per Reisedatum
3.2 Hotel MarkUp per Zielgebiet
3.3 Übersteuerung Steuerschlüssel

Anforderung

Im Rahmen der neuen „dynamischen Geschäftsmodelle" wird es immer mehr erforderlich die aktuelle Preisstruktur weg von fest vor-kalkulierten hin zu dynamisch kalkulierten Verkaufspreisen zu ändern.
Die aktuelle Entwicklungsphase fokussiert sich dabei auf

• Eigen-Content (Stammdaten in DaVinci),
• GTA-Fremd-Content und
• HH-Flüge.

Bahnleistungen sind nicht relevant.
Fremd-Content, z.B. über den/die Player eingebuchte Leistungen, wird separat behandelt.
Die VK-Berechnung aufgrund der statisch in DaVinci hinterlegten VK-Preistabellen ist weiterhin möglich.
Im Rahmen des aktuellen Entwicklungsprojektes wurde eine MarkUp Kalkulation implementiert, die es erlaubt, den Verkaufspreis zum Zeitpunkt der Buchung dynamisch auf Basis des EKs und eines prozentualen MarkUps zu kalkulieren.
Darüber hinaus wurde die Möglichkeit der Kalkulation mit Hilfe eines fixen MarkUps implementiert, die zusätzlich, auch auf derselben Leistung, genutzt werden kann. Diese ist separat dokumentiert.
In diesem Dokument wird die Funktionsweise der prozentualen MarkUp Kalkulation beschrieben.

Funktionsweise

Ist die MarkUp Kalkulation auf der Ebene Buchungscode für ein bestimmtes Produkt aktiviert, so wird der der Verkaufspreis der Leistung zum Zeitpunkt der Buchung nicht gemäß der innerhalb von Davinci definierten statischen Verkaufspreistabelle bestimmt, sondern auf Basis des bestehenden EK-Preises der Leistung plus des gültigen MarkUps.
Ist die MarkUp-Kalkulation deaktiviert, so werden weiterhin die klassischen VK-Preistabellen genutzt.
Die MarkUp Kalkulation lässt sich auf Produktebene im Tab „Buchungscode" über das Kennzeichen „Benutze MarkUp" aktivieren:

Während des Buchungsprozesses übernimmt die Kalkulation sämtliche EK-Preiszeilen der Leistung in den Verkauf, inklusive aller Einträge wie z.B. Produktart und Steuer, und erhöht den Betrag um den definierten MarkUp (siehe auch „MarkUp Filter").
Dabei wird ein MarkUp immer auf alle Einkaufspreiszeilen einer Leistung angewendet. Es ist nicht möglich diese separat zu kalkulieren.
Die dynamische EK-VK-Währungsumrechnung sowie das Handling benutzerdefinierter Preise erfolgen gemäß der generellen DaVinci Logik.

MarkUp Filter

Die aktuell implementierten Filterkriterien zur Definition eines prozentualen MarkUps sind:

• Buchungscode
• Schnittstelle / Eigen-Content
• Katalog
• Destination (Statistikkennzeichen)
• Produkttyp (Statistikkennzeichen)
• Anforderung (H, F, …)
• Agentur
• Buchungsdatum (Von-Bis)
• Abreisedatum (Von-Bis)

Die Kriterien sind in der vorgeschlagenen Priorität aufgelistet.
Bezogen auf eine Leistung trifft immer genau eine MarkUp-Definition.
Diese wird laut Prioritätenauswertung bestimmt und auf die gesamte Leistung (sämtliche EK-Preiszeilen) angewendet.
Zur Definition des neuen MarkUp-Regelwerkes wurde eine neue UI zur zentralen Verwaltung implementiert.
Diese kann unter Leistungen -> Markups -> Markups prozentual geöffnet werden.


Bevor die Kalkulationseinträge angelegt oder überarbeitet werden können, muss der Benutzter
diese über das folgende Icon "auschecken":



Ein prozentualer dynamischer MarkUp kann generell auf 7 stammdaten- bzw. produktbezogenen Ebenen definiert werden.

Die erste Ebene (Basis) ist der Standard-Wert und dient als systemweiter FallBack, falls dieser von keiner weiteren Definition übersteuert wird.
Die Ebene ist üblicher Weise ausgeblendet und lässt sich über die Lasche am linken Rand einblenden.


Neben dem Basis MarkUp Ebene 1 stehen die folgenden sechs Ebenen zur Verfügung:

• Buchungscode
• Schnittstelle / Eigen-Content
• Katalog
• Destination (Statistikkennzeichen)
• Produkttyp (Statistikkennzeichen)
• Anforderung (H, F, …)

Die sieben Ebenen werden zum Buchungszeitpunkt in der Hierarchie ausgewertet, in der sie auf der UI aufgelistet sind und verwaltet werden können.
Mit Hilfe eines Clicks auf

• entweder einen MarkUp-Eintrag
• oder „Alle/alle anderen"

gelangt der Benutzer jeweils von links nach rechts durch die Definitionshierarchie.

Hierbei bilden die Basisebene 1 und die Buchungscodeebene 2 eine Ausnahme, da die Basiseben der absolute Fallback ist und durch die Produktauswahl die Ebenen 3-6 bereits vorgegeben sind (hier lässt das System lediglich die Navigation über „Alle/alle anderen" zu).
ACHTUNG:
Die MarkUp Definitionen werden erst über das <Speichern> Icon am oberen linken Rand der Lasche gespeichert. Beim Schließen der Lasche fragt DaVinci automatisch nach.
Nach MarkUp Änderung ist ein GenVas Cache Update notwendig bevor die Änderungen wirksam werden.

Bezogen auf jeden produktbezogenen Eintrag können im unteren Bereich leistungs- bzw. vorgangsbezogenen MarkUps differenziert werden.

Hier können MarkUps bezogen auf

• die Agentur
• das Buchungsdatum (Von-Bis) und
• das Abreisedatum (Von-Bis)

angegeben werden.
Die sieben Ebenen werden zum Buchungszeitpunkt laut vorgegebener Priorität (Spalte 1) ausgewertet.

Übersteuerung Steuerschlüssel

Generell übernimmt das System während der MarkUp Kalkulation alle Einträge aus jeder Einkaufspreiszeile in die entsprechende Verkaufspreiszeile.
Somit auch z.B. die Produktart und den Steuerschlüssel des Preisbestandteils.
Ist es nun gewünscht, dass im Falle eines Steuerschlüssels mit 0% immer der Steuerschlüssel aus der ersten Einkaufspreiszeile übernommen wird, so kann dies über ein Anwendungsgrundlagensetting aktiviert werden.
Anwendungsgrundlagen -> DaVinci -> Sonstiges -> Steuer

Archiv

Das System historisiert alle Markup Einträge nachdem diese ausgecheckt, erfasst/modifiziert und anschließend gespeichert wurden unter einer eindeutigen fortlaufenden Versionsnummer (1, 2, 3, …). Die aktuelle Version ist unter der Version 0 abgelegt.
Zusätzlich werden der DaVinci-Benutzer plus der Zeitpunkt der Änderung gespeichert.
Zur technischen Analyse kann der Benutzer die entstandenen Versionen

1. entweder direkt über die Datenbanktabellen auswerten oder
2. mit Hilfe der Datenbankprozedur „COMPARE_MARKUP_PERCENT_VERSIONS" vergleichen.

Die betroffenen Datenbanktabellen lauten:

Die Prozedur vergleicht die Änderungen der beiden per Parameter übergebenen Versionen auf Basis von XML. Für den Fall, dass lediglich eine Version übergeben wird, wird die angegebene Version mit der aktuellen Version 0 verglichen.
Beispiele für den Prozeduraufruf:
COMPARE_MARKUP_PERCENT_VERSIONS 2 0
Vergleicht die Versionen 2 mit der aktuellen Version 0.
COMPARE_MARKUP_PERCENT_VERSIONS 2
Vergleicht ebenfalls die Versionen 2 mit der aktuellen Version 0.
COMPARE_MARKUP_PERCENT_VERSIONS 2 3
Vergleicht die Versionen 2 mit der Version 3.

Die Ergebnisliste der Prozedur ist eine technische Sicht auf den in der Prozedur ausgeführten XML-Vergleich.
Die Ansicht beinhaltet die modifizierten Ebenen (korrespondieren mit den DB-Tabellen) und Einträge ausgehend von den betroffenen XML-Knoten.
Beispiel
Der Benutzer erhöht den Markup für Buchungscode AYDELPAL_01 von 10% auf 11% und darüber hinaus den Markup für den Buchungszeitraum 01.10.2015-31.12.2015 von 8% auf 9%:

Ergebnis der Prozedur

Zeile 1
Sagt aus, dass im 2. XML-Knoten MARKUP_PERCENT_BASE (entspricht der gleichnamigen DB-Tabelle) eine Änderung stattgefunden hat. Die entsprechenden XMLs der Versionen werden in OldValue und NewValue ausgegeben.
Zeile 2
Sagt aus, dass im2. XML-Knoten MARKUP_PERCENT_BASE (entspricht der gleichnamigen DB-Tabelle) der Eintrag RATE von 0,1 (10%) auf 0,11 (11%) geändert wurde.
Zeile 3
Sagt aus, dass im 1. XML-Unterknoten MARKUP_PERCENT_BASE (entspricht der gleichnamigen DB-Tabelle) eine Änderung stattgefunden hat. Die entsprechenden XMLs der Versionen werden in OldValue und NewValue ausgegeben.
Zeile 4
Sagt aus, dass im 1. XML-Unterknoten MARKUP_PERCENT_BASE (entspricht der gleichnamigen DB-Tabelle) der Eintrag RATE von 0,08 (8%) auf 0,09 (9%) geändert wurde.

Beispiele

Produkt MarkUp per Reisedatum

Definition eines generellen MarkUps von 5% für das Hotel LISHSANA_01.
Bei Abreise 01.01.2020-20.01.2020 allerdings sollen für Agentur 1 7 % MarkUp und alle weiteren Agenturen 8% berechnet werden.



Es werden 7% MarkUp auf sämtliche EK-Preiszeilen (Zimmerpreis + Verpflegung) berechet.

Hotel MarkUp per Zielgebiet

Definition eines generellen MarkUps von 3% für die Destination LIS
Für alle Hotels, Anforderung H, der Destination LIS sollen 3,5% berechnet werden.



Es werden 3,5% MarkUp auf sämtliche EK-Preiszeilen (Zimmerpreis + Verpflegung) berechet.

Übersteuerung Steuerschlüssel

Es wurde der Steuerschlüssel aus dem Zimmerpreis (1. EK Preiszeile) in beide Verkaufspreiszeilen übernommen, da der hinterlegte Steuerschlüssel der Verpflegung 0% ist.