How timekeeping is calculated

How timekeeping is calculated

Read this when a number looks wrong: why someone shows as late, why a day counts as absent, why overtime or night differential is lower than expected, or why a setting you changed made no difference. It explains, rule by rule, how KAMI turns check-ins into tardy, undertime, absent days, overtime, night differential and paid time.

It covers employees paid from check-ins. Employees with Use Time logs on are paid from time logs instead.

Where: Attendance › Event List › open an event › Calculation, and Attendance › Timesheet

You need: the Team Attendance right to see other people's events

How to work out why a day's figures are wrong

  1. Go to Attendance › Event List, find the person and date, and open the event.
  2. Under Timekeeping, check Actual In, Actual Out and the break times. If one is wrong, correct it or ask the employee for an amendment. KAMI recalculates when the change is saved or approved.
  3. Under Calculation › Tardy, read Tardy in, Break tardy, Undertime and Absent to see where the time went.
  4. Open the Settings panel under Timekeeping. It lists the settings this day was calculated with: Expected Hours, Tardy grace, Profile checkin required, Activity Check-in Required, Break-in Required, Fixed Break Time, Check-in Grace Only, Deduct Wage, Deduct Tardy and Auto-pay Excess Hours.
  5. If those differ from the current activity or profile settings, the day is stale. An Attendance Administrator can select Refresh Cache in that panel, or Refresh selected on the Event List for many days.
  6. Open Additional Options and check Half-day absence and Full-day absence. A full day of tardy with both taps present is almost always one of these.

The rule behind everything: a day keeps its own copy of the settings

When a day's first check-in record is created, KAMI copies onto it the employee's expected hours, check-in and break requirements, tardy grace and Check-in tardy grace only, and the activity's Duration Type, tardy deduction, grace deduction and Tardy Rounding. Later changes to the activity or profile do not reach that day until it is refreshed.

A saved shift is different again: picking a shift copies its times onto the event, so editing the shift never changes existing events, and refresh does not bring the change in.

⚠️ Refresh recalculates every selected day with today's settings, which can change pay for a period already paid. Refresh only the days the change was meant for.

Who is measured at all

Tardiness and absence apply only when both Check-in Required is on for the employee and the activity requires check-in. Otherwise the day has no tardy and is paid as scheduled, even with no check-in.

Event statuses

StatusWhen it is setEffect
ValidStamps recorded in the expected orderCalculated normally
Missed startNo check-in by the scheduled start (or the latest core-hours start) plus Absent if no check-in in Attendance RulesAbsent day
Missed endChecked in, but no check-out by the scheduled end plus Absent if no check-outAbsent day
AbsentStamps out of order or incomplete: a check-out with no check-in, a break started but not ended, or a required break never recorded. Also days imported as absentAbsent day

Allow non-linear check-in lets an employee record stamps in any order, but a day with missing stamps still counts as absent until corrected. The Event List shows these as Absent or Missing logs.

Absent days are the day's scheduled hours, less the scheduled break, divided by the employee's expected hours (Leave Day Hours if set, otherwise Expected Work Hours/Day). An absent day has no paid time, unless the activity's tardy deduction is off (see below).

How tardiness is measured

Tardy is made of three parts, added together before any grace or rounding:

PartHow it is measured
Tardy inCheck-in time minus the scheduled start. With core hours, minus the latest allowed start instead
UndertimeScheduled end minus check-out. With core hours, the scheduled length is counted from the check-in, so a later start means a later finish
Break tardyOnly with Break-in Required. With Fixed Break Time, starting the break early plus ending it late. Without it, the break taken minus the break scheduled

Without Break-in Required, someone who leaves during their scheduled break is not charged undertime for the break part.

Grace, rounding and deduction

Which grace applies. On the primary working activity, KAMI uses the larger of the activity's Tardy grace and the employee's Tardy grace override. On other activities, the activity's grace applies. New working activities start at 15 minutes.

What grace is compared with. Grace is compared with the whole tardy, late check-in, undertime and break tardy together, not with the check-in alone. With Check-in tardy grace only on the employee, a check-in within grace counts as on time and only undertime is charged; break tardy is not counted that day.

Then, in this order:

  1. Seconds are dropped.
  2. If the total is within grace, tardy is zero.
  3. Otherwise it is rounded up to the activity's Tardy Rounding increment.
  4. The grace minutes are then taken off, unless the activity charges the grace once someone is past it (shown on the event as Deduct Tardy).

Example: grace 15 minutes, rounding 15 minutes, 16 minutes late. Charged 30 minutes when grace is charged, 15 when it is not.

Whether it costs money. With the activity's tardy deduction off (shown on the event as Deduct Wage), tardy and absent days still show everywhere, but neither reduces paid time.

What the absence thresholds really do

An event can carry two thresholds, set on the event or copied from its shift or template:

  • Half-day absence: when tardy is more than this, at least half the day's scheduled hours are charged as tardy.
  • Full-day absence: when tardy is more than this, the whole day's scheduled hours are charged as tardy.

Neither marks anyone absent. The status stays Valid, absent days stay at zero, and the day shows as tardy. Both compare the tardy before grace and rounding, and both apply only after check-out.

How paid time is worked out

The activity's Duration Type decides each event's paid time:

Duration TypePaid time
LimitedScheduled hours less break, less tardy
ExcessThe longer of scheduled hours and hours actually worked (break excluded), less tardy
Excess less scheduled breakAs Excess, less any part of the scheduled break not taken
Actual hours (no tardy)Hours actually worked. No tardy is charged

An Unpaid activity pays nothing. A full-day event, such as leave, counts as one day of expected hours. Round Hours on the activity rounds hours to two decimal places.

Overtime through the overtime window

The overtime window pays time worked after the scheduled end. Overtime runs from the scheduled end to the check-out, or to the window's end if that is earlier, so time past the window's end is not overtime. With core hours, it starts from the moved finish. It needs both a check-in and a check-out.

Overtime window rounding and minimum, on the event's activity, points to an overtime activity whose request rounding and category minimums then apply to the window. For example, 17:07 to 17:52 in 15-minute blocks counts 17:15 to 17:45, and overtime under the employee's minimum counts as none. Actual times are kept. Night differential stops where counted overtime stops.

In Attendance Rules, Break after and Break deducted take a break off long overtime: once overtime reaches Break after, the Break deducted time is subtracted. On the timesheet, activities tagged as overtime pay also count in full as overtime.

Night differential

Night differential is worked out only when the activity's Premium Rate is above 0. The default is 0, which turns it off. The night period is the activity's, 22:00 to 06:00 by default.

  • Only hours that are both scheduled and worked count. Staying late earns none beyond the schedule and overtime window. Arriving late loses the part missed.
  • The scheduled break is excluded, unless Include break in Night Differential is on.
  • Night hours inside overtime are split out and paid at the combined overtime and night rate.
  • A day missing a check-in or check-out earns no night differential.
  • Employees not required to check in earn it on their scheduled hours.

Tips

  • Fix the evidence, not the result. Correct a wrong stamp and let KAMI recalculate.
  • Read Full-day absence as "charge the whole day". A report of absences will not count these days.
  • Explain grace before people query a payslip. "Two minutes past grace cost me 17 minutes" is grace being charged, working as configured.

Related articles