Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Learn about how Maica uses Timesheets within Maica.
A Timesheet is a record to capture time spent delivering services for a given Resource. This includes information about the Appointment or Shift related to the service, any breaks taken as well as travel times where applicable.
Timesheet records are not technically critical to the lifecycle within the Maica solution although the typical purpose is to provide an award interpretation and payroll system with the relevant data to process payments for your .
Timesheets are generated following the successful completion of either or , via checking out or quick completing these.
Timesheets can be enabled or actually fully disabled in Maica. If enabled, each Resource can then be set up for Timesheets generation individually.
Learn about how Maica uses Service Agreements within the overall solution.
A Service Agreement is the financial construct under which a Participant receives services. This includes the ability to set up funding structures compliant with the NDIS, Aged Care and other funding arrangements. Service Agreement capture information such as Support Items, Price Lists as well as key dates during which the Service Agreement is valid.
The purpose of Service Agreements is to ensure that services are not delivered without verified funding. Maica considers the entire Participant Lifecycle as one connected process and therefore, it is critical that a has the appropriate Service Agreement funding in place prior to receiving services.
Service Agreements are a fundamental concept in Maica and these records are essential to being able to deliver services to your . Maica validates that the relevant funding, via a Service Agreement, is in place throughout the Maica lifecycle, including whilst managing:
Service Agreements provide you with assurance that a particular service to your is financially covered. Maica will inform the end user, pending their permissions, that any available funding may be exceeded without actually stopping the service from proceeding.
A Delivery Activity is the technical output of a delivered service; it essentially represents each delivered service to each . It is very unlikely that the average end user (or ) will need to be concerned with these records, as it is a fairly technical record. The information captured on a Delivery Activity will include the following key information:
Key Dates
Learn about how Maica uses Locations within the overall solution.
Locations in Maica specify a particular geographic address that may be used across your organisation. A typical example of this might be a wellness centre, therapy studio, or headquarters.
Locations capture information such as MMM classifications, addresses, and geolocation coordinates derived from Google, via Maica's Google Maps API integration.
The purpose of Locations is to abstract the actual address information from the end user (or Resources) when managing either Appointments or Shifts. The end user does not need to be concerned with entering the right address everytime an Appointment or Shift is managed but rather can simply select the Location.
Locations are primarily used when managing Appointments and Shifts. This allows the end user to simply select a Location rather than entering an address manually. Maica's Google Maps API integration also uses Locations to geo-code each one which is then used to calculate travel times between Appointments. Locations are also set for each Resource as their primary Location so Maica can track the travel time from this address.
Locations are a good way to abstract the management of addresses manually, so we encourage you to capture Locations for each address that is used more than once and should be globally accessible.
A reference to the Appointment which delivered the service to the Participant
A reference to the Service Agreement Item funding the delivered service for the Participant
Billing information to ensure Maica's billing engine can process the delivered service
Let us further explain this via an example:
If an Appointment is scheduled to deliver occupational therapy to 2 Participants, the Appointment will have two Delivery Activities, one for each Participant for the service.
Each Delivery Activity will be billed according the Service Agreement underpinnig the service for each Participant.
The purpose of Delivery Activities is to track delivered services and create a billing record that can be processed by Maica's billing engine. This essentially abstracts the Appointment from the billing and allows administrators to manage specific billing scenarios as required by any relevant business process.
Delivery Activities are a backend process and get generated when scheduling Appointments to deliver services to Participants. The Maica billing engine then reads the Delivery Activities to inititate the appropriate billing logic.
The generation of Delivery Activities is totally controlled by Maica, there is no reason to manually interact interact with these records. You are able to change them in case the billing logic execution produced incorrect results but, outside of this use case, these will just run in the background.
The purpose of Resources is to capture the care team delivering services. This has been architected as its own data object, called Resource rather than using the native Salesforce Contact. The main reason for this is to separate the workforce from the overall Contacts/Participants in the system. Resources also capture fundamentally different information which lends itself moreso to a specific data object to manage this.
Resources are used widely in Maica, including associating them with Appointments and Shifts. This includes beign able to filter and select Resources for Appointments based on Skills and Availability. In addition, Maica generates Timesheets for Resources when Appointments or Shifts are completed successfully.
Resources, or your care team, are the backbone of your organisation, making a real difference to your Participants. We are proud to have built a powerful and enjoyable application for your team to use and ensure that the focus remains on the quality of service to your Participants.
The purpose of Assets is to capture the various non-human Resources delivering services. This has been architected as a record type on the Resource data object rather than using the native Salesforce Contact. The main reason for this is to separate the workforce (human and non-human) from the overall Contacts/Participants in the system. Assets also capture fundamentally different information which lends itself moreso to a specific data object to manage this.
Assets are used widely in Maica, including associating them with Appointments and Shifts. This includes beign able to filter and select Assets for Appointments based on Skills and Availability.
There are many use cases where not only human care workers (Resources) are involved in the delivery of services but also non-human ones, such as cars, rooms, equipment, among many others. Maica offers the ability to treat these non-human Resources just like your care team buy including them in the scheduling, filtering, and rostering of your services.
We are an innovative NDIS and Aged Care software designed for providers. We help providers streamline operations, enhance care delivery, and boost efficiency with our comprehensive digital healthcare solutions built on the Salesforce platform.
Through the power of software, we want to enable providers to best manage their clients as effectively and as efficiently as possible.
Offering all the benefits of Salesforce's security, reliability, and scalability, we provide seamless data management, comprehensive reporting, and powerful automation. With access to Salesforce's extensive ecosystem, Maica users can optimise their operations and deliver superior care using industry-leading technology.
Our Knowledge Base is divided into two main sections:
The User Guide
The Administration Guide.
This structure is designed to meet the needs of different types of users within the organisation. The User Guide provides easy-to-follow instructions for everyday users who work with the application, while the Administration Guide offers more technical information for administrators and power users responsible for configuring and maintaining the system. This setup ensures that each user can quickly access relevant resources based on their role and responsibilities.
In order to switch between the two guides, simply use the dropdown in the top left corner of your screen.
The User Guide is designed for non-technical, everyday users of Maica. It contains practical information on how to use the application for tasks such as managing Participants, Scheduling Appointments & Shifts, creating Service Agreements, and navigating the Planner. This guide is ideal for staff members who need step-by-step instructions for using Maica in their daily work. If you're looking for how-to guides, tips for common tasks, or general feature overviews, the User Guide is the place to start.
Learn about how Maica uses Price Lists within the overall solution.
A Maica Price List is a collection of Support Items and their associated unit prices within the Price List. This allows you to configure multiple Price Lists and charge varying amount for your services, via Support Items, without having to replicate Support Items.
The purpose of Price Lists is to control a consistent pricing strategy across an organisation, where services, given the same circumstances, are charged at the same unit prices. This primarily prevents pricing errors as well as manual administration of individual .
The main use case for Price Lists is to associate them with to control pricing for the duration of the , although this can be changed throughout of course.
Price Lists are a fairly straight forward concept but offer a significant advantage in managing service pricing throughout the journey. Whilst multiple Price Lists are not required (only one is mandated to manage ), we encourage you to arrange your pricing structures across multiple Price Lists to ease the administration burden as well as prevent billing errors.
Learn about how Maica uses Contacts within the overall solution.
A Participant is the person receiving services under the context of a Service Agreement. This includes information such as personal details, funding information, notes, preferences, among many others. Maica uses the native Salesforce Contacts object to capture Participants and you can learn more about Salesforce Contacts here.
The purpose of Participants is to capture the people receiving services and their relevant attributes and related information. This includes a number of default attributes, such as Age, Gender, etc as well as related information including their , goals, , funding, and manh others.
The underlying Salesforce platform allows for the easy extension of any of these components using the platform configuration tools which you can learn about .
Participants are used throughout Maica and are part of virtually every part of the Maica lifecycle. This starts from Intake, Profile Management, Service Agreements, Appointments, Invoices, and Reporting. Participants form one of the core concepts of Maica and without a Participant, not only can Maica not function, any healthcare service provider also can't achieve their goals without Participants.
Maica, like healthcare service providers, exists to empower the caring for Participants. We take great care to create a Participant profile that is relevant, useful and enjoyable to use.
Learn about how Maica uses Appointments within the overall solution.
An Appointment is the principal way of organising services to your Participants into timeslots across your care team, including capturing the following key information:
Participants who are being serviced as part of the Appointment
who are delivering the service as part of the Appointment
which are being delivered as part of the Appointment
at which the Appointment is being held
Recurrance if the Appointment is a repeating service being delivered
An Appointment sets out the structure under which services are delivered to . They are visually represented in the and can be accessed using either the web browser or mobile device (using the Salesforce mobile application).
In Maica, Appointments form the central mechanism by which information about delivered services is captured and managed. Appointments are primarily managed through the and can be created or managed by any authorised end user, whether this be a dedicated scheduling team member or the themselves.
The majority of service delivery and billing is managed via Appointments, with the exception of , and therefore these records form a fundamental part of Maica. With the use of various available sections and custom fields, you can really make the Appointment management experience your own.
Learn about how Maica manages and utilises Incidents.
An Incident in Maica is a record used to capture and manage events that impact the safety, wellbeing, or service delivery of a Participant or Resource.
It includes important details such as the type of incident, severity level, reporter, linked participant, and date of occurrence, helping you maintain clear and consistent reporting across all areas of care.
The purpose of the Incident object is to provide a centralised, transparent way to record and manage critical events.
By logging incidents within Maica, you can ensure that events are tracked from the first report to final resolution with full visibility, accountability, and compliance in mind.
Incidents are linked to related records such as Participants, Appointments, and Reporters, allowing staff to easily trace context and outcomes.
Incidents are used widely across Maica to support compliance, reporting, and internal reviews. Staff can create new incident records directly from the Participant Profile or , allowing quick and accurate data capture in real time.
Each incident record can include:
Type – classifies the nature of the event (e.g., injury, behavioural, medication).
Severity Level – determines the seriousness or potential impact of the incident.
Reporter and Owner – identifies who logged the incident and who is responsible for follow-up.
Status – tracks the incident’s progress from open to resolved.
Incident records play a vital role in ensuring safety, compliance, and service quality within Maica. By capturing detailed information and linking incidents to relevant Participants or Appointments, your team can maintain transparency, reduce risks, and continuously improve care standards.
Over time, the insights gathered from Incident data help strengthen organisational practices — turning every recorded event into an opportunity for learning and improvement.
Learn about how Maica uses Shifts within the overall solution.
A Shift, whilst similar to Appointments, is the principal way of organising your Resources into timeslots across your locations, including capturing the following key information:
(Shift Service) which are being delivered as part of the Shift
at which the Shift is being held
Recurrance if the Shift is a repeating service being delivered
A Shift sets out the structure under which are rostered on a , including on a recurring basis. They are visually represented in the and can be accessed using either the web browser or mobile device (using the Salesforce mobile application).
In Maica, Shifts form the central mechanism by which information about rosters is captured and managed. Shifts are primarily managed through the and can be created or managed by any authorised end user, whether this be a dedicated scheduling team member or the themselves.
It's important to understand the main differences between Shifts and , so we can best summarise this as follows:
are structured to allow to receive specific services at specific times.
Shifts are structures to place at a during specific times.
Learn all about the key concepts and terms used within the Maica solution.
Whilst using Maica, you will come across a number of key terms so this articles aims to provide the necessary insights into the meaning of each of those.
A Participant is the person receiving services under the context of a Service Agreement. This includes information such as personal details, funding information, notes, preferences, among many others.
A Resource is the person delivering the services, such as a care worker, physio, nurse, etc. This includes information such as personal details, availability, skills, among many others.
An Asset is a non-human Resource, such as a room, car, or medical equipment. Anything that needs to be scheduled or managed outside of your actual care team can be considered an Asset within Maica.
Learn about the overall Maica Lifecycle
Maica follows a best-practise lifecycle to manage not only the care worker experience but also the Participant care throughout the solution as shown in the below diagram.
Maica views the entire experience as a single solution rather than a set of distinct features. This means that, at all times, everything that is important to the needs of healthcare service Providers is considered, including financial agreements, availability of care workers, participant preferences, etc.
The above diagram outlines a process flow that involves multiple systems and interactions, starting with an external interaction, leading to service management and eventually ending in finance and resource handling. Let’s break it down step by step:
Starting Point: The process can begin in various ways, such as through Email, an Online Chat, an Online Referral Form (hosted on a website), or a Phone Call. These are all the methods a participant can use to initiate contact.
Participant Information: Once contact is made, the system identifies or creates a record for the Participant (the individual receiving the services). The participant’s Preferences (such as preferred communication method or service type) are then set.
Service Agreement: If services are required, a Service Agreement is created for either an Aged Care budget, NDIS (which is validated against an NDIS Plan), or any other configured funding type. This agreement lays out the details of what services will be provided to the participant.
Learn about how Maica uses Checklists within the overall solution.
A Checklist is essentially a list of applicable tasks (Checklist Items) that a Resource will perform and acknowledge either before/during/after an Appointment or Shift. A typical example of this might be to do a COVID test, complete an assessment, or greet the Participant. An example of a Checklist might be:
The purpose is to control tasks that need to be completed as part of an or that are not billable to a Participant's but are required for compliance, security, or client care.
Checklists are used within and to show at various points throughout the journey, including:
Check In
Check Out
Appointment Management
Shift Management
Checklists are a really good way to get your Resources to perform tasks that are either common to your process, address compliance issues or simply record that the right tasks are done at the appropriate time.
Learn about how Maica uses Invoices within the overall solution.
An Invoice is the financial record capturing the delivered services required to be billed. This includes several Invoice Line Items, one for each delivered service across a billing period which essentially dictates how long an Invoice is open for before being finalised.
The prupose of Invoices is to ensure Maica captures all financial obligations to a Participant's . This primarily records what needs to be billed, using a number of funding structures, and also reduces the available funding on a .
Invoices are primarily used within Maica's billing logic where records are created based on completed or . Similar to , Invoices are largely a backend record and mostly managed by Maica's automation.
Invoices are an essential component in the billing execution logic and typcially require no manual intervention. Solution administrators may manage these records if required but this would be unusual.
Learn about the underlying Salesforce platform that Maica has been developed on.
Maica has been developed on the Salesforce platform so becoming familiar with this technology will be essential to understanding Maica. We have summarised the key learnings, functions, and features ot be award of so everything is in a single easy-to-access place for you.
Salesforce is a powerful cloud-based platform that helps businesses manage their relationships with customers. It offers tools and applications for sales, customer service, marketing, and more, all in one place. Think of Salesforce as a digital assistant that organizes and tracks interactions with customers, whether it’s through emails, phone calls, or social media. This helps businesses understand their customers better, provide better service, and ultimately grow their business. Because it’s cloud-based, all of this can be accessed from anywhere with an internet connection, making it incredibly versatile and convenient for companies of all sizes.
Salesforce Person Accounts is a feature designed to help businesses manage relationships with individual customers, not just companies. In simple terms, think of it as a way to store and organize all the information about a person, like their contact details, preferences, and interactions, in one place.
Normally, Salesforce separates people (Contacts) and companies (Accounts) into different records, but Person Accounts combine these two into one. This makes it easier for businesses to handle all the information about a person, whether they’re interacting as an individual or on behalf of a company.
It’s particularly useful for industries like healthcare, retail or financial services, where customer relationships often revolve around individuals rather than businesses.
You can learn more about Salesforce's Person Account architecture .
In Salesforce, data is organised into structures called “objects,” which are similar to tables in a database. There are two main types of objects: Standard Objects and Custom Objects. Standard Objects are built-in features of Salesforce, like Accounts, Contacts, Leads, and Opportunities. These represent common business data and come with predefined fields. For instance, the Account object might include fields for the company’s name, industry, and contact information. Custom Objects, on the other hand, are created by users to store information specific to their business needs. For example, a company might create a Custom Object to track employee training or project details.
Each object consists of “fields,” which are like columns in a table. Fields hold the data for individual entries, called “records.” For instance, in the Contact object, you might find fields for First Name, Last Name, Email, and Phone Number. Salesforce allows users to customize these fields or create new ones to capture specific information. Fields can also have different types, such as text, date, number, or picklist (a dropdown menu with predefined options). This architecture is flexible, allowing businesses to tailor Salesforce to fit their unique data requirements and ensure that the system aligns with their specific workflows and processes.
Navigating Salesforce is designed to be user-friendly, with a focus on helping users quickly access the information they need. At the core of this navigation are “Apps,” which are collections of objects, tabs, and other functionalities tailored to specific business processes. For example, the Sales app might include objects like Accounts, Contacts, Opportunities, and Leads, while the Service app could focus on Cases and Knowledge articles. Users can switch between apps using the App Launcher, usually found in the top left corner, which provides a dropdown menu to select from the available apps. This setup helps users stay organized and focused on their specific roles and tasks.
Within each app, data is presented in “List Views” and “Detail Pages.” List Views display records in a table format, making it easy to see multiple entries at once. These views can be customized to show specific fields and filters, allowing users to quickly find the records that are most relevant to them. For instance, a sales rep might use a List View to see all open Opportunities sorted by closing date. Clicking on a record in a List View takes the user to the Detail Page for that record, where they can see all the associated information and related lists, such as activities, attachments, and notes. The Detail Page is a comprehensive view of a single record, providing all the details in one place.
Description and Outcome – summarises key details and final actions taken.
Pre-Appointment Check In
Greet Participant
Before
COVID Test
Before
Complete Assessment
After
A Service Agreement is a critical concept in Maica as this forms the financial structure under which services are delivered (via Appointments). Any Participant receiving services must have a valid Service Agreement in place; this means the Service Agreement dates must fall within the date of the service and the relevant funding items must be present.
An Appointment Service is a critical concept in Maica as this forms the structure under which services (via Appointments) are delivered and then billed. An Appointment Service groups a set of related Support Items (by Service Day, Service Time and Support Category) which Maica then uses for billing.
An Appointment is the primary process by which Maica allows you to deliver direct services to Participants. Appointments capture information on Participants, Resources, Appointment Services, and many other elements to bring together the delivery of direct services.
A Shift is the primary process by which Maica allows you to roster Resources for certain times at certain locations. This includes the ability to generate recurring rosters across various time periods. Shifts capture information on Resources, Shift Services, Location, and many other elements to bring together the rostering of your care team.
A Delivery Activity is the key output of a delivered service (via Appointments); this record links the service delivery to the billing engine with references to the Service Agreement and Invoices. This can be considered an adminstrative record but an important concept to understand.
A Checklist consists of a number of Checklist Items that can be assigned to either Appointments or Shifts and shown to the end user either before, during, or after an Appointment or Shift for completion.
An Invoice represents the billing process used by Maica for various funding structures, including the NDIS and Aged Care. Invoices are automatically generated by the Maica billing engine based on Service Agreement, Appointments, and Delivery Activities.
A Support Item is the product (or service) being delivered to a Participant, such as a physiotherapy massage or a wheelchair. Anything that is to be billed under a Participant's Service Agreement will be managed as a Support Item by Maica.


Appointments and Shifts: After the service agreement is in place, Appointments and/or Shifts are scheduled. Each appointment is connected to resources (people, services, etc.) and is linked to the timesheets and staff availability, as seen by the connection to Resources and Skill(s).
Timesheets and Resource Management: When an appointment happens, Timesheets are generated, which capture the time spent by staff or resources in delivering the service. These timesheets are important for payroll and resource allocation and are linked to the Human Resource Management system.
Invoices and Claims: Once services are delivered, an Invoice is generated. The diagram shows how different claims (such as NDIS Claims, Aged Care Claims, or Plan Manager submissions) impact this process. This is also linked to determining the Invoice Funding Type, meaning where the payment for the service is coming from.
Finance and Payroll: The invoice information is synchronised with the Finance Management system and other external systems like Payroll & Award Integration for processing payments. Additionally, HR Management is updated with availability and skills information to allocate resources efficiently.

Learn about the things to look for when first getting started with Maica.
So you have installed Maica or logging into Maica for the first time...exciting!
We thought we would share the most common initial tasks when first starting on Maica to set up what you need and ensure it works the way you want it to. The list below is a really good starting point.
Maica pre-loads the required reference data into your solution during the installation process. This includes data such as , Support Categories, Reference Groups, and Price List Entries. These will serve as the foundation of your services whether this is NDIS or Aged Care.
In cases where you wish to amend or change the default reference data, this can be loaded using this .
When installing Maica for the first time, a bunch of are pre-configured for you, including the way the looks and behaves, are managed and are allocated to your teams. There are many settings beyond this though that determine how Maica will behave, including:
We would encourage you to go through all of Maica's settings to make sure they are configured in a way relevant to you.
Once you are satisfied that your reference data is in place and the settings are configured to your liking, another important concept becomes relevant. As Maica is built on top of the Salesforce platform, the solution offers you a large number of to control what users are able to do (and not do) in the system.
Once you are ready to start scheduling and delivering services, either via Appointments or Shifts, you will need to set up your . These essentially function as the basis of what is being delivered and how this delivery is being billed for using Maica's billing automation.
The concept of a in Maica is quite important as this is the person delivering the service to your participants. These can be either human, such as care workers, or non-human, such as cars and rooms.
Maica offers a number of native integrations, such as , , , and the . The connection to the NDIS APIs must be done via an accredited aggregator and will facilitate and manage this integration for all Maica clients. If you would like to use the automated travel features and maps integrations, then Maica requires a key to be configured. You will also find guides to configure the integration with Xero and Stipe in our knowledge base.
Learn about how Maica uses Appointment Services within the overall solution.
An Appointment Service is an absolutely critical concept in Maica as this serves as the basis for creating a family of related Support Items for the purposes of billing. An Appointment Service captures all Support Items that essentially deliver the same service but at different times and days, so the billing engine can determine which specific Support Item to bill against. A typical example of an Appointment Service might be:
The purpose of Appointment Services, and by far the most significant advantage, is to abstract the need for the end user (or ) to select a specific at the time of managing the or . The best way to describe this is via an example...let's take the above Appointment Service. If an or is delivering this service, there is a potential difference in cost for the Participant if this service is delivered in the morning versus the evening, via specific for either time.
As the Resource managing the or though, we don't believe the selection of this specific should be required and the configuration of the Appointment Service abstracts this selection. The simply selects Therapy Services as the Appointment Service without needing to be concerned about when the service is being delivered.
Appointment Services are used throughout the delivery of services within Maica. They are particularly important when managing as this will determine what is being delivered to your . Appointment Services are also utilised in the following features:
We totally appreciate that the concept of Appointment Services might be a little difficult to understand at first but, ultimately, they are designed to make life easier and abstract your care team from additional administration overhead during the management of or .
Learn about how Maica uses Support Items within the overall solution.
A Support Item is used to define a distinct service or product being delivered to a Participant, such as an occupational therapy session or wheelchair. Support Items capture information about the service itself as well as the service day (weekday, Saturday, Sunday, etc) , service time (morning, afternoon, etc), and many other attributes to define what a service is and how it is delivered.
A typical example of a Support Item might be:
The purpose of Support Items is to define the service being delivered as well as capture them in the for a . A number of funding strutures may use Support Item differently, for example, in the NDIS, Support Items are billed differently depending on when a service is delivered. In this case, it would be useful to have mutliple Support Items for each time (such as morning or afternoon) and associate these with the appropriate .
Support Items are used widely within Maica, including in the management of , , and . These records bring together the funding captured under a with the being delivered within an or .
An important field to call out here is the Item Number Override, specifically added for Support at Home.
The Item Number Override field allows you to define your own Support Item Numbers for Support at Home Products/Support Items when variations or custom pricing are required. This addresses scenarios where the standard Services Australia Product catalogue does not support specific pricing or item definitions.
Please refer to the field details in the table below:
Products or Support Items with an override item number can be included in:
Price Books
Service Agreements
Budget Planning and Claims Processes
Please note: It is not advised to populate the Item Number Override field for NDIS Products and Services.
This field is intended specifically for Support at Home use cases where flexibility is needed for pricing or categorisation.
Support Items are the backbone of setting up your services, particularly via . We would typically expect a Maica solution to have potentially hundreds of Support Items to distinguish between each service. There is absolutely no issue with having many Support Items in your catalogue.
Learn about adding Files to a new Billable Participant Note
To begin attaching a file, simply click the Upload Files button at the bottom of the screen to bring up the dialogue box. Once selected, you can attach files to your Participant Note. This includes the ability to take a photo, attach a PDF file, or upload any other allowed file type.
On a mobile device, this will also feature the option to take a photo while uploading the file.
As this is the last stage, once you have attached all your required Files simply click the Save & Close button to complete your Billable Participant Note.
After you create a Billable Participant Note, Maica will have created both an and a Participant Note. The Note will be stored against the Participant and can be viewed in the , whilst the Appointment will be automatically assigned a Complete status and used within Maica for Billing.
Learn about Maica in a structured and sequenced way to maximise your journey.
Maica is a powerful healthcare management application and learning how it all works and fits together can be a daunting task. We have developed our knowledge base to help you with this journey and have below outlined the best way we believe you should go about learning all about Maica and Salesforce.
Learn about Billable Participant Notes in Maica
A Billable Participant Note is a documented interaction provided to a participant that is eligible for billing. For example, a of yours may deliver a over the phone and record and document the call as a Note. As a was delivered, this may be considered billable under the .
After you create a Billable Participant Note, Maica will have created both an and a Participant Note. The Note will be stored against the Participant and can be viewed in the , whilst the Appointment will be automatically assigned a Complete
Learn how to Order your information on the Planner
On the Planner, you can order your information in order to make it easier to locate or prioritise data. For example, in , you can order Resource(s) by Age Group, which improves visibility and planning efficiency.
To begin, simply begin by clicking the Order By button, as shown below.
Learn about Custom Fields for a new Billable Participant Note
The Custom Fields tab captures any information from Custom Fields that have been added to your Organisations profile beyond what Maica offers. This stage functions the same way it does within an .
Where this is the case, and the custom fields have been configured, this stage will present all configured custom fields using the input relevant to their data type. This includes the ability to select pick lists, dates, lookups, and other options based on the configuration of your own Custom Fields.
If no Custom Fields have been configured, this stage of the process will not show and you will be directed straight to the Add Tasks
Learn about Attaching Files to an Appointment
To begin attaching a file, simply open an and then click the Files button at the bottom of the screen to bring up the dialogue box. Once selected, you can attach files to an . This includes the ability to take a photo, attach a PDF file, or upload any other allowed file type.
Learn how to record Participant Signatures for an Appointment
To begin recording a Participant(s) signature, simply open an and then click the Signature button at the bottom of the screen to bring up the dialogue box. Once selected, you can record signatures against an . On a desktop, you do so by manually moving the mouse in the display box, whilst on mobile this will include the ability to simply write on the screen.
If you have multiple in a single , you must choose which the signature applies to. All within the will display in the dropdown list highlighted below.
Learn how to create a new Billable Participant Note from the Planner Quick Action
Therapy Services
Occupational Therapy
Weekday
Morning
Occupational Therapy
Saturday
Morning
Occupational Therapy
Sunday
Morning
Occupational Therapy
Anytime
Anytime
The Item Number Override field enables Providers to enter a custom item number that best suits these use cases.
Item Number Override
Product / Support Item
Text
Defines a custom Support Item Number for Support at Home products. Can be used when the default Services Australia item number is not sufficient.
Therapy Services
Weekday
Morning
Hours
Wheelchair
Anytime
Anytime
Unit
Support Coordination
Saturday
Anytime
Hours
There are multiple ways to create Billable Note(s) within Maica, these include:
Directly from the Planner
Through the Maica Quick Actions
A new Billable Participant Note includes the completion of multiple stages before it can be confirmed, below is a list of these stages:
To dive deeper into each stage, please visit the specific pages for detailed information on every stage.
This function is only available in Timeline Mode.
Once selected, the custom Filter By Field Selector module will display, as shown below.
It is here you can select which field you wish to organise your information by.
After selecting a field, click Select to finalise. Below, I have chosen to Order my Resources by Age Group.

Where this is the case, and the custom fields have been configured, this stage will present all configured custom fields using the input relevant to their data type. This includes the ability to select picklists, dates, lookups, and other options based on the configuration of your own Custom Fields.
If no Custom Fields have been configured, this stage of the Appointment creation process will not show and you will be directed straight to the Summary stage.
On a mobile device, this will also feature the option to take a photo while uploading the file, as illustrated below.

Simply begin by clicking the New Billable Participant Note button, as shown below.
Once done, the New Billable Participant Note module will display.
Once the module is displayed, please complete your Note by following the instructions described here.
Learn how to create a new Appointment or Shift from the Planner Quick Action
There are multiple ways to create a new Appointment or Shift from the Planner, this article will show you how to use the Quick Action.
Simply begin by clicking the + button, as shown below.
Once done, either the New Appointment or New Shift module will display. Maica determines which module to display based on what you are in. Please refer to the table below to see which opens which module:
Once the applicable module has been shown, create your Appointment or Shift by following the same steps detailed .
Learn about the Planner within Maica
In Maica, the Planner is the primary location for Rostering and Scheduling. It is a versatile tool that is the recommended location to create, manage, edit and view your Appointments and Shifts, as well as manage Unavailability. The Planner is at the core of powering the Maica lifecycle.
The Planner offers multiple and , and includes key such as Managing Unavailability and Appointment Optimisation. The Planner also offers the ability for you to apply to refine and customise your view.
For further information on the Planner functions, please click here:
The Appearance Guide button is located at the bottom of the Planner, indicated by an arrow button, as shown below.
Simply clicking the arrow button reveals a legend that outlines the colours and indicators used within the Planner to represent different Appointment statuses and types, as shown below.
This guide will help you quickly determine the type and status of each appointment at a glance, right from the Planner.
To help users understand how Appointment times are displayed, the Planner now includes a Timezone Indicator, as shown below.
The globe icon indicator shows the current browser timezone (e.g. Melbourne).
Hovering over the icon reveals a tooltip: "Your current Time Zone."
This helps you know whether the times shown in the Planner are adjusted to your own timezone or reflect a target timezone set on the Appointment.
This is especially useful for distributed teams working across multiple time zones, ensuring everyone understands the context of time-based views.
Learn how to Create a New Billable Participant Note from the Global Actions Menu
To begin creating a new Note from the Maica Actions menu, simply click the New Billable Participant Note option and you will be presented with the pop-up to begin populating your Note.
Similar to creating a new Billable Participant Note from the Planner, after the pop-up is presented, a few stages must be completed before the Note can be confirmed.
When creating a Billable Participant Note from the Maica Actions menu, the Date & Time will be pre-populated. Maica will pre-populate this field to the current Date & Time of the action selected, and will automatically set the duration to 15 minutes. This can be changed manually in the stage of the creation.
Learn about the Planner Filter
The Planner Filter in Maica is a tool that allows users to refine and customise the information displayed on the Planner. By selecting specific criteria, you can narrow down the view to focus on relevant information and data. The Planner Filter ensures that users can efficiently manage and organise Appointments, Shifts, Resources, and Participants based on the selected filters.
The Planner Filter is located on the far left hand side of the Planner menu, as shown below:
Once you have selected the Filter, Maica offers two filtering options. These are:
For further in-depth information on each filtering option, please refer to the associated page.
When a Filter of any type is applied in the Planner, whether it's a Basic or Advanced filter, the filter icon circled above will turn Yellow.
This provides a visual cue that a filter is currently active. To reset the view, simply click the filter icon and clear the selected filters.
If the Filter is open but nothing has been applied, it will appear Green.
Learn about the Participant View in Maica
The Participant View is organised by Participants. In Calendar Mode, it shows all Appointment and Shift related Planner information, and in Timeline Mode it organises all Appointments and Shifts by associated Participants.
On Calendar Mode, Participant View will display your Planner with the above information within a grid based on the days and hours of the .
On Timeline Mode, Participant View will organise your Planner by Participant(s). This will display all of the Participant(s) that have Appointments populated on the left , and all of their associated Appointments on the right.
When you make an Appointment from Timeline Mode in Participant View, the Appointment will be pre-populated with the Participant of the row on which you created it.
Learn about Appointment Breaks
To begin recording an Appointment Break, simply open an Appointment and then click the Manage Appointment Breaks button at the bottom of the screen to bring up the dialogue box.
Once selected, you can create a new break by selecting the + New button on the right hand side of the screen, as shown below.
Once you have added a new Appointment Break, you will be prompted to populate a number of fields detailing the break. Here, you can assign the relevant Date & Time information, the relevant Resource(s), the break category and write custom notes.
Within an Appointment Break, you can choose to create a corresponding . You do so by simply clicking the toggle, as shown below.
If the is created, it must be assigned a Timesheet Activity.
Learn about the Asset View in Maica
The Asset View is organised by Assets. In Calendar Mode, it shows all Appointment and Shift related Planner information, and in Timeline Mode it organises all Appointments and Shifts by associated Assets.
On Calendar Mode, Asset View will display your Planner with the above information within a grid based on the days and hours of the , as shown below.
On Timeline Mode, Asset View will organise your Planner by Asset(s). This will display all of the Asset(s) that are assigned to Appointments and Shifts populated on the left , and all of their associated Appointments and Shifts on the right.
When you make an Appointment from Timeline Mode in Asset View, the Appointment will be pre-populated with the Asset of the row on which you created it.
Learn about the Agenda View in Maica
The Agenda View displays your Planner information in a list format, grouped by day. Instead of showing events on a grid, it provides a sequential agenda of Appointments, making it easy to quickly review what is scheduled for each day.
Agenda Mode only displays Appointments, in order to see Shifts, please use , or Views.
Please note, in Agenda View there is no toggle between Calendar or Timeline Mode, it is simply Agenda Mode.
In Agenda Mode, your Planner information will be displayed within a scrolling list organised by date. Each day expands to show all of its associated Appointments and Shifts, with details such as:
Time of the Appointment or Shift
Participant(s) allocated (if applicable)
Location recorded on the Appointment
Please note, drag & drop functionality will be locked when the Planner is in Agenda View.
When you create or edit an Appointment in Agenda Mode, it will automatically appear in the correct chronological order for the day.
Learn how to Create a New Shift from the Global Actions Menu
To begin creating a new Shifts from the Maica Actions menu, simply click the New Shift option and you will be presented with the New Shift pop-up.
Similar to creating a new Shifts from the Planner, after the pop-up is presented, a few stages must be completed before the Shifts can be confirmed.
When creating an from the Maica Actions menu, the Date & Time will be pre-populated. Maica will pre-populate this field to the current Date & Time of the action selected, and will automatically set the duration to 60 minutes. This can be changed manually in the stage of the creation.
Learn how to Group your information on the Planner
On the Planner, you can group your information in order to make it easier to visualise related items together. For example, in Shift View, you can order Shifts(s) by Location, which improves organisational clarity and planning.
To begin, simply begin by clicking the Group By button, as shown below.
Once selected, the custom Group By Field Selector module will display, as shown below.
It is here you can select which field you wish to organise your information by.
After selecting a field, click Select to finalise. Below, I have chosen to Group my Shifts by Location.
Learn how to Synchronise Participant Information with the NDIS in Maica
Synchronise Participant Information Quick Action?The Synchronise Participant Information Quick Action in Maica allows you to connect with the PRODA/NDIS systems to retrieve key Participant data such as Plan Records, Plan Budgets, Plan Goals, and Service Bookings from the PRODA.
Essentially, it will generate a Funding Record for your Participant with the relevant and selected data directly from the NDIS/PRODA.
Synchronise Participant Information Quick Action?The Synchronise Participant Information Quick Action in Maica is located in the top right corner of your interface on the Participant Record, as shown below.
The Quick Action will retrieve the following information from PRODA for your Participants:
Plan and Plan Budgets
Plan Goals as recorded on the Participant's Plan with the NDIS
Service Bookings and Booking Items
Synchronise Participant Information Quick Action?To begin Syncing Data for your Participant, simply click the Synchronise Participant Information Quick Action to display the following pop-up:
Maica needs certain information about the Participant in order to retrieve the information from the NDIS systems, including Last Name, Date of Birth, and NDIS Number. This needs to be populated in the before the Sync can be successful.
Here, you can nominate which Data you wish to Sync with Maica, including:
Plan Budgets: These are retrieved from the NDIS Plan the Participant has set up with the agency.
Plan Goals: These are retrieved from the NDIS Goals the Participant has set up with the agency.
Service Bookings: This will retrieve all associated (and available) Service Bookings for the Participant.
Once you have selected which Data you wish to Sync, click Confirm and Maica will connect directly to the NDIS to retrieve the following information. Once done, you will see the following Summary screen.
At this stage, you can close the pop-up and your Data in Maica will updated accordingly.
Learn about the Shift View in Maica
The Shift View is an overview of all Shift information.
On Calendar Mode, Shift View will display your Planner with the above information within a grid based on the days and hours of the .
On Timeline Mode, Roster View will organise your Planner by Shift(s). This will display all of the Shifts(s) in chronological order.
Similar to , If you use the Group By Planner Action, Maica will show helpful indicators on your Planner to inform you of how many unique Shifts(s) you have at any given time, as shown above.
In addition, a few useful interaction features are available on the Shift cell in Timeline Mode on Shift View. These are:
Learn how to Create a New Appointment from the Global Actions Menu
To begin creating a new Appointments from the Maica Actions menu, simply click the New Appointment option and you will be presented with the New Appointment pop-up.
Similar to creating a new Appointment from the Planner, after the pop-up is presented, a few stages must be completed before the Appointment can be confirmed.
When creating an from the Maica Actions menu, the Date & Time will be pre-populated. Maica will pre-populate this field to the current Date & Time of the action selected, and will automatically set the duration to 60 minutes. This can be changed manually in the stage of the creation.
Learn how to Create a New Timesheet Entry from the Global Actions Menu
To begin creating a new Timesheet Entry from the Maica Actions menu, simply click the New Timesheet Entry option and you will be presented with the pop-up to begin populating your Entry.
Similar to creating a new Billable Participant Note from the Planner, after the pop-up is presented, a few stages must be completed before the Note can be confirmed.
When creating a Timesheet Entry from the Maica Actions menu, the Date & Time will be pre-populated. Maica will pre-populate this field to the current Date & Time of the action selected, and will automatically set the Entry duration to 60 minutes. This can be changed manually during the creation.
Learn how to get directions on Google Maps directly from your Appointment Profile
The Google Maps action opens the directions to the Appointment from a number of selectable starting points in Google Maps, directly from the Appointment.
To begin using the Google Maps Action, first open up the Appointment, then simply select the Google Maps button in the top right hand corner of the interface, as shown below.
After clicking the Google Maps button, a dropdown menu will appear, allowing you to select a location from which to receive directions. There are the following options:
Home Address
Primary Location
Current Location
Following a selection of Location, a new tab will open in Google Maps with directions to your Appointment from your selected Location.
Learn about Service Bookings and how they are managed in Maica
The NDIS defines a Service Booking as the following:
Service Bookings are used to set aside funding for an NDIS registered provider for a support they will deliver.
Essentially, it is an agreement between an NDIS participant and a registered service provider that allocates a specific portion of the participant's NDIS funding for certain services. Service bookings are used to reserve funding for services that the participant plans to receive under their NDIS plan.
Learn how Maica manages Funding from the NDIS
In Maica, Funding for NDIS Participants is managed through Quick Actions located on the Contact Record. These are further explained in more detail .
However, before diving into the Quick Actions, please review the Key Terms that should be noted when using Maica's Funding operations.
This article shows you how to send a Participant a list of their upcoming appointments using the Upcoming Appointments Quick Action available on the Contact record.
Maica allows authorised users to send Participants a list of their upcoming appointments directly via email. This is achieved using a configured Lightning Email Template and a streamlined Quick Action accessible from the Contact record
Upcoming Appointments refer to scheduled sessions or services linked to a Participant that are due to occur within a specified date range. These can include therapy sessions, consultations, or any other service activities recorded in Maica.
Learn about Global Actions in Maica
Learn about Checklists within an Appointment
Discover how to specify the Shift location
Learn about the Appointment Profile Record in Maica
To open an Appointment Profile, simply open an and then click the External Link button located in the top right corner of the screen to bring up the profile, as shown below.
Once clicked, you will be directed to a new Salesforce tab showing you the Appointment Profile. Here, you will see a summary of the including any , , Files and more.
You can also open an Appointment Profile directly from the
Learn how to record Appointment Expenses
To begin recording an Appointment Expense, simply open an Appointment and then click the Manage Appointment Expenses button at the bottom of the screen to bring up the dialogue box.
Once selected, you can create a new Expense by selecting the + button on the right hand side of the screen, as shown below.
This allows for the selection of relevant organisational Checklist(s) based on the tasks to be performed during the Appointment. Maica will automatically assign Checklist(s) to your Appointment that are associated with the selected Appointment Service(s)
This allows for the ability to assign your Appointment to a Shift(s). Maica will automatically assign Shift(s) that occur at the same Location as the new appointment, as well as the same Date & Time. If no Shift(s) are active during the Appointment, this section will not be automatically assigned. however you can then manually assign Shift(s).
Appointment Type
The Appointment Type is a pick list allowing for the selection of the appropriate type of Appointment being created. This enables the selection of the following values: Booking, Group Booking, On-Site, Event, Consultation
Appointment Status
The Appointment Status is a pick list allowing for the selection of the appropriate status of Appointment being created. This enables the selection of the following values: Scheduled, Planned Completed.
Maica uses a number of key terms which are important in helping you understand how the solution manages NDIS Participant Funding. In Maica, the term Funding is used to represent the term Plan used by the NDIS. These terms are explained in the table below:
Funding Record
Represents the specific details of a Participants Plan from their associated Funding body. For NDIS Participants, these are the specific details of a Participant's Plan retrieved from the NDIA.
Funding Item
The specific Budget Items or Funded Supports included in a Participant's Plan.
Funding Goal
Used to capture Goals defined as part of a Participant's Plan, i.e. Improving Daily Living Skills
Now, to begin managing your NDIS Participants Funding, you should use the Quick Actions on the Contact Record. Maica's Contact Records have unique actions to help you manage crucial pieces of information for your NDIS Participants. To learn more about the these actions, see below.
The Synchronise Participant Information Quick Action in Maica allows you to connect with the PRODA/NDIS systems to retrieve key Participant data such as Plan Records, Plan Budgets, Plan Goals, and Service Bookings from the NDIS which will be used to populate your Participants Funding Record in Maica.
To learn more about the Synchronise Participant Information Quick Action, click here.
The Create Service Booking Quick Action in Maica allows you to create Service Bookings for your Participants that will Sync directly with the NDIS. This Action sits within the Funding Record.
The Create Service Booking Quick Action helps ensure that the allocated funds and service details are accurately reflected in both Maica and the NDIS system.
To learn more about the Create Service Booking Quick Action, click here.
During or Either. Any other Checklist Item(s) will be shown at either the Check-In or Check-Out stage. For each Checklist Item, if so configured in the Checklist, you are prompted to provide further information to manage possible outcomes of Checklist Items in the form of a Note. You access this Note by simply clicking on each Checklist Item.
New Appointment
New Appointment
New Appointment
New Appointment
New Shift
New Shift





Shift Fill
This Tooltip shows how many Resource(s) are assigned to each Shift based on the required number of Resource(s) to fill the Shift.
Unfilled Row
This row shows all unfilled Shift(s) in one location for ease of access to populate any unfilled Shift(s).














1
Next/Previous
The next and previous arrows allow you to navigate to the previous or next date range based on the selected period. Eg, if your period is selected to month, the next button will take you to the next month.
2
Select Date
Clicking on the calendar icon opens a date picker, allowing you to manually select a specific date or date range (depending on the selected period) to display in the planner.
3
Today
The Today button quickly returns your view to the current date, no matter where you are in the planner.

If you're looking for detailed information about Service Bookings and their importance in the NDIS, refer to the Service Booking resources published by the NDIS here.
In the upcoming PACE system rollout from the NDIS, Service Bookings are being phased out to offer participants greater flexibility with their NDIS funds. Hence, this section will only be relevant for your non-PACE Participants.
In Maica, you can find the following information and functionality on a Service Booking Record:
Budget Information (Funding Information)
Service Booking Period Information (Start Date & End Date)
Service Booking Progress Information (Period and Funding Utilisation )
NDIA Synchronisation Information (NDIS Reference & Last Sync Date)
Booking Items (where the actual details of the funded supports are defined)
When it comes to the Status of a Service Booking, we have used the same Service Booking Status variables seen in PRODA and simply replicated them in Maica. This ensures familiar terminology and consistency across Service Booking records in PRODA and Maica. Please refer to the table below to view the status values and their related API names.
In Process
INPR
Awaiting Participant Approval
APAP
Awaiting Provider Approval
APRO
Change Awaiting Participant
APAC
Change Awaiting Provider
APRC
Rejected
REJT
In Maica, you can create Service Bookings through the Create Service Booking Quick Action located on the Funding Record.
The Create Service Booking Quick Action in Maica allows you to create Service Bookings for your Participants that will Sync directly with the NDIS.
To learn more about the Create Service Booking Quick Action, click here.
Open the Participant’s Contact record in Maica.
In the top-right corner of the record, click the Upcoming Appointments Quick Action.
In the pop-up modal, begin by entering a Start Date and End Date.
Select the Status
You can further narrow down the list of appointments by applying any of the following filters:
Appointment Service
Resource
Location
Once all filters are set:
Click Generate.
Maica will create an email using your organisation’s Upcoming Appointments template.
The list of matching appointments will be included directly in the body of the email.
To begin adding tasks for your Participant Note(s), simply click the the + button in the top right corner of the screen.
Once a new Participant Note Task has been created, you will be prompted to populate a number of customisable fields, including assigning your task to the required personnel.
You can open the text input box by clicking the arrow on the far right hand side of the screen, as shown below.
This will allow you to add custom comments to your task, as shown below.
Once you have populated your task, click the Blue Tick to save it and add it your Billable Participant Note.
If you are presented with the below error when clicking the Save & Next button and hence trying to proceed to the next stage of creating your Billable Participant Note, it means you have not properly saved a created Task.
In order to resolve this, simply ensure the Blue Tick in the top right hand corner of your interface (as shown above) has been clicked on all Tasks. This makes sure they are properly saved and allows you to proceed to the Files stage.
To get started, you can find the Global Actions menu, which is represented by a + icon, in the top right corner of your interface. As shown below.
Simply click on this icon to open the dropdown menu, which will display all available actions.
The Maica Actions are custom actions specifically designed for Maica, whilst the other actions available in the Global Actions dropdown are standard Salesforce actions available by default in any Salesforce organisation.
Select Maica Actions to open the submenu in the bottom right corner of your screen. This will remain accessible until you close it, regardless of the screen you navigate to within Maica. As shown below:
Shifts and Shifts with allocated Resource(s), as well as showing only Resource(s) with Shifts in Timeline Mode. To learn more, click here. On Calendar Mode, Roster View will display your Planner with the above information within a grid based on the days and hours of the selected period.
On Timeline Mode, Roster View will organise your Planner by Resource(s). This will display all of the Resource(s) that have Shifts populated on the left , and all of their associated Shifts and Unavailability on the right.
When you make a Shift from Timeline Mode in Roster View, the Appointment will be pre-populated with the Resource of the row on which you created it.
If you use the Group By Planner Action, Maica will show helpful indicators on your Planner to inform you of how many unique Shifts(s) you have at any given time, as shown below.
Here, we have have grouped by Location, and Maica is showing us that during the three time slots we have 1 unique Shift.
The colours of the numbers indicate the filled status of the Shift(s), as per below:
Green: Shifts filled with the required number of Resource(s).
Yellow: Shifts partially filled with the required number of Resource(s).
Red: Shifts not filled with the any Resource(s).
LocationAccomodationLocationIn Calendar Mode, Accomodation View shows all Appointment related Planner information, and in Timeline Mode it organises all Appointments by associated Accomodations.
On Calendar Mode, Asset View will display your Planner with the above information within a grid based on the days and hours of the selected period.
On Timeline Mode, Accomodation View will organise your Planner by Accomodation(s). This will display all of the Accomodation(s) that are assigned to Appointments on the left , and all of their associated Appointments on the right.
When you make an Appointment from Timeline Mode in Accomodation View, the Appointment will be pre-populated with the Accomodation of the row on which you created it.
If the Group By Planner Action is in use, Maica will show helpful indicators on your Planner to inform you of how many unique Appointment(s) you have at any given time, as shown above by the Green 1. To learn more about these indicators, click here.
When creating a Shift, Maica automatically assigns a Time Zone using the current user’s browser location (e.g. Melbourne).
Once a Location is selected, Maica checks if that Location is in a different timezone. If it is, you'll be prompted to update the Shift's timezone to match the Location.
By default, the Time Zone is set to match the current user's browser (e.g. Australia/Sydney).
If a Location is selected:
Maica uses Google’s Time Zone API to detect the correct timezone based on its address.
If the Location’s timezone differs from the one already assigned, a confirmation modal appears, allowing you to confirm or override the update.
If no Location is selected, the Time Zone can still be selected manually from the picklist.
In order for Maica to successfully detect and change Timezones, a Google API Key must be properly set up in the Maps Management Settings. To learn how to set up your API Key, .
The Start and End Times are saved using the Shift's selected timezone.
Other users will see the Shift adjusted to their own local timezone when viewing it (e.g. in the Planner, Quick Info, or record view).
A world icon appears in the Planner showing the viewer's browser timezone with helpful tooltip context. To learn more, click here.
For edge cases (e.g. border towns or cross-timezone Shifts), you can manually override the timezone selection.
Example
Outcome
User creates an Shift for 9:00 AM in Perth
✅ Shift shows as 9:00 AM in Perth time, but 11:00 AM for users in Sydney.
A border Location causes conflicting timezone logic
✅ User is shown a confirmation modal and can override the timezone if needed.
A user views an Shift created in a different zone
✅ Maica shows the time adjusted to the viewer’s local timezone (e.g. Planner, Quick Info).
Location is updated post-save
✅ System re-evaluates and prompts to apply new timezone via modal.
Expand Profile button located in the bottom right corner of any If an Appointment has the status Completed, you will be able to manually generate an Invoice for this Appointment in the Appointment Profile. To begin, simply click the Generate Invoice button located in the top right corner of the Appointment Profile, as shown below.
Once the Generate Invoice button has been clicked, Maica will display a summary of the Invoice to be generated. For each Participant, Maica will show you Invoice Line Items with information on the Claim Type, Quantity, Rate and Total Cost of each item. You will also be able to see if the Item exceeds the current remaining budget of the Participant(s) Service Agreement, as shown below.

Once you have created a new Appointment Expense, you will be prompted to populate a number of fields detailing the break. Here, you can assign the relevant Date Information, the relevant Resource, the expense amount and write custom notes.
After you have populated the Expense fields, simply click the blue tick in the top right corner to finalise the expense.
After you have completed and saved an expense, you can add any relevant files to the record. To do so, scroll to any saved expense and select the Attach Files button, as shown below.








Learn about the Planner Actions within Maica
Planner actions refer to actions and tasks possible through the Planner. There are several actions you can take within the Planner in Maica, including the following:
To dive deeper into each Action, please visit the specific pages for detailed information on every Action.
Learn about taking Participant Notes within an Appointment
To begin recording a Participant Note(s), simply open an Appointment and then click the Notes button at the bottom of the screen to bring up the dialogue box.
Once selected, you can create a new note by selecting the + button in the top right corner of the screen, as shown below.
Once a new Participant Note has been created, you will be prompted to populate a number of customisable fields.
This will open up the text input box for custom Note(s). Here, you can also add a Note Template, by clicking the button shown below.
Click the Blue Tick in the upper corner to save your letter after you have filled in the required fields and entered your Note.
Use the "Create Note for All Participants"checkbox to create the same note for all Participants in the Appointment (except those with cancelled Delivery Activities). When selected, the Participant field is disabled, and a separate note is automatically created for each Participant. Each note appears in the modal after saving and can be edited individually.
Once you have create a Participant Note(s), additional actions will become available. These actions are detailed below.
To begin attaching a file, simply click the Files button at the top right corner of the Participant Note to bring up the dialogue box. Once selected, you can attach files to the Note. This includes the ability to take a photo, attach a PDF file, or upload any other allowed file type. On a mobile device, this will also feature the option to take a photo while uploading the file.
To begin managing tasks for your Participant Note(s), simply click the Manage Tasks button at the top right corner of the Participant Note to bring up the dialogue box. Once selected, you can create a new task by selecting the + button in the top right corner of the screen.
Once a new Participant Note Task has been created, you will be prompted to populate a number of customisable fields, including assigning your task to the required personnel.
Similar to recording a new , you can open the text input box by clicking the arrow on the far right hand side of the screen, as shown below.
This will allow you to add custom comments to your task, as shown below.
Please note: The Participant Note Section has been removed from the / (and ) flows due to issues determining the assignment of the Participant Note record while completing Appointments with multiple Participants.
Participant Notes can still be created at any stage in the Appointment lifecycle by selecting the Note quick action from the Manage Appointment module (which can be assigned to a specific Participant), or, from the from the Maica Global Actions menu.
Learn how to Check Into Appointments
When checking into an Appointment, you are presented with a dialog showing essentially three distinct areas of input including Appointment Date Information, Resource(s) that are Checking In, Appointment Checklist Information as well as Check-In Location; these areas are further described in this article.
This part of the Check-In process captures the relevant Date and Time information. Maica offers configurable capability for Check-In information to ensure that can be accurately recorded.
When Checking-In to your , Maica will automatically populate the Date and Time information to the current Date and Time. This can be configured by manually entering any desired Date and Time, or by setting the information directly to match the Scheduled Appointment by selecting the text shown below.
This part of the Check-In process determines which are Checking-In at any given time. When you check in to an for the first time, all of the allocated to that are automatically populated. This can be modified by manually removing any resources that are not currently Checking-In. To Check-In these at a later time, simply reselect the , then Check-In, and repeat the process. All assigned to the who have not already Checked-In will be automatically populated once again.
This part of the Check-In process captures any assigned to the . If a has been associated with an , you will be presented with the list of each Checklist Item and asked to capture the outcome of each item.
For each Checklist Item, if so configured in the , you are prompted to provide further information to manage possible outcomes of Checklist Items in the form of a Note. You access this Note by simply clicking on each Checklist Item.
This part of the Check-In process captures accurate Check-In Location information. Maica offers the ability for Check-In locations to be tracked to ensure that can be accurately recorded.
Learn how Maica manages Funding from the Home Care Packages
In Maica, Funding for Aged Care Participants with Home Care Package Funding is managed through a Quick Action located on the Participants Service Agreement. This Quick Action is the Manage Budget tool and is further explained in more detail here.
Essentially, within the Manage Budget Quick Action you will manage all your Home Care Package Funding, however it is important to note that once a Budget has been created, Maica will generate a Funding Record for your Participant with the relevant data.
This Funding Record will sit on your Participants Contact Record, and whilst is not useful in managing your Participants Funding, it will provide a handy overview of the Budget information.
Within a Home Care Package Funding Record you can find the following information and functionality:
Funding Budget Information
Funding Period Information (Start Date & End Date)
Funding Items
Funding Overviews & Charts
The key components of a Home Care Package Funding Record are the Funding Items, these are explained in further detail below.
The Funding Item represents the specific Plan Budget Items or Components included in a Participant's Home Care Package. Generally, these define what Support Purposes have been selected to form part of a Home Care Package Budget. For example, when Managing your Home Care Budget, if you have selected an Oxygen Supplement, as shown below.
This will then be created as a Funding Item record in your Funding Record, as per below:
The Participant Budget Information section has a number of Roll-Up Summary fields that collect data from the corresponding Funding Item record(s). These fields are explained in further detail below:
Learn about Cancelling an Appointment
When Appointments are cancelled, Maica will mark the Appointment and any existing Delivery Activities as cancelled rather than simply deleting the Appointment and associated information.
Maica supports two scenarios in which Appointments can be cancelled, including:
Single Appointments: They are cancelled by simply setting all related to cancelled and the Appointment Status is also set to cancelled. Appointments are not deleted.
Recurring Appointments: They are cancelled for either only the specific being managed or for any future part of the . Maica will display the following option when a Recurring Appointment is attempted to be cancelled. Appointments are not deleted.
When an Appointment is to be cancelled, Maica can capture the Date/Time of the cancellation request. This allows you to record the actual cancellation request time rather than it defaulting to the time when the cancellation action is performed. This ensures more accurate tracking of cancellation events and appropriate calculation of related charges.
The Cancellation Requested Date field allows you to manually input the date and time of the client's cancellation request, ensuring Maica records accurate information and processes Cancellation charges correctly.
A client requests the cancellation of an Appointment scheduled for 10:00 AM, 5th December 2024, at 8:00 AM, 5th December 2024.
You, as the user, cancel the Appointment in the Planner at 12:00 PM, 5th December 2024.
You can then populate the Cancellation Requested Date field with 8:00 AM, 5th December 2024 (the time the client made the request).
Maica uses the Cancellation Requested Date to determine Cancellation charges, reflecting the correct timeline and avoiding overcharging.
When cancelling an Appointment, Maica asks for a Cancellation Reason. If a Cancellation Reason is selected, Maica requires a Cancellation Date.
The Cancellation UI with all the above fields is shown below.
Learn how to Quick Complete an Appointment
Quick Completing an Appointment essentially bypasses the checking in/out processes and sets an Appointment to the Completed status. It is possible to still capture Appointment Service information whilst Quick Completing an Appointment.
When Quick Completing an , you are presented with a dialog showing distinct areas of input including Appointment Date & Time Information, Appointment Service Information, Manage Travel as well as Check-In/Out Location; these areas are further described in this article.
If you wish to Quick Complete your Appointment without adjusting any of these areas, you can. Maica will automatically populate the required ones with information from the Appointment, hence, they only need to be manually adjusted if desired.
This part of the Quick Complete process captures accurate Location information. Maica offers the ability for Locations to be tracked to ensure that can be accurately recorded.
This part of the Quick Complete process captures the relevant Date & Time information. Maica offers configurable capability when Quickly Completing an Appointment to ensure that can be accurately recorded.
When Quickly Completing your , Maica will automatically populate the Date and Time information to the scheduled Date and Time of the Appointment. This can be configured by manually entering any desired Date and Time.
When Quick Completing an Appointment, you can also Manage Travel. To learn more about the Manage Travel Action, please click here:
This part of the process offers an overview of the delivered as well as the ability to adjust the quantity of each service as required. Adjusting the quantity offers you flexibility within an to control how long each may spend for each within an , or how long each Service may have been delivered. This means, if the actual service duration has changed for one or more Participants, this can easily be captured.
Learn about the Schedule View in Maica
The Schedule View is the default view in Maica. It is an overview of all Planner information and hence displays Appointments & Shifts .
On Calendar Mode, Schedule View will display your Planner with the above information within a grid based on the days and hours of the .
On Timeline Mode, Schedule View will organise your Planner by Resource(s). This will display all of the Resources that in use on the left with all of their associated Appointments & Shifts on the right.
Appointments can be repositioned within the timeline by clicking and dragging them:
Moving an Appointment up or down into another Resource’s row will reallocate the Appointment to that Resource.
If an Appointment does not yet have a Resource, it will appear in the Unfilled row on the Planner. From there, it can be dragged into a Resource row to complete the allocation.
The time and date of the Appointment remain fixed when you drag it; only the Resource assignment changes.
When Drag & Drop functionality is used to reassign an Appointment, Maica will still run all validation.
When you make an Appointment from Timeline Mode in Schedule View, the Appointment will be pre-populated with the Resource of the row on which you created it.
A few useful interaction features are available on the Resource cell in Timeline Mode on Schedule View. These are:
Learn about how Resources can manage their Unavailability within Maica
Maica supports the management of Unavailability records which essentially mark any given as not available for inclusion into an or .
The Manage Unavailability Tool essentially allows you to manage and create these records directly from the , as demonstrated below.
Maica offers the ability to either create a single Unavailability for any given Resource or multiple at the same time by simply adding multiple Resources into the Resources(s) input.
Learn how to manage Service Bookings in Maica
In Maica, you can manage Service Bookings through the Manage Service Booking Quick Action located on the Service Booking Record.
The Manage Service Booking Quick Action in Maica allows you to manage previously created Service Bookings for your Participants
Learn about the process of creating a new Appointment.
Learn how to create Service Bookings in Maica
Learn about how to use Maica and what rules should be followed to ensure Maica behaves as expected.
Maica has been developed on the Salesforce platform which means, as a user, you are able to configure the underlying platform, make changes to page layouts, edit records directly, among many other things. At times, this will compromise the way Maica works and could result in either invalid data or processing errors. The below page outlines how Maica should be used/configured to avoid potential errors or unexpected bahaviours.
The list of the below Salesforce Maica data objects can be edited directly. Any data objects not listed below must be interacted with via Maica's user interface components to avoid unexpected behaviour.
Learn about the different Views & Modes in the Maica Planner
A Planner View in Maica is defines what type of data is displayed in the Planner. It allows users to switch between different categories to focus on specific scheduling information. Each view determines which Shifts and Appointments are shown based on the selected focus and each view is tailored to a particular need within an organisation.
Maica provides various Planner views.
Learn about creating Recurring Schedules for Shifts
Learn about the Advanced Planner Filters in Maica
Approved
APPR
Completed
CMPD
Deleted
DELE









Total Budget Income (Daily)
SUM total of the Subsidies & Supplements
Total Client Contributions (Daily)
SUM total of the Client Contributions
Total Claimable Fees (Daily)
SUM total of the Claimable Fees
Total Billable Fees (Daily)
SUM total of the Billable Fees
Total Available Funding (Current Month)
Formula that first calculates the SUM of the Daily Budget Income and Daily Client Contributions, then subtracts the Daily Claimable Fees and then multiplies the Total by the days in the current month.









Enables you to manage Resource Unavailability and create Unavailability records directly from the Planner.
7
Enables you to create directly from the Planner.
1
Enables the ability to sort fields by specific criteria, such as date or name.
2
Enables the ability to Group Appointments, Shifts, Participants or Resources based on selected attributes, such as location or Postal Code.
3
Allows you to choose a specific date for viewing information within the Planner.
4
Allows you to schedule a new Appointment or Shift within the Planner.
5
6

It is important to note that if multiple Resources are selected, Maica will create an individual Unavailability record for each Resource to ensure that each Resource can manage their own Unavailability.
To create a new Unavailability record, simply click on the Unavailability icon in Maica's Planner, select the + New button and complete the fields as per the below screenshot.
Start and End Date/Time
The Start and End date and time of the Unavailability. This will default to the current time with a duration of 60 minutes. Note, when you adjust the Start Time, the End Time auto-updates to remain 60 minutes later (unless the end time has already been manually changed).
All Day Toggle
When enabled, Unavailability spans from 12:00 AM on the Start Date to 12:00 AM the following day. Duration is automatically set to 24 hours, with times hidden from the modal.
Resource(s)
The Resource(s) for whom the Unavailability record will be created.
Type
The type of Unavailability being created. This list is configurable via Maica .
Status
The status of Unavailability being created. This list is configurable via Maica .
Unavailability Enforcement
Unavailability Enforcement determines the severity of the Unavailability:
Hard Unavailability prevents adding a Resource to an Appointment/Shift
Soft Unavailability prompts a user confirmation but allows addition to an Appointment/Shift.
Please note, drag and drop is prevented on Hard Unavailability, but allowed onto Soft Unavailability with a confirmation required.
You create a new unavailability record at 2:15 PM
✅ Defaults to 2:15 PM – 3:15 PM
You select All Day for 11 July
✅ Maica blocks anyone from scheduling the selected Resource from 12:00 AM 11 July to 12:00 AM 12 July.
A multi-day All Day unavailability (11–13 July)
✅ Maica treats the End Date as exclusive, covering 11–12 July only.
Editing an existing unavailability that was marked All Day
✅ Checkbox automatically selected if both Start and End times are 12:00 AM.
Please follow the steps below to manage a Service Booking:
The first step in managing a Service Booking is simply clicking the Manage Service Booking Quick Action located on the Service Booking Record, as shown below:
Once you clicked on the Quick Action above, you will be shown the Manage Service Booking pop-up, as shown below:
Here you will be asked to select which management action you wish to perform. Each action is explained further below:
If a Service Booking has multiple Booking Item records for a Flexible or Core Support Category (01–04), Maica allows you to alter the Quantity or Rate to move funding across these Booking Item records. You can do this if there is enough Total Remaining Budget for the parent Service Booking.
In order to do this, simply update the Quantity and/or Rate using the input fields shown below.
Once the update has been successfully completed, the Booking Item records will be modified to reflect the budget reallocation.
If circumstances change between you and one of your Participants, you can utilise Maica to cancel or end a Service Booking.
In order to do this, you do not need to remove the Service Booking; instead, reduce the End Date and enter a date between Today and the current Service Booking End Date. This will automatically trigger a cancellation in PRODA.
When you reduce the end date or end a service booking, you should keep the following points in mind:
You cannot backdate a Service Booking's End Date to a date earlier than the date you are amending it.
PRODA (and thus Maica) does not have a distinct Cancelled Status value, hence there is nothing on the record in Maica to indicate that the End Date has been decreased and the Service Booking cancelled. As a result, we have included an Info Panel to the Quick Action to notify you that you will receive an error if you try to reduce the End Date again, as shown below.
Under the Reduce End Date action, you can also manage Retained or Accrual Booking Item Amounts. Here, you have the option to add an accrual amount to ensure that sufficient funds are retained in the Service Booking to cover pending Payment Requests for services rendered.
Unspent funds are refunded to the available support category balance. This means that you can continue to claim for services provided (via Invoices and Payment Requests), but the Participant can use the unspent funds in a new Service Booking with a new Provider.
If one of your Participants has chosen the NDIA to pay their Providers, i.e. Agency Managed, then a Service Booking is created by the NDIA to link the supports in their Plan to their chosen Providers. As Maica is listening to the New Service Booking Provider notification, this Agency Managed Service Booking will appear in Maica with a Status of Awaiting Provider Approval or Change Awaiting Provider.
Given the Service Booking is created by the NDIA (and not you), you must approve the Service Booking before the Participant receives services. This ensures your Participant has funding allocated to pay your Invoices .
Use the Manage Service Booking Quick Action to Approve the Service Booking and begin delivering services.
The Reject option corresponds to the Approve function, as stated above. If you do not agree or approve the Service Booking created/updated by the NDIA, you can reject it using the Manage Service Booking Quick Action.
If you wish to End a Service Booking, you should do this by updating the End Date, as explained above. Service Bookings should not be deleted.
Because the NDIS is ultimately in charge of Service Booking Data, it is crucial that the NDIS and Maica are coordinated and consistent, this where the Force Sync becomes helpful.
In the event you believe a Maica Service Booking record has become misaligned with the PRODA version, use the Force Sync option to update the Service Booking and associated Booking Item records.
Essentially, all the data stored on these records will be updated and replaced with what is current in PRODA.
Schedule, Participant, Asset or Accomodation View in order to create an Appointment, otherwise you will Please see below for an example:
When creating an Appointment, a number of fields will be pre-populated. These fields depend on the Planner view the user is in when the Appointment is created. The pre-populated fields for each view are outlined in the table below:
Start Date, Start Time, End Date, End Time
Start Date, Start Time, End Date, End Time, Participant
Start Date, Start Time, End Date, End Time, Asset
Start Date, Start Time, End Date,End Time, Location, Accomodation
This view will create a Shift
This view will create a Shift
After the new Appointment is created, a few stages must be completed before the Appointment can be confirmed.
Below is a list of these stages:
To dive deeper into each stage, please visit the specific pages for detailed information on every stage.
Please follow the steps below to create a Service Booking:
The first step in creating a Service Booking is simply clicking the Create Service Booking Quick Action located on the Funding Record, as shown below:
Once you clicked on the Quick Action above, you will be shown the Create Service Booking pop-up, as shown below:
Before populating your Booking Items, you should first set up your Service Booking by selecting the Period of the Service Booking as well as the Type.
For your Booking Period, you can choose between Custom Dates, or the entire Plan Date.
For your Booking Type, you can choose between Standard Booking or Plan Managed. Please refer to the information box above to understand the difference and which one will be relevant for your Service Booking.
Once you have setup your Service Booking, it is time to add your Booking Items.
To begin, simply click the + Add button on the right hand side of the interface. This will create a Booking Item Line Item with the following fields ready to be populated:
Support Category
NDIS Support Categories are the broad areas of funding under the National Disability Insurance Scheme (NDIS). Refer below for more information around available Support Categories to select for your Service Bookings.
Support Item
NDIS Support Items are the specific services or products that participants can access through their NDIS funding, based on their plan’s approved categories.
Quantity
This is a Maica concept that allows you to adjust the Quantity of delivery for any specified Support Item.
Rate
This is the price of 1 Quantity unit of any Support Item. This field is automatically populated based on the selected Price List, but is adjustable if desired.
Price List
This field allows you to selected which Price List you wish to associate with the selected Support Item delivery.
If you have associated Funding Items (Plan Budgets) on your Participants Funding Record, the Support Categories will be automatically populated with the available Support Categories and Budget. If you attempt to Add additional Booking Items, you will only be able to select from Support Categories associated with the linked Funding Items.
If you have no associated Funding Items, you will be able to select from all Support Categories.
After you have added all of your Booking Items, you will need to confirm your Service Booking before it can be created and synced with the NDIS. To do so, Maica will present you with a summary and a toggle, as illustrated below:
Once the toggle is selected TRUE, the Submit button will appear and you will be able to confirm your Service Booking.
After doing so, your Service Booking Record will be synced with the NDIS, and if successful, created in Maica within the Funding Record where you can manage and review your Service Booking. To learn more about managing a Service Booking, click here.
Accommodation
maica_cc__Accommodation__c
Availability
maica_cc__Availability__c
Checklist
maica_cc__Checklist__c
Checklist Item
maica_cc__Checklist_Item__c
Client Goal
maica_cc__Client_Goal__c
Client Note
maica_cc__Client_Note__c
Client Note Template
maica_cc__Client_Note_Template__c
Connection
maica_cc__Connection__c
The Planner Views have a direct relationship with the Planner Modes. Each View will display slightly different information depending on what Mode is selected. As a result, please refer to the information below outlining the Planner Modes before continuing learning about the Planner Views.
To dive deeper into each view, please visit the specific pages for detailed information on every view.
A Planner Mode in Maica refers to the layout or format used to display the schedule. The two Modes in Maica's planner are Timeline Mode and Calendar Mode.
Timeline Mode: This mode presents Appointments and Shifts in a horizontal timeline, displaying the schedule across a selected time period while aligning the selected view category along the side.
Calendar Mode: This mode offers a more traditional calendar view, where Appointments and Shifts are displayed within a grid based on the days and hours of the selected period.
You can toggle between these Modes to choose how the schedule is visually represented within each View.
When in the Planner, you can adjust your display options by simply using the following buttons:
1
View
Dropdown selection of the views that are explained .
2
Period
Dropdown selection of the period. The period allows you to select a time frame and controls the length of time shown in the planner view. The available periods in Maica's Planner are:
Day
Week
Fortnight
Month
3
Mode
Toggle selection of the modes that are explained .
To change the day in which your Planner starts with, head to the settings. Maica will default this to Monday, however, you can select any day of the week to suit your needs.
Schedule Start
Data
The Start Date of the Recurring Shift.
Schedule End
Data
The End Date of the Recurring Shift.
Frequency
Picklist
This enables the selection of the following values: Daily, Weekly, Monthly, Quarterly, Annually
Repeat Every
Number
This captures the interval based on the Frequency, for example if Weekly is selected, then the number 2 means Every 2 weeks.
When setting up a new recurring Shifts Schedule, you can control which attributes are copied from the Master Shift to each generated Shift. This provides greater flexibility when planning recurring services, especially if Resources aren’t confirmed at the time of setup.
In the Schedule section, you’ll see the following checkboxes:
Inherit Resources
Inherit Checklists
Ticking a box means the selected attribute will be copied from the Master Shift to each Shift in the series.
When making Recurring Shifts, you have two more configurable options.
When this is toggled on, Maica will exclude any Shift that falls on a Public Holiday from your Recurring Schedule.
If you create a Recurring Schedule by End Date and Public Holidays fall within the specified dates, the Public Holidays will be skipped and the number of Shifts in your schedule will be reduced by the number of Public Holidays within the specified dates.
If you create a Recurring Schedule by Number of Shifts and Public Holidays fall within your schedule, the Public Holidays will be skipped, but the Number of Shifts will remain constant, and the End Date will be extended accordingly.
The scope of your schedule can also be determined by inputing the Number of Shifts desired within your recurring schedule (This is a configurable alternative to determining the scope by End Date). If the Number of Shifts is selected, Maica will automatically provide an End Date based on the Start Date, Frequency and Repeat Every fields. To toggle between End Date and Number of Shifts, click the hyperlinked text under the field box.
Advanced Filters use the same Add Criteria process found in the Optimiser’s Resource Pool and Ranking Criteria, but here the purpose is filtering the Planner view, not selecting or ranking Resources.
The Advanced Filter allows you to:
Limit the Planner to specific types of records
Filter by any field from supported objects (e.g., Appointment, Participant, Resource)
Combine multiple conditions using AND logic
Show only records that meet your defined rules
Build complex or multi-field views for targeted scheduling work
In order to show you how you apply an advanced filter in Maica, let's use an Appointment Attribute as an example:
First, begin by selecting the Advanced menu option in the Planner filter.
Then, select Add Criteria to start building the Filter.
Appointment/Shift Attributes Criteria – Filter Appointments or Shifts based on specific properties (e.g. location). Applying filters here will limit which Appointments or Shifts are visible in the Planner.
Resource Attributes Criteria – Filter which Resources are shown in the Planner. You can use this to narrow results by Age, Skills, or other relevant fields.
Participant Attributes Criteria – Filter which Participants are shown in the Planner. Again, you can use this to narrow results.
These available fields are determined by what View & Mode your Planner is in at the time of applying the filter.
As mentioned above, let's add an Appointment Attribute Criteria.
Begin by simply clicking the Add Criteria link to create a New Criteria box.
A new filter block appears with three components:
Field dropdown
Operator dropdown
Value field
Note, the Value field will appear after you have selected your Field and Operator. The Value updates dynamically and only presents options related to the selected Field and Operator.
Start by selected your Field.
To do so, you must first choose an Object. The available Objects will be presented to you based on your Planner View and Mode. An example of the available Objects in Schedule View is shown below.
Once you have selected the Object, all available Fields will be presented and available for selection.
Once you have selected your desired Field, move onto Operator and Value.
Fields are grouped by object. Examples:
Appointment fields: Location, Start Time, Status
Resource fields: Region, Gender, Employment Type
Participant fields: Age Group, Language, LGA
Finally, after selecting your Field, you must select an Operator and a Value. These concepts are defined below:
Operator: An Operator is a function that defines the relationship between two values (Field and Value). It determines how the two are compared, filtered, or evaluated, such as checking for equality, differences, or whether one value contains another.
Value: A Value is a specific piece of data that corresponds to the selected field. It represents the actual option or information that will be used for comparison or filtering. For example, the values may be the possible states (e.g., ACT, NSW) for the field Location > State.
So, using the location field on the Appointment as an example, you could set your Operator and Value to the following:
Field: Location > State
Operator: equals
Value: NSW
This will filter the Planner to only show Appointments where the State in the Location field equals NSW.
Once done, click the Green Tick at the top of the Filter to apply your changes.
Once your filters have been applied, the outline of the criteria will change from Yellow to Grey to indicate it has been saved.
Roster or Shift View in order to create a Shift, otherwise you will Please see below for an example:
When creating a Shift, a number of fields will be pre-populated. These fields depend on the Planner View the user is in when the Shift is created. The pre-populated fields for each view are outlined in the table below:
This view will create an Appointment
This view will create an Appointment
This view will create an Appointment
This view will create an Appointment
Start Date, Start Time, End Date, End Time, Resource
Start Date, Start Time, End Date, End Time
Below is a list of these stages:
To dive deeper into each stage, please visit the specific pages for detailed information on every stage.
1
Resource Location
This Quick Action opens your Resource(s) location and travel information on Google Maps. It will show a directions to all Appointments and a route between them for the specified Period.
2
Resource Scheduling Information
This Tooltip shows your Resource(s) scheduling information taken directly from their Resource Profile.













Learn about the Schedule Manager Actions within Maica
The Schedule Manager Actions are tools that allow you to manage multiple Appointments or Shifts directly from the Schedule Manager, and also include Additional Actions for the Manager itself.
These actions are designed to make bulk updates easier, as well as provide quick access to configuration tools and supporting functions.
Actions in the Schedule Manager fall into two categories:
– operations that can be applied to multiple selected records at once:
– options for configuring the table view or creating new records from within the Schedule Manager:
The sections below describe each of these actions in more detail
As mentioned, Bulk Actions allow you to update multiple Appointments or Shifts at the same time. To use these actions, you must first select at least one record. Selection is done using the checkboxes located on each row, or by using the checkbox in the header row to select or deselect all records in the view. Each Bulk Action is further described below:
The Resource Allocation action allows you to assign one or more Resources to multiple selected Appointments or Shifts at the same time. You can add additional Resources, or replace existing.
When selected from the Bulk Actions menu, the modal will open. This screen uses the Smart Selection Filter, which applies the same matching logic as the Appointment Optimiser to order resources by suitability.
From the modal, you can search for and select the resources you wish to allocate.
After confirming your selection, the Confirm Resource Allocation screen will appear. Here you can choose how the resources are applied:
Merge – keeps existing resources on the appointments and adds the newly selected ones.
Override – removes existing resources and replaces them with the newly selected ones.
Once confirmed, Maica will validate rostering conflicts before applying the allocation across all selected appointments or shifts.
The Change Status action allows you to update the status of multiple selected Appointments or Shifts in a single step.
When selected from the Bulk Actions menu, the Select Status modal will appear. From here, you can choose the new status from the dropdown menu and apply it to all selected records.
After choosing a status, the Confirm Status Change screen will be displayed. This provides a final confirmation that the status change will be applied to the selected records. Selecting Yes, Change Status will complete the update.
The Cancel action allows you to cancel multiple selected Appointments or Shifts at once.
When selected from the Bulk Actions menu, the Cancel Appointments modal will appear. From here you can:
Enter the Date and Time of the cancellation.
Select a Cancellation Reason from the dropdown menu.
Add a Cancellation Reason Description to provide more detail.
After completing the form, you will be taken to the Confirm Cancellation screen. This provides a final confirmation before the cancellation is applied to the selected records. Selecting Yes, Cancel will complete the process.
The Quick Complete action allows you to finalise multiple selected Appointments or Shifts in a single step. This action is designed to streamline processing by running the associated timesheet and invoicing workflows automatically.
When selected from the Bulk Actions menu, the Confirm Quick Complete screen will appear. Here, a message showing the number of records to be completed will display. Selecting Yes, Complete will immediately trigger Maica's validation and finalise the selected appointments or shifts.
For a hands-on walk-through of the Bulk Actions in the Schedule Manager, you can access the Interactive Overview below.
In addition to Bulk Actions, there are Actions designed for configuring the Schedule Manager and help you customise the way information is displayed, these are detailed below.
The Select Fields to Display option allows you to configure which columns are visible in the table view.
In order to configure the columns, begin by opening the Select Fields to Display modal, then:
In Available Fields (left), click the field you want to add.
Click the right arrow to move it into Visible Fields (right).
To remove a column, select it in Visible Fields and click the left arrow.
To change the display order, use the up/down arrows
Custom columns, such as formula fields, will appear in Available Fields once created.
Learn how to Manage Preferences of Participant(s) in Maica
In Maica, Preferences capture the Participant(s) Preferences when receiving a Service. Preferences can be allocated one of three possible states, these include the following:
Required
The best way to get started with Managing Preferences is to go to a Participant Profile and simply clicking the Manage Preferences button located in the top right corner of the interface, as shown below.
Once you click this button, Maica will present a pop-up which allows you to add new preferences or edit existing ones, as shown below.
To add a new Preference, simply click on the Add button located in the top right corner of this pop-up and select which type of Preference you would like to set up. The Preference options are further explained . To edit an existing Preference, simply click the Pen icon located to the right hand side of any existing Participant Preference.
There are three types of Participant Preference Categories you can manage, these include:
When selected, all of these Categories will have the same Input Fields can be completed. There is one exception to this, and this is the lookup. The lookup will be specific to the selection. Meaning, if you choose to add a Resource Skill Preference, the lookup will show a list of available Skills, and if you choose a Resource/Asset Preference, it will show a list of available Resource(s) & Asset(s).
The table and image below shows a list of the Participant Preference Input Fields required to finalise a Preference. The Resource Attribute Preference pop-up has been used as an example.
Learn about the information in an Appointment Summary
The Summary provides an overview of the Appointment, including the selected Start Date, Start Time, End Date and End Time. It also summarises each selected Appointment Service for each selected Participant, as described in the below image and by the below table:
If the Unit of Measure if Hourly, then the Quantity field offers you flexibility within an to control how long each may spend at an or how long each Service may be delivered for. For example, if Margaret Johnson will attend the created for the full 3.5 hours, but Luca Milne may only attend for 2 hours and I wanted to bill accordingly, I would adjust Luca's quantity.
When adjusting the quantity for a , Maica will alert you with a symbol indicating that you have individual that does not correspond with the details of your . This is not an error, but rather an alert to identify the adjusted quantity. Once you have changed the quantity for a , the total Appointment cost will also automatically update. Please refer to the image below for an example with an updated quantity and the changes Maica will display:
The Quantity Unit of Measure field describes the billing frequency of the Support Item(s) making up the selected Appointment Service. These could be any of the following:
Hourly
Daily
Weekly
If the Quantity Unit of Measure field is anything other than Hourly, Maica will default this field to 1.
Learn about capturing basic details for a new Shift
The Basic Details tab captures the basic details of the Shift, as described in the below table:
This alert will show in the instance where the selected Resource(s) have a Roster Mode conflict and hence cannot be allocated to the proposed Shift. This is the only restriction that Maica enforces where the user cannot continue to create the Shift.
In order to resolve this alert, you must select Resource(s) that are set to a Roster Mode of Shift during the time of the proposed Shift.
You can set a Resource(s) Roster Mode on their , , or by using a in your Maica organisation for all Resource(s). To learn more, click the links.
This alert will show in the instance where you have a different number of Resource(s) allocated compared to the specified Required number for the Shift. This will result in an incomplete Shift.
For example, if you have an incorrect required number of , Maica will alert you with the following warning:
The Shift does not have the required number of Resources allocated.
In this instance, Maica will still allow you to continue to the next stage of creating your Shift. However, as mentioned, it will result in an unfulfilled Shift.
In order to resolve the Incomplete allocation alert, ensure that the number of selected match the specified required number. : If you only require 1 Resource for your Shift, ensure 1 is allocated, as shown below.
Learn about creating Recurring Schedules for Appointments
Learn about the Schedule Manager within Maica
In Maica, the Schedule Manager is a dedicated tool for managing and in a data table view.
It functions in a similar way to the , offering the same filters and tools, but in a list-style layout with additional bulk actions. This enables you to view and manage hundreds of records at once, configure which fields are displayed, and perform bulk actions such as status changes, cancellations, quick completes and resource allocations.
Goal
maica_cc__Goal__c
Invoice
maica_cc__Invoice__c
LGA
maica_cc__LGA__c
Location
maica_cc__Location__c
Operating Hour
maica_cc__Operating_Hour__c
Payment
maica_cc__Payment__c
PHN
maica_cc__PHN__c
Postcode
maica_cc__Postcode__c
Price List
maica_cc__Price_List__c
Price List Entry
maica_cc__Price_List_Entry__c
Resource
maica_cc__Resource__c
Resource Skill
maica_cc__Resource_Skill__c
Service Agreement
maica_cc__Service_Agreement__c
Skill
maica_cc__Skill__c
Support Item
maica_cc__Support_Item__c
Required Preferences indicate essential items for a Participant when a Service is being delivered. This could include but is not exclusive to a language or strict Time of Day they are available.
Excluded
Excluded Preferences indicate essential items to keep out for a Participant when a Service is being delivered. This could include but is not exclusive to an individual Resource they do not want to work with or a Time of Day they are not available.
Preferred
Preferred Preferences indicate items that a Participant would like when a Service is being delivered, but are not required for the Service to go ahead. This could include but is not exclusive to an individual Resource they enjoy being with or a Gender of Resource they would rather have.
Resource/Asset Preference
This refers to the ability to specify preferences for specific Resource(s) or Asset(s), such as whether you want to work with a specific individual or not, or, in a specific room or not.
Resource Attribute Preference
This refers to the ability to specify preferences for specific Resource(s) attributes, such as Gender or Age.
Resource Skill Preference
This refers to the ability to specify preferences for specific Resource(s) skills, such as the ability to Administrator Medication.
Lookup
This lists all fields that are available for selection specific to the Preference Category selected, and allows for one to selected as a Preference.
Value Lookup
This only applies to a Resource Attribute Preference. When a Resource Attribute is selected, this allows for an additional value to be captured.
Preference State
Start Date
This allows for a Start Date to be selected in which the Preference becomes effective.
End Date
This allows for a End Date to be selected in which the Preference stops being effective. If left blank, the Preference will always be effective.
Appointment Service
This allows for a Preference to be specific to an Appointment Service. For example, if a Participant required an English speaker only whilst receiving a particular Service.

















Click Confirm to apply the layout to the table.
Show Shifts
On Calendar View, this filter gives the ability to toggle the visibility for Shifts on and off.
Show Unfilled Appointments or Shifts
Maica considers an Unfilled Appointment or Shift any Appointment or Shift that does not have the required number of Resources or Participants allocated to match the required number. This filter option allows you display your unfilled Appointments or Shifts on the Planner.
Show only Unfilled Appointments or Shifts
This filter allows you to only display Unfilled Appointments or Shifts. This may be beneficial when completling or finalising your roster to see which Appointments or Shifts require attention.
Show only records with Appointments
When in Timeline Mode, this filter allows you to only show rows for records with associated Appointments during the selected time period; this means if you had a Resource with no Appointments for the selected, they would not show in your Planner if this was toggled on.
Show only my Participants
When using the Resource Participant related list in the , it is possible to assign certain Participants to a particular Resource. This filter allows you to only see the Participants assigned to you as the logged on User/Resource.
Participants
This allows you to select a number of specific Participants and only see their associated Appointments or Shifts in the Planner.
Show only my Appointments or Shifts
This will automatically only show the Appointments or Shifts in which the logged on User/Resource is allocated.
Resources or Assets
This allows you to select a number of specific Resources and/or Assets and only see their associated Appointments or Shifts in the Planner.
Show where Participants and Resources match
If you have selected specific Participants or Resources from the above filters, this filter will show only Appointments where both of them are allocated.
Type
This refers to the type of Appointment or Shift you are wanting to see in the Planner, such as Booking.
Status
This refers to the Status of the Appointment or Shift you are wanting to see in the Planner, such as Scheduled or Completed.
Unavailability Status
This filters the Status on the Unavailability records shown in the Planner, such as Approved. Please note, this Filter is only filtering Unavailability records, all other Appointments and Shifts will not be impacted.
Resource Skills
This filters Resources based on associated Skills, such as the ability to Administer Medication. This filter is particularly relevant on Schedule View in Timeline Mode, when the Planner is organised by Resource.
Location
This filters Appointments based on the Location at which they are being held; this Location is recorded against an Appointment as an address or a lookup to a Location record.
Appointment or Shift Services
This refers to the associated Appointment or Shift Services for any given Appointment or Shift; this means you can filter based on what services are being delivered.
MonthlyYearly
Each
1
This is the Appointment Service selected at the Basic Details stage
2
This is the Participant(s) selected at the Basic Details stage
3
This is the Claim Type selected at the Basic Details stage
4
This is the quantity based on the Unit of Measure.
If the Unit of Measure is hourly, the Quantity field will show a Quantity based on the created Appointment's Start and End time for each selected Participant. For example, the shown Appointment time is from 8:15am - 11:45am, this is a quantity of 3.5 which represents 3 and a half hours. This field is adjustable for each Participant, please refer to the Adjusted Quantity section below for further information.
As mentioned, this field is dependant on the Quantity Unit of Measure, The possible fields are further described below.
5
This is the Number of Appointments based on the Recurring Schedule calculated at the Schedule stage
6
This is the total cost of the Appointments based on the Recurring Schedule calculated at the Schedule stage. It is a sum of the total number of individual Appointments.


Shift: This means Appointments can only be scheduled within a Shift that a Resource is part of and it is within any active Availability record(s) if these exist. If no Availability record(s) exist, Appointments still must fall within a Shift that the Resource is assigned to.
Roster ModeResourceGlobal Roster ModeThis allows for the selection of Resource(s) by simply typing a name of a Resource (or multiple) or by clicking on the Filter icon which allows for Smart Selection of Resource(s).
This allows for the selection of Asset(s) by simply typing a name of a Asset (or multiple) or by clicking on the Filter icon which allows for Smart Selection of Asset(s).
Date & Time Details
The date and time details are pre-populated from the Planner so there is nothing to do for the user.
Shift Service
This allows for the selection of Shift Service(s). You can add an Shift Service by typing the name of the service, or by using any key words configured within the service. For example: If you were adding Support Coordination, you could type Support Coordination, or, advice.
Claim Type
This allows for the selection of a Claim Type by selecting one from the provided dropdown list.
Time Zone
When creating a new Shift, the timezone is automatically set & displayed based on the Salesforce user’s current browser timezone. This occurs before a Location is selected.


Schedule Start
Data
The Start Date of the Recurring Appointment.
Schedule End
Data
The End Date of the Recurring Appointment.
Frequency
Picklist
This enables the selection of the following values: Daily, Weekly, Monthly, Quarterly, Annually
Repeat Every
Number
This captures the interval based on the Frequency, for example if Weekly is selected, then the number 2 means Every 2 weeks.
When setting up a new recurring Appointment Schedule, you can control which attributes are copied from the Master Appointment to each generated Appointment. This provides greater flexibility when planning recurring services, especially if Participants or Resources aren’t confirmed at the time of setup.
In the Schedule section, you’ll see the following checkboxes:
Inherit Participants
Inherit Resources
Inherit Checklists
Ticking a box means the selected attribute will be copied from the Master Appointment to each Appointment in the series.
When making Recurring Appointments, you have two more configurable options.
When this is toggled on, Maica will exclude any Appointment that falls on a Public Holiday from your Recurring Schedule.
If you create a Recurring Schedule by End Date and Public Holidays fall within the specified dates, the Public Holidays will be skipped and the number of appointments in your schedule will be reduced by the number of Public Holidays within the specified dates.
If you create a Recurring Schedule by Number of Appointments and Public Holidays fall within your schedule, the Public Holidays will be skipped, but the Number of Appointments will remain constant, and the End Date will be extended accordingly.
The scope of your schedule can also be determined by inputing the Number of Appointments desired within your recurring schedule (This is a configurable alternative to determining the scope by End Date). If the Number of Appointments is selected, Maica will automatically provide an End Date based on the Start Date, Frequency and Repeat Every fields. To toggle between End Date and Number of Appointments, click the hyperlinked text under the field box.
When creating a Recurring Appointment Schedule, Maica calculates the projected cost of the schedule and generates a breakdown like the following:
The cost calculation is triggered by clicking the Calculate Cost Breakdown hyperlink. The breakdown will contain all appointments that fall inside the schedule, including their day of the week, and will provide the following budgeting data:
Top Left
Time of day is being held.
Top Right
Total cost of the individual .
Bottom Left
Total amount of the that has been utilised for the specified service to date as a result of the Recurring Appointment Schedule.
Bottom Right
Total budget remaining within the at the time the appointment has taken place.
When the Total Remaining or the Appointment Cost amounts are shown in red, it means that there are insufficient funds in the selected Participant(s) Service Agreement to cover the scheduled Appointments. Hence, it is unlikely that payment/claiming/invoicing will be successful.
When the budget data does not show, it means that there is no Service Agreement for the selected Participant(s).
As mentioned, the Schedule Manager is designed to bring the full functionality of the Planner into a flexible, Excel-like table view. You can:
Apply the same Filters available in the Planner to refine your list.
Configure which columns are displayed, including custom fields.
Perform bulk actions such as Quick Completes, Cancellation, Status Changes, and Resource Allocation.
Access individual Appointment Actions through the row-level menu.
For further information on specific Schedule Manager actions, please click here.
The Schedule Manager includes several components located in the top toolbar and row level. These are outlined below:
1
Filter
Applies Basic & Advanced filters to refine the list of records displayed. To learn more about the Filter, .
2
Date Picker
Select the date range to display. Note, if a Custom Period is selected, you will be able to input the Custom Range using Start Date and End Date fields that will replace the standard Date Picker.
3
Select Period
Choose the period from the following options (Day, Week, Fortnight, Month, Custom) to adjust the range of Appointments or Shifts shown in the Schedule Manager.
4
Switch View
Toggle between viewing Appointments or Shifts.
The Schedule Manager also contains a Records Summary at the bottom of the screen. This Summary displays a count of the total records loaded into the view for the selected date range and filters as well as the count of the selected records at any given time.
For a hands-on walk-through of the Schedule Manager, you can access the Interactive Overview below. This provides a step-by-step demonstration of the key components and functions outlined above, allowing you to explore how to navigate the Schedule Manager.
Notes
Additional notes that can be taken during the creation of the Unavailability.
Create a corresponding Timesheet
This indicates that a corresponding timesheet activity will be generated for each Unavailability.
This is a Recurring Unavailability
If a Recurring Unavailability is required, this enables the capturing of the required details as documented further .



Learn about capturing Note details for a new Billable Participant Note
The Take a Note tab captures the basic details of the Billable Participant Note, as described in the below table:
Category
Non-Billable Notes and Appointment Service When a note is marked as non-billable, you can still select an Appointment Service to indicate which service the note relates to.
This helps maintain reporting accuracy without affecting billing or claiming.
Quantity is locked at 0
This alert will show in the instance where the selected have no for the selected . When this is the case, Maica will alert you under the input box (as shown) and the Save & Next button will become unavailable. This is the only restriction that Maica enforces where the user cannot continue to create a Billable Participant Note.
In order to resolve this alert, you must select an that the selected have an for and hence can be billed against.
When the have an for the selected , the alert will be replaced by the following billing and budget information:
Learn about the process of running the Optimiser
This article walks through a complete Optimisation run from start to finish. It starts from configuring your Optimisation run and continues all the way through to confirming your updated Records.
The first step in any Optimisation run is defining which Resources the Optimiser will consider.
In this example, let's assume our Planner shows a week with 51 unfilled Appointments, and we begin with 184 active Resources.
We open the Resource Pool and start applying filters to refine the group.
Select Resource Pool.
Click Add Criteria.
Choose a Field (e.g., Resource → Work Type).
Select an Operator (e.g., equals).
After applying this first filter, our pool narrows from 184 → 126 Resources.
We then add a second filter:
Resource → Region equals East Metro
This reduces the pool further to 68 Resources.
Now, the Optimiser will only consider these 68 Resources when filling all 51 unfilled Appointments.
With the 68-person Resource Pool set, we now decide how those Resources should be scored.
Ranking Criteria uses the same Field → Operator → Value structure, but instead of filtering people out, it influences how well they score during optimisation.
For this example, let's say we add one criterion:
Resource → Gender equals Woman
This does not reduce the pool size (still 68), but Resources who match the rule will receive a higher scoring contribution.
If a Ranking rule is too strict (e.g., a value that no Resources have), optimisation may return no matches.
Next, we tell Maica how much weight each category should have in the scoring formula.
We open the Settings panel, which displays the five weighted categories:
We leave everything at 25%, except Travel = 0%.
This means each of the four categories contributes equally to the final Matching Score.
We now select all 51 unfilled Appointments and click Optimise.
At the top of the Optimiser, the Progress Indicator shows:
0 of 51 filled
As the run progresses, the count updates in real time.
At any point in the time you can pause the optimisation process by clicking the progress spinner within the progress indicator. If you do so, Maica will save the records that had already been optimised before the run was paused. If you then continue without deselecting records, Maica will pick up from where your run left off
The Optimiser evaluates each Appointment one at a time based on our configuration:
It checks if the Appointment can be filled using the 68 Resources in the Pool.
It scores each eligible Resource against the Ranking Criteria and weightings.
It assigns the highest-scoring Resource(s).
If an Appointment cannot be filled, it’s skipped, given an error status, and the run continues. You can then review these after the optimisation run.
After a short period, we see:
37 of 51 filled
Some Appointments are now marked as fully optimised, and others remain unfilled or partially filled.
Please note, you can work in the Optimiser whilst a run is underway. If you wish to view Appointment Insights or perform other Actions whilst the run is ongoing, you can. The only thing that will interfere with the run is cancelling and closing the modal.
Once the run is complete, all Appointments will be sorted into Statuses: Filled, Partially Filled, Unfilled or Error.
Let's say, after the first run, 45 of the 51 Appointments have been successfully filled using our 68-person Resource Pool.
This leaves 6 Appointments still unfilled. Rather than adjusting Ranking Criteria or weightings, we decide to broaden our Resource Pool slightly to give the Optimiser more people to draw from.
We return to the Pool and remove the criterion:
Resource → Region equals East Metro
Our pool expands from 68 → 122 Resources.
With this wider set, we select only the remaining 6 unfilled Appointments and run the Optimiser again.
The Progress Indicator updates until all 6 are filled. We now have 51 of 51 Appointments filled across the week.
Now, let's say one of our confirmed care workers calls in to say they are unwell and unable to attend a particular Appointment. We need to make an adjustment.
So, begin in the Resource Column for the required Appointment, and:
Open the dropdown menu on the Resource’s pill.
Select Withdraw.
The pill becomes greyed out, indicating the worker is no longer active for this Appointment but still visible for audit purposes. Our Confirmed Badge will also now turn back to Red, indicating the Confirmed Resources do not match the configured Requited on the Appointment.
Now, we need to allocate a replacement Resource. To do so:
In the same Appointment, select Find Resource Manually.
The modal shows all eligible Resources based on our updated 122-person Pool.
We scroll to find Nicolette O’Mahony (who scored 52%) and select her.
Click Confirm in the modal.
Nicolette is now added as the new confirmed Resource, while the withdrawn worker remains greyed out.
The Appointment is once again fully covered.
With all adjustments complete, we prepare to finalise the Optimiser session. To do so, we click Confirm at the bottom-right of the Optimiser.
A Summary Screen appears, outlining the number of Appointments or Shifts updated to each Status. Once we confirm this, all Optimiser results are written to the underlying Appointment and Shift records in Maica, and updates are made.
During this update of records, Maica will detect any further Validation or additional Errors that may arise. It will display them and give you the option of continuing or returning back to the Optimiser. An example of this step may be a Soft Unavailability detected. Here, Maica lets you know about it, but doesn't stop the Resource being assigned.
This marks the end of our run.
Learn about checking out of Appointments
When checking out of an Appointment, you are presented with four distinct areas of input including Appointment Date Information, Resource(s) that are Checking Out, Appointment Service Information and Check-Out Location whilst the second shows Appointment Checklist Information and the Manage Travel Action.
Similar to , This part of the Check-Out process captures the relevant Date and Time information. Maica offers configurable capability for Check-Out information to ensure that can be accurately recorded.
When Checking-Out of your , Maica will automatically populate the Date and Time information to the current Date and Time. This can be configured by manually entering any desired Date and Time, or by setting the information directly to match the scheduled by selecting the text shown below.
Similar to , this part of the Check-Out process determines which are Checking-Out at any given time. When you check out of an for the first time, all of the allocated to that are automatically populated. This can be modified by manually removing any resources that are not currently Checking-Out. To Check-Out these at a later time, simply reselect the , then Check-Out, and repeat the process. All assigned to the who have not already Checked-Out will be automatically populated once again.
This part of the Check-Out process offers an overview of the delivered as well as the ability to adjust the quantity of each service as required. Adjusting the quantity offers you flexibility within an to control how long each may spend for each within an . This means, if the actual service duration has changed for one or more Participants, this can easily be captured at the time of Check-Out.
This part of the Check-Out process captures accurate Check-Out Location information. Maica offers the ability for Check-Out locations to be tracked to ensure that can be accurately recorded.
This part of the Check-Out process captures any assigned to the . If a has been associated with an , you will be presented with the list of each Checklist Item and asked to capture the outcome of each item.
Similar to , for each Checklist Item, if so configured in the , you are prompted to provide further information to manage possible outcomes of Checklist Items in the form of a Note. You access this Note by simply clicking on each Checklist Item.
The Manage Travel Action offers the ability to capture travel and associated expense claim information. The main purpose of the Travel Management tool in Maica is to facilitate the accurate recording of travel-related information and ensure that travel-related expenses and time is tracked and logged accurately.
Travel is recorded at the Resource level on the Appointment Resource record. The Appointment displays totals and averages rolled up from its related Resources.
The tool is broken down into a number of sections, as outlined below:
The first step in using the Manage Travel tool is to track the time and distance travelled as part of the Appointment. Maica will automatically populate, using Google, and based on the information provided at the stage of the Appointment creation, however, it can be adjusted if desired.
If you have multiple Resource(s) assigned to a particular Appointment, this section allows you switch between each one and adjust their Travel individually.
The Time Based Travel Breakdown allows you to divide the total minutes of travel into the time travelled to an Appointment, and from an Appointment.
You can do so by moving the slider to your desired split of Travel Time.
This allows flexibility in your Travel billing, and also has a direct relationship with how you may want to charge for Travel.
Maica allows you to create Timesheet Entries based on the Time Based Travel. These can be both Billable and Non-Billable, depending on how you treat Travel within your organisation. In order to create a Timesheets from Travel, you must have Payable Travel not equal to Do not Pay (it can be any other value) in the Travel Management Settings.
The Non-Time Based Travel Breakdown allows to divide the total kilometres of travel into the distance travelled to an Appointment, and from an Appointment.
Similar to the Time Based Travel Breakdown, you can do so by moving the slider to your desired split of Travel Distance. Additionally, you can manually input distance values for either distance to or from the Appointment.
When updating travel distances in the Travel Management modal, the system dynamically recalculates values based on the input changes. The logic ensures that adjustments are proportionally applied while maintaining accuracy.
As Expense Claims are based on Non-Time Based Travel, it is important to note that within the Travel Management Settings, you can select how you wish to Pay for Travel. The options include; Do not pay, Pay for travel to an Appointment, Pay for Travel from an Appointment, Pay for both.
This essentially means that if you have selected any value other than Do not pay, moving the slider will determine your Resource(s) reimbursement amount based on your Travel Management Settings.
Finally, once the above stages have been completed, the Manage Travel Tool will create an Expense Claim.
The Expense Claim is generated based on Non-Time Based Travel Breakdown as well as Reimbursement Rate set in the . It is stored as a record against a Resource that captures what they should be paid for their expenses.
Learn about how Maica manages Incidents
Incidents in Maica allow you to record, track, and manage any event that affects the safety, wellbeing, or care of a Participant, Resource, or Environment. Incidents can be entered directly by Care Workers through the Maica Mobile App or created later by office-based staff.
This article outlines how to create an Incident, what information is captured, and how the Incident progresses through the management process.
Incidents ensure that Support Teams can:
Record factual information about events as they happen
Capture all required details for compliance and organisational reporting
Track the status of an incident from initial reporting through to closure
Document actions taken and any follow-up required
Maintain a consistent and auditable record across the organisation
As mentioned, Incidents can be created either in the Maica Mobile App (care workers) or via Salesforce Desktop (office users).
Consistent with other functionality, this is managed via Permission Sets. To learn more about what Permissions grant access to the functionality around Incidents, .
First, you must open the form:
Mobile App: Navigate to Appointment → Incidents → New Incident.
Desktop: Go to the Incidents tab and click New.
This section captures the essential details of the event.
This section is used once internal investigation or review has been completed.
Incidents progress through the following stages:
New — The incident has been logged and requires review.
Under Investigation — An internal investigation is underway.
Escalated — Incident requires additional oversight or external reporting.
Closed — All actions complete and the incident is finalised.
Incidents automatically appear as related lists on:
Participant
Resource
Appointment (where applicable)
This allows staff to easily see all incidents associated with a specific person or service event.
Discover how to specify the Appointment location
The second tab captures the location details of the Appointment. There are four different methods by which the location can be established, as shown below:
By using the Location tab, you can choose the location of your from your stored Locations . Once your Location is selected, any connected Accomodation records are displayed and accessible for selection in order to provide a more detailed location.
The Participant Location tab enables the Appointment Location to be selected from a list of all recorded Mailing Address values for each associated with the . So, when adding to an , you can automatically select the Appointment Location from all addresses connected to their record.
The Manual Entry tab allows for flexibility where the is to be held at a location not previously recorded. You can enter an address manually to be captured against the . Here, you have the option to manually enter the information or have the fields automatically fill in by using the to find the address.
If your is not at a physical address, simply click the toggle to turn off all Location selection options and proceed with the setup.
When creating an Appointment, Maica automatically assigns a Time Zone using the current user’s browser location (e.g. Melbourne).
Once a Location is selected, Maica checks if that Location is in a different timezone. If it is, you'll be prompted to update the Appointment’s timezone to match the Location.
By default, the Time Zone is set to match the current user's browser (e.g. Australia/Sydney).
If a Location is selected:
Maica uses Google’s Time Zone API to detect the correct timezone based on its address.
If the Location’s timezone differs from the one already assigned, a
In order for Maica to successfully detect and change Timezones, a Google API Key must be properly set up in the Maps Management Settings. To learn how to set up your API Key, .
The Start and End Times are saved using the Appointment’s selected timezone.
Other users will see the Appointment adjusted to their own local timezone when viewing it (e.g. in the Planner, Quick Info, or record view).
A world icon appears in the Planner showing the viewer's browser timezone with helpful tooltip context. To learn more, .
Maica integrates with Google Maps to determine travel times.
When selecting a location for any given , Maica will use Google to determine the required travel time and distance to and from the . It will then give you an Appointment Travel Time Breakdown which includes a summary of your travel, as well as the total travel time and distance for the .
When determining your Appointment Travel Time Breakdown, you have three options for both the origin (1. from which travel will be started) and the destination (2. to which travel will complete) of your . These options are shown in the table below:
Maica uses Google Traffic Awareness to check that you will arrive to your on time. It does this by assessing your selected time with your estimated travel time in order to verify that you will make it based on Google Traffic data. If you aren't expected to make it, Maica will display the alert below:
Discover the Appointments Actions possible in Maica.
Select a Value (e.g., Full-Time).
Travel
0%
Ignored for this run, as all services are online.
Skills
25%
Measures how many required skills the Resource has.
Availability
25%
Checks if the Resource has enough hours available for the Appointment.
Workload
25%
Compares the Resource’s total weekly hours against their limit.
Attributes
25%
Matches Resource attributes (e.g. gender, language) to Participant requirements.
Claim Type is hidden
A Delivery Activity is still created, but with Billing Status = Do Not Bill
✅ Example: A user creates a non-billable Participant Note for a group session and selects “Community Access” as the Appointment Service. Maica logs the note and creates a Delivery Activity for reporting, but excludes it from invoicing.
This allows for the selection of a Category by selecting one from the provided dropdown list.
Interaction Type
This allows for the selection of a Interaction Type by selecting one from the provided dropdown list.
Participant
This allows for the selection of Participant(s) by simply typing a name of a Participant (or multiple) or by clicking on the Filter icon which allows for Smart Selection of Participant(s).
This is a required field as Notes in Maica are always held against a Participant.
Goal
Once a Participant has been selected, this allows for the Participant Note to be associated with a Goal
Date & Time
The Date & Time details are pre-populated from the current Date & Time, and the duration is set to 15 minutes. The Date & Time can be changed manually if required, and your default duration can also be adjusted in Maica Settings; click here to learn more.
Note Text
This allows for custom text around the details of the Note. You can also insert a template here.
Billable Participant Note
This toggle allows for the Note to be billable. If toggled on, Maica will generate an Invoice Line Item for the selected Appointment Service and duration/quantity.
Maica will also validate that the selected Participant has the an Agreement for the selected Service. If they don't, Maica will alert you and not allow the Note to be continued to the next stage. To learn more, see below.
1
This is the total cost of the Note. It is calculated based on the Duration and price of the Appointment Service.
2
This is the amount of Available Funding the selected Participant has within their Service Agreement for the allocated Appointment Service.
3
This is the quantity of the created Billable Participant Note based on the Start Time and End Time for each selected Participant. For example, the shown Note time is from 9:39am - 9:54am, this is a quantity of 0.25 which represents a 1/4 of an hour. This field is adjustable, please refer to the Adjusted Quantity section for further information.
4
This is a dropdown to select the required Claim Type.


If no Location is selected, the Time Zone can still be selected manually from the picklist.
Example
Outcome
User creates an Appointment for 9:00 AM in Perth
✅ Appointment shows as 9:00 AM in Perth time, but 11:00 AM for users in Sydney.
A border Location causes conflicting timezone logic
✅ User is shown a confirmation modal and can override the timezone if needed.
A new Appointment is created with no Location
✅ User can select the timezone manually via picklist.
A user views an Appointment created in a different zone
✅ Maica shows the time adjusted to the viewer’s local timezone (e.g. Planner, Quick Info).
Location is updated post-save
✅ System re-evaluates and prompts to apply new timezone via modal.
Previous/Next Appointment
This is either the previous Appointment (in cases where travel is to an Appointment) or the next Appointment (in cases where travel is from an Appointment).
Home Address
This is the address on the Salesforce User profile linked to the Resource record.
Primary Location
This is a lookup on the Resource record which is associated with a location containing an address.
Current Location
The current location of the Resource (User) using Maica







This allows for the selection of by simply typing a name of a Resource (or multiple) or by clicking on the Filter icon which allows for of .
This allows for the selection of by simply typing a name of a Asset (or multiple) or by clicking on the Filter icon which allows for of .
Date & Time Details
The date and time details are pre-populated from the so there is nothing to do for the user.
This allows for the selection of . You can add an by typing the name of the service, or by using any key words configured within the service. For example: If you were adding Support Coordination, you could type Support Coordination, or, advice.
Claim Type
This allows for the selection of a Claim Type by selecting one from the provided dropdown list.
Time Zone
When creating a new Appointment, the timezone is automatically set & displayed based on the Salesforce user’s current browser timezone. This occurs before a Location is selected.
This alert will show in the instance where you have an incorrect ratio. An incorrect ratio is a situation in which the number of selected Resource(s) or Participant(s) does not match the specified ratio number.
For example, if you have an incorrect ratio of Resource(s), Maica will alert you with the following warning:
The Appointment does not have the required number of Resources allocated.
In this instance, Maica will still allow you to continue to the next stage of creating your Appointment. However, it will result in an unfulfilled appointment. Upon completion, an unfulfilled appointment, like any appointment, will be billed against the Participant(s) Service Agreement based on the ratio, not the selected Resource(s).
In order to resolve the Incorrect Ratio alert, ensure that the number of selected Resource(s) and Participant(s) match the specified ratio. For example: If you have 2 resources allocated to your appointment, ensure your ratio number is set to 2.
This alert will show in the instance where the selected Participant(s) have no Agreement for the selected Appointment Service. When this is the case, the Participant(s) will be marked in red (as shown) and the Next button will become unavailable. This is a restriction that Maica enforces where the user cannot continue to create the Appointment.
In order to resolve this alert, you must select an Appointment Service that the selected Participant(s) have an Agreement for and hence can be billed against after your Appointment is delivered.
When the Participant(s) have an Agreement for the selected Appointment Service, the alert will be replaced by the following:
Provides an overview of the selected service and the available funding in the Participant(s) plan for said service.
Indicates that the service will be billed against a Category Agreement Item
Indicates that the service will be billed against a Statement Agreement Item
Allows for multiple services to be added to the Appointment, as long as the selected Participant(s) have an Agreement for all Services being added.
This alert will show in the instance where the selected Resource(s) have a Roster Mode conflict and hence cannot be allocated to the proposed Appointment. This error is also a restriction that Maica enforces where the user cannot continue to create an Appointment.
In order to resolve this alert, you must select Resource(s) that are set to a Roster Mode of Appointment during the time of the proposed Appointment, or, if they are set to Shift, the proposed Appointment must be scheduled during an active Shift for the allocated Resource(s).
You can set a Resource(s) Roster Mode on their Resource Profile, Availability Records, or by using a in your Maica organisation for all Resource(s). To learn more, click the links.
This allows for the selection of by simply typing a name of a Participant (or multiple) or by clicking on the Filter icon which allows for of .
Similar to Checking-In, Checking-Out of Appointments sets the endpoint for Timesheets as well as Invoices. Again, whilst this is not a mandated process, it is recommended to track your care team's movements as well as time spent. In addition to mirroring much of the Check-In experience, when Checking-Out, you are also able to stipulate who is Checking-Out and how much time has been spent on each Appointment Service delivered during the Appointment. If allowed by the User, Checking-Out also captures the geolocation of the Appointment Check-Out.
Quick completing an Appointment bypasses the checking in/out processes and sets an Appointment to the completed status with a single click. It is possible to still capture Appointment Service information whilst doing this.
The cancellation of an Appointment records the reason and sets the status to cancelled as well as any associated Delivery Activities. The Appointments is not deleted but placed into a cancelled status allowing you to charge for cancellations.
This provides for the ability to attach files to any given Appointment, including photos taken on a mobile device. These files are stored against the Salesforce Appointment record.
This allows you to record signatures for each Participant who is associated with an Appointment. Signature files are captured as timestamped images against the Salesforce Appointment record.
The management of breaks that might occur during Appointments can become important and this action allows you to record any breaks taken, whether billable or not during any given Appointment.
Appointment Expenses allows you to add Expense records against a Resource that may occur during a Shift, such as having to pay a for a Parking Spot.
It is possible to take Participant Notes during the management of an Appointment at any time, including for already completed Appointments.
Checklists allow you to complete a set of pre-defined tasks that have been set (via Maica Checklists) for each Appointment Service delivered during the Appointment.
This opens the Salesforce Appointment profile which allows you to see all relevant Appointment information using the native Salesforce platform.
The Google Maps action opens the directions to the Appointment from a number of selectable starting points in Google Maps, directly from the Appointment.
In order to begin actioning an Appointment, simply click on the Appointment in your Planner, then click the View button. Once the Appointment is showing, the available Appointment Actions (depending on your Appointment Status), will be visible on the bottom of the window, other than the Open Appointment Profile action, which is in the top right corner, as shown below.
Some Actions are also available from the Appointment Quick Information dialog, as shown below. The Quick Information Actions are accessible simply by clicking the Appointment and without having to open the entire module.
The visibility of the Appointment actions are dependant on the status of the Appointment. Please refer to the table below to learn which action is available for each Appointment status.
Scheduled (Pre Check-In)
Check-In Quick Completion Cancellation Attach Files Participant Signatures Appointment Breaks Participant Notes Checklist Open Appointment Profile
In Progress (Post Check-In)
Check-Out Cancellation Attach Files Participant Signatures Appointment Breaks Participant Notes Checklist Open Appointment Profile
Completed (Post Check-Out)
Appointment Breaks Participant Notes Open Appointment Profile
Maica provides control over how Appointment Resources are managed, ensuring your team always has visibility, data integrity, and the right level of access when managing Appointments. Appointment Resources in Maica operate under a status-based acceptance workflow. This allows teams to clearly define whether a Resource is available and approved to attend an Appointment.
Each Appointment Resource record includes a status—Pending or Accepted—which determines whether the Resource is authorised to carry out Appointment actions.
For a Resource, the visibility of the Appointment Actions are dependant on the Status of that particular Resource for that specific Appointment.
Resources who have not been marked as Accepted for an Appointment cannot:
Check In/Out
Quick Complete
Cancel Appointments
When Recurring Appointments are generated from a Master:
The Appointment Resource Status is automatically inherited from the Master record.
Updates made to the Master (e.g., a status change) can cascade to all related Appointments if triggered manually.
The table below outlines a few common scenarios around Resource Status and Scheduler Permissions and how Maica handles them in each case.
A Resource is assigned but still Pending
❌ Cannot check in, complete, or cancel
Scheduler with Accept All Permission
✅ Can approve any Resource directly
Care Worker without Permission tries to accept themselves
❌ Action is blocked
Recurring Appointment from Accepted Master
✅ All inherit Accepted status
Scheduler adds and approves on the spot
✅ Can approve via warning icon
Resource tries to check in for another Resource
❌ Not allowed without permission
Checking into Appointments sets the baseline for generating Timesheets as well as Invoices. Whilst this is not a mandated process, it is recommended to track your care team's movements as well as time spent. If allowed by the User, the Checking-In process also captures the geolocation of the Appointment Check-In.
5
Select Fields
Configure which columns appear in the table, including custom or formula fields. To learn more, click here.
6
Refresh
Reload the table to display the most up-to-date data.
7
New Appointment
Create a new Appointment or Shift directly from the Schedule Manager.
8
Resource Optimiser
Launch the Optimiser tool, as available in the Planner. To learn more, click here.
9
New Participant Note
Create a Participant Note directly from the Schedule Manager.
10
Timezone
Displays the timezone in which Appointments and Shifts are shown. To learn more about Timezones in Maica, .
11
Actions Dropdown
Provides access to bulk actions. To learn more about each action, click here.
12
Appointment Actions
A row-level dropdown menu on each Appointment or Shift. This allows you to open, manage, or perform actions on an individual record.

Incident Type
Classifies the event as an Incident, Near Miss, or Hazard.
Incident Status
Tracks progress (New → Under Investigation → Escalated → Closed).
Reported By
The reporting User.
Appointment
The associated Appointment.
Participant
The Participant affected by the incident.
Incident Date and Time
Exact date and time the incident occurred. Not the time it was reported.
Subject
A short summary describing the incident.
Description
A factual account of what happened, including contributors, sequence of events, and why it occurred.
Immediate Actions
Any urgent actions, first aid, or interventions taken at the time.
Incident Location
Address or description of where the incident occurred.
Attachments
Photos, documents, or evidence supporting the incident record.
Participant Harmed
Indicates whether the Participant was harmed.
Harm Detail
Further detail about the nature and extent of the harm (displayed only if harm = Yes).
Family Notified
Whether a family member or guardian was informed.
External Agency Notified
Whether any external services were contacted.
External Agencies Contacted
Police, Ambulance, Fire, Hospital, Coroner or Other.
Other External Agencies
Additional agencies not listed above.
External Agency Reference
Any case numbers or reference details provided by agencies.
Witnesses
Names, roles, and contact details of witnesses, if applicable.
Review Concluded Date
When the internal investigation was completed.
Review Conducted By
The staff member who completed the review.
Review Disclosure
Indicates whether the incident was disclosed to an external regulatory or oversight body.
Review Conclusions / Actions
Summary of findings and any recommended or completed actions.






Learn about how the Smart Selection Filter works in Maica
The Smart Selection Filter is a tool designed to identify and rank the most suitable , , or for an based on a range of possible Attributes. It simplifies the roster selection process by comparing all available options to selected attributes and presenting them in an ordered list based on matches. This feature allows you to quickly and efficiently select the optimal fit for your .
Unlike the Resource Optimiser (which evaluates multiple Appointments at once), Smart Selection is a single-record, real-time matching tool designed to help end users pick the best candidate during scheduling.
Learn about managing Appointments in Maica.
Once an has been , you may want to change some of the details, such as the Resource(s) or Checklist applicable to the . All this can be done via the Manage Appointment processes outlined in this article.
In order to begin Managing an Appointment, simply click on the Appointment in your Planner. To manage the fields after selecting an , click the edit button in the bottom right corner of the Manage Appointment screen. Until you click this button, all fields will be read-only.

The Smart Selection Filter helps end users choose the most suitable:
Participant(s)
Resource(s)
Asset(s)
for an Appointment or Shift by:
Filtering out anyone who fails key requirements
Scoring everyone who remains
Ranking them in order of suitability based on your selected Sort Criteria
It uses a simplified version of the Resource Optimiser, providing real-time scoring for a single selection.
In Maica, you select Participant(s), Resource(s), and Asset(s) in the Basic Details stage of creating or managing an Appointment, it is here you will also find the Smart Selection Filter. On the right side of the selection search box, you will see a Filter symbol; simply click this Filter to open the Smart Selection Filter pop-up, as shown below.
This tool can also be accessed across Maica where Participant, Resource or Asset selectors are available
Once you have clicked on the Filter icon, and Smart Selection Filter pop-up has been presented, you will notice a number of elements within the tool. These are described below:
Sort Order Toggle
This button allows you to switch the display order of the list between ascending and descending, letting you view the items from top to bottom or bottom to top based on the current sort criteria.
Score
Displays the calculated Matching Score (%) for each Resource. The score reflects how well the Resource meets the current Skills, Attributes, Availability, Workload, and Travel criteria (based on Matching Score weightings). The list is sorted by this score unless you change the Sort Criteria.
Sort Criteria Dropdown
Allows you to choose how the Resource list is ordered. Options include: Availability, Workload, Skills, Attributes, Travel, and Overall Matching Score. This determines which scoring or attribute value the table sorts by. These options are detailed .
Ranking Criteria
Allows you to add additional scoring rules that influence how Resources are ranked. Ranking Criteria work the same as in the : each rule consists of a Field, Operator, and Value, and Resources earn score if they match the defined rules.
Settings
Opens the Smart Selection Filter settings panel, allowing you to refine which Resources appear in the list. This includes options such as Only allocated Resources (show only Resources linked to the selected Participant) and Only matched Resources (hide Resources that do not match any selected Skills or Attributes). These settings affect the candidate list before scoring is applied.
When selecting a Resource(s), you can chose to order your list based on a number of additional criteria. These are further explained in the table below:
Skills
Measures how many of the required Skills a Resource has compared with the total Skills needed.
Availability
Checks whether the Resource has enough Available hours on the relevant day to cover the Appointment or Shift. Any existing usage or unavailability is subtracted from the daily limit, and the remaining time is compared against the requirement. The resulting score is weighted by the Availability percentage.
Workload
Evaluates weekly capacity by comparing the required minutes for the Appointment or Shift plus the Resource’s current scheduled hours against their weekly limit. The result is scaled by the Workload importance percentage.
Attributes
Counts how many requested Attributes a Resource satisfies (for example, gender, language, or experience).
Travel
Scores proximity by comparing the Resource’s distance to the Appointment location against the closest candidate. Resources co-located or nearest to the site receive the highest score, weighted by the Travel importance percentage.
To use the Smart Selection Filter, you only need to open it and select your Resource, Participant or Asset, as they will already be ranked by scores generated from your Global Settings and Appointment conditions!
However, we advise adding Ranking Criteria refine suitability. To do so,
Click Add Criteria.
A new filter row will appear where you can specify the Field, Operator, and Value.
Multiple criteria can be added to refine the criteria further.
Understanding Filter Components
Each criterion is made up of three components:
Field
Defines which field the Optimiser will evaluate. Fields are grouped under Resource or Skill objects. Examples include Resource → Work Type, Resource → Gender, or Skill → Certificate.
Operator
Determines how the value is compared to the field. Common operators include equals, not equal to, contains, and does not contain. The Operator value is refined depending on the selected Field.
Value
The specific value being matched against the field. This may be a picklist option, text entry, or date, depending on the selected field. For example, if Resource → Gender is chosen, available values might be Man or Woman.
Once done, click the ✓ button to apply your selected Criteria.
The candidate list will update automatically, with each row recalculated based on your filters and Smart Selection logic and new percentages presented.
You can click on a % score to see a more detailed breakdown of that score
The Smart Selection Filter adapts depending on the type of record you are selecting.
When selecting a Resource, Smart Selection uses the full Matching Score logic, including:
Skills
Attributes
Availability
Workload
Travel
Ranking Criteria
Sort Criteria options include all categories, plus the Overall Matching Score, which uses the same weighting model as the Optimiser.
When selecting a Participant, Smart Selection uses a simplified evaluation model:
Only Attributes are used for scoring
Skills, availability, workload, and travel do not apply
Ranking Criteria can still be added, but only Attribute-based fields impact scoring
The Score column for Participants represents the number of matched Attributes.
Asset matching also uses Attributes only. Examples include:
Vehicle type
Equipment category
Capacity
Location
Skills and capacity-based logic used for Resources do not apply. The Score column reflects matched Attribute count.
These available options are summarised in the table below:
Resource
✔
✔
✔
✔
✔
Overall Matching Score (weighted)
Participant
Once editing, you are able to manage the following sections:
In this section you can manage the Participant(s), Resource(s) and Asset(s) allocated to your selected Appointment. Similarly to Creating an Appointment, you can do this by simply typing the name of a Participant, Resource or Asset (or multiple), or by clicking on the Filter icon which allows for Smart Selection of any of the above mentioned.
You can also adjust Date & Time Information as well as the Type of Appointment. This is aimed at showing you quickly who is attending and who is delivering services on what date and and what time.
This section allows you to manage your existing Appointment Service(s) as well as add new Appointment Service(s) if needed.
The following fields are manageable:
1
Click this button to add an additional Appointment Service(s).
2
Change the quantity of an to control how long each may spend at an . The quantity of an is further explained .
3
Click this button to refresh any changes to your including an adjustment of quantity. This will update any relevant information including the Service cost.
4
This number outlines the number of Appointment Service(s) that are connected to your appointment.
5
Click this button to mark this as cancelled, this will exclude this Service from your .
If the selected Participant(s) do not have an Agreement for the added Appointment Service, an error will occur. This error is further detailed here.
This section enables the editing of the Location at which the Appointment is being held including a lookup to an existing Location, a Participant Mailing Address, a manually-entered Address, or a Digital Location for this Appointment only.
When managing Location, there is a Recalculate Travel button located in the top right hand corner of the modal. This enhancement allows you to refresh travel times and distances directly within the modal, without needing to update the Origin/Destination values or reload the modal if changes have been made prior.
The focus of this section is to edit the Shift(s) and Checklist(s) applicable to this Appointment. The Shift lookup is filtered by active Shift(s) at the same Location that the Appointment is being held.
The Custom Fields tab captures any information from Custom Fields that have been added to your Organisations Appointment profile beyond what Maica offers. This section allows for the management of already added fields, not the addition of new fields.
When editing a Recurring Schedule, you have the following options:
The first Appointment in a series of Recurring Appointments is seen to be the blueprint of what will be created in future Appointments. This includes all details for the Appointment, such as Participant(s), Resource(s), Location, Date & Time Information, etc. This means that any modifications made to the first Appointment will affect all subsequent Recurring Appointments generated, thus adjustments should be carefully examined.
Maica will prompt you to confirm that you would like to apply changes to all future Appointments, as shown below.
Editing any subsequent Appointment within a series of Recurring Appointments gives you the option to either apply changes to just the Appointment being edited or to all future Appointments. Again, Maica will prompt you to confirm which option you would like to apply the changes to, as shown below.
If you select to apply changes only to the Appointment being edited only, then the updated Appointment retains its link to the parent Appointment Schedule, however Maica identifies it as a modified Appointment and hence as a "gap" in the schedule, which prevents the creation of any replacement or duplicate Appointment records. This logic is further detailed below:
If you select to apply changes to all future Appointments, then essentially the edited Appointment becomes the Master Appointment of a new Appointment Schedule and a new Schedule is created, beginning from the selected Appointment onwards.
The new Schedule is automatically linked back to the original using the Previous Schedule field (described below), ensuring a clear audit trail and visibility of historical changes.
Previous Schedule Field: This field shows the original Schedule that this one was created from (e.g. when changes were applied to all future Appointments mid-series). It helps track the full history of recurring schedule changes and ensures clean separation between old and new appointment series.
This prevents unintended changes from being applied to both Schedules and ensures historical accuracy is maintained. The logic is further detailed below:
Once you have made the changes, either click the Tick icon to confirm your changes and update your Appointment, or the Undo icon on the bottom left of the screen to cancel your changes.







Learn about the Funding Record and what information it captures in Maica
In Maica, the Funding record contains key information that will drive interactions with your Participants, as well as serving as the foundation for some central Maica functions, such as Service Booking creation.
A Funding record is where you can find the following information and functionality:
PACE Information
Plan Budget Information
Plan Period Information (Start Date & End Date)
NDIA Synchronisation Information (NDIS Reference & Last Sync Date)
A very important point to note about Plan records is that they are created and updated in PRODA only and not Maica. PRODA is the master of this information and Maica simply retrieves the most up-to-date Plan information and create a Funding record based on the retrieved information. What this means is that any updates to the Funding record in Maica will not be reflected in PRODA. This applies to Plan Goal records also. You cannot create a Funding record for your Participants
As mentioned above, Plan records are created and updated in PRODA, Maica only retrieves the information and populates a Funding record based on the retrieved information.
In order to retrieve the required information to populate Funding records for your Participants, refer to Maica's Quick Action tool.
A Funding Record contains a number of components, these are explained in further detail below.
The Funding Item represents the specific Plan Budget Items or Funded Supports included in a Participant's Plan. Generally, these define what Support Category and Support Item (for a stated support) can be selected to form part of a Service Booking.
If Funding Item records exist in Maica, they will be used as an outline when a Service Booking is being created. This essentially means that the Categories and Amounts from the Funding Item will be used as the default Booking Items in the Create Service Booking Quick Action.
To learn more about that the Create Service Booking Quick Action, click .
Plan Budget records can only be retrieved by Maica and used to generate Funding Item records if your Organisation satisfies all of the required criteria set by the NDIS. Please contact the NDIA directly if you want more information regarding Plan Budget access as Maica does not manage or enable this.
Funding Item information will be accessible on the right hand side of your Funding record interface, and will include Budget records and a summary component, as shown below.
Funding Periods allow the NDIA to define how often Participants can access portions of their budget, rather than receiving full access upfront. The NDIS will issue funding intervals of 1, 3, 6, or 12 months for eligible Participants.
When Funding Periods exist, they will display within the related Funding Item in Maica. This allows you to view how the Participant’s total approved budget has been broken into intervals for use.
On the Funding Item, there will be two sections related to Funding Periods:
This section provides an overview of the Funding Period Information, including:
Then, each individual Funding Period record is displayed in the table at the bottom of the Funding Item, including:
In order to learn more about Participant Funding Periods, click .
If the Participant has identified specific Plan Goals in their planning conversations with the NDIS, these can be retrieved and made available in Maica as Funding Goals.
In Maica, a Funding Goal has a Master-Detail relationship with Funding. This means that you cannot have a Funding Goal without Funding. Furthermore, if Funding is deleted, all associated Funding Goal records will also be deleted.
Additionally, due to the nature of how Plan Goal records are stored and managed by the NDIS, Maica re-creates these records as part of each sync. This means that any changes, either new records or updates to existing records will be lost following a sync. Essentially Plan Goal records, like Plans, are managed by the NDIS and we do not recommend updating these records in Maica.
You may wish to create your own Participant Goals seperate from Funding Goals to manage the Goals you have set between your Organisation and the Participant.
As above, Funding Goal information will be accessible on the right hand side of your Funding record interface.
The Service Booking related component provides a view of all your Participants Service Booking records that have been created in Maica and PRODA that are related to the specific Funding you are viewing.
The Funding is the key component in creating a Service Booking, as Maica cannot create a Service Booking in PRODA without a reference to the Funding.
Service Bookings can be created in Maica directly from the Funding Record, to learn more about this process, click .
As above, Service Booking information will be accessible on the right hand side of your Funding record interface.
The Budget Information section has a number of Roll-Up Summary fields that collect data from the corresponding Funding Item record(s). For example, if there are five Funding Item entries, each with an Approved Amount of $2000, the Fundings record's Total Approved Value will be $10,000.
If there is no Funding Item data, all Totals will be $0 with 0% Utilisation.
The NDIA Synchronisation Information section contains information on to help identify your Participants Plan in PRODA as well as when it was last synchronised in Maica.
If your Plan expires and your new Plan has not yet been finalised, the NDIS will automatically extend your current Plan for up to another 12 months.
This means that your present financing will continue until your new Plan is finalised, ensuring that you have no gaps in your money or support.
If your current Plan is less than a 12-month plan, your extended Plan will be for the same time period; for example, a six-month Plan will be automatically extended for six months.
Maica 'listens' for this event in PRODA and will extend the End Date of the corresponding Funding Record for you.
If the Plan has been automatically extended as described above, the End Date will be automatically extended for all active Service Booking Records.
Again, in this instance, Maica will update all relevant Service Booking Records.
Service Bookings
Plan Component
Identifies the part of the plan this funding applies to (e.g. Core Flexible)
Management Type
Indicates if the funding is Plan Managed or Self Managed
Instalment Type
Defines the interval type (e.g. Regular)
Instalment Start Date
Start date of the current funding period
Instalment End Date
End date of the current funding period
Next Instalment Start Date
Start date of the upcoming funding period
Next Instalment End Date
End date of the upcoming funding period
Next Instalment Release Amount
Amount to be released at the start of the next funding period
Funding Period ID
A unique reference for each funding period. You can also click into the Funding Period ID to view the record in further detail.
Amount
The amount of budget available for that period
End Date
The final date the funds for this period are valid
Released
Indicates whether the funds are currently available (Yes/Not yet released)
Total Approved
SUM total of the Approved Amount
Total Allocated
SUM total of the Allocated Amount
Total Remaining
SUM total of the Remaining Amount
Total Spent
SUM total of the Spent Amount
Utilisation
Formula that divides the Total Approved by the Total Spent to display a percentage indicating how much of the total Approved Plan Budget has been spent.
NDIS Reference
The unique identifier (or ID) assigned to the Plan in PRODA. This is not generated by Maica.
Last NDIS Sync
Represents the date and time the Plan record was last synchronised or refreshed from PRODA.






Contacts work in Salesforce, Trailhead has a number of great learning resources, including hands-on challenges and modules.Contact records are the place where you capture and manage attributes and information of your Participants, including:
Personal Information (i.e. Name)
Contact Information (i.e. Phone and Email)
Address Information
Demographic Information (i.e. Birthdate, Age, Primary Language)
NDIS Number (NDIS only)
Communication Preferences
The Participant Record includes handy Summary Components containing key information about the Participants Funding , Service Bookings , Service Agreements and Schedule. These components are:
This component summarises crucial information from the Participant's Funding right on the Contact record. This means you will not have to sift through associated documents to receive a quick, at-a-glance summary of the Participant's Funding information. It is located on the right hand side of the record under the Funding Information tab.
Similar to the Funding component, this component summarises the key period and budget information for any active Service Booking records associated with the Participant. This will only be relevant for your non-PACE NDIS Participants.
Similar to the above components, this component summarises the key period and budget information for any active Service Agreements records associated with the Participant. This component will show you information around each Agreements Approved Amounts, Remaining Amounts, Utilised Amounts and End Date.
These fields are calculated by the following:
Agreement Approved Amount: maica_cc__Service_Agreement__c.maica_cc__Approved_Amount__c
Agreement Utilised Amount: maica_cc__Service_Agreement__c.maica_cc__Utilised_Amount__c
Agreement Remaining Amount: maica_cc__Service_Agreement__c.maica_cc__Remaining_Amount__c
Agreement End Date: maica_cc__Service_Agreement__c.maica_cc__End_Date__c
If a Participant has multiple Service Agreements, you will be able to switch between them on the Summary Component through tabs, as shown below.
Each tab will display the same fields listed above for each individual Agreement.
The Active Schedule component provides visibility into all active Recurring Appointment Schedules linked to a Participant.
This component displays key scheduling information to help users understand the current structure of recurring appointments at a glance.
Each record in the Active Schedule list includes:
Schedule ID
Schedule Start Date
Schedule End Date
Frequency
Interval
Appointment Service(s)
Next Appointment Date (linked to the Appointment record)
Type
Records are sorted in ascending order by Schedule Start Date for clarity. A scroll bar is provided for large lists, with placeholder text shown when no schedules match the criteria.
The component will display as shown below:
The Upcoming Appointments section provides a clear, paginated list of a Participant’s scheduled Appointments. It allows you to quickly review upcoming services, with filtering options to improve visibility and management.
This list is especially useful for seeing future commitments at a glance without navigating into the Planner.
Appointments are displayed in pages of up to 10 records at a time, with scrolling available to access more. The list includes key details such as:
Scheduled Start Date/Time (recurring icons are shown for repeating Appointments)
Status of the Appointment
Duration in minutes
Ratio
Each record can be expanded to show further information, including the Resource(s) delivering the service, the Service(s) attached, the Appointment Address, and a link for directions that opens directly in Google Maps.
Additionally, to help you focus on the most relevant information, you can filter the list by Status or by a specific time frame. Available time frames include:
Today
Tomorrow
This Week
Next Week
Next Two Weeks (Fortnight)
This Month
All
Appointment records are accessible via the Scheduled Start Date link.
The Participant Record also includes handy Related Lists containing key information about the Participants. The key lists are further detailed below:
The Connections List allows you to define relationships between Contacts. This could include both personal relationships as well as any other form of connection between people.
The easiest way to access Connections is via the Participant Profile under Related.
Before detailing how Connections function in further detail, here are some things you should know about this feature:
Connections are reciprocal. Meaning, Maica will create a corresponding Connection for both Contacts.
You can create your own Connection types beyond what Maica offers out of the box within the Connection Settings.
Now, please refer below to see what a typical Connection record will look like in Maica.
In order to create a new Connection, simply click the New button and complete the following fields:
Contact: Maica auto-populates this field with the name of the Contact the Connection record is connected to.
Related Contact: Specifies the Contact who's related to the person in the Contact field.
Type: Specifies how the Related Contact is connected to the Contact. In the below example, Andrew Milne is Luca Milne's parent.
Status: Specifies whether this is a current or former Connection.
Once these fields have been populated, a few additional options are available for you to record, including:
Primary Contact: When this option is selected, Maica will display the Related Contact on the Participant profile for ease of access to critical information. We have shown you a sample of this at the bottom of this article.
Next of Kin: Specifies that the Related Contact is the Next of Kin for the Contact.
Description: A place to add additional information about the Connection.
Statement Recipient: Specifies that the Related Contact is the recipient of the Statement.
Invoice Recipient: Specifies that the Related Contact is the recipient of the Invoice for self managed Service Agreements.
Once done, your Connection record will be saved within the Profile of both Contacts.
The Participant Resource related list allows for the management of Resources being assigned to Participants. It is located under Client Care tab.
The benefit of this list is to be able to see which Participants are associated with which Resources, as shown below. This is particularly useful if a Participant is associated with multiple Resources.
To link a Participant with a Resource, simply click New, select the desired Resource from the dropdown, nominate a Date Range, and Save.
The Participant Goal related list allows for the management of Goals being assigned to Participants.
The benefit of this list is to be able to track and manage the Goals associated with each Participant, including their progress over time. This is particularly useful when a Participant has multiple Goals at different stages.
To create a new Participant Goal, simply click New, complete the required fields:
Goal Name: Enter a custom Goal Name for your Participant
Contact: Maica auto-populates this field with the name of the Contact the Connection record is connected to.
Goal: Associate a Goal or create a new one to assign to the selected Participant
Start Date
As well as any optional fields such as:
End Date
Stage: Choose between Definition, In Progress, Partially Achieved, Fully Achieved or Not Achieved.
Description
Once done, simply click Save.
Below are some example scenarios of how Participant Goals will behave in Maica:
A Participant has multiple historic Goals
✅ Only active (non-archived) Goals are shown in lookup fields.
A Maica user tries to add a Goal to a new Participant Note
✅ Archived Goals are not displayed, ensuring only current Goals can be linked.
A Maica user marks a Goal as archived
✅ The Goal is no longer visible in lookup fields across the system.
Maica includes an automated process to populate key geographical classification fields on the Participant Record using Mailing Postal Code and Mailing City. This ensures accurate regional classification without manual input, streamlining data entry and improving reporting accuracy.
When a Participants Mailing Postal Code and Mailing City are provided, Maica automatically matches these values against a Postcode record to populate the following fields on the Participant Record:
MMM Classification (maica_cc__MMM_Classification__c)
PHN (Primary Health Network) (maica_cc__PHN__c)
LGA (Local Government Area) (maica_cc__LGA__c)
Mailing Postal Code: 3184
Mailing City: Elwood
LGA: Port Phillip
PHN: South Eastern Melbourne
MMM Classification: 1
Please note:
If you modify the Mailing City or Mailing Postal Code to values that do not correspond to a Postcode record, Maica clears the LGA, PHN, and MMM Classification fields.
You cannot manually edit these fields, ensuring consistency and preventing incorrect classifications.
✖
✔
✖
✖
✖
Attribute match count
Asset
✖
✔
✖
✖
Optional (location-based)
Attribute match count


Postcode Suburb Key = 3184Elwood






Learn about the Resource Profile and its components in Maica
In Maica, the Resource Profile is the parent object that supports two Record Types: Resources and Assets. A Resource and Asset are defined in Maica as shown below:
Resource: The care workers or clinicians working directly with your Participants.
Asset: The non-human Resources such as rooms, cars, medical equipment, etc.
You can define your Resource type through the Record Type when creating a Resource.
Resource attributes are fields that are stored against the Resource profile. Maica includes a number of these attributes, however these are easily broadened using Salesforce's standard toolset.
Depending on the Record Type, there will be different available attributes on the Resource Profile. These are explained in more detail below.
Asset AttributesThe table below outlines the attribute fields related to the Asset Record Type.
Resource AttributesThe table below outlines the attribute fields related to the Resource Record Type.
In addition to the standard attributes described above, Maica also provides a variety of related information to further manage the configuration of a Resource.
The Resource Participants related list allows for the management of Participants being assigned to Resources. It is located under Profile Management tab and is the source for the Number of Clients attribute.
The benefit of this list is to be able to see which Resources are managing which Participants, as shown below. This is particularly useful if a Resource is managing multiple Participants.
To link a Resource with a Participant, simply click New, select the desired Participant from the dropdown, nominate a Date Range, and Save.
Maica offers the ability to globally record a set of Skills such as Driving a Car or Administering Medicine. Those Skills can then be assigned to Resources via the Skills related list as shown below.
To add a Skill , simply click New, select the desired Skill from the dropdown, nominate a Date Range, provide an optional description and Save.
Shift Resource is a related list of any Shift the associated Resource has been assigned to - it's simply a record of that person being part of the shift and contains details of the Shift.
Shift Resources are managed through creating Shifts in the Planner, and it is recommended that the list on the Resource Record is simply used as a reference. It will be updated dynamically and there is no need for manual intervention.
Expenses are records that indicate an expense has been incurred by a Resource that needs to be paid back to said Resource by the service provider.
Expenses are managed through the management or creation of , and it is recommended that the list on the Resource Record is simply used as a reference. It will be updated dynamically and there is no need for manual intervention.
The Appointments related list is a summary of all Appointments the Resource has been assigned to.
Appointments are managed through creating Appointments on the , and it is recommended that the list on the Resource Record is simply used as a reference. It will be updated dynamically and there is no need for manual intervention.
The Timesheets related list is a summary of all Timesheets related to the Resource.
Appointments are managed through or Maica's automation, and it is recommended that the list on the Resource Record is simply used as a reference. It will be updated dynamically and there is no need for manual intervention.
An Availability Record is used in Maica to record when a particular Resource is available for accepting either Shifts or Appointments.
Availability Records are constructed based on the following fields:
Simply click New and populate the above fields to create an Availability record for your Resource.
Maica's construction of Availability by referencing Operating Hour records enables centralised management of operating times. If Operating Hours ever change, simply change the organisational Operating Hour record rather than needing to adjust working hours for each Resource.
An Unavailability Record is used in Maica to record when a particular Resource is not available for accepting either Shifts or Appointments.
Resources can simply populate the Date and Reason for their Unavailability, and it will be created as a record on their profile.
As mentioned above, Roster Mode in Maica is used to define the behaviour and validation applied when scheduling Appointments for a Resource. When selecting a Roster Mode for a Resource or Availability, there are two selectable options. These are:
Appointment: This means Appointments can be scheduled at any time for a Resource provided it is within any active Availability record(s) if these exist. If no Availability record(s) exist, Appointments can be created at any time.
Shift: This means Appointments can only be scheduled within a Shift that a Resource is part of and it is within any active Availability record(s) if these exist. If no Availability record(s) exist, Appointments still must fall within a Shift that the Resource is assigned to.
For example, if your Resource was in Shift Mode, then you can only schedule an Appointment for them during their assigned Shifts. If they have a Shift from 9 AM to 1 PM, you can only schedule Appointments within that window. Even if they are available for the entire day, you cannot schedule outside their Shift times.
Additionally, if your Resource is in Appointment Mode during a period of Availability, you could not assign them to a Shift during that same period. A Resource must be in Shift Mode in order to be assigned a Shift.
Default Quantity
Number
Birthdate
Date
Gender
Picklist
Age
Formula
Derived from Birthdate
Primary Language
Picklist
Derived from the Global Value Set of Languages
Age Group
Formula
Derived from Birthdate
Mobile
Formula
The mobile from the associated User record
Phone
Formula
The phone from the associated User record
Email
Formula
The email from the associated User record
Address
Formula
The address from the associated User record
Timezone
Formula
The timezone from the associated User record
ID Number
Text
The Staff Member or Employee Number used to identify the Resource.
Start Date
Date
End Date
Date
Employment Category
Picklist
Employment Type
Picklist
Induction Complete
Checkbox
Indicates if the Resource has completed your Induction process.
Position
Picklist (Multi-Select)
The employment position held by the Resource. Here you can replace existing Maica values with those that suit your organisation's Positions.
Roster Mode
Picklist
Used to define the behaviour and validation applied when scheduling Appointments for the Resource. See for further information.
Primary Location
Lookup
The Location where the Resource works most often.
Daily Hours Limit
Number
The maximum number of hours the Resource can work per day. This field is utilised in the .
Weekly Hours Limit
Number
The maximum number of hours the Resource can work per week. This field is utilised in the .
Weekly Hours Minimum
Number
The minimum number of hours the Resource should be scheduled to work each week. This field is utilised in the .
Maximum Client Number
Number
Number of Clients
Roll-Up Summary
Derived from the number of associated Resource Participants.
Schedule Notification
Picklist
Indicates if and how often the Resource is emailed their Appointment Schedule
Roster ModeResourceGlobal Roster ModeID Number
Text
The Asset Number used to identify the Resource.
Type
Picklist
Picklist of any default or custom Asset Types
Appointment Service
Lookup
Lookup of Appointment Service
Active
Checkbox
Resource Name
Text
User
Lookup
The internal Salesforce User record that the Resource relates to.
Active
Checkbox
Indicates if the Resource record is Active and available within Maica
Timesheet Management
Picklist
Operating Hour
This is a lookup field that defines which operating hour this Resource is available to be scheduled and rostered.
Location
This is a lookup field that defines the Location this Availability period applies to. If you do not select a Location, Maica allows the Resource to work at any Location during the Availability period.
Effective From
The date the Availability period takes effect from or starts, i.e the date from which it applies to the Resource
Effective To
The date the Availability period ends, i.e the date from which it no longer applies to the Resource
Interval
This a picklist field that defines the Interval in which the Availability applies
Roster Mode
Used to define the behaviour and validation applied when scheduling Appointments for the Resource. See below for further information.


Indicates if the Resource record is Active and available within Maica
Ability to enable or Disable for your Resource
Learn about the Resource Optimiser in Maica
The Resource Optimiser is a tool within the Maica Planner used to identify and fill unfilled Appointments or Shifts using Maica's Optimisation Engine.
It consolidates all Appointment and Shift records requiring optimisation into a single screen, allowing users to review, run, and confirm Resource allocations efficiently.
To learn more about how to Maica classifies a record as requiring optimisation, please .
The Optimiser evaluates each Appointment or Shift based on a range of customisable inputs such as Resource Availability, Attributes, Workload, Skills, and Participant Preferences and then fills each one with the most suitable Resource.
The Resource Optimiser can be accessed directly from the Planner Toolbar, as shown below.
To find it, simply:
Open the Planner.
Select the Optimiser icon from the toolbar at the top of the screen.
The Optimiser panel will open, displaying a list of all unfilled Appointments or Shifts within the date range currently shown in the Planner.
When the Optimiser is opened, it retrieves all records where the required number of Resources does not meet the defined ratio and the Status is Scheduled or Planned. These records are considered unfilled and are therefore eligible for optimisation.
Additionally, the Optimiser will also only consolidate records from the defined Period currently displayed in the Planner at the time it is opened.
In summary,
Included Records:
Appointments or Shifts where Status is Scheduled or Planned.
Records where the number of Resources does not meet the Ratio.
Appointments or Shifts visible within the current Planner date range.
Excluded Records
Appointments or Shifts marked as Completed or Cancelled.
Records that already meet the required Resource or Participant Ratio.
Records outside of the visible Planner date range.
The Optimiser is made up of a range of different parts, each are described in the table below:
Please refer to the sections below for further detail on the above described Optimiser parts:
The Resource Pool is used to define a smaller, more relevant group of Resources for optimisation. Only Resources matching the criteria added to the pool will be considered when running the Optimiser.
To configure the Resource Pool:
Click Add Criteria.
A new filter row will appear where you can specify the Field, Operator, and Value.
Multiple criteria can be added to refine the pool further.
Each added criterion is combined with an AND condition, meaning all must be met for a Resource to be included.
Understanding Filter Components
Each criterion is made up of three components:
Example: Adding the criterion Resource → Work Type equals Full-Time limits the pool to only full-time staff. Adding an additional rule such as Skill → Certificate IV in Disability will further narrow the pool so that only full-time staff who hold that qualification are considered.
The Current Pool count shows how many Resources meet all applied criteria.
Unlike the Resource Pool, the Ranking Criteria controls how Resources are scored and prioritised when compared against Appointments or Shifts. It uses the same Add Criteria process as described in the Resource Pool section above, but serves a different function.
While the Resource Pool determines who is eligible to be considered, the Ranking Criteria determines how well those Resources match the Appointment or Shift once they are included.
When Ranking Criteria is applied:
A Resource must meet at least one of the criteria to be included in the Optimiser run.
If a Resource meets none of the criteria, they are excluded entirely.
Resources who meet one or more criteria are included and then ranked based on the number of criteria they satisfy.
Ranking Criteria therefore acts as both:
An inclusion rule (must meet at least one), and
A prioritisation rule (more matches = stronger candidate).
Criterion: Resource → Gender equals Woman
Any Resource who identifies as a Woman will be included and receive scoring contribution for this rule.
Any Resource who does not match this rule receives zero for this criterion and is excluded from automated selection.
Criteria added:
Resource → Region equals East Metro
Resource → Language contains Mandarin
Here is how Resources are treated:
Key behaviour:
Worker A ranks highest because they meet two criteria.
Workers B and C rank below Worker A because they meet only one.
Worker D is excluded because they meet none.
The Matching Score Importance Level determines how much influence each category has on the Resource’s overall matching score. The total of all categories must equal 100%, and each category’s weight can be adjusted manually to prioritise what matters most to your organisation.
The categories are defined below:
Please note, weighting does not filter Resources — it influences how strongly each matching criterion affects the total score.
This Setting restricts Optimisation to Resources who already have a defined relationship with the Participant. Meaning, only Resources who are a to the allocated Participants on the Appointment or Shift will be considered.
The Resources column displays all Resources linked to each Appointment or Shift within the Optimiser. Each Resource is represented by a status indicator (colour and outline) showing their current state in the optimisation or confirmation process. From this column, users can view, update, or manage Resource statuses using the available actions.
Each Resource is displayed as a pill with a distinct border colour and style to indicate its current status.
Each Resource pill includes a dropdown menu providing context-sensitive actions. The available actions depend on the Resource’s current status.
The Appointment Insights modal is available for each Appointment or Shift, and is better used after the Optimiser has been run. It can be accessed by expanding the record and selecting the Insights icon.
The table below details the fields on each Insight:
The Manual Assignment function allows users to select or replace Resources for an Appointment or Shift directly within the Optimiser. It provides full control over Resource allocation without rerunning the optimisation process.
Manual Assignment uses the modal to display all eligible Resources that meet the Optimiser’s current configuration. Each Resource is shown with a corresponding Overall Matching Score, allowing users to make informed selections based on the same scoring logic used by automated optimisation.
Please note, opening the Find Resource respects the defined Resource Pool in the Optimiser. Meaning, if you set Resource → Work Type equals Full-Time, then opening the Find Resource modal will only show Full-Time staff.
Click the Resource Column in the Optimiser to open the Find Resource modal.
Review the list of available Resources and their matching scores. These will be ordered by the assigned Resources, followed by the most suitable remaining Resources.
Use the Search Bar or Sort By options to locate preferred Resources.
Tick the checkbox beside each Resource you wish to assign.
5
Progress Indicator
Shows the number of filled versus total unfilled records (e.g. 0 of 51 filled). Updates automatically during optimisation and provides the ability to pause your run at any stage.
6
Optimisation Trigger
Executes the Optimisation process for selected records based on the current Ranking Criteria, Resource Pool and Settings.
7
Select All
Selects or deselects all records within the list for batch Optimisation or Confirmation.
8
Status Column
Displays the current Status of each Appointment or Shift (e.g. Unfilled, Filled, Partially Filled, or Error).
9
Appointment Column
Shows the Appointment or Shift identifier, including the date and time. Please note, this information is configurable and based on your Appointment Text Format in the.
10
Configurable Column
Allows custom configuration to display additional fields such as Location or Participants.
11
Displays current Resources. (Statuses and Resource Pills described further below)
12
Required Badge
Displays the number of Resources required for the Appointment or Shift based on the defined Ratio.
13
Pending Badge
Displays the number of Resources who have been Broadcast too but have not yet responded. Please note, this is a Broadcasting function which is coming soon to Maica.
14
Accepted Badge
Displays the number of Resources who have Accepted the Appointment or Shift but are not yet confirmed.
15
Confirmed Badge
Displays the number of confirmed Resources currently allocated to the Appointment or Shift.
16
Provides further and more detailed matching information for each Resource, including matched and unmatched criteria. It also displays all Pending Resources related to the Appointment or Shift. (Described further below)
17
Allows manual selection or replacement of Resources from the Appointment or Shift using Maica's Find Resource modal. (Described further below)
18
Undo
Reverts to the last Optimisation for the selected Appointment or Shift.
19
Cancel
Exits the Optimiser without saving any changes made during the current session. A confirmation modal will appear before closing.
20
Confirm
Saves all Optimisation results and applies them to the selected Appointments or Shifts. Once confirmed, a summary screen will display all changes made during the session. Please note, while using the Optimiser, no records are updated in Maica until Confirm is selected. Any changes made prior to confirmation exist only within the Optimiser session.
Worker C
✖
✔
✔
Medium (matches one)
Worker D
✖
✖
✖
Excluded
Withdrawn
Greyed out
Represents a Resource that has been withdrawn from the Appointment or Shift.
Click Confirm to save your selection within the Optimiser session.
The Appointment or Shift will display the newly assigned Resource(s) once the modal closes.
4. Assign multiple Resources at once
Appointment has no Resources assigned and requires 3.
You manually select three Resources from the list and confirm.
All three Resources are added simultaneously. The record will show as filled once confirmed on the main Optimiser screen.
5. Add Resource who does not meet all criteria
Appointment requires 1 Resource; you select a Resource with a lower Matching Score (e.g. 40%).
The selected Resource is manually confirmed.
The Resource is still accepted. The Optimiser does not prevent manual overrides, allowing assignment even if some criteria are unmet.
6. Cancel without confirming
You open Manual Assignment and select Resources but then choose Cancel.
You cancel the selection.
No changes are saved. The Appointment or Shift remains in its previous state.
1
Used to create filters to define a smaller, more relevant group of Resources for Optimisation. Only Resources matching the selected pool criteria will be considered when running the Optimiser. (Described further below)
2
Criteria you add adjust Resource scoring. (Described further below)
3
Provides configuration options for Optimisation behaviour on a per run basis. (Described further below)
4
Status Filters
Allows filtering of Appointments or Shifts within the Optimiser by status, for example showing only Filled or Partially Filled records.
Field
Defines which field the Optimiser will evaluate. Fields are grouped under Resource or Skill objects. Examples include Resource → Work Type, Resource → Gender, or Skill → Certificate.
Operator
Determines how the value is compared to the field. Common operators include equals, not equal to, contains, and does not contain. The Operator value is refined depending on the selected Field.
Value
The specific value being matched against the field. This may be a picklist option, text entry, or date, depending on the selected field. For example, if Resource → Gender is chosen, available values might be Man or Woman.
Worker A
✔
✔
✔
Highest (matches both)
Worker B
✔
✖
✔
Medium (matches one)
Skills
Measures how many of the required Skills a Resource has compared with the total Skills needed.
Availability
Checks whether the Resource has enough Available hours on the relevant day to cover the Appointment or Shift. Any existing usage or unavailability is subtracted from the daily limit, and the remaining time is compared against the requirement. The resulting score is weighted by the Availability percentage.
Workload
Evaluates weekly capacity by comparing the required minutes for the Appointment or Shift plus the Resource’s current scheduled hours against their weekly limit. The result is scaled by the Workload importance percentage.
Attributes
Counts how many requested Attributes a Resource satisfies (for example, gender, language, or experience).
Travel
Scores proximity by comparing the Resource’s distance to the Appointment location against the closest candidate. Resources co-located or nearest to the site receive the highest score, weighted by the Travel importance percentage.
Confirmed
Black outline
Indicates that the Resource has been confirmed for the Appointment or Shift. Confirmed Resources will be applied to the record once the Optimiser session is confirmed.
Accepted
Yellow outline
Indicates that the Resource has accepted an allocation but is not yet confirmed. These Resources are awaiting user confirmation. Note, this is a broadcasting function that is coming soon to Maica.
Pending
Blue outline
Shows that a Resource has been requested but has not yet responded. Pending Resources may later accept or decline. Note, this is a broadcasting function that is coming soon to Maica.
Declined
Red outline
Confirm
Marks the Resource as confirmed for the Appointment or Shift. Once confirmed, the outline changes to black.
Available for Resources with Pending, Withdrawn, Declined or Accepted status.
Decline
Marks the Resource as having declined the allocation. The outline changes to red.
Available for Resources with Pending, Withdrawn, Confirmed or Accepted status.
Withdraw
Withdraws a previously confirmed or accepted Resource. The pill becomes greyed out.
Available for Resources with Confirmed, Accepted, Pending, or Declined status.
Remove
Removes the Resource from the Appointment or Shift entirely. This deletes the pill from the record within the Optimiser.
A previously confirmed Resource becomes unavailable.
Confirmed (black)
User selects Withdraw.
Resource becomes Withdrawn (greyed out).
A declined Resource is no longer relevant.
Declined (red)
User selects Remove.
Resource pill is removed from the Appointment.
A previously unavailable Resource becomes available.
Declined (red)
User selects Confirm.
Appointment ID and Time
Displays the unique Appointment or Shift identifier and its scheduled start and end time.
Location
Shows the Appointment or Shift location or Note (e.g. The Appointment is happening online).
Pending Resources
This is a Broadcasting function, coming to Maica shortly.
Overall Matching Score
Displays a percentage score showing how closely the Resource matches the Appointment or Shift. The score combines all weighted categories (Availability, Workload, Skills, Attributes, and Travel). Note, you can click the score to see a further breakdown of each category, as well as switch between any Resources allocated to the Appointment or Shift.
Matched Criteria
Lists all conditions where the Resource met the Optimiser’s requirements. Each entry includes a short description explaining the match, for example: Available for scheduled time or Within weekly limit.
Unmatched Criteria
Lists any conditions not met by the Resource, preventing a full match. For example: Skill missing – Certificate IV in Disability or Travel distance exceeds defined range.
1. Add extra Resource to a fully filled Appointment
Appointment requires 2 Resources and already has 2 confirmed.
You manually select and add an additional Resource.
The new Resource is added as an extra allocation and displayed in the Optimiser. Maica allows you to do so if desired.
2. Replace a confirmed Resource
Appointment has 1 confirmed Resource who is no longer available.
You open Manual Assignment, deselect the current Resource, and select another.
The new Resource replaces the previous one in the Optimiser view. Changes are not applied to the Appointment record until Confirm is selected.
3. Add Resource to a partially filled Appointment
Appointment requires 2 Resources but currently has 1 confirmed.
You select an additional Resource manually.


Indicates that the Resource declined the allocation. The Resource remains visible until manually removed or withdrawn.
Available for all statuses.
Resource becomes Confirmed and allocated to the Appointment.
The Appointment now shows 2 confirmed Resources and the record will be considered fully filled once confirmed.