Calendars

Payroll Calendars

The payroll calendar describes how the settlement runs are displayed in the calendar. The calendar in the system culture serves as the basis. The Payroll Calendar determines the frequency of wage payments with the wage cycle, the wage period and the weekly and annual definition. Each tenant has one or more calendar definitions that are addressed by different objects.

The payroll calendar ist the basis for case fields with the time type Period and CalendarPeriod.

Calendar types

The payroll calendar divides the business data into two time units:

• Pay-cycle in which wages are paid, usually the calendar year (CycleTimeUnit).
• Pay-period in which wages are paid, e.g. the calendar month (PeriodTimeUnit).

The pay-cycle is always a multiple of the pay-period

The following overview shows the possible combinations of the two time units with the number of wage payments in a cycle.

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

¹⁾ Override the effective number of days in the calendar month with an average value.
²⁾ Fiscal years with the year starting on any calendar month.
³⁾ Month breakdown: [1 ... 15] + [16 ... days in month].
⁴⁾ Default payroll calendar.

Calendar example

Example of different payroll calendars.

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: Custom calendar name YearlySalary
• 4: Cycle time type is Year
• 5: Period time type is CalendarMonth
• 6: Data apply to the cycle: annual wages
• 9: Custom calendar name MonthlySalary
• 10: Cycle time type is Year
• 11: Period time type is CalendarMonth
• 12: Data apply to the period: monthly wages
• 15: Custom calendar name QuarterSalary
• 16: Cycle time type is Year
• 17: Period time type is Quarter
• 18: Start of the year isApril
• 19: Data apply to the period: quarterly wages

Calendar usage

The evaluation of the calendar in the wage run is carried out according to the following priority:

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