Vergleichsreport

Lohnarten sind die zentralen Konfigurationsobjekte des PS-Moduls: Jede Lohnart beschreibt eine Gehaltskomponente (fixer Bezug, variabler Bezug oder Fehlzeit), die in der Gehaltsverrechnung je Person erfasst, berechnet und an das Abrechnungssystem exportiert wird. Verwaltet werden sie über die Übersicht ps_showWageTypes (filterbar nach Verwendungs- und Bewertungstyp) und die Detailmaske ps_editWageType.

Gemeinsame Felder

• Name und Beschreibung: Anzeige in Masken und Listen.
• Code (Pflicht): der technische Schlüssel der Lohnart. Er wird in Berechnungs-Skripten als Variable wt<Code> referenziert – nach Produktivsetzung nicht mehr ändern.
• Verwendungstyp (Pflicht, beim Anlegen): Fixe Gehaltskomponente, Variable Gehaltskomponente oder Fehlzeit. Die Auswahl blendet die zugehörige Feldgruppe ein (siehe unten).
• Bewertungstyp (Pflicht): Manuell – der Wert wird in der Abrechnungsmaske erfasst – oder Berechnet mit einem JavaScript-Ausdruck. Im Skript-Kontext stehen alle manuellen Lohnarten als Variablen wt<Code> sowie die Person als person (mit den HR-Personendaten) zur Verfügung. Beispiel: wtGEHALT * 0.1 für einen 10%-Zuschlag.
• Exportcode: der allgemeine Code für den Export ins Abrechnungssystem. Er greift nur, wenn beim zugeordneten Abrechnungssystem kein systemspezifischer Exportcode hinterlegt ist (siehe unten).

Fixe Gehaltskomponente

Für monatlich wiederkehrende Bezüge (Gehalt, Zulagen, Sachbezüge, ...). Zusätzliche Felder:

• Gehalts-Code (HR-Expert): verknüpft die Lohnart mit einem Gehaltscode aus HR-Expert. Über diese Verknüpfung liest die Abrechnung den aktuellen Bezug aus der Gehaltshistorie der Person – und der Workflow-Systemschritt "Gehaltsänderungen zurückschreiben" schreibt in der Abrechnung geänderte Beträge wieder in die HR-Expert-Gehaltshistorie zurück (bei Betrag 0 wird der bestehende Bezug historisiert).
• JS-Ausdruck Option Gehalts-Code: optionaler boolescher JavaScript-Ausdruck, der bestimmt, für welche Personen die Gehaltscode-Verknüpfung gilt (z.B. nur bestimmte Beschäftigungsarten).

Fixpositionen tragen ein Gültig-ab-Datum; Änderungen gegenüber dem Vormonat setzen die Änderungsmarkierung des Personen-Statements.

Variable Gehaltskomponente

Für einmalige bzw. monatlich schwankende Bezüge (Überstunden, Prämien, Reisekosten, ...). Zusätzliche Felder:

• Untertyp: Betrag, Stundensatz oder Menge – bestimmt, wie der erfasste Wert zu interpretieren ist.
• Standardwert / Minimalwert / Maximalwert: jeweils mit einem Wert-Typ:
  • Zahl – fixer Wert,
  • Script – JavaScript-Ausdruck,
  • Zeit-Konto – Name eines TA-Kontos; der Wert wird aus dem Kontostand (Industrieminuten) zum Ultimo des abgeschlossenen Vormonats vorbelegt bzw. begrenzt.
• Verarbeitungsmodus Zeitkonten mit Quellkonto und Zielkonto: steuert, was der Workflow-Systemschritt "Zeitkonten verarbeiten" nach der Freigabe tut – Kontokorrektur (relativ oder absolut) oder Umbuchung vom Quell- auf das Zielkonto zum Periodenbeginn.

Typisches Beispiel Überstundenauszahlung: Standardwert = Zeit-Konto "Überstunden" (Vorbelegung mit dem Saldo des Vormonats), Maximalwert = dasselbe Konto (nicht mehr auszahlen als vorhanden), Verarbeitungsmodus = Umbuchung Quellkonto "Überstunden" → Zielkonto "Ausbezahlte Überstunden".

Fehlzeit

Verknüpft einen Fehlgrund aus der Zeitwirtschaft mit der Abrechnung. Zusätzliche Felder:

• Fehlgrund: der abzurechnende Fehlgrund (z.B. Krankenstand, Urlaub).
• Erfassungsmodus: Ganztägig, Untertägig (Stunden je Einzeltag) oder Tage und Stunden. Achtung: Dieser Modus ist nach dem Anlegen nicht mehr änderbar – bei Bedarf muss eine neue Lohnart angelegt werden.

Fehlzeiten werden je Person und Abrechnungsperiode als Intervalle (von/bis, Stunden) geführt und über den Fehlzeiten-Konnektor exportiert.

Mandanten-Zuordnung

Im Bereich Mandanten wird festgelegt, für welche Mandanten die Lohnart gilt. Die Zuordnung ist tagesgenau historisiert und trägt eine Reihung, welche die Anzeige-Reihenfolge der Lohnarten in der Abrechnungsmaske bestimmt. Die gereihten Tabellen je Mandant sind auch in der Mandanten-Konfiguration (Reiter "Gehaltsabrechnungsdienste") sichtbar.

Zuordnung zu Abrechnungssystemen und Exportcodes

Im Bereich Abrechnungssysteme wird die Lohnart einem oder mehreren Systemen zugeordnet, jeweils mit einem optionalen systemspezifischen Exportcode (dieselbe Zuordnung ist auch von der Systemmaske ps_editSystem aus pflegbar; Duplikate werden in beiden Richtungen abgewiesen).

Vorrangregel beim Export: Es gilt der Exportcode der Zuordnung zum Abrechnungssystem des Mandanten; fehlt er, der allgemeine Exportcode der Lohnart. So kann dieselbe fachliche Lohnart je Zielsystem Wage types are the central configuration objects of the PS module: each wage type describes a salary component (fixed payment, variable payment or absence) that is recorded per person in the salary accounting, calculated and exported to the payroll system. They are managed through the overview ps_showWageTypes (filterable by usage and valuation type) and the detail form ps_editWageType.

Common fields

• Name and description: shown in forms and lists.
• Code (required): the technical key of the wage type. It is referenced in calculation scripts as the variable wt<Code> – do not change it after go-live.
• Usage type (required, at creation): fixed salary component, variable salary component or absence. The selection reveals the corresponding field group (see below).
• Valuation type (required): manual – the value is entered in the accounting form – or calculated with a JavaScript expression. The script context provides all manual wage types as variables wt<Code> and the person as person (with the HR person data). Example: wtGEHALT * 0.1 for a 10% supplement.
• Export code: the general code for the export to the payroll system. It only applies when no system-specific export code is stored on the assigned payroll system (see below).

Fixed salary component

For monthly recurring payments (salary, allowances, benefits in kind, ...). Additional fields:

• Salary code (HR-Expert): links the wage type to a salary code from HR-Expert. Through this link, the accounting reads the current payment from the person's salary history – and the workflow system step "write salary changes back" writes amounts changed in the accounting back into the HR-Expert salary history (for amount 0, the existing salary entry is historicized).
• JS expression salary code option: optional boolean JavaScript expression determining for which persons the salary-code link applies (e.g. only certain employment types).

Fixed positions carry a valid-from date; changes relative to the previous month set the change marker of the person statement.

Variable salary component

For one-off or monthly varying payments (overtime, bonuses, travel expenses, ...). Additional fields:

• Subtype: amount, hourly rate or quantity – determines how the entered value is interpreted.
• Default / minimum / maximum value: each with a value type:
  • number – fixed value,
  • script – JavaScript expression,
  • time account – name of a TA account; the value is pre-filled or limited from the account balance (industrial minutes) at the ultimo of the completed previous month.
• Time account processing mode with source account and target account: controls what the workflow system step "process time accounts" does after approval – an account correction (relative or absolute) or a transfer from the source to the target account at the start of the period.

Typical example, overtime payout: default value = time account "Überstunden" (pre-filled with the previous month's balance), maximum value = the same account (never pay out more than available), processing mode = transfer from source account "Überstunden" → target account "Ausbezahlte Überstunden".

Absence

Links an absence reason from time and attendance to the accounting. Additional fields:

• Absence reason: the absence reason to be accounted (e.g. sick leave, vacation).
• Recording mode: full day, intraday (hours per single day) or days and hours. Caution: this mode cannot be changed after creation – if needed, a new wage type must be created.

Absences are maintained per person and accounting period as intervals (from/to, hours) and exported via the absence connector.

Client assignment

The Clients section defines which clients the wage type applies to. The assignment is historicized to the day and carries a ranking that determines the display order of the wage types in the accounting form. The ranked tables per client are also visible in the client configuration (tab "Payroll services").

Assignment to payroll systems and export codes

The Payroll systems section assigns the wage type to one or more systems, each with an optional system-specific export code (the same assignment can also be maintained from the system form ps_editSystem; duplicates are rejected in both directions).

Precedence rule for exports: the export code of the assignment to the client's payroll system applies; if missing, the wage type's general export code. This way, the same business wage type can carry different codes per target system (BMD, DATEV, ...) unterschiedliche Codes tragen.

Verwendung zur Laufzeit

• Beim Anlegen einer Abrechnung erhält jedes Personen-Statement automatisch Positionen für alle dem Mandanten zugeordneten fixen und variablen Lohnarten.
• Berechnete Lohnarten werden nach der Erfassung der manuellen Werte ausgewertet.
• Die Exporte (fixe/variable Bezüge, Fehlzeiten) liefern je Position u.a. Firmennummer, Personalnummer, Periode, Wert/Stunden und den aufgelösten Exportcode an den jeweiligen Konnektor-Link.

Praxis-Hinweise

• Codes stabil halten: Berechnungs-Skripte (wt<Code>) und Export-Zuordnungen hängen am Code – Umbenennungen nach Produktivsetzung vermeiden.
• Verwendungstyp und Fehlzeit-Erfassungsmodus sind nach dem Anlegen fixiert; falsche Anlage erfordert eine neue Lohnart.
• Systemwechsel am Mandanten entfernt Lohnarten-Zuordnungen, die im neuen Abrechnungssystem nicht enthalten sind – vor einem Wechsel die Zuordnungen im Zielsystem vollständig pflegen.
• Reihung pflegen: Eine konsistente Reihung je Mandant erleichtert dem Consultant die monatliche Erfassung erheblich.

Verwandte Seiten: Gehaltsverrechnung (Salary Accounting), Modul Payroll Services.

Runtime usage

• When an accounting is created, every person statement automatically receives positions for all fixed and variable wage types assigned to the client.
• Calculated wage types are evaluated after the manual values have been entered.
• The exports (fixed/variable components, absences) deliver, per position, the company number, employee ID, period, value/hours and the resolved export code to the respective connector link.

Practical notes

• Keep codes stable: calculation scripts (wt<Code>) and export assignments depend on the code – avoid renaming after go-live.
• Usage type and absence recording mode are fixed after creation; a wrong setup requires a new wage type.
• Switching the client's payroll system removes wage-type assignments not contained in the new system – fully maintain the assignments in the target system before switching.
• Maintain the ranking: a consistent ranking per client considerably eases the consultant's monthly data entry.

Related pages: Salary Accounting Process, Payroll Services Module.