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

• TmOptions.leadCurrencyIsoCode und leadCurrencyName legen die Leitwährung fest (Standard: EUR / Euro). Sie werden beim Start ausgewertet: Existiert die Währung noch nicht, wird sie mit Kurs 1 angelegt. Früher lagen diese Parameter in der Bean TmCurrencyServiceTarget; bei der Aktualisierung wurden die Werte automatisch übernommen.
• TmCurrencyServiceTarget.useRecordDateForLookupOfExchangeRate (Standard: false): Bei true wird der Wechselkurs zum Belegdatum ermittelt, bei false zum Enddatum der Reise. Gilt nur, wenn beim Reisetyp kein Stichtag für den Wechselkurs festgelegt ist (für Kilometergeldbelege immer).
• TmOptions.currencyLayerApiKey ist der API-Schlüssel für den Wechselkurs-Anbieter CurrencyLayer beim Import der Wechselkurse.
• TmTravelServiceImpl.travelIdGeneratorImpl wählt den Generator für Reise-IDs (Standard: TmTravelIdGeneratorDefault). Früher lag dieser Parameter in der Bean TmTravelServiceTarget.
• Bei TmTravelIdGeneratorFormattedDateNumber steuern die Parameter travelIdTemplate (Standard: {0}{1}), simpleDateFormatPattern (Datumsformat, Standard: yyDDD) und decimalFormatPattern (Nummernformat, Standard: 00) den Aufbau der Reise-ID.

Travel-Optionen

• TmOptions.adminRoleDelete und adminRoleUpdate bestimmen Administrationsrechte (Standard jeweils: Webdesk Administrator).
• TmOptions.showColumnAmountTaxFree (Standard: false) und showColumnAmountTaxable (Standard: true) steuern steuerfreie beziehungsweise steuerpflichtige Spalten. Die Mandanten-Einstellungen "Die steuerfreie Spalte/Zeile ... anzeigen" bzw. "Die steuerbare Spalte/Zeile ... anzeigen" haben Vorrang.
• TmOptions.routePlanningURLPattern definiert die URL-Vorlage für die Routenplanung (Platzhalter z.B. ${sourceLocation} und ${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 TmTravelServiceTarget.
• TmOptions.allowedAttachmentsMimeTypes: Dateitypen, die zu einer Reisekostenabrechnung hochgeladen werden dürfen (Standard: jpg, jpeg, png, pdf, rtf, zip sowie Word-, Excel- und PowerPoint-Formate). Die Mandanten-Einstellung "Wählen Sie die Dateitypen, die zu einer Reisekostenabrechnung hochgeladen werden dürfen" hat Vorrang.
• TmOptions.allowedVatTaxes: auswählbare Umsatzsteuersätze in Prozent (Standard: 7, 10, 20).
• TmOptions.useFirstTravelTypeAsDefault (Standard: true): der erste verfügbare Reisetyp wird bei einer neuen Reisekostenabrechnung vorausgewählt. Die gleichnamige Mandanten-Einstellung hat Vorrang.
• TmOptions.useItinerarySegments (Standard: 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 Vorrang.
• TmOptions.validateKmBillClashesPerVehicle (Standard: 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 Vorrang.
• TmOptions.travelFolderAutoCreation (Standard: 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: leer).
• TmOptions.authorMayUploadAdditionalFilesAtAnyTime (Standard: false): der Reisende darf jederzeit weitere Dateien hochladen.
• TmOptions.showClientInTravelFolder (Standard: true): der Mandant wird in der Reisemappe angezeigt.
• TmTravelServiceImpl.copyAttachmentsFromRequest2Expense (Standard: 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 (Standard: 100).
• TmOptions.useTaxfreeAllowanceCalDefinitionIfNoCorporateExists (Standard: 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.

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