Attestation Forms
Executive Summary
Attestation Forms is where attestation paperwork is prepared, sent for signature and tracked. Staff start a new attestation period by choosing an attestation cycle, year and period. The system reviews each client in the configured client groups, finds their approved visits in AlayaCare for the period, and builds one attestation form per client listing those visits. Opening a period shows every form with its status and counts. From there staff can distribute the forms to the client or designated representative by email and text message, send reminders, review and print the forms, download them, add a form for an extra client, rebuild a single form, and upload completed signed forms back to the client's files in AlayaCare. A form can be opened to review its visits, employees, signing parties and full history.
Key Features
- Start a new attestation period for a cycle, year and period and create a form for each client with qualifying visits
- Review every period that has been processed, including who started it, when, and how long it took
- Open a period to see counts of forms that are Pending, Waiting For Distribution, Waiting For Signature, Cancelled, Refused To Sign and Complete
- Distribute all forms (or a single form) by email and text message with a secure signing link
- Send reminders for forms that are still waiting for signature
- View a form as a PDF, download the forms as a zip file, or print them as combined PDF files
- Add a form for an extra client in a period, or rebuild a single form from current AlayaCare data
- Upload completed signed forms to the client's files in AlayaCare, one at a time or all at once
- Open a form to review its visits, employees, signing parties and history, copy signing links, and open the client or an employee in AlayaCare
- Configure client groups, branch, tags, form header details, email, text message and upload options in the page settings
Typical Workflow
- If you manage configuration, confirm the page settings (client groups, branch, form header, email and text message accounts, signing link addresses).
- Click Start A New Period, choose the attestation cycle, year and period, then click Ok. Wait for Creating Forms to finish.
- Open the new period with Edit. Check the Pending Forms tab and the Messages tab for forms that could not be completed (for example, a client with no email or text details).
- Click Distribute All Forms and confirm. Forms move to Waiting For Signature.
- Use Send All Reminders as needed. Forms become Complete when a signature is received, or Refused To Sign if the client or representative refuses.
- Click Upload Completed Forms to attach the signed PDFs to the clients in AlayaCare.
Report Output
Each form is produced as a PDF from the attestation form layout. An unsigned copy is created when the form is ready to distribute, and a signed copy is created the first time a completed form is viewed (if one has not already been stored). Forms can be viewed in the View Form window, downloaded together as a zip file named AttestationForms_{date}.zip (one PDF per form, named Client_{client name}{form ID}.pdf), or printed together as one or more combined PDFs named AttestationSigning{date}From{first}To{last}.pdf. When more than 400 forms are printed, the combined PDFs are split into groups of 400. A form uploaded to AlayaCare is named AttestationForm_{last name}{first name}{form ID}From{first visit date}To{last visit date}.pdf.
Report Contents
| Content | How it is determined |
|---|---|
| Form ID | The form number shown on the form. |
| Agency logo | The agency logo from the page settings, when one has been uploaded. |
| Company name, address, phone and fax | The company details entered under Logo And Address in the page settings. |
| Client name | The full client name on a signed form. On a form that has not been signed, the client's first name is shown in full and the last name is partly hidden. |
| Service date | Date of the visit, in your time zone (month-day-year). |
| Start / end time | Visit start time and visit end time, in your time zone. |
| Service hours | Visit duration in minutes divided by 60, shown with two decimals. |
| Service name | Name of the service code on the visit. |
| Employee name | Employee first name, last name for the visit. |
| Recipient signature | The signature captured from the client or designated representative, when the form has been signed. |
Visits are listed in start-time order.
Configurable Settings
Open View Settings or Edit Settings from this screen (when permitted) to change these options.
| Group | Setting | Type | Purpose |
|---|---|---|---|
| General | Client Groups | Multi-select | Client groups whose clients are included when a new period is started. |
| General | Branch Number | Text | Branch whose clients are included when a new period is started. |
| General | Service Codes To Exclude | Multi-select | Visits with these service codes are left out of the forms. |
| General | Number of previous days to check | Text | Number of days before the period start date to include visits. |
| General | AC Tag ID meaning "Billable" | Dropdown | AlayaCare tag. Visits that already carry this tag are left out of newly created forms. |
| General | Verbal Attestations Required FCF Tag | Text | Form context field tag. Clients whose value is TRUE are skipped when a period is started. |
| General | Mail Attestations Required FCF Tag | Text | Form context field tag. Clients whose value is TRUE are skipped when a period is started. |
| General | Designated Rep FCF Tag | Text | Form context field tag that says whether the client has a designated representative. |
| General | Designated Rep FCF Value | Text | The value that means the client has a designated representative. |
| General | Designated Rep Name FCF Tag | Text | Form context field tag holding the representative's name. |
| General | Designated Rep Preferred Name FCF Tag | Text | Form context field tag holding the representative's preferred name. |
| General | Designated Rep Phone Number FCF Tag | Text | Form context field tag holding the representative's phone number. |
| General | Designated Rep Email FCF Tag | Text | Form context field tag holding the representative's email address. |
| General | Client Mobile Phone FCF Tag | Text | Form context field tag holding the client's mobile phone number. |
| General | Client Texting Capability FCF Tag | Text | Form context field tag saying whether the client can receive text messages. |
| General | Client Texting Capability FCF Value | Text | The value that means the client can receive text messages. |
| General | Designated Rep Texting Capability FCF Value | Text | The value that means the representative can receive text messages. |
| Logo And Address | Agency logo (Select A File) | PNG upload | Logo printed on the forms. |
| Logo And Address | Form Company Name | Text | Company name printed on the forms. |
| Logo And Address | Form Address | Text | Company address printed on the forms. |
| Logo And Address | Form Address 1 | Text | Additional address line printed on the forms. |
| Logo And Address | Form Phone | Text | Company phone number printed on the forms. |
| Logo And Address | Form Fax | Text | Company fax number printed on the forms. |
| Email Settings | Email account to use for distribution | Dropdown (editable) | Email account used to send signing links. |
| Email Settings | Email account to use for refuse to sign | Text | Email address used when a signer refuses to sign. |
| Email Settings | Form Signing Link Url (PDF) | Text | Web address that signing links for the PDF version are built from. |
| Email Settings | Form Signing Link Url (Visit List) | Text | Web address that signing links for the visit-list version are built from. |
| SMS Settings | SMS account to use for distribution | Dropdown (editable) | Text message account used to send signing links. |
| Upload Settings | Upload Signed PDF | Yes/No | Whether signed PDFs are uploaded to AlayaCare. |
| Upload Settings | Folder for Uploaded PDF | Text | AlayaCare file folder that uploaded PDFs are saved in. |
Which settings are shown to you depends on the settings permission you hold. When you only have View Settings, every field is read-only.
Available Permissions
The following permissions are available to be assigned to AlayaCare Roles:
| Attribute | What It Controls |
|---|---|
| View | Open the page, including the period details |
| Settings View | Open View Settings to see the page configuration |
| Settings Edit | Open Edit Settings and change the page configuration |
Main Grid
The grid lists every attestation period that has been started, newest first (14 rows per page).
| Column | Description |
|---|---|
| Added | Date and time the period was started, in your time zone. |
| Added By | User who started the period. |
| Cycle | Attestation cycle. |
| Year | Period year. |
| Period | Period number. |
| From | First day of the period. |
| To | Last day of the period. |
| Processing Start | When form creation began. |
| Processing End | When form creation finished. |
| Duration | Time taken to create the forms. |
| Manage Records | Edit icon that opens the period. |
Actions
| Button | Description |
|---|---|
| Start A New Period | Opens the Start A New Report dialog to create forms for a cycle, year and period. |
| View Settings | Opens the page settings in read-only mode (when settings view is permitted and settings edit is not). |
| Edit Settings | Opens the page settings for editing (when settings edit is permitted). |
| Edit (row icon, or right-click a row) | Opens the Attestation Form Periods page for that period. |
Dialog Components
Start A New Report
Opens from Start A New Period.
| Field | Purpose |
|---|---|
| Select An Attestation Cycle | The attestation cycle. Required. |
| Year | The period year. Defaults to the current year. The previous year is also offered in January and February. |
| Select An Attestation Cycle Period | The period to create forms for. The list shows the periods of the chosen cycle and year with their start and end dates. Required. |
| Ok | Checks the choices and starts creating forms. |
Warnings are shown when no cycle or no period is selected, or when the period has already been processed ("This period has already been processed"). Forms are then created in the background in a Creating Forms panel (see Processing Overviews).
Attestation Form Periods
Opens from Edit on a period. Use the back arrow next to the title to return to the list of periods. The top of the page shows the Billing Cycle, Year and Period (read-only) and a count of forms in each status: Pending, Waiting For Distribution, Waiting For Signature, Cancelled, Refused To Sign and Complete.
| Button | Description |
|---|---|
| Refresh | Reloads the forms and counts. |
| Start A New Form | Opens the Start A New Form dialog to add a form for one more client in this period. |
Tabs
| Tab | Purpose |
|---|---|
| All Forms | Every form in the period, with the buttons for distributing, downloading, printing, reminders and uploading. |
| Pending Forms | Forms that could not be completed and are still Pending, with the reasons. |
| Refused To Sign | Forms where the client or representative refused to sign, with the reason. |
| Messages | Messages recorded while the period was created. |
All Forms — Grid
The grid is paged 12 rows at a time, sorted by client name, and the first three columns stay in view while scrolling.
| Column | Description |
|---|---|
| ID | Form number. |
| Client Name | Client name. |
| Status | Pending, Waiting For Distribution, Waiting For Signature, Cancelled, Refused To Sign or Complete. |
| Distributed | Date and time the form was first sent for signature. |
| Reminder | Date and time a reminder was last sent. |
| Pending Reason | For Pending forms, the reasons the form is not ready. |
| Terminated Employees | Employees on the form who are terminated in AlayaCare. |
| Signed On | Date and time the form was signed. |
| Upload Status | Result of the last upload to AlayaCare (Success or Failed). |
| Uploaded On | Date and time the form was uploaded to AlayaCare. |
| Groups | Client groups the client belongs to for this form. |
| Actions | Edit icon that opens the form. |
All Forms — Grid Filters
| Filter | Purpose |
|---|---|
| Filter Client Name | Limits the list to client names containing the text (not case-sensitive). |
| Filter ID Includes | Limits the list to form numbers containing the text. |
| Filter Employees | All or Terminated. Terminated shows only forms that include a terminated employee. |
| Filter Status | Limits the list to one or more statuses. |
Click Apply Filter to refresh the list. Use Clear Filter to reset filters and reload.
All Forms — Grid Actions
| Button | Description |
|---|---|
| Distribute All Forms | Sends every form that is Waiting For Distribution to its signing party after you confirm. |
| Download Selected Forms | Downloads the forms currently listed (after filters) as one zip file. Forms that have no PDF yet are skipped. |
| Print Selected Forms | Combines the forms currently listed (after filters) into PDF files for printing. |
| Send All Reminders | Sends a reminder for every form that is Waiting For Signature after you confirm. |
| Upload Completed Forms | Uploads every Complete form that has not yet been uploaded to AlayaCare after you confirm. |
| Apply Filter | Applies the filters. |
| Clear Filter | Clears the filters. |
| Edit (right-click a row, or row icon) | Opens the Form dialog. |
| View (right-click a row) | Shows the form as a PDF. Complete forms show the signed PDF; other forms show the unsigned PDF. A warning is shown for Pending or Cancelled forms because they have no form to view. Each view is recorded in the form history. |
| Refresh Form (right-click a row) | Cancels the form and builds a new one for the same client from current AlayaCare data. |
| Distribute (right-click a row) | Sends just this form. Shown only when the status is Waiting For Distribution. |
| Upload Completed Form (right-click a row) | Uploads just this form to AlayaCare. Shown only for Complete forms that have not been uploaded. |
Distribute, reminder and upload actions need the matching settings. If the email account or the text message account is not set up, a warning ("SMS Account Setup incomplete" or "Mail From Account Setup incomplete") is shown and nothing is sent.
Pending Forms — Grid
| Column | Description |
|---|---|
| ID | Form number. |
| Client Name | Client name. |
| Messages | The reasons the form is Pending, for example missing email or phone details for the signing party. |
| Actions | Edit icon that opens the form. |
Right-click a row for Edit, View or Refresh Form.
Refused To Sign — Grid
| Column | Description |
|---|---|
| ID | Form number. |
| Client Name | Client name. |
| Status | Form status. |
| Reason | Reason given for refusing to sign. |
| Actions | Edit icon that opens the form. |
Right-click a row for Edit, View or Refresh Form.
Messages — Grid
| Column | Description |
|---|---|
| Type | Type of message, for example ERR for an error. |
| Message | The message text. |
Start A New Form
Opens from Start A New Form. Type at least three characters of a client's name or number in Client and pick the client from the list, then click Ok. A warning is shown if no client is selected or if the client already has a form in this period ("Client already has a form"). Otherwise the system builds a form for that client in a Creating Form panel, using the same rules as when a period is started. Cancel closes the dialog without creating a form.
Form
Opens from Edit on a form. The client name is shown at the top, with Open Client In AlayaCare, which opens the client's scheduling page in AlayaCare in a new browser tab. Ok and Cancel both simply close the dialog.
Tabs
| Tab | Purpose |
|---|---|
| Visits | The visits included on the form. |
| Employees | The employees who worked those visits. |
| Signatures | The people asked to sign the form. |
| History | Everything that has happened to the form. |
Visits — Grid
| Column | Description |
|---|---|
| Visit AC ID | AlayaCare visit number. |
| From | Visit start, in your time zone. |
| To | Visit end, in your time zone. |
| Service Code | Service on the visit. |
| Duration | Visit length. |
| Employee | Employee, last name first. |
| Employee Terminated | Ticked when the employee is terminated in AlayaCare. |
Employees — Grid
| Column | Description |
|---|---|
| Employee | Employee, last name first. Each employee is listed once. |
| Employee Terminated | Ticked when the employee is terminated in AlayaCare. |
| Actions | Open Employee In AlayaCare icon. |
Right-click a row and choose Open In AlayaCare to open the employee's schedule in AlayaCare in a new browser tab.
Signatures — Grid
| Column | Description |
|---|---|
| Signing Party | Client or Designated Rep. |
| Designated Rep | Name of the designated representative, when there is one. |
| Client Name | Client name. |
| Email address the signing link is sent to. | |
| Email Notified | When the email notification was sent. |
| SMS | Phone number the text message is sent to. |
| SMS Notified | When the text message notification was sent. |
| Signing Method | How the form was signed. |
| Signing Name | Name entered by the signer. |
| Signed | When the form was signed. |
| Refused To Sign | Ticked when the signer refused. |
| Reason Code | Reason given for refusing. |
| Refused Dt | When the signer refused. |
| Manage Records | Two copy icons, Copy Link To Clipboard (PDF) and Copy Link To Clipboard (Visit List). |
Signatures — Grid Actions
Right-click a row.
| Button | Description |
|---|---|
| Copy Link To Clipboard PDF | Copies the signing link for the PDF version of the form. |
| Copy Link To Clipboard Visit List | Copies the signing link for the visit-list version of the form. |
| Send Test Email | Opens the Send Test Email window addressed to the signing party's email, with a blank message body. |
| Send Notification (PDF) | Opens the Send Test Email window pre-filled with the notification text and the PDF signing link. |
| Send Notification (Visit List) | Opens the Send Test Email window pre-filled with the notification text and the visit-list signing link. |
The Send Test Email window has Recipient Email, Subject and a message box, which you can edit before clicking Ok to send it from the distribution email account (or Cancel). A warning ("Mail From Account Setup incomplete") is shown if that account is not set up.
History — Grid
| Column | Description |
|---|---|
| Action Dt | Date and time of the action, in your time zone. |
| By | User who performed the action. |
| Action | What happened, for example Form Started, Form Viewed or a status change. |
| Comments | Extra detail about the action. |
| IP Address | IP address the action came from. |
View Form
Opens from View on a form and shows the form as a PDF, with a Close button.
Dependencies
The following tables must be configured for lookups on this view to work:
| Table | Description |
|---|---|
| AttestationCycles | Cycles offered in Select An Attestation Cycle. Also covers its attestation cycle periods: periods offered in Select An Attestation Cycle Period, including the date by which signatures are required. |
| EmailAccounts | Email accounts offered in the page settings and used to send signing links. |
| Groups | Client groups offered in the page settings. |
| ServiceCodes | Service codes offered in Service Codes To Exclude. |
| SMSAccounts | Text message accounts offered in the page settings and used to send signing links. |
| Tags | AlayaCare tags offered in AC Tag ID meaning "Billable". |
Processing Overviews
This section describes what happens after you confirm a processing action.
Start A New Report (Ok)
- Requires a cycle and a period, and stops with a warning if that period has already been processed.
- Closes the dialog and opens the Creating Forms panel. The action is recorded in the action log.
- Saves the period with the user, the cycle, year, period dates and the signature-required-by date from the period. Visits are collected starting the configured number of days before the period start date.
- Cancels forms from earlier periods that are not yet Complete or Cancelled. Each cancelled form gets a history entry "Form Cancelled By Create Attestation Forms".
- Signs in to AlayaCare and loads the cancellation codes.
- Loads the clients for the configured branch and client groups, sorted by last name then first name.
- For each client, loads the client details. A client is skipped when the Verbal Attestations Required or Mail Attestations Required form context field is TRUE.
- Loads the client's approved visits for the collection window and the details of each visit. A visit is left out when it is cancelled and its cancellation code is missing or not billable, when it already carries the billable tag from the settings, or when its service code is on the exclusion list. For the remaining visits the employee is loaded, and the visit verification is loaded when the AlayaCare site has the visit verification features.
- Creates one form per client with visits, with status Pending, the signature expiration date from the period, and the client's groups. Each visit is stored with its start and end, duration in minutes (seconds are ignored), service code, employee and terminated status, the first clock in and out, and any overwritten verified times. A history entry "Form Started" is written.
- Works out who must sign. If the client has no value in the designated representative field, an error message is recorded for the period and the form history, and the form stays Pending. If the field matches the configured value the signing party is the Designated Rep (the representative's name, email and phone come from the configured fields); otherwise it is the Client (email from the client record, mobile phone from the configured field). A phone number is only usable when the texting capability field matches the configured value. If no email address and no usable phone number is available, an error message is recorded and the form stays Pending. Otherwise a signing record is created.
- Sets the form status: Pending when there are no visits or no signing record, otherwise Waiting For Distribution. When the form is not Pending, its unsigned PDF is created.
- Saves the end time and duration on the period. Any error creating a form is recorded as a message on the period.
Start A New Form (Ok)
Runs steps 5 and 7 to 11 above for the one selected client only, using the collection window of the period being viewed.
Refresh Form
- Marks the selected form Cancelled and writes "Form Cancelled By Refresh Attestation Form" in its history.
- Reloads the client's approved visits for the period from AlayaCare and applies the same visit rules, then creates a new form (new form number) with the same client groups, the visits, the signing record and the unsigned PDF, as in Start A New Report.
Distribute All Forms / Distribute
- Requires the distribution email account and text message account to be set up, then asks for confirmation.
- Takes each form that is Waiting For Distribution (only the selected form for a single Distribute).
- For each signing record, sends an email when an email address is present and a text message when a phone number is present. The message names the client with part of the name hidden, contains the signing link for the PDF version, states the date and time the link expires, and explains why the person is receiving it (designated representative or client).
- Records the date and time of each notification and a history entry for each.
- Recalculates the form status. A form that has been notified and not yet signed becomes Waiting For Signature; one that has been notified and signed becomes Complete.
Send All Reminders
- Requires the same email and text message accounts, then asks for confirmation.
- Takes each form that is Waiting For Signature.
- Sends the same email and text message again with the subject marked as a reminder, and records the reminder date and time and a history entry.
Upload Completed Forms / Upload Completed Form
- Asks for confirmation.
- Takes each Complete form that has not been uploaded (only the selected form for a single upload).
- Uploads the signed PDF to the client's files in AlayaCare, in the folder given in the settings.
- On success, saves the upload date, the user and the Upload Status Success. If AlayaCare does not accept the file, the Upload Status is set to Failed.
Download Selected Forms / Print Selected Forms
- Takes the forms currently listed after the filters are applied.
- Uses the signed PDF when there is one, otherwise the unsigned PDF. Forms with no PDF are skipped.
- Download builds one zip file with a PDF per form. Print merges the PDFs into combined PDF files of up to 400 forms each. The files are then downloaded by the browser.