Client Accounts List
Executive Summary
Client Accounts List is the accounts-receivable workspace for client funder accounts. A client account is one client billed through one funder and one billing contact. Billing staff search for an account, refresh a client's accounts from AlayaCare, export the list to Excel, and open an account to work with it. Inside an account they review the transactions, invoices, voided items, statements, ODSP invoices, payment receipts, notes and access history, and they can add, mark, close, reopen and void transactions, maintain the account's distribution and preauthorized payment settings, and export the account's details.
Key Features
- Search accounts by account ID, CRN, client UID, or client name, limited to a branch
- Search AlayaCare for a client, or type a client UID, and refresh that client's accounts from AlayaCare
- Export all accounts for the selected branch to Excel
- Open an account to review its transactions with filters for type, status and marked items
- Add transactions with department splits, or repeat the previous transaction's details
- Mark open items, close marked items that balance, and reopen a closed item (when permitted)
- Void a transaction with a reason (when permitted); voided items are kept on a separate tab
- Review the account's invoices, account statements, ODSP invoices, payment receipts and access history, and download statement and invoice PDFs
- Keep dated notes on the account
- Change the account's preferred statement distribution method, funder account number and preauthorized payment details
- Record Frontstream payment details for agencies that use Frontstream
- Export the account's transactions, invoices and voids to Excel
Typical Workflow
- Choose the Branch if needed, enter a filter (for example Filter Name or Filter Account ID), and click Apply Filter.
- If the client or account is missing, search for the client in AlayaCare (or type the Client UID) and click Refresh Client to create or update their accounts.
- Open an account with Edit (or right-click the row and choose Edit).
- Review the tabs. On Transactions, use Add, Mark, Close Marked Items, Open Closed Item and Void as needed.
- Use Export in the account or on the list when an Excel copy is needed.
Available Permissions
The following permissions are available to be assigned to AlayaCare Roles:
| Attribute | What It Controls |
|---|
| View | Open the page and see client accounts |
| Read-only | See account details but not change them. In an open account, all buttons that add, mark, close, reopen, void or edit are disabled. |
| All Branches | Allow the Branch selection to include all branches |
| Void | Void transactions on an account (the Void icon on a row is hidden without it, and Void shows "Void not allowed") |
| Open | Show Open Closed Item and allow reopening a closed item |
Main Grid
Accounts matching the filters, 13 rows per page. Unless your agency has turned the requirement off, the grid stays empty until at least one of the four text filters is filled in and Apply Filter is clicked.
| Column | Description |
|---|
| CRN | Client reference number. |
| Account ID | Account number. |
| Client UID | AlayaCare client ID. |
| Client Name | Client last name, first name. |
| Funder | Funder code. |
| Funder Name | Funder name. |
| Bill Contact ID | Billing contact ID. 0 when the client is billed directly. |
| Bill Contact Name | Billing contact last name, first name. |
| Balance | Current balance of the account. |
| Last Date | Date of the most recent transaction, in your time zone. |
| Manage Records | Contains the Edit icon that opens the account. |
Main Grid Filters
| Filter | Purpose |
|---|
| Branch (top right) | Limits accounts to a branch. Defaults to your branch. Only users with the All Branches permission can pick all branches; otherwise it is fixed to your branch. |
| Filter Account ID | Shows the account with this account number. |
| Filter CRN | Limits to accounts with this client reference number. |
| Filter Client UID | Limits to the client with this AlayaCare ID. |
| Filter Name | Limits to clients whose name matches the text. |
| Search For Client In AlayaCare | Finds a client in AlayaCare, within the selected branch. Used by Refresh Client, not by the grid filters. |
| Client UID | Alternative to the search box: type a client ID for Refresh Client. |
Click Apply Filter to refresh the list. Use Clear Filter to reset filters, including the client search and Client UID.
Actions
| Button | Description |
|---|
| Apply Filter | Loads the accounts that match the filters. |
| Clear Filter | Clears all filters and reloads. |
| Refresh Client | Enabled once a client is chosen in the search box or a Client UID is typed. Creates or updates that client's accounts from AlayaCare, then shows that client's accounts. Warnings: "Client UID not found" or "Invalid Client UID". See Processing Overviews. |
| Export | Exports every account for the selected branch (the filters are not applied) to an Excel workbook named clientaccounts_{date and time}.xlsx with one sheet, Client Accounts. Columns: Account ID, Client UID, Client Name, client Email, Address, Address Line 2, City, State, Zip; Funder Code, Funder Name; Billing Contact ID, Billing Contact Name and the contact's Email, Address, Address Line 2, City, State, Zip; Funder Account Number; Preferred Distribution; Add Source; Last Transaction; Last Access User; Last Access; Use PAP; and, for preauthorized accounts, PAP Document Type, PAP From Date, PAP To Date, Bank#, Transit#, Account# (shown as the first digit, asterisks and the last two digits), PAP Account Holder First Name, Last Name and Comments, and Payment Processor Client Account ID. |
| Edit (icon in Manage Records, or right-click a row) | Opens Client Account Details. |
Dialog Components
Client Account Details
Opens from Edit. Before it opens, the client's accounts are refreshed from AlayaCare, and the access is recorded in the account's Access History. The header reads Client Account Details For: AccountID: {id} Client: {name}, UID={id} * Billing Contact: {name}, ID={id} * Funder: {name}. The Export button at the top exports the account to Excel as *clientaccountdetails_{client UID}_{date and time}.xlsx with the sheets Summary (funder, client, billing contact, export date and user), Transactions (as currently filtered), Invoices and Void Transactions**.
Tabs
| Tab | Purpose |
|---|
| Transactions | Invoices, payments and adjustments on the account, with the buttons to add, mark, close, reopen and void them. |
| Invoices | Invoices received from AlayaCare for the account. |
| Void Transactions | Transactions that have been voided. |
| Settings | The account's distribution and preauthorized payment details. |
| Frontstream | Frontstream payment details. Shown only for agencies set up for Frontstream. |
| Account Statements | Statements produced for the account. |
| ODSP Invoices | ODSP invoices produced for the account. |
| Payment Receipts | Payment receipts produced for the account. |
| Notes | Dated notes about the account. |
| Access History | Who has opened the account. |
Transactions - Grid
Newest first, 7 rows per page. When a transaction was split across several departments, click the expand arrow on its row to see the Department and Amount of each part.
| Column | Description |
|---|
| Date | Document date. |
| Number | Transaction number. |
| Type | Transaction (document) type. |
| Department | Department the amount belongs to. Blank when split across several departments. |
| Notes | Document notes and supplemental notes. |
| Original Date | Original transaction date, shown for prior-period items. |
| Status | O for open or C for closed. |
| Qty | Quantity. |
| Rate | Rate. |
| Debit | Debit amount. |
| Credit | Credit amount. |
| Balance | Running balance. |
| Marked | Ticked when the item is marked. |
| Premium | Ticked for premium lines. |
| Premium ID | AlayaCare premium ID. |
| Reconcile ID | Reconciliation number given when the item was closed. |
| Visit ID | AlayaCare visit the item came from. |
| Actions | Contains the Void icon (requires the Void permission). |
Transactions - Grid Filters
| Filter | Purpose |
|---|
| Transaction Types | Choose any of Invoice, Payment and Adjustment. All are selected to start. |
| Status | Open, Closed or All (the default). |
| Marked Items | When ticked, shows only marked items. |
The grid refreshes as soon as a filter changes.
Transactions - Grid Actions
All of these are disabled when the user has the Read-only permission.
| Button | Description |
|---|
| Add | Opens Add Transaction with empty values. |
| Add With Prior Details | Opens Add Transaction starting with the date, document type and notes last used. |
| Void | Voids the selected transaction. See Processing Overviews. |
| Mark | Marks or unmarks the selected open transaction. "You can only mark open items" is shown for closed items. |
| Close Marked Items | Closes all marked transactions together. See Processing Overviews. |
| Open Closed Item | Reopens the selected closed transaction. Shown only with the Open permission. |
| Void (icon in Actions) | Voids that row. |
| Add, Void, Mark / Unmark, Open Closed Item (right-click a row) | Same as the buttons. Mark appears only on open items and changes to Unmark on marked ones. Open Closed Item appears only with the Open permission. |
Invoices - Grid
| Column | Description |
|---|
| Invoice Id | AlayaCare invoice ID. |
| Invoice Number | AlayaCare invoice number. |
| Date | Posting date. |
| Amount | Invoice amount. |
Void Transactions - Grid
| Column | Description |
|---|
| Date | Document date of the voided transaction. |
| Type | Transaction type. |
| Department | Department ID. Expand the row to see a split across departments. |
| Notes | Document notes. |
| Status | Status when it was voided. |
| Qty | Quantity. |
| Rate | Rate. |
| Debit | Debit amount. |
| Credit | Credit amount. |
| Void Date | When it was voided. |
| Reason | Reason entered when voiding. |
Settings - Details
Shows, read-only: Client Name, Email, Client Address, Client Address Line 2, City Province Postal, Billing Contact, Billing Contact Email, Billing Contact Address, Billing Contact Address Line 2, City Province Postal, Preferred Statement Distribution Method, the funder's account number (labelled with the funder's own label), and Use PAD Payments?. For preauthorized accounts it also shows Preauthorized Document Type, From Date, To Date, Bank Number, Transit Number and Account Number (all shown as asterisks), Bank Account Holder First name, Bank Account Holder Last name, Bank Account Holder Comments and Payment Processor Client Account ID. The client and billing contact details come from AlayaCare and cannot be changed here.
Settings - Grid Actions
| Button | Description |
|---|
| Edit | Opens the Edit Settings dialog (disabled with the Read-only permission). |
Frontstream - Grid
| Column | Description |
|---|
| Name | Name on the card or bank account. |
| Account Number | Shown as asterisks followed by the last four digits. |
Frontstream - Grid Actions
| Button | Description |
|---|
| Add | Opens Add PAP Detail (disabled with the Read-only permission). |
Account Statements - Grid
Statements produced for the account, newest period first (10 rows per page).
| Column | Description |
|---|
| Statement Date | End date of the statement period. |
| Client Name | Client on the statement. |
| Billing Contact | Billing contact on the statement. |
| Distribution Method | Print or Email. |
| Distribution Status | Status of distribution. |
| Distribution Date/Time | When it was distributed. |
| Distribution Email | Email address used. |
| Prior Balance | Balance brought forward. |
| Payments | Payments in the period. |
| Credit Adjust. | Credit adjustments. |
| Debit Adjust. | Debit adjustments. |
| New Fees | New charges. |
| Balance Owing | Balance at the end of the period. |
| Extended Payments | Extended payment amount. |
| Preauthorized Payments | Preauthorized payment amount. |
| Amount Due | Amount due. |
| Actions | Contains the Download PDF icon. |
Account Statements - Grid Actions
| Button | Description |
|---|
| Download PDF (icon, or right-click a row and choose Download) | Downloads the statement PDF. |
ODSP Invoices - Grid
| Column | Description |
|---|
| ID | Invoice number for the year. |
| Year | Year. |
| Cycle | Billing cycle. |
| Period | Period number. |
| Client Name | Client on the invoice. |
| Billing Contact | Billing contact. |
| New Fees | New fees. |
| Credit Adjust. | Credit adjustments. |
| Debit Adjust. | Debit adjustments. |
| Amount Due | Amount due. |
| Actions | Contains the Download PDF icon. |
ODSP Invoices - Grid Actions
| Button | Description |
|---|
| Download PDF (icon, or right-click a row and choose Download) | Downloads the invoice PDF. |
Payment Receipts - Grid
| Column | Description |
|---|
| Statement Date | End date of the receipt period. |
| Client Name | Client on the receipt. |
| Billing Contact | Billing contact. |
| Distribution Method | Print or Email. |
| Distribution Status | Status of distribution. |
| Distribution Date/Time | When it was distributed. |
| Distribution Email | Email address used. |
| Payments | Payments covered. |
| Actions | Contains the Download PDF icon. |
Payment Receipts - Grid Actions
| Button | Description |
|---|
| Download PDF (icon, or right-click a row and choose Download) | Downloads the receipt PDF. |
Notes - Grid
The list is on the left. Selecting a note shows its text on the right.
| Column | Description |
|---|
| Subject | Note subject. |
| Note Date | Date and time of the note. |
| Manage Records | Contains the delete and edit icons. |
Notes - Grid Actions
Edit and delete do nothing when the user has the Read-only permission.
| Button | Description |
|---|
| Add | Opens Client Note (disabled with the Read-only permission). Also available by right-clicking a row. |
| Edit (icon, or right-click a row) | Opens the note for editing. |
| Delete (icon, or right-click a row) | Deletes the note after "Are you sure you want to delete this Note?". |
Access History - Grid
| Column | Description |
|---|
| Details | What was recorded. |
| Action Date | Date and time. |
| User | User who performed the action. |
| Page | Page the action came from. |
Add Transaction
Opens from Add or Add With Prior Details. Click Ok to save or Cancel to close.
| Field | Purpose |
|---|
| Document Date | Date of the transaction. Defaults to today. |
| Select A Document Type | Type of transaction. The type decides whether the amount is a debit or a credit. |
| Cheque Number | Appears only for the cheque document type. |
| Document Notes | Filled in with the type's description and locked, except for adjustment types, where it must be entered. |
| Document Amount | Total amount of the transaction. |
| Add Department | Opens a department lookup to add another department line. |
| Department / Amount | One line for each department already used on this account, plus any added. Enter how the amount is split. |
Messages: "Please enter a valid Amount", "Please enter a Document Type", "Please enter Document Notes", and "Distribution must match Document Amount" (the department amounts must add up to the document amount). The document date must fall in an open funder period: "Funder not found", "Period not found", "Funder Period not found" or "Period closed" is shown otherwise. With one department the transaction is saved against it; with several, the split is saved with the transaction. The date, type and notes are remembered for Add With Prior Details.
Void Transaction
Opens after you confirm voiding. Enter the Reason (required: "Please enter a reason") and click Ok.
Edit Settings
Opens from Edit on the Settings tab. Click Ok to save.
| Field | Purpose |
|---|
| Preferred Statement Distribution Method | Email or Print. Used when statements are produced. |
| Funder account number (labelled with the funder's own label) | Account number the funder uses for this client. Shown only when the funder has a label set. |
| Use Preauthorized Payments? | Turns on preauthorized payments. Turning it off clears the document type and dates. |
| Preauthorized Document Type | Type of preauthorized payment document. |
| From Date / To Date | Period the preauthorization applies. |
| Bank Number, Transit Number, Account Number | Bank details, for bank-based document types. |
| First Name, Last Name, Comments | Optional bank account holder details. |
| Payment Processor Client Account ID | Client's ID at the payment processor (up to 20 characters). |
Client Note
Opens from Add or Edit on Notes. Enter the Subject, Note Date and the note text, then click Ok. All three are required ("Please enter a subject", "Please enter a note", "Please select a valid date").
Add PAP Detail
Opens from Add on the Frontstream tab. Choose a Type, enter the details and click Save, or Cancel to close. The details are sent to Frontstream, which returns a token; only the name and the last four digits are kept here.
| Type | Fields |
|---|
| Credit | Name on Card, Credit Card Number, Expiration (MM/DD), Address, Postal Code. The number, expiry, name, address and postal code are all validated. |
| Debit | Name on Account, Account Type (Checking or Savings), Check Type (Personal, Corporate or Government), Transit/Routing#, Account Number, Address, Postal Code. The transit and account numbers must each be at least 5 characters. |
Dependencies
The following tables must be configured for lookups on this view to work:
| Table | Description |
|---|
| Billing Cycles | Used to find the billing period a transaction date falls in. |
| Branches | Branch list used to filter accounts. |
| Departments | Departments offered when splitting a transaction. |
| Document Types | Types offered for new transactions, and the preauthorized payment document types. |
| Funders | Billing cycle and account number label for each funder; accounts are only created for funders with a billing cycle. Also covers its funder periods: used to confirm the period is open before adding or voiding a transaction. |
Processing Overviews
This section describes what happens after you confirm a processing action.
Refresh Client (and opening an account)
- Signs in to AlayaCare and loads the client's details. If the client is not found, nothing is changed.
- Loads the client's services. For co-pay programs, also loads the program's policies to find the funder and billing contact.
- For each funder and billing contact on the services, checks the funder is set up here with a billing cycle. Funders without one are ignored.
- For billing contacts, loads the contact from AlayaCare and creates or updates the local billing contact (including whether the contact is the client).
- Creates the account if it does not exist, with distribution method Print. If it exists, updates the client's name, address, phone, email, branch and billing contact flag when they have changed, and records what changed.
- After a Refresh Client from the list, shows that client's accounts.
Close Marked Items
- Requires at least one marked transaction ("No transactions marked").
- Requires total debits to equal total credits ("Debits and Credits do not match").
- After you confirm, sets each marked transaction to closed and unmarks it.
- Records a reconciliation covering these transactions, tags each with its reconcile ID, and shows "Transactions closed successfully". If anything fails, nothing is saved ("Error Saving Transaction").
Open Closed Item
- Requires the selected transaction to be closed and to have a reconciliation ("You can only open closed items", "Item not properly closed").
- Checks that the reconciliation's debits and credits still balance.
- After you confirm ("Do you want to reopen this transaction?"), removes the reconciliation from every transaction that was closed with it, so they all become open again, and records who reopened it and when.
Void
- Requires the Void permission ("Void not allowed").
- Refuses closed transactions, transactions that belong to a Bulk Funder Payment batch, transactions in a closed funder period, and transactions used in a Preauthorized Payment Submission, each with its own message.
- After you confirm and enter a reason, copies the transaction (and any department split) to the Void Transactions tab with the reason, user and time, and removes it from the Transactions tab.
- If the transaction was part of a deposit, the deposit totals are updated.