Timesheet statement reminder
Notifies employees when a timesheet statement reaches its submission deadline, and keeps reminding them — on their working days only — for as long as it stays overdue.
How it works
The job walks through every pending, ready or overdue timesheet statement in the workspace and moves it one step further along its lifecycle:
- Period with only time off → closed — when the period has ended and every one of its working days was covered by approved full-day time off, the statement is submitted on the employee’s behalf. If a manager approved that time off they have already signed off on the period, so it is approved at the same time; if policy approved it automatically, it is left for the manager to approve. Evaluated before the steps below, so a period the job closes is never marked overdue first
- Pending → Ready — when today is on or after the last working day of the period, the statement is marked ready and the employee is notified that the deadline has arrived. This threshold follows the employee’s own schedule, so approved full-day time off at the end of the period moves the deadline earlier — the employee is told before they leave, not while they are away
- Ready → Overdue — the calendar day after the period ends, regardless of the employee’s schedule. Time off straight after the period end does not push this back: the manager’s missing-submission entry depends on it, and it has to appear on a predictable day
- Overdue → reminded, every working day — while the statement stays overdue, the employee’s reminder is brought back to the top of their notifications and one email is sent on each of their working days. Weekends, public holidays and approved full-day time off are skipped, so nobody is chased while away. The first reminder uses the general “your timesheet is overdue” wording; every reminder after that names the manager waiting for it
Period outside the employment → withdrawn. Before any of these steps, a statement whose period has no day inside the employee’s employment is withdrawn. This happens when an end date is entered after the next period was already opened: the statement, the manager’s missing-submission entry and the employee’s reminders for it disappear. The check reads the employment as it stands now, so it works whatever Applies from date the end date was saved with. A statement that was ever submitted is never withdrawn, because the following periods’ balances build on it; it is left for an administrator.
Periods are processed oldest first, and one is only closed once every earlier period is approved — each period’s settlement is the opening balance of the next. After a long period of time off, the periods are therefore closed one per night rather than all at once.
Reminders stop as soon as the employee submits: the recurring reminder is dismissed and the manager’s entry becomes a normal approval.
Ongoing time off with no end date — an open sick period, for example — does not move the deadline. Such time off is only known to cover days up to today, so the days after it still count as working days and the deadline stays on the period’s real last working day.
Each step checks whether its day has been reached or passed, not only whether it is today, so a statement that missed its exact day (for example because the job did not run) catches up on the next run. Re-runs never send the same notification twice.
Example: time off across the period end
A monthly period covering 1–31 August, with approved time off from 24 August to 7 September:
| Day | What happens |
|---|---|
| Fri 21 Aug | Last working day before the time off, so the statement becomes Ready and the employee gets the deadline notification — while still at work |
| Tue 1 Sep | The day after the period ended, so the statement becomes Overdue and the missing submission appears in the manager’s approvals inbox |
| 1–7 Sep | The employee gets no reminders (all days are time off). The manager’s daily digest lists the missing submission from 1 September onwards |
| Tue 8 Sep | First working day back: the employee’s overdue reminder and email start, and repeat every working day until the timesheet is submitted |
When it runs
The job runs automatically and only triggers when at least one pending, ready or overdue statement exists for the workspace.
Parameters
This job has no parameters.
Job results
| Metric | Description |
|---|---|
processed | Number of statements evaluated |
withdrawn | Statements withdrawn because their period lies wholly outside the employment |
auto_closed | Periods with only time off, closed and approved straight away |
auto_submitted | Periods with only time off, closed but still awaiting a manager |
ready_emitted | Number of statements moved to ready (deadline reached) |
overdue_emitted | Number of statements moved to overdue (day after the period ended) |
reminded | Number of overdue reminders sent this run (one per overdue statement whose employee works today) |
skipped | Statements not yet due for any step, already handled, or whose employee is not working today |
errors | Failures during processing |
Who gets notified
- The employee gets the deadline notification when the period becomes ready, then one overdue reminder per working day until they submit. They are never reminded on a day off.
- The manager sees the missing submission in from the day after the period ended, and in their daily Manager digest. This does not depend on anyone’s calendar — a manager will see (and be emailed about) a missing timesheet for an employee who is still away, and will keep seeing it until the employee returns and submits.
- A manager who is away should set up an approval delegation: their digest is held while the delegation is active, their delegates receive it instead, and a catch-up summary arrives on the manager’s first working day back.
Each step of the statement also records the employee’s direct manager — this is how the manager’s approvals inbox is filled again after a rebuild.
Troubleshooting
| Issue | Solution |
|---|---|
| A period with only time off was not closed | The period must be over, contain no registration or check-in at all, and have every working day covered by approved full-day time off. A day with part-day time off, a request still awaiting approval, or an earlier period still open each hold it back |
| No deadline notification | Check that the statement is in “pending” state and that today is on or after the last working day of the period for that employee |
| No overdue notification | The statement must be in “ready” state and the period must have ended. Note the statement becomes overdue the day after the period ends — this is never delayed by time off |
| Employee on time off received no reminder | Expected. Overdue reminders are only sent on the employee’s working days; they resume on their first working day back |
| Manager chased about an employee who is away | Expected — the missing submission is raised the day after the period ends regardless of the employee’s time off. The employee is reminded when they return |
| Manager receiving digests while away | Set up an approval delegation for the time away; digests then go to the delegates and the manager gets a catch-up summary on their return |
| Manager inbox empty after a rebuild | Re-run the Rebuild employee projections job, then re-run this job so each statement records its manager again |
| Missing submission shown for an employee who has left | The statement is withdrawn on the next nightly run once the employee’s end date is before the period starts. If it stays, the statement was submitted at some point and needs handling by an administrator |