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 Enroll in Benefits page (/hr/my-benefits/enroll) guides employees through a four-step wizard to review eligibility, select or waive benefit plans, manage dependents, review cost breakdowns, and submit enrollment during an active open enrollment window.

​
Overview

The wizard uses four steps:
  1. Eligibility — displays the active enrollment period details and the count of eligible and ineligible plans. The employee must confirm their eligibility before proceeding.
  2. Plan Selection — shows eligible plans with coverage level options and premiums. Employees can toggle individual plans, select coverage levels, or elect to waive all coverage (requires a waiver reason).
  3. Dependents — for each selected plan, employees assign dependents or add new dependents via the Dependent Form dialog. Skipped when coverage is waived.
  4. Review — shows a full cost breakdown of selected plans, dependent assignments, and employer contributions. Employee must accept terms before submitting.
Progress is auto-saved as a draft every 2 seconds. If a previous draft exists, it is restored on page load with a toast notification. Existing enrollments are pre-populated when no draft is present. If no open enrollment period is active, the page redirects to /hr/my-benefits with an error toast.

​
Who it’s for

No explicit permission gate on this route.

​
Before you start

  • Open enrollment must be active for your organization.
  • You must be linked to an employee record via your user profile.
  • Dependents can be added during step 3 if not already created.

​
Steps

  1. Navigate to HR → My Benefits → Enroll or go to /hr/my-benefits/enroll.
  2. Step 1 — Eligibility: Review eligible plan count and confirm your eligibility.
  3. Step 2 — Plan Selection: Select plans and coverage levels, or elect to waive coverage and provide a reason.
  4. Step 3 — Dependents: Assign dependents to each selected plan or add new dependents.
  5. Step 4 — Review: Review all selections, cost breakdown, and accept the terms.
  6. Click Submit Enrollment to finalize.

​
Key concepts

ConceptMeaning
Open enrollment periodThe date window defined by HR during which enrollment changes are accepted
Coverage waiverOpting out of all benefit plans; requires a written reason
Draft saveEnrollment progress is auto-saved; restored on next visit during the same period

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/benefits-routes.tsx
  • src/cores/hr/benefits/pages/employee/EnrollmentWizardPage.tsx
  • src/cores/hr/benefits/hooks/useBenefitEnrollmentMutation.ts
  • src/cores/hr/benefits/hooks/useOpenEnrollmentPeriods.ts