Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt

Use this file to discover all available pages before exploring further.

The Payroll Calendar page at /hr/payroll/calendar provides a monthly calendar view of scheduled pay periods, submission/approval deadlines, and the processing deadline for each pay cycle. Users with schedule management permission can also configure the organization’s pay schedule from this page.

​
Overview

The calendar displays one month at a time and shows pay-period events color-coded by status: Scheduled, In Progress, Completed, and Skipped. Days that fall on a configured holiday are highlighted. Clicking a pay-period event navigates to the linked payroll run detail page (if a run exists for that period). The “Regenerate” button rebuilds calendar events for the next 12 months using the active pay schedule and holiday list. Users with hr.pay_schedules.manage permission see a “Settings” button that opens an inline Pay Schedule form.

​
Who it’s for

No explicit permission gate on this route. Users with the hr.pay_schedules.manage permission additionally see the Settings and Regenerate controls.

​
Before you start

  • A pay schedule must be configured before calendar events appear. If no schedule exists, a warning card is shown with a “Configure Schedule” button (visible to schedule managers only).
  • Holiday dates must be loaded for the selected year for holiday highlighting to work.

​
Steps

View pay periods
  1. Navigate to HR → Payroll → Calendar (/hr/payroll/calendar).
  2. Use the left/right arrows to move between months, or click Today to return to the current month.
  3. Hover over a pay-day event chip to see the full period start/end, submission deadline, approval deadline, and processing deadline.
  4. Click an event chip to go to the linked payroll run (only available when a run exists for that period).
Configure a pay schedule (managers only)
  1. Click the Settings button in the page header.
  2. Complete the Pay Schedule form fields (name, frequency, anchor date, offset days, deadlines, holiday adjustment settings).
  3. Click Save. The form closes and the calendar reloads with updated events.
Regenerate events
  1. Click Regenerate to rebuild the next 12 months of calendar events using the current schedule and holiday list.

​
Key concepts

TermMeaning
Pay PeriodThe date range of work covered by a single payroll run.
Pay Date OffsetNumber of days after the period ends before paychecks are issued.
Submission DeadlineLast day employees can submit timesheets for this period.
Approval DeadlineLast day managers must approve timesheets.
Processing DeadlineLast day payroll must be finalized before the pay date.
SemimonthlyTwo pay dates per month, configured by semimonthly_first_day and semimonthly_second_day.

Human Resources

Human Resources core overview.

Governance & parity

This page documents shipped product behavior. It is not medical, legal, or billing advice. Verify against your organization’s policies and applicable regulations before using it for clinical, compliance, or billing decisions. Protected health information (PHI) shown in the product is governed by your tenant’s access controls and is never exposed in this documentation.
  • src/routes/hr.tsx
  • src/cores/hr/pages/PayrollCalendarPage.tsx
  • src/cores/hr/hooks/payroll/usePayCalendarEvents.ts
  • src/cores/hr/hooks/payroll/usePaySchedule.ts