Allgemeines

Grundsätzliche Informationen zur Verwendung von Systemparametern finden Sie im Kapitel Systemparameter im Handbuch zum Modul "Portal & Organisation".

Referenz der relevanten Systemparameter für das Dienstreise-Modul

Mit den Systemparametern für das Dienstreise-Modul können z.B. Abrechnungsmethoden  und ihr Verhalten verfeinert werden.

Modul

Bean

Eigenschaft

Erklärung

Mögl. Werte

tm

TmAllowanceCalc24HourImpl 

truncateTaxFreeIfBiggerThanAmount

Ist der steuerfreie Taggeld-Anteil größer als der auszubezahlende Betrag, so wird er auf den auszubezahlenden Betrag gekürzt

true/false

tm

TmAllowanceCalc24HourImpl 

useForeignStages 

Sollen Auslandsetappen verwendet werden?

true/false

tm

TmAllowanceCalcCalDayImpl 

truncateTaxFreeIfBiggerThanAmount 

Ist der steuerfreie Taggeld-Anteil größer als der auszubezahlende Betrag, so wird er auf den auszubezahlenden Betrag gekürzt

true/false

tm

TmAllowanceCalcCalDayImpl 

use24HourImplForForeignStages 

Soll bei der Kalendertagsmethode die Berechnung der Auslandetappen nach der 24 Stunden Methode erfolgen?

true/false (Default: false)

tm

TmAllowanceCalcCalDayImpl 

use24HourImplForInlandIfStagesExist 

Soll bei der Kalendertagsmethode auch für das Inland die 24 Stunden Methode verwendet werden (wenn Auslandsetappen existieren)?

true/false (Default: true)

tm

TmAllowanceCalcCalDayImpl 

useForeignStages 

Sollen Auslandsetappen verwendet werden?

true/false

tm

TmCalculatorDefaults 

roundingPrecision

Rundungspräzision, z.B. 100 = Rundung auf 2 Dezimalstellen, 1000 = Rundung auf 3 Dezimalstellen; wird bei der Rundung von Taggeldbeträgen verwendet

10, 100, 1000 (Default: 100)

tm

TmCurrencyServiceTarget 

leadCurrencyIsoCode 

Iso Code der Standardwährung

EUR

tm

TmCurrencyServiceTarget 

leadCurrencyName

Name der Standardwährung

Euro

tm

TmOptions

adminRoleDelete 

Webdesk Rolle mit welcher Reisen gelöscht werden können

Webdesk Administrator

tm

TmOptions

adminRoleUpdate 

Webdesk Rolle mit welcher alle Reisen geändert werden können

Webdesk Administrator

tm

TMOptions

routePlanningURLPattern

tm

TmOptions

showColumnAmountTaxable 

Steuerbare Kosten in Reiseübersicht anzeigen

true/false

tm

TmOptions

showColumnAmountTaxFree

steuerfreie Kosten in Reiseübersicht anzeigen

true/false

tm

TmPercentageStrategy

generateCommentForTaxFreeCalc 

Berechnungsformel für steuerfreien Anteil anzeigen

true/false

tm

TmRecordCalcAddFieldReductionImpl 

additionalFieldName 

Belegabrechnungsethode "Reduktion um Produkt aus Fixwert und Zusatzfeldwert ": Name des Zusatzfeldes, welches verwendet wird

z.B. inkludierte Frühstücke, Mittagessen etc.

tm

TmRecordCalcAddFieldReductionImpl 

multiplier

Belegabrechnungsethode "Reduktion um Produkt aus Fixwert und Zusatzfeldwert ": Multiplikator mit welchem Zusatzfeldwert multipliziert wird, das Ergebnis wird  vom Belegwert abgezogen.

0,1

tm

TmRecordCalcMultiplyWithFactorImpl 

factor

Belegabrechnungsmethode "Multiplikation  mit fixem Faktor": Faktor, mit dem multipliziert wird

15.0

tm

TmRecordCalcMultiplyWithFactorImpl 

multiplyFactorWithMaxDailyValueInland 

Multiplikation des Faktors mit max. Inlands-Taggeld

true/false (Default: false)

tm

TmRecordCalcMultiplyWithFactorImpl 

roundingPrecision 

Rundungspräzision, z.B. 100 = Rundung auf 2 Dezimalstellen, 1000 = Rundung auf 3 Dezimalstellen; nur aktiv, wenn die kaufmännische Rundung auf true gesetzt ist; bei Rundung auf nächste ganze Zahl wird Rundung nicht berücksichtigt.

10 (Default: 100)

tm

TmRecordCalcMultiplyWithFactorImpl 

roundOriginalValueToNextIntValue

Ist der Parameter auf true gesetzte, wird der originale Belegwert auf die  nächste ganze Zahl gerundet, bei false wird kaufmännisch gerundet. Verwendung z.B. bei Verrechnung passiver Reisezeit (im Zusammenhang mit Faktor)

true/false

tm

TmRecordCalcMultiplyWithFactorImpl 

taxfree 

Ist der Parameter gesetzt, sind mit dieser Methode abgerechnete Belege immer steuerfrei.

true/false (Default: false)

tm

TmRecordCalcZeroTaxFreeConditionalImpl 

additionalFieldName

Belegabrechnungsmethode "steuerbar bei aktiviertem Zusatzfeld": Name des Zusatzfeldes

steuerbar

tm

TmTravelIdGeneratorFormattedDateNumber 

decimalFormatPattern 

Reisenummerngenerierung aufgrund des Datums: Dezimalteil (Formatvorlage für fortlaufende Nummerierung innerhalb des selben Tages)

00

tm

TmTravelIdGeneratorFormattedDateNumber 

simpleDateFormatPattern 

Reisenummerngenerierung aufgrund des Datums: Datumsteil (Formatvorlage für Datumsteil z.B. JahrMonatTag=yyyyMMdd

yyDDD

tm

TmTravelIdGeneratorFormattedDateNumber 

travelIdTemplate 

Zusammensetzung von Datum und fortlaufender Nummerierung zur Reisenummer ({0} = datumsteil, {1} = Nummernteil)

{0}{1}

tm

TmTravelServiceTarget 

costCenterOrgHierarchy 

Name der Organisationsstruktur, welche die Kostenstellen beschreibt (bleibt das feld leer > Kostenstellenstruktur vom Reisenden 

(tm)

TmTravelServiceTarget 

travelIdGeneratorImpl 

Reisenummerngenerierungsmethode; derzeit TmTravelIdGeneratorDefaultImpl oder

TmTravelIdGeneratorFormattedDateNumber 

TmTravelIdGeneratorDefault

tm

TmTwelfthsStrategy 

generateCommentForTaxFreeCalc 

Betrifft Zwölftelabrechnungsmethode: soll auch die Berechnung des steuerfreien Anteils von Taggeldern im Kommentar ausgewiesen werden

true/false

Systemparameter Dienstreise

Systemparameter Dienstreise

Systemparameter gelten übergreifend für das Travel-Modul. Sie sind nur zu ändern, wenn die fachliche Regel nicht durch eine historisierte Konfiguration oder einen Reisetyp abgebildet werden kann. Die verfügbare Parameterliste hängt von der installierten Variante und den aktivierten Modulen ab.

Währung und Reise-ID

• TmCurrencyServiceTarget.leadCurrencyIsoCode und leadCurrencyName legen die Leitwährung fest.
• TmTravelServiceTarget.travelIdGeneratorImpl wählt den Generator für Reise-IDs.
• Bei TmTravelIdGeneratorFormattedDateNumber steuern Formatparameter wie travelIdTemplate, Datumsformat und Nummernformat den Aufbau der Reise-ID.

Travel-Optionen

• TmOptions.adminRoleDelete und adminRoleUpdate bestimmen Administrationsrechte.
• TmOptions.showColumnAmountTaxFree und showColumnAmountTaxable steuern steuerfreie beziehungsweise steuerpflichtige Spalten.
• TmOptions.routePlanningURLPattern definiert die URL-Vorlage für die Routenplanung.
• TmTravelServiceTarget.costCenterOrgHierarchy legt fest, aus welcher Organisationshierarchie Kostenstellen ermittelt werden.

Berechnung und Rundung

• TmCalculatorDefaults.roundingPrecision definiert die Standardpräzision für Rundungen.
• Die Parameter von TmAllowanceCalc24HourImpl und TmAllowanceCalcCalDayImpl steuern unter anderem steuerfreie Kürzungen und die Behandlung ausländischer Etappen.
• Weitere Calculator-Parameter können Faktoren, Rundung, steuerfreie Anteile oder Zusatzfelder betreffen. Sie dürfen nur zusammen mit der jeweiligen Abrechnungsdefinition geändert werden.

Vorgehen und Prüfung

1. Vorherige Werte dokumentieren und die betroffenen Reisetypen beziehungsweise Abrechnungsdefinitionen identifizieren.
2. Parameter ändern und Cache-/Cluster-Aktualisierung abwarten.
3. Eine Inlands- und eine Auslandsreise sowie, falls betroffen, Beleg, Kilometergeld, Zeitkorrektur und Export prüfen.

Fachliche Berechnungsregeln gehören bevorzugt in Abrechnungsdefinitionen, nicht in unkommentierte globale Parameter.