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.

Einige Parameter der Bean TmOptions sind nur der systemweite Standardwert: Ist in den Mandanten-Einstellungen (Reiter "Reisemanagement") ein Wert gesetzt, hat dieser Vorrang (unten vermerkt).

Währung und Reise-ID

System Parameters Travel

System parameters apply across the entire Travel module. They should be changed only if the business rule cannot be modeled by a historized configuration or a trip type. The available parameter list depends on the installed variant and the enabled modules.

Some parameters of the bean TmOptions are only the system-wide default value: if a value is set in the client settings (tab "Travel management"), it takes precedence (noted below).

Currency and trip ID

• TmOptions.leadCurrencyIsoCode and leadCurrencyName define the base currency (default: EUR / Euro). They are evaluated at startup: if the currency does not exist yet, it is created with rate 1. These parameters used to be in the bean TmCurrencyServiceTarget; the values were adopted automatically during the update.
• TmCurrencyServiceTarget.useRecordDateForLookupOfExchangeRate (default: false): if true, the exchange rate is determined as of the receipt date, if false as of the end date of the trip. Applies only if no cutoff date for the exchange rate is set in the trip type (always for mileage allowance receipts).
• TmOptions.currencyLayerApiKey is the API key for the exchange rate provider CurrencyLayer when importing exchange rates.
• TmTravelServiceImpl.travelIdGeneratorImpl selects the generator for trip IDs (default: TmTravelIdGeneratorDefault). This parameter used to be in the bean TmTravelServiceTarget.
• For TmTravelIdGeneratorFormattedDateNumber, the parameters travelIdTemplate (default: {0}{1}), simpleDateFormatPattern (Datumsformatdate format, Standarddefault: yyDDD) und and decimalFormatPattern (Nummernformatnumber format, Standarddefault: 00) den Aufbau der Reise-control the structure of the trip ID.

Travel -Optionenoptions

• TmOptions.adminRoleDelete und adminRoleUpdate bestimmen Administrationsrechte (Standard jeweils and adminRoleUpdate determine administration rights (default in each case: Webdesk Administrator).
• TmOptions.showColumnAmountTaxFree (Standarddefault: false) und and showColumnAmountTaxable (Standarddefault: true) steuern steuerfreie beziehungsweise steuerpflichtige Spalten. Die Mandanten-Einstellungen "Die steuerfreie Spalte/Zeile control tax-free and taxable columns, respectively. The client settings "Show the tax-free column/row ... anzeigen" bzw. "Die steuerbare Spalte/Zeile and "Show the taxable column/row ... anzeigen" haben Vorrangtake precedence.
• TmOptions.routePlanningURLPattern definiert die URL-Vorlage für die Routenplanung (Platzhalter z.B defines the URL template for route planning (placeholders e.g. ${sourceLocation} und and ${targetLocation}). Ist der Parameter leer (Standard), wird eine veraltete Map24-Adresse verwendet. TmTravelServiceImpl.costCenterOrgHierarchy legt fest, aus welcher Organisationshierarchie Kostenstellen ermittelt werden (Standard: leer). Früher lag dieser Parameter in der Bean If the parameter is empty (default), an outdated Map24 address is used.
• TmTravelServiceImpl.costCenterOrgHierarchy specifies from which organization hierarchy cost centers are determined (default: empty). This parameter used to be in the bean TmTravelServiceTarget.
• TmOptions.allowedAttachmentsMimeTypes: Dateitypen, die zu einer Reisekostenabrechnung hochgeladen werden dürfen (Standardfile types that may be uploaded to a travel expense report (default: jpg, jpeg, png, pdf, rtf, zip sowie as well as Word-, Excel - und and PowerPoint -Formateformats). Die Mandanten-Einstellung "Wählen Sie die Dateitypen, die zu einer Reisekostenabrechnung hochgeladen werden dürfen" hat VorrangThe client setting "Select the file types that may be uploaded to a travel expense report" takes precedence.
• TmOptions.allowedVatTaxes: auswählbare Umsatzsteuersätze in Prozent (Standardselectable VAT rates in percent (default: 7, 10, 20).
• TmOptions.useFirstTravelTypeAsDefault (Standarddefault: true): der erste verfügbare Reisetyp wird bei einer neuen Reisekostenabrechnung vorausgewählt. Die gleichnamige Mandanten-Einstellung hat Vorrangthe first available trip type is preselected for a new travel expense report. The client setting of the same name takes precedence.
• TmOptions.useItinerarySegments (Standarddefault: false): Benutzer können Routen und Zwischenziele inklusive privater Aufenthalte erfassen. Die Mandanten-Einstellung "Erlaube dem User Routen und Zwischenziele inkl. privater Aufenthalte zu erfassen" hat Vorrangusers can record routes and intermediate destinations including private stays. The client setting "Allow the user to record routes and intermediate destinations including private stays" takes precedence.
• TmOptions.validateKmBillClashesPerVehicle (Standarddefault: true): bei Kilometergeldbelegen wird geprüft, dass sich die Kilometerstände (Km Von/Bis) nicht mit einem früheren Beleg desselben Fahrzeugs überschneiden. Die Mandanten-Einstellung hat Vorrangfor mileage allowance receipts, it is checked that the odometer readings (Km from/to) do not overlap with an earlier receipt of the same vehicle. The client setting takes precedence.
• TmOptions.travelFolderAutoCreation (Standarddefault: false): Benutzer dürfen die automatische Erstellung von Reisemappen aktivieren. Die Mandanten-Einstellung "Benutzern die automatische Erstellung von Reisemappen erlauben" hat Vorrang. TmOptions.travelTypesToExcludeFromTimeRangeValidation: Kurznamen von Reisetypen, deren Reisen nicht auf Terminkollision geprüft werden (Standard: leerusers may enable the automatic creation of travel folders. The client setting "Allow users to automatically create travel folders" takes precedence.
• TmOptions.travelTypesToExcludeFromTimeRangeValidation: short names of trip types whose trips are not checked for appointment conflicts (default: empty).
• TmOptions.authorMayUploadAdditionalFilesAtAnyTime (Standarddefault: false): der Reisende darf jederzeit weitere Dateien hochladenthe traveler may upload additional files at any time.
• TmOptions.showClientInTravelFolder (Standarddefault: true): der Mandant wird in der Reisemappe angezeigtthe client is displayed in the travel folder.
• TmTravelServiceImpl.copyAttachmentsFromRequest2Expense (Standarddefault: false): Anhänge des Reiseantrags werden in die Reisekostenabrechnung übernommen (nur mit Dokumentenmanagement).

Berechnung und Rundung

• TmCalculatorDefaults.roundingPrecision definiert die Standardpräzision für Rundungen (Standardattachments of the travel request are carried over to the travel expense report (only with document management).

Calculation and rounding

• TmCalculatorDefaults.roundingPrecision defines the default precision for rounding (default: 100).
• TmOptions.useTaxfreeAllowanceCalDefinitionIfNoCorporateExists (Standarddefault: true): Fehlt eine Abrechnungsdefinition für die Unternehmenssicht, wird die steuerfreie Abrechnungsdefinition für beide Sichten verwendet.
• 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.

• if a settlement definition for the company view is missing, the tax-free settlement definition is used for both views.
• The parameters of TmAllowanceCalc24HourImpl and TmAllowanceCalcCalDayImpl control, among other things, tax-free reductions and the handling of international legs.
• Further calculator parameters can concern factors, rounding, tax-free portions or additional fields. They may only be changed together with the respective settlement definition.

Procedure and verification

1. Document the previous values and identify the affected trip types or settlement definitions.
2. Change the parameter and wait for the cache/cluster refresh.
3. Check a domestic and an international trip and, if affected, receipt, mileage allowance, time correction and export.

Business calculation rules preferably belong in settlement definitions, not in uncommented global parameters.