Calendars

Payroll Calendars

Der Payroll Kalender beschreibt wie die Lohnlaäufe im Kalender abgebildet sind. Die Grundlage dazu ist der Kalender in de Systemkultur.

Der Payroll Kalender bestimmt die Frequenz der Lohnzahlungen mit dem Lohnzyklus, der Lohnperiode, sowie die Wochen- und Jahredefinition. Jeder Mandant besitzt eine oder mehrere Kalenderdefinitionen, welche von verschiedenen Objekten addressiert werden.

Der Payroll Kalender ist die Grundlage für Falldaten vom Zeitttyp Period und CalendarPeriod.

Calendar types

Der Payroll Kalender unterteilt die Geschäftsdaten nach zwei Zeiteinheiten:

• Lohnzyklus in welchem die Löhne erfolgen, üblicherweise das Kalenderjahr (CycleTimeUnit)
• Lohnperiod in der Zeitraum der Lohnzahlung wie z.B. der Kalendermonat (PeriodTimeUnit)

Der Lohnzyklus ist immer ein Vielfaches der Lohnperiode

Die folgende Übersicht zeigt die möglichen Kombinationen beider Zeiteinheiten mit der Anzahl der Lohnzahlungen in einem Zyklus:

Pay Period	Week Cycle	Bi-Week Cycle	Semi-Month Cycle	Lunar-Month Cycle	Month Cycle	Bi-Month Cycle	Quarter Cycle	Semi-Year Cycle	Year Cycle
Week	1	2	-	4	-	-	13	26	52
Bi-Week	-	1	-	2	-	-	-	13	26
Semi-Month 3)	-	-	1	-	2	4	6	12	24
Lunar-Month	-	-	-	1	-	-	-	-	13
Month 1)	-	-	-	-	1	2	3	6	12 4)
Bi-Month 2)	-	-	-	-	-	1	-	3	6
Quarter 2)	-	-	-	-	-	-	1	2	4
Semi-Year 2)	-	-	-	-	-	-	-	1	2
Year 2)	-	-	-	-	-	-	-	-	1

¹⁾ Übersteuerung der effektiven Anzahl der Tage im Kalendermonat mit einem Durchschnittswert
²⁾ Fiskale Jahre mit dem Jahresstart an einem beliebigen Kalendermonat
³⁾ Monatsaufteilung: [1 ... 15] + [16 ... Tage im Monat]
⁴⁾ Default calendar

Calendar example

Beispiel verschiedener Payroll Kalender:

1   "calendars": [
2     {
3       "name": "YearlySalary",
4       "cycleTimeUnit": "Year",
5       "periodTimeUnit": "CalendarMonth",
6       "valueType": "Cycle"
7     },
8     {
9       "name": "MonthlySalary",
10      "cycleTimeUnit": "Year",
11      "periodTimeUnit": "CalendarMonth",
12      "valueType": "Period"
13    },
14    {
15      "name": "QuarterSalary",
16      "cycleTimeUnit": "Year",
17      "periodTimeUnit": "Quarter",
18      "firstMonthOfYear": "April",
19      "valueType": "Period"
20    }
21  ]

Die Kalender im Detail:

• 3: Benutzerdefinierter Kalendername YearlySalary
• 4: Zyklus Zeittyp ist Year
• 5: Periodenzeittyp ist CalendarMonth
• 6: Daten gelten für den Zyklus: Jahreslöhne
• 9: Benutzerdefinierter Kalendername MonthlySalary
• 10: Zyklus Zeittyp ist Year
• 11: Periodenzeittyp ist CalendarMonth
• 12: Daten gelten für die Periode: Monatslöhne
• 15: Benutzerdefinierter Kalendername QuarterSalary
• 16: Zyklus Zeittyp ist Year
• 17: Periodenzeittyp ist Quarter
• 18: Beginn des Jahres ist April
• 19: Daten gelten für die Periode: Quartalslöhne

Calendar usage

Die Auswertung des Kalenders im Lohnlauf erfolgt nach folgender Priorität:

1. Wage Type
2. Empoloyee
3. Division
4. Tenant

TODO

• JSON example