Learn how to configure key components in Maica
The following articles will show you how to properly setup important components of the Maica system to ensure proper operation. These components are crucial to Maica's lifecycle and enable efficient Service Delivery.
To explore each component in detail and access specific configuration guides, please visit their pages below:
Before proceeding with the configuration of the above components, ensure that you understand them in Maica. To learn about each component, please see the following articles:
Learn how to configure Appointment Services in Maica
To correctly configure an Appointment Service, please follow the steps indicated below.
Appointment Services
in the App LauncherIn the Salesforce App Launcher, search for Appointment Services
and choose it to open the list view of all Appointment Services
in your Maica instance, as shown below.
Appointment Service
Once you are viewing your Appointment Services
, simply click the New
button located in the top right hand corner of your interface to bring up the New Appointment Service
pop-up, as shown below.
After the pop-up is displayed, you will be prompted to fill-in the following fields:
Name
This will be the name of your Appointment Service. As an Appointment Service is essentially a parent object for your Support Items, we recommend naming your Appointment Services generically based on the Support Items it will contain.
Claim Types
Available: Lists all potential Claim Types that can be associated with the Appointment Service.
Chosen: Select the relevant Claim Types for this Service that match the associated Support Items. Only selected Claim Types in this section will apply to the Appointment Service.
Tags
These are custom tags to categorise or group Appointment Services. Tags can assist in easy search and filter of Services when assigning a Service to an Appointment.
Available Sections
Available: Lists different sections that can be added to the appointment service.
Chosen: Select the sections relevant to this Service. This customises what fields or information will be displayed when setting up an Appointment using this Service.
Start & End Date
This field represents the beginning date (when the Appointment Service becomes active) and when the end date (when the Appointment Service is no longer valid). If the End Date is left blank, the Appointment Service will be active indefinitely.
Participant Note Template
Participant Note Template: This assigns a template for Participant Notes that will be associated with the Service. Select a pre-existing template or search for one to guide standard note-taking.
Pre-load Template: If checked, this option will automatically load the selected Note template whenever this Appointment Service is used.
Finally, once populated, simply click Save
to create your Appointment Service
.
Skills
and Checklists
Select your newly created Appointment Service to open up the record. Once open, you will see the related list fields on the right hand side of your interface, as shown below.
This step is only going to focus on Skills
and Checklists
. Both of these related lists work the same way, which is:
Click the New
button to add Skills
and Checklists
Select which Appointment Service
you wish to assign the Skill
or Checklist
too. The Service you open the selector from will be selected by default.
Select which Skill
or Checklist
you wish to assign, and set its associated Requirement Level
to either Required
or Recommended
.
Click Save
to finalise your selection.
Support Items
to an Appointment Service
Again, on your newly created Appointment Service, refer to the related list fields on the right hand side of your interface to identify the Support Items list. Here you will see all associated Support Items within an Appointment Service.
It is crucial to note here that assigning Support Items does not work in the same way as assigning Skills and Checklists.
Clicking the New
on the Support Item related list directly from your Appointment Service record will create an entirely new Support Item, not assign an existing one. In order to assign a Support Item to an Appointment Service, you must do it directly from the Support Item record.
As mentioned, in order to assign a Support Item to an Appointment Service, you must do it directly from the Support Item record. This is due to the fact that one Support Item can only ever belong to one Appointment Service.
To explain how this process works, please refer to the demonstration below. In the Demonstration, the following examples will be used and referenced:
Appointment Service: Recovery Coaching
Support Item: Psychosocial Recovery Coaching - Saturday
Now, your Appointment Service is ready to be used.
When configuring Appointment Services, it is crucial that no Support Items with the same configuration are assigned to the same Appointment Service, as this will disrupt Maica's ability to accurately validate the Participants funding, and potentially disrupt the Billing Flow.
The following four fields in a Support Item decide whether they are considered 'identical' within the Maica system:
Service Day
Service Time
Support Category
Registration Group
So, in summary, no two Support Items with identical inputs to the four fields listed above can exist within the same Appointment Service. If one field differs, they can exist.
Learn how to configure Support Items in Maica
Similar to Support Categories, custom fields have been added to the Support Item object in Maica. These allow you to configure appropriate Support Items to represent the Home Care Package Budget, and allows them to be useable within the Manage Budget tool.
So, the following section explains how to configure a Support Item, the steps you need to take to ensure that you can effectively set up and manage budgets while adhering to Home Care Package requirements, and details of the key configurable fields/components within the Support Item object. Below will also detail the relationship between Support Items and Support Categories, as well as how to be relate them in Maica.
If you wish to configure your own Support Items within Maica in order to set up and manage budgets correctly, please follow the steps indicated below.
Support Items
in the App LauncherIn the Salesforce App Launcher, search for Support Items
and choose it to open the list view of all Support Items
records in your Maica instance, as shown below.
Support Item
Once you are viewing your Support Item
, simply click the New
button located in the top right hand corner of your interface to bring up the New Support Item
pop-up, as shown below.
After the pop-up is displayed, you will be prompted to fill-in a number of fields.
Support Items
FieldsEach field on the New Support Item pop-up is detailed below. The key fields are described and their relationships are described in further detail:
Support Item Name
: This will be the name of your Support Item. You can name your Support Item anyway you wish.
Support Category
: This field allows you to associate your Support Item with any given Support Item.
Registration Group
: This field allows you to associate a Support Item with a specific Registration Group for classification.
Support Item Number
: The unique identifier number for the support item.
Support Item Type
: The Support Item Type pick list is a crucial field in configuring your Support Item. It essentially defines the type of Support Item, however this is important for both building your budget, as well as Maica's fee automation and regulations on a Service Agreement.
There are values within the Support Item Type pick list to support a Home Care Package, these values are described below:
Basic Subsidies
A Basic Subsidy for home care packages is a government-funded financial support provided to eligible individuals to help cover the costs of home care services. It is part of the Australian Government’s Home Care Package Program, aimed at assisting older adults to live independently in their own homes for as long as possible. The subsidy amount depends on the level of care required, ranging from basic support for daily tasks to higher levels of care for more complex needs.
Care Management Fees
Care Management Fees in home care packages refer to the costs associated with planning and coordinating the care services provided to an individual. These fees cover the management of the home care package, including creating care plans, organizing services, monitoring care quality, and ensuring that the individual’s needs are met. Care management can be provided at varying levels, depending on the complexity of the Participant's requirements.
Package Management Fees
Package Management Fees for home care packages are the costs related to the administration and organisation of the overall home care package. These fees cover tasks such as managing budgets, handling invoicing and compliance, maintaining records, and ensuring that the services provided meet regulatory requirements. They are necessary to ensure the smooth operation of the home care package and are separate from care management fees.
Basic Daily Fees
Basic Daily Fees for home care packages are optional contributions paid by the individual receiving care to help cover the costs of their home care services. The fee is set by the government and is typically a small percentage of the aged pension. It helps supplement the government subsidy and can be charged in addition to the care management and package management fees, depending on the provider.
Income Tested Fees
Income Tested Fees for home care packages are additional fees that some individuals may be required to pay based on their income. These fees are determined by the Australian Government and apply to those with higher incomes, contributing toward the cost of their home care services. The amount varies depending on the individual’s income level, and there are annual and lifetime caps to limit the total amount a person can be required to pay. These fees are separate from the basic subsidy and other fees associated with the home care package.
Various Types of Supplements
Supplements for home care packages are additional payments provided by the Australian Government to support individuals with specific care needs. These supplements are designed to address special circumstances and can be added to the basic subsidy. Common types of supplements include:
Dementia and Cognition Supplement: For individuals with cognitive impairments such as dementia.
Veterans’ Supplement: For veterans who have a related health condition.
Oxygen Supplement: For those requiring continuous oxygen due to medical conditions.
Enteral Feeding Supplement: For individuals needing tube feeding.
Hardship Supplement: For those facing financial difficulties in paying home care fees.
These supplements help ensure that individuals with specialised needs receive appropriate care and support.
Funding Level
: Funding Level defines what level of funding can be assigned, and therefore set the rate against the relevant items.
Quantity Unit of Measure
: The Quantity Unit of Measure field allows you to specify the billing frequency or unit for the Support Item.
Home Care Package Support Items should all be set to a daily unit of measurement because fees and credits that are in the package budget through subsidies are always charged at a daily rate according to the rate schedule provided by the Commonwealth.
Claim Type
:
Claim Types (Available): Lists possible claim types applicable to the Support Item.
Claim Types (Chosen): Shows selected claim types that apply specifically to this Support Item.
The Claim Type should be set as Home Care Package. Maica has various different claim types that can be applied to particular Support Items, and to make it is important to make sure that the system is selecting the Home Care Package value that we're not pulled into any order of claims process that you might be running. If you're using in Maica, and you're administering NDIS or CHSP for example, you want to selecting Home Care Package will ensure that your Home Care Package Support Items are specifically handled by your Home Care Package claiming processes.
Service Day
: Specifies which days this Support Item is available for service.
Service Time
: Sets the available time range for the service related to this Support Item.
Appointment Service
: Captures what Appointment Service applies to this Support Item, including Skills and Resources.
Travel Activity
: Marks the Support Item as a Travel Activity which is available when manually creating Timesheet Entries and Manage Travel when creating Appointments.
Timesheet Activity
: Marks the Support Item as a Timesheet Activity which is available when manually creating Timesheet Entries.
Display Name
: The name that will be displayed throughout Maica for this Support Item.
Tags
: Keywords or phrases that help in categorising or searching for this Support Item throughout Maica.
Once you have populated the relevant fields, click Save
to finalise your Support Item.
Price List
Once you have configured your Support Items, it is important to add them to an associated Price List.
To do so, refer to the related list on the Support Item record. Simply click New
, to add your Support Item as a Price List entry into a configured Price List. At this point, you can set your rate.
Once done, your Support Item will be set up and ready to support you managing budgets of a Home Care Package Service Agreement.
Learn how to configure Support Categories in Maica
When it comes to Home Care Packages, custom fields have been added to the Support Category object in Maica. These allow you to configure appropriate Support Categories to represent the Home Care Package Budget, and allow our Manage Budget feature to interrogate the Support Category Records in your system to ensure that you can effectively set up and manage budgets while adhering to Home Care Package requirements.
As well as the ability to configure Support Categories, Maica offers a template with default categories, categorised by the various line items that form a package budget for home care, as per the table below.
Billable Fees
Fees that are charged directly to a customer through a co-payment invoice.
Claimable Fees
Fees that the provider can claim on behalf of the Home Care Package.
Client Contributions
Money paid into the package directly by the client, such as a basic daily fee.
Subsidies
The base subsidy paid by the government into the Home Care Package budget.
Supplements
Additional pieces of funding that individual participants can acquire approval for, to help with specific needs.
If you wish to configure your own Support Categories within Maica in order to set up and manage budgets correctly, please follow the steps indicated below.
Support Categories
in the App LauncherIn the Salesforce App Launcher, search for Support Categories
and choose it to open the list view of all Support Categories
records in your Maica instance, as shown below.
Support Category
Once you are viewing your Support Categories
, simply click the New
button located in the top right hand corner of your interface to bring up the New Support Category
pop-up, as shown below.
After the pop-up is displayed, you will be prompted to fill-in the following fields:
Name
This will be the name of your Support Category. You can name your Support Categories anyway you wish.
NDIS Name
This is the official name of the support category as recognised by the NDIS (National Disability Insurance Scheme), if applicable. Note: As NDIS Support Categories are populated via the Data Import, this will be automatically be populated.
Support Purpose
The Support Purpose dropdown is a configurable field within a Support Category, to which new values have been added to represent the categories of budget items within a Home Care Package. It is important that before you begin adding products that represent actual budget items to the package, you first set up your support categories to support the creation of the products underneath.
Category Number
This field is a unique identifier or reference number for the Support Category.
Fund Management Type
Specifies the type of fund management associated with the Support Category, indicating how funds are managed for services under this category. If you are configuring Support Categories for Home Care Packages, please ensure this is set to Home Care Package.
The Category Product
field associates the Support Category to a specific Product.
However, please note, it is not best practice on Maica to use the Category Product
field when configuring Support Categories, rather, it is best practice to link Products Records to Support Categories directly from the Product record. This is further explained here.
Once populated, simply click Save
to create your Support Category.
Support Category
with Support Items
Now that your Support Category has been set up, you must populate it with Support Items that correspond to the budget items in the package.
As mentioned above, this is not done through the Support Category, but rather, directly from the Support Item record.
Clicking the New
on the Support Item related list directly from your Support Category record will create an entirely new Support Item, not assign an exisiting one.
Learn how to configure Overnight Availability in Maica
To enable Overnight or 24 Hour Availability for a Resource
, you must first properly configure an Operating Hour
Record. To do so, follow the steps outlined below.
As Maica creates Availability
by referencing Operating Hour
records, it is critical to appropriately configure an Overnight or 24 Hour Operating Hour
record before attempting to plan a Resource's
Availability
.
Operating Hours
in the App Launcher or directly from the Resource
In Maica, there are two ways to create your Operating Hours
record, these are:
Through the Salesforce App Launcher
Directly from the Resource Availability Record
Follow the steps below to see how they both work:
In the Salesforce App Launcher, search for Operating Hours
.
Then, simply select it to open the list view of all Operating Hours
in your Maica instance, as shown below. Click New
to begin populating your record.
Navigate to a Resource
you wish to create an Overnight or 24 hour Availability record for. Then, under Availability
, click New
.
This will bring up the New Availability module, as shown below. Once here, navigate to the Operating Hours field, select it as if you were to assign an Operating Hours record, and click New Operating Hour
.
Operating Hours
RecordAfter the pop-up is displayed, you will be prompted to fill-in the following fields:
Name
A descriptive name for the Operating Hour record.
Weekday
The day(s) of the week when this operating hour applies. You can select one or multiple days.
Start Time
The time when the operating hour begins for the selected weekday(s).
End Time
The time when the operating hour ends for the selected weekday(s).
To configure the Operating Hours
records that enable overnight or 24-hour Availability
for Resources
in Maica, you will need to follow slightly different processes.
See the respective sections below for further information on each one.
To set up an Operating Hour record to allow for 24 hour Availability, you need to set up the record so that:
The Start Time
and End Time
are the same (e.g., 12:00 AM to 12:00 AM).
The selected weekdays define the active period (e.g., selecting Monday and Tuesday allows bookings spanning from Monday through to Wednesday).
If you wanted to book a Resource for an overnight Appointment on Mondays and Tuesdays, meaning they can take appointments that span Monday through Wednesday, then:
Assign an Operating Hour record with the following inputs:
Name: "Organisation Preference"
Weekday: Monday, Tuesday
Start Time: 12:00 AM
End Time: 12:00 AM
Save the record.
Note,
If a user tries to book an appointment beyond the allowed range (e.g., past Wednesday in this case), Maica will not allow it.
If a non-consecutive day is selected (e.g., Monday and Wednesday but not Tuesday), the system prevents bookings that cross the missing day.
To set up an Operating Hour record to allow for Overnight Availability, you need to configure the record so that:
The End Time is earlier than the Start Time (e.g., 6:00 PM to 6:00 AM).
A single weekday is selected, meaning the availability will carry into the following day.
If you wanted to book a Resource for an overnight shift that starts on Monday at 6:00 PM and runs until Tuesday at 6:00 AM, then:
Assign an Operating Hour record with the following inputs:
Name: "Organisation Preference"
Weekday: Monday
Start Time: 6:00 PM
End Time: 6:00 AM
Save the record.
Once the Operating Hour
record has been created, the next step is to assign it to a Resource’s
Availability
. This ensures that the Resource
follows the configured operating hours when scheduling Appointments.
Once your Availability Record has been created with the correctly configured Operating Hours, you will be ready to schedule Overnight or 24 Hour Appointments.