Timesheet Form Checking
Executive Summary
Timesheet Form Checking is an audit screen for completed PCA timesheet forms. An office user picks a timesheet week and starts a new report. The system takes every form in that week that is marked Complete, compares what was saved on the form with what AlayaCare currently holds, and records every difference. Each report is kept in a list showing when it was run, by whom, how long it took, and how many forms had errors or warnings. Opening a report shows each checked form with its error and warning counts and, when a row is expanded, the individual differences found (for example a visit time that was changed in AlayaCare after the form was signed, a missing employee UMPI, or a form duration that no longer matches). From a checked form, the user can open the full Timesheet Form window to view the PDF, refresh the form's identifiers or visits, resend signature requests, reject the form so it can be signed again, or jump to the client or employee in AlayaCare.
Key Features
- Start a new check for all Complete forms in a chosen timesheet week
- Keep a history of every check, with start time, end time, duration, and counts of forms checked, forms with errors, and forms with warnings
- Compare each form with AlayaCare: employee UMPI, recipient member number (or date of birth), visit status, visit start and end times, service code, verified times, and form durations
- Flag completed forms whose completed PDF is missing
- Filter a report by status (All, Errors, Warnings), client name, form ID, and employee name
- Expand a form to see each difference, with the value on the form beside the value in AlayaCare
- Open a form from a report to view its PDF, signatures, visits, and history
- From the form window: regenerate a completed form, reject a form, refresh identifiers, refresh visits, refresh the signature list, send, resend, or copy a signing link, mark a recipient as unable to sign, and open the client or employee in AlayaCare
Typical Workflow
- Click Start A New Report, choose the timesheet week in the Select a week list, and click Ok.
- Wait while the completed forms are checked. When the check ends, the report opens automatically. A message tells you whether no discrepancies, discrepancies, or only warnings were found.
- In the report, set Status Filter to Errors (or Warnings) and click Apply Filter to see only the forms that need attention.
- Expand a form row to read each difference. The Form Value column shows what the form holds and AC Value shows what AlayaCare holds.
- Click the edit icon on a form (or right-click the row and choose Edit) to open the form window and correct the problem, for example with Refresh Form Identifiers, Refresh Form Visits, Regenerate Completed Form, or Reject Form.
- Return to the report list with Back and start a new check to confirm the corrections.
Report Output
The check itself is shown on screen and is not exported. The form window can show a PDF timesheet for each form (a "time and activity" sheet) with View Form. A fresh PDF is built each time View Form is clicked for a form that is not Complete. The completed form shows the PDF that was stored when the form was completed, and Regenerate Completed Form rebuilds it. The PDF opens in a viewer window with a Close button and no download or print buttons.
Report Contents
| Content | How it is determined |
|---|---|
| Agency name, address, phone, and fax | Taken from the agency's tenant settings. |
| Form number | The form's year-based number. |
| Services | The form's service type. |
| Recipient stay | The stay start and end dates (or only the one entered) followed by the location. |
| Recipient name and employee name | Shown in full once the form is Complete or marked Recipient Unable To Sign. Before that, the first name is shown and the last name is partly masked. |
| Recipient member number | The client's member number or date of birth, as stored on the form. |
| Employee UMPI | The employee's UMPI as stored on the form. |
| Day columns and daily total | One column per day of the timesheet week with the date, weekday, and the total of the visit durations on that day. Days with no visits show X. |
| Ratio, Shared location, Time In, Time Out, Activities | One line per visit per day: the service code ratio, No for 1:1 visits (otherwise Community when the visit includes the agency's shared-location task, else Home), the form start and end times, and the PCA activities mapped to the visit's completed tasks. |
| Total time by ratio | Total form time for 1:1, 1:2, and 1:3 visits; a ratio with no time is left blank. |
| Caregiver and recipient signatures | The saved signature images and dates. When the recipient was unable to sign, the text "Recipient Unable To Sign", the reason, and the date are printed instead. |
Available Permissions
The following permissions are available to be assigned to AlayaCare Roles:
| Attribute | What It Controls |
|---|---|
| View | Open the page, start reports, and open reports and forms |
The actions inside the Timesheet Form window are controlled by permissions assigned on the Timesheet Forms page (not on this page):
| Attribute (Timesheet Forms page) | What It Controls |
|---|---|
| Reject Form | Enables Reject Form |
| Refresh Form Identifiers | Enables Refresh Form Identifiers |
| Recipient Unable To Sign | Enables Unable To Sign |
| Refresh Signature List | Enables Refresh Signature List |
| Send Signature Request | Enables Send Signature Request and Resend Signature Request |
| Refresh Form Visits | Enables Refresh Form Visits |
Main Grid
The grid lists every report that has been run, 14 rows per page.
| Column | Description |
|---|---|
| ID | Report number. |
| Added | Date and time the report was started, shown in the tenant time zone. |
| Added By | The user who started it. |
| From Date | First day of the timesheet week that was checked. |
| To Date | Last day of the timesheet week that was checked. |
| Processing Start | When checking began. |
| Processing End | When checking finished. |
| Duration | How long the check took. |
| Completed Forms Checked | Number of Complete forms in the week that were checked. |
| Forms With Errors | Number of forms with at least one error. |
| Forms With Warnings | Number of forms with at least one warning. |
| Manage Records | Edit icon that opens the report. |
Actions
| Button | Description |
|---|---|
| Start A New Report | Opens the Start A New Report dialog. |
| Manage Records (edit icon) | Opens the report. |
| Edit (right-click a row) | Opens the report. |
Dialog Components
Start A New Report
Opens from Start A New Report. The Select a week list shows every timesheet week (shown as "from to to" dates) that has already begun, and the most recent week is pre-selected. Click Ok to run the check, or use the close icon to cancel. If no week is selected the warning "Please select a valid period week" is shown. If the chosen week has no Complete forms, the warning "No Forms Found" is shown and no report is created.
Timesheet Form Checking (report)
Opens when a report is started or when you open a row on the main grid. It shows what the check found. Back returns to the list of reports.
The top of the page shows the read-only values From Date, To Date, Forms Checked, Forms With Errors, and Forms With Warnings. The two counts are left blank when they are zero.
Report — Grid Filters
| Filter | Purpose |
|---|---|
| Status Filter | All, Errors (only forms with errors), or Warnings (only forms with warnings). |
| Client Name Includes Filter | Forms whose client name contains the text entered (not case-sensitive). |
| Form ID Includes Filter | Forms whose form number contains the text entered. |
| Employee Name Includes Filter | Forms whose employee name contains the text entered (not case-sensitive). |
Click Apply Filter to apply the filters. Clear Filter resets all of them. Refresh List applies the current filters again to the list already on screen. Forms are listed by employee, then client, then form number.
Report — Grid
| Column | Description |
|---|---|
| ID | The form's number. |
| Client | Client name, last name first. |
| Service Type | The form's service type. |
| Employee | Employee name, last name first. |
| Visits From | Date and time of the first visit on the form. |
| Visits To | Date and time of the last visit on the form. |
| Errors | Number of errors found; blank when none. |
| Warnings | Number of warnings found; blank when none. |
| Manage Records | Edit icon that opens the Timesheet Form window. Right-click a row and choose Edit to do the same. |
Click the arrow at the left of a row to expand the differences found for that form:
| Column | Description |
|---|---|
| Visit ID | The AlayaCare visit the difference relates to. 0 for differences on the form itself. |
| Type | Err for an error or Inf for a warning. |
| Section | Where the difference was found: Form Identifiers, Complete PDF, or Visits. |
| Entity | What was compared (see the table below). |
| Form Value | The value saved on the form. |
| AC Value | The value currently in AlayaCare. |
Differences that can appear:
| Entity | Type | Meaning |
|---|---|---|
| Employee NPI Number missing | Err | The form has no employee UMPI. AC Value shows the one in AlayaCare. |
| Employee NPI Number does not match value in AlayaCare | Err | The UMPI on the form differs from AlayaCare. |
| Status is complete but PDF not generated | Err | The form is Complete but its completed PDF was never stored. |
| Client Member Number missing | Err | The form has no recipient member number (or date of birth). |
| Client Member Number does not match value in AlayaCare | Err | The member number (or date of birth) on the form differs from AlayaCare. |
| Visist Status | Inf | The visit's status in AlayaCare is different from when the form was created. |
| Visit Start Time / Visit End Time | Err | The scheduled start or end of the visit has changed in AlayaCare. |
| Service Code | Err | The visit's service code has changed in AlayaCare. |
| Verified Start Date / Verified End Date | Err or Inf | The verified time in AlayaCare differs from the one on the form. It is a warning when the form never held a verified time and an error otherwise. Checked only when the agency uses visit verification and the verification is approved. |
| Form Start/Verified Start, Form End/Verified End | Err | The form held no verified times and its start or end differs from the verified time in AlayaCare. |
| Form Duration | Err | The duration saved on the form differs from the one recalculated from the visit (rounded to the nearest 15 minutes, minimum 15 minutes). |
Timesheet Form (form window)
Opens from the edit icon or Edit in a report. The header shows Timesheet Form ID and Last Printed. It shows Client / Service, Employee, From, To, Recipient Signing Party Type, and Status (with the pending reason in brackets for a Pending form). If the signing party type or member number is missing, the red message "Update Client Profile and refresh the form" is shown. Close closes the window.
| Button | Description |
|---|---|
| View Form | Opens the PDF timesheet. Disabled while the form is Pending. |
| Regenerate Completed Form | Shown only for Complete forms. Refreshes the identifiers, rebuilds the form's visits from AlayaCare, rebuilds the completed PDF, and opens it. There is no confirmation prompt. |
| Reject Form | Hidden while the form is Pending or Waiting For Caregiver Signature. Enabled with the Reject Form permission. Asks "Are you sure you want to reject this form?" before continuing. |
| Open Client In Alayacare | Opens the client's scheduling page in AlayaCare in a new browser tab. |
| Open Employee In Alayacare | Opens the employee's schedule page in AlayaCare in a new browser tab. |
Sections
| Section | Purpose |
|---|---|
| Form Identifiers | Shows Employee UMPI, Recipient Member Number, and Form ID. A warning icon with a count shows how many identifiers are missing. Refresh Form Identifiers reloads the UMPI and member number (or date of birth) from AlayaCare and rebuilds the PDF; it is hidden when the form is Complete or Cancelled and needs the Refresh Form Identifiers permission. |
| Recipient Stay | Read-only From, To, and Location of a recipient stay. |
| Recipient Unable To Sign | Unable To Sign opens a dialog (see below); it needs the Recipient Unable To Sign permission and a caregiver signature on the form. Once set, the date, reason, and comments are shown. |
| Visit Summary | Total Visits, Signed By Client, and Total Duration. |
| Visit Detail | Refresh Form Visits (hidden when the form is Complete; enabled for Pending and Waiting For Caregiver Signature forms with the Refresh Form Visits permission) and the list of visits on the form. |
| Employee Signature Detail | Status, Signature Received Date/Time, and View Signature, which shows the caregiver's signature image or the warning "No Employee Signature Present". |
| Client / Responsible Party Signature | The signers with Name, Status, Email, Type, Signature Request Date/Time, and Signature Received Date/Time, plus the buttons described below. |
| History | Date/Time, Action, IP, and User for each action on the form (6 per page). |
Visit Detail — list
| Value | Description |
|---|---|
| Visit ID and Form Duration | The AlayaCare visit number and the duration used on the form. |
| Scheduled Start, Scheduled End, Scheduled Duration | The scheduled visit times. |
| Clocked In, Clocked Out, Clocked Duration | The clock-in and clock-out times of the visit's latest work session. |
| Verified In, Verified Out, Verified Duration | The verified times from AlayaCare visit verification, when available. |
| Start, End, Duration | The times and duration used on the form. |
| Intervention(s) | The visit's tasks; a completed task is marked (x). |
Client / Responsible Party Signature — buttons
| Button | Description |
|---|---|
| Refresh Signature List | Reloads client and responsible party details from AlayaCare. Hidden when the form is Cancelled, signed, or marked unable to sign. Needs the Refresh Signature List permission. |
| Send Signature Request | Emails the signer a link to sign. Enabled when the notification email account is set up, the caregiver has signed, the signer has an email address, no request has been sent yet, and the form is not signed or marked unable to sign. Needs the Send Signature Request permission. |
| Resend Signature Request | Sends the email again (subject marked RESEND). Enabled only after a request has been sent. Needs the Send Signature Request permission. |
| Copy Link To Clipboard | Copies the signer's signing link and shows "Link Copied to Clipboard". |
| View Signature | Shows the signer's signature image, or a warning that none is present. |
Both send buttons ask "Are you sure you want to send a request for signature?" before sending.
Unable To Sign
Opens from Unable To Sign in the form window. The header reads Client Unable To Sign. Choose a Reason and optionally enter Comments, then click Ok (or Cancel). Without a reason the warning "Please Select A Valid Reason" is shown. Saving marks the form Complete and rebuilds the completed PDF.
View Form and signature viewer
View Form opens the PDF timesheet in a viewer with a Close button. View Signature opens an image viewer with the saved signature.
Dependencies
The following tables must be configured for lookups on this view to work:
| Table | Description |
|---|---|
| Email Accounts | The mail account (named in the agency's notification email setting) used to send signature request emails. |
| PCA Activities | Activity names printed on the PDF. Also covers its PCA activity interventions: maps AlayaCare tasks to PCA activities for the PDF. |
| Service Codes | Provides each visit's timesheet service type and ratio; compared with the visit's current service code. |
| Tags | Names of the AlayaCare visit tags used for signatures acquired, ignored variance, and visits excluded from a timesheet. |
| Tenant Configuration | The agency's PCA timesheet settings: cycle selection, signing party / member number / UMPI / responsible party fields, notification email, signing link address, shared-location task, and the agency name, address, phone, and fax. |
| Timesheet Cycles | The timesheet cycle in use. Also covers its timesheet cycle periods: the periods and weeks offered in Select a week, with their dates and signature due dates. |
Processing Overviews
This section describes what happens after you confirm a processing action.
Start A New Report (Ok)
- Requires a week to be selected, otherwise stops with a warning.
- Finds every form in the chosen week with the status Complete (all employees and clients). If there are none, shows "No Forms Found" and stops.
- Creates the report with the start time, the week's dates, and the user.
- For each form, in turn, loads the client and employee from AlayaCare and records any differences:
- Compares the employee UMPI and the recipient member number (or date of birth) with AlayaCare.
- Flags a Complete form that has no stored completed PDF.
- For each visit on the form, loads the visit from AlayaCare (and the approved verification when the agency uses visit verification) and compares the status, start time, end time, service code, verified start and end, and the form duration.
- Updates the report with the number of forms checked, forms with errors, forms with warnings, the end time, and the duration in minutes.
- Shows "Forms Checked - No Discrepancies Found", "Forms Checked - Discrepancies Found", or "Forms Checked - Warnings Found", and opens the report.
Reject Form
- Asks for confirmation, then logs "Timesheet marked as Rejected".
- Removes the caregiver and recipient signatures and the stored PDFs from the form, and sets its status to Waiting For Caregiver Signature.
- Clears the signed and request dates and the saved signature of every signer.
- When signature tags are configured, removes the signature-acquired, ignore-variance, and excluded-from-timesheet tags from each visit on the form in AlayaCare.
- Sets the week (and period) back to In Progress when not all of its forms are Complete, and shows "Form Rejected".
Regenerate Completed Form
- Logs "Completed Form Regenerated".
- Refreshes the form identifiers from AlayaCare (see Refresh Form Identifiers).
- Removes the form's visits and tasks, reloads the visits for the client and week from AlayaCare, reapplies the checks and rounding, and rebuilds them on the same Complete form.
- Rebuilds the completed PDF and opens it.
Refresh Form Visits
- Logs the action. Only runs for Pending and Waiting For Caregiver Signature forms.
- Sets the form back to Pending and removes its visits and tasks.
- Reloads the employee's visits in AlayaCare for the client and the week, leaving out visits already on other forms.
- When no visits remain, the form is set to Cancelled with the warning "Pending Status Changed to 'Cancelled' Due To No Visit Records Found".
- Otherwise rebuilds the form. Cancelled visits are ignored, visits that are not completed hold the form as Pending with a reason, and visits whose clocked or verified time differs from the scheduled time by more than the agency's maximum are excluded and tagged in AlayaCare as excluded from the timesheet. When all visits are acceptable, the form becomes Waiting For Caregiver Signature.
Refresh Form Identifiers and Refresh Signature List
- Reloads the client and employee from AlayaCare.
- Updates the form's recipient member number (or date of birth) and employee UMPI, and logs the action (including a UMPI change).
- For Refresh Signature List, also updates unsigned signers and adds new ones from AlayaCare.
- Rebuilds the PDF.
Send, Resend, and Copy signing link
- Send Signature Request and Resend Signature Request require the notification email account; otherwise "Mail From Account Setup incomplete" is shown.
- The email contains a greeting, the client's name (partly masked), the service, the visit dates, the signing deadline (when set for the week), and the signing link.
- A responsible party is emailed at their own address, and the client at the client email on the form. The send date and time is recorded on the form and the signer.
- Copy Link To Clipboard only copies the link; nothing is sent or recorded.
Unable To Sign (Ok)
- Requires a reason.
- Marks the form as recipient unable to sign with the date, user, reason, and comments, and sets it to Complete.
- Logs the action and rebuilds the completed PDF.