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 Staffing Agencies page lists all configured staffing agency records and provides create/edit dialogs for users with the hr.contractor.manage permission. It is served at route /hr/contractors/agencies.

Overview

The page renders agency cards in a responsive grid showing agency name, contact name, email, phone, standard markup percentage, and active/inactive status. Users with hr.contractor.manage can add new agencies or edit existing ones via a dialog form. An “Show Inactive” toggle filters the list to include deactivated records. This page is part of the HR-34 Contractor & Contingent Workforce Management feature.

Who it’s for

Permission check: useHasPermission('hr.contractor.manage') — write operations (add, edit) are gated; read access is available to any authenticated user who can reach this route. No top-level RequirePermission guard wraps the route in hr.tsx.

Before you start

  • At least one staffing agency record must exist before it can be linked to a contractor.
  • Only users with hr.contractor.manage can create or modify agency records.

Steps

View agencies
  1. Navigate to HR > Contractors > Agencies or go to /hr/contractors/agencies.
  2. Use the Show Inactive toggle to include deactivated agencies in the list.
Add an agency (requires hr.contractor.manage)
  1. Click Add Agency.
  2. Complete the agency form (name, contact details, markup percentage).
  3. Save to create the record.
Edit an agency (requires hr.contractor.manage)
  1. Click any agency card to open the edit dialog.
  2. Update fields as needed and save.

Key concepts

TermMeaning
Standard Markup %Configured markup percentage stored on the agency record. SME: confirm calculation basis.
Active / InactiveStatus badge on each card; inactive agencies are hidden by default.

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/StaffingAgenciesPage.tsx
  • src/cores/hr/hooks/contractors/useStaffingAgenciesList.ts