Only this pageAll pages
Powered by GitBook
Couldn't generate the PDF for 174 pages, generation stopped at 100.
Extend with 50 more pages.
1 of 100

User Guide

Loading...

Getting Started

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Participants

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Resources

Loading...

The Planner

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Schedule Manager

Loading...

Loading...

Appointments

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Shifts

Loading...

Loading...

Loading...

Loading...

Timesheet

Learn about how Maica uses Timesheets within Maica.

Definition

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.

Purpose

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 .

Usage

Timesheets are generated following the successful completion of either or , via checking out or quick completing these.

Final Thoughts

Timesheets can be enabled or actually fully disabled in Maica. If enabled, each Resource can then be set up for Timesheets generation individually.

Timesheets are a very typical way for Maica to pass information to award interpretation and payroll solutions.

Service Agreement

Learn about how Maica uses Service Agreements within the overall solution.

Definition

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.

Purpose

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.

Usage

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:

Maica considers a Salesforce Contact to be a (or Client) only when an active Service Agreement is captured. It is important to note that the Service Agreement does not need to be fully funded but it does need to exist.

Final Thoughts

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.

Delivery Activity

Definition

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

Location

Learn about how Maica uses Locations within the overall solution.

Definition

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.

Asset

Learn about how Maica uses Assets within the overall solution.

Definition

An Asset is a non-human Resource delivering a service, either via an Appointment or a Shift. This includes information such as location details, availability, unavailability, skills, and the relationship to specific .

Typical Assets might be cars being used to deliver services, rooms being booked, as well as any equipment beign taken to

Resource

Learn about how Maica uses Resources within the overall solution.

Definition

A Resource is a person delivering a service, either via an Appointment or a Shift. This includes information such as personal details, availability, unavailability, skills, and the relationship to specific .

A Resource record is linked to a Salesforce record to provide access to Maica and the underlying Salesforce platform.

Purpose

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.

Usage

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.

Final Thoughts

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.

Resources
Appointments
Shifts
Participant
Participants
Appointments
Shifts
Billable Participant Notes
Participant
Participants

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.

    Purpose

    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.

    Usage

    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.

    Final Thoughts

    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.

    Participant
    Resource

    Purpose

    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.

    Usage

    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, via their Salesforce User record have access to Maica and the underlying Salesforce platform through the web browser or a number of available mobile applications.

    Final Thoughts

    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.

    Participants
    User
    and
    , such as medical equipment.

    Purpose

    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.

    Usage

    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.

    In many ways, Maica treats Assets just like Resources with some reduced functionality, such as capturing personal information as this does not apply to non-human Resources.

    Final Thoughts

    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.

    Participants
    Appointments
    Shifts

    Welcome to the Maica User Guide

    Who are we?

    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.

    How is our Knowledge Base structured?

    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.

    User Guide Overview

    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.

    Discover Maica

    More Resources


    Price List

    Learn about how Maica uses Price Lists within the overall solution.

    Definition

    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.

    Purpose

    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 .

    Usage

    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.

    Final Thoughts

    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.

    Participant

    Learn about how Maica uses Contacts within the overall solution.

    Definition

    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.

    Maica considers a Contact to be a Participant when an active Service Agreement is associated with the Contact record. The Service Agreement does not need to be fully funded but it does need to have the relevant Support Items for which services are being delivered.

    Purpose

    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 .

    Usage

    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.

    Final Thoughts

    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.

    If you are using a Salesforce edition in which is used (your system administrator will know), then please be assured that Maica will work within this architecture also.

    Appointment

    Learn about how Maica uses Appointments within the overall solution.

    Definition

    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

    You can learn how to create Appointments .

    Purpose

    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).

    Usage

    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.

    Final Thoughts

    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.

    Incident

    Learn about how Maica manages and utilises Incidents.

    Definition

    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.

    Typical examples of incidents include medication errors, behavioural events, injuries, property damage, or other occurrences that require documentation and review.

    Purpose

    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.

    Usage

    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.

    Final Thoughts

    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.

    Shift

    Learn about how Maica uses Shifts within the overall solution.

    Definition

    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:

    • Resources who are delivering the service as part of the Shift

    • (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

    You can learn how to create Shifts .

    Purpose

    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).

    The primary difference between Shifts and is that Shifts do not have specific associated with the Shift. The overall purpose of a Shift is to place at a specific at specific (and potentially recurring) times.

    Usage

    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.

    Final Thoughts

    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.

    Both, and Shifts can be recurring and will automatically be generated by Maica.

    Maica Key Concepts

    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.

    Key Term
    Description

    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.

    Maica offers a setting to rename of these key terms to your preference, for example, if you want to rename Maica Participants to Clients, the settings allows for this to happen.

    The Maica Lifecycle

    Learn about the overall Maica Lifecycle

    The Maica Lifecycle in 90 seconds

    The Maica Lifecycle in one Picture

    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.

    The Maica Lifecycle Description

    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.

    This is complemented with selected external applications to fulfil specific functions, including award interpretation, document management, and finance, all built on the Salesforce platform for security, compliance, and scalability.

    Checklist

    Learn about how Maica uses Checklists within the overall solution.

    Definition

    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:

    Checklist Name
    Checklist Item
    Sequence

    Purpose

    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.

    Usage

    Checklists are used within and to show at various points throughout the journey, including:

    • Check In

    • Check Out

    • Appointment Management

    • Shift Management

    Final Thoughts

    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.

    You can then easily report on progress whether this be the completion or not of certain tasks (Checklist Items).

    Invoice

    Learn about how Maica uses Invoices within the overall solution.

    Definition

    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.

    Purpose

    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 .

    Usage

    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.

    It is quite common that Maica submits Invoices to external finance systems, like Xero to which Maica has a pre-configured .

    Final Thoughts

    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.

    Salesforce Key Concepts

    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.

    The Basics

    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.

    The Salesforce Homepage

    You can learn more about the Salesforce platform .

    The Person Account Architecture

    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.

    The Person Account architecture is Salesforce's best-practise approach to managing people and organisations most effectively. All of Salesforce's inductry cloulds are built on this architecture with which Maica is fully compatible.

    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 .

    Maica is fully compliant with Salesforce's Person Account architecture which gives you access to all of Salesforce's industry clouds, including:

    Data Objects and Attributes

    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.

    User Interface Navigation

    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.

    You can learn more about the Salesforce platform .

    Support Items
    Service Agreements
    Service Agreement
    Service Agreements
    preferences
    notes taken
    here
    Person Account
    Resource
    s
    Appointment Services
    Location
    here
    Participants
    Maica Planner
    Maica Planner
    Resource
    Shifts

    Description and Outcome – summarises key details and final actions taken.

    Mobile App
    Appointment Services
    Location
    here
    Resources
    Location
    Maica Planner
    Appointments
    Participants
    Resources
    Location
    Resource
    Maica Planner
    Resource
    Appointments
    Appointments
    Participants
    Resources
    Location
    Appointments

    Pre-Appointment Check In

    Greet Participant

    Before

    COVID Test

    Before

    Complete Assessment

    After

    Appointment
    Shift
    Service Agreement
    Appointments
    Shifts
    Service Agreement
    Service Agreement
    Appointments
    Shifts
    Delivery Activities
    integration

    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.

    Appointment Service

    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.

    Appointment

    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.

    Shift

    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.

    Delivery Activity

    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.

    Checklist

    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.

    Invoice

    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.

    Support Item

    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.

    Participant
    Resource
    Asset
    Service Agreement
    Salesforce Service Cloud
    here
    here
    Salesforce Health Cloud
    Salesforce Nonprofit Cloud
    here
    The Salesforce Person Account Model

    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.

  • The Maica Lifecycle

    Participant Profile

    Learn about the Participant Profile and its components in Maica

    The Maica Planner

    Discover our Planner's incredible power and capabilities.

    Appointments

    Learn how to create Appointments through Maica's intuitive interface.

    Service Agreements

    Dive into the creation and management of Service Agreements tailored to your needs.

    Shifts

    Explore the process of creating and managing your Shifts within Maica.

    Invoicing

    Discover Maica's advanced invoicing capabilities.

    Schedule a Demo

    Schedule a 30 minute demo to see if Maica is for you.

    Request a Trial

    Try Maica today!

    Partners

    Partner with Maica and join a network dedicated to enhancing care delivery.

    Get Started with Maica

    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.

    • Reference Data Load

    • Settings

    As Maica has been built on the Salesforce platform, all of Salesforce's configuration and extension tools are available to make Maica uniquely yours, such as Lightning Page Layouts, Flows, Reports, and Data Model Extensions.

    Reference Data Load

    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 .

    to start configuring your reference data in Maica beyond the pre-loaded information.

    Settings

    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.

    Your Maica implementation partner will be able to walk you through the various settings and their impact on how Maica works and our also explains each setting for you.

    Permission Sets

    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.

    It is critical to go through an assign the relevant Permission Sets to the right users (Resources) in Maica so they can perform the needed functions but you can also restrict what actions they are able to take. If some functions are not available to some users, this might be because they don't have the right assigned.

    Appointment Service(s) Setup

    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.

    You can learn more about Appointment Services in and to get started. Your Maica implementation partner can also assist you with the configuration of Appointment Services.

    Resource(s) Setup

    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.

    The key to setting up Resources is to link a Resource record to a record as this is how your team is granted access to Maica (and Salesforce).

    Integrations (, Google, , )

    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.

    Configuring integrations can be tricky and quite technical so your Maica implementation partner will be able to assist you in setting this up.

    Appointment Service

    Learn about how Maica uses Appointment Services within the overall solution.

    Definition

    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:

    Appointment Service
    Support Item
    Service Day
    Service Day

    An Appointment Service also captures the required Skills and to deliver the service but the primary purpose of an Appointment Service is to control billings.

    Purpose

    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.

    The Maica billing engine will determine at the time of billing which specific needs to be selected for billing rather than the end user () having to do this.

    Usage

    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:

    The selection of a specific associated with an Appointment Service happens in Maica's billing engine at the time of billing.

    Final Thoughts

    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 .

    Support Item

    Learn about how Maica uses Support Items within the overall solution.

    Definition

    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:

    Support Item Name
    Service Day
    Service Time
    Unit of Measure
    Support Item Name
    Service Day
    Service Time
    Unit of Measure
    Support Item Name
    Service Day
    Service Time
    Unit of Measure

    Purpose

    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 .

    Usage

    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 .

    Item Number Override

    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.

    Some Support at Home products may require alternative item numbers due to:

    • Non-standard or variable pricing requirements.

    • Variants such as daytime, afternoon, evening, or overnight rates.

    Please refer to the field details in the table below:

    Field Label
    Object
    Type
    Description

    The existing Support Item Number field can be left blank if an override value is used

    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.

    Final Thoughts

    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.

    Files

    Learn about adding Files to a new Billable Participant Note

    How do I attach Files to my 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.

    What happens after I create a Billable Participant Note?

    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.

    The same logic applies if your Participant Note is not Billable, however, there will be no Invoice Line Item.

    Your Maica Learning Path

    Learn about Maica in a structured and sequenced way to maximise your journey.

    Introduction

    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.

    We encourage you to follow the sequence outlined below as this will guide you through the basics of the underlying Salesforce platform as well as the Maica solution.

    Billable Participant Notes

    Learn about Billable Participant Notes in Maica

    What is a Billable Note?

    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

    Order By

    Learn how to Order your information on the Planner

    How do Order my 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.

    Custom Fields

    Learn about Custom Fields for a new Appointment

    What does the Custom Fields stage include?

    The Custom Fields tab captures any information from Custom Fields that have been added to your Organisations Appointment profile beyond what Maica offers.

    Custom Fields can be added via the Maica Settings. To learn more, click

    Custom Fields

    Learn about Custom Fields for a new Billable Participant Note

    What does the Custom Fields stage include?

    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

    Attach Files

    Learn about Attaching Files to an Appointment

    How do I attach a file 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.

    Participant Signatures

    Learn how to record Participant Signatures for an Appointment

    How do I record a Participant(s) Signature?

    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.

    Billable Participant Note

    Learn how to create a new Billable Participant Note from the Planner Quick Action

    How do I create a new Billable Participant Note from the Planner?

    There are multiple ways to create a new Billable Participant Note in Maica, this article will show you how to use the Quick Action in the Planner.

    You can also create a Billable Participant Note through the

    Therapy Services

    Occupational Therapy

    Weekday

    Morning

    Occupational Therapy

    Saturday

    Morning

    Occupational Therapy

    Sunday

    Morning

    Occupational Therapy

    Anytime

    Anytime

    Checklists
    Resource
    Support Item
    Appointment
    Shift
    Appointment
    Shift
    Support Items
    Appointment
    Shift
    Support Item
    Resource
    Support Item
    Resource
    Appointments
    Participants
    Appointments
    Shifts
    Billable Participant Notes
    Support Item
    Appointments
    Shifts
    Gaps in the Services Australia product catalogue where no equivalent Support Item definition exists.

    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

    Service Agreement
    Participant
    Price List
    Service Agreements
    Appointment Services
    Invoices
    Service Agreement
    Appointment Service
    Appointment
    Shift
    Appointment Services
    Appointment
    Participants Profile
    status and used within Maica for Billing.

    The same logic applies if your Participant Note is not Billable, however, there will be no Invoice Line Item.

    How do I create a Billable Note?

    There are multiple ways to create Billable Note(s) within Maica, these include:

    • Directly from the Planner

    • Through the Maica Quick Actions

    What does a Billable Participant Note include?

    A new Billable Participant Note includes the completion of multiple stages before it can be confirmed, below is a list of these stages:

    1. Take a Note

    2. Custom Fields

    3. Tasks

    4. Files

    To dive deeper into each stage, please visit the specific pages for detailed information on every stage.

    Resource
    Service
    Service
    Service Agreement
    Appointment
    Participants Profile
    stage.
    Appointment

    Learning Path and Resources

    1. Learn the Basics of the Salesforce Platform

    2. Learn the Basics of the Maica Solution

    3. Learn how to use the Maica Solution

    4. Learn how to configure the Maica Solution

    Learn the Basics of the Salesforce Platform

    • Getting started with Salesforce Trailhead

    • Navigating Salesforce

    Learn the Basics of the Maica Solution

    • Maica Key Term Glossary

    • Maica Key Concepts

    Learn how to use the Maica Solution

    • Participant Profile

    • Appointment Overview

    • Shift Overview

    • Service Agreement Overview

    Learn how to extend the underlying Salesforce Platform

    • Salesforce Configuration

    • Salesforce User Profiles

    • Salesforce Flows

    • Salesforce Validation Rules

    This function is only available in Timeline Mode.

    Once selected, the custom Filter By Field Selector module will display, as shown below.

    Note, all fields with an > have additional fields available within them, however you can also Order By the parent field.

    It is here you can select which field you wish to organise your information by.

    As I have selected the Order By action from Schedule View, the available fields are Resource fields, as shown above. This is because Schedule View organises the Planner by Resource. If you were to select the Order By action from Accomodation View, these fields would be catered to Accomodations.

    After selecting a field, click Select to finalise. Below, I have chosen to Order my Resources by Age Group.

    Once you have selected a field in which to order your information, you can change the order from ascending to descending by simply clicking the Arrow button to the left of the Order By button.

    Schedule View
    .

    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.

    To learn more about Custom Fields in Salesforce, click here.

    Mobile Use

    On a mobile device, this will also feature the option to take a photo while uploading the file, as illustrated below.

    Take a photo and store it against the Appointment
    Appointment
    Appointment
    Attach Appointment Files Dialogue Box
    Capturing Participant Signature
    Appointment
    Appointment
    Participant(s)
    Appointment
    Participant
    Participant(s)
    Appointment
    .

    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.

    Maica Quick Actions
    Permission Sets
    Appointment Service(s) Setup
    Resource(s) Setup
    Integrations (NDIS, Google, Xero, Stripe)
    Support Items
    Price Lists
    Reference Data Import Template
    Planner
    Appointments
    Shifts
    Permission Set
    Appointment Services
    Maica's Key Concepts
    here
    Resource
    Salesforce User
    Xero
    Stripe
    Vertic
    Google Maps API

    Create new Appointment

    Learn how to create a new Appointment or Shift from the Planner Quick Action

    The Create new Appointment Quick Action may be called Create new Shift depending on what View you are in the Maica Planner. It is the same tool, but can be used for both Appointments or Shifts.

    How do I create a new Appointment or Shift from the Planner?

    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.

    You can also create an Appointment or Shift by dragging and releasing your mouse directly onto the Planner. To learn more, click .

    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:

    View
    Module

    Once the applicable module has been shown, create your Appointment or Shift by following the same steps detailed .

    There will be no pre-populated fields if you create an Appointment or Shift through the Quick Action.

    Planner Overview

    Learn about the Planner within Maica

    What is the Planner?

    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.

    Planner Function Overview

    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:

    Appearance Guide

    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 learn how to customise your Planner to your organisations desire, please refer to the section in the Maica settings.

    Timezone Indicator

    To help users understand how Appointment times are displayed, the Planner now includes a Timezone Indicator, as shown below.

    How It Works

    • 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.

    New Billable Participant Note

    Learn how to Create a New Billable Participant Note from the Global Actions Menu

    How do I create a new Billable Participant Note from the Maica 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.

    To learn more about the details and stages of creating a New Billable Participant Note, click .

    Pre-populated Fields

    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.

    You can also change your default duration in Maica Settings; click here to learn more.

    Planner Filter

    Learn about the Planner Filter

    What is 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.

    Where do I find the Planner Filter?

    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.

    Planner Filter Applied Notification

    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.

    Participant View

    Learn about the Participant View in Maica

    What information does the Participant View display?

    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.

    You have the option to display both unfilled Appointments and Appointments with allocated Participant(s). To learn more, click .

    Calendar Mode

    On Calendar Mode, Participant View will display your Planner with the above information within a grid based on the days and hours of the .

    Please note that both the cascade effect shown above and the information presented within the cells are configurable. To learn more, click .

    Timeline Mode

    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.

    You can also display all Participant(s), not just those with allocated Appointments. To learn more, click . Please note, Maica defines a Participant as a Contact with an active Service Agreement. Contacts without an active Service Agreement will not be displayed.

    Appointment Breaks

    Learn about Appointment Breaks

    How do I record an Appointment Break?

    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.

    In order to maintain the parameters of an Appointment, Maica will not allow you to create an Appointment Break outside the Date or Time of the Scheduled Appointment. You also must assign a Category in order to submit a Note.

    Appointment Break Actions

    1. Create Corresponding Timesheet

    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.

    The Break will be stored as an Unavailability record against the allocated Resource.

    Asset View

    Learn about the Asset View in Maica

    What information does the Asset View display?

    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.

    You can display all Assets(s), not just those with allocated Appointments or Shifts if desired. To learn more, click .

    Calendar Mode

    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.

    Please note that both the cascade effect shown above and the information presented within the cells are configurable. To learn more, click .

    Timeline Mode

    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.

    Please note that both the Asset Name and Type presented beneath their name within the Asset cells are configurable. To learn more, click .

    Agenda View

    Learn about the Agenda View in Maica

    What information does the Agenda View display?

    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.

    Agenda Mode

    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

    Inline with the rest of the Planner, the information on these cells in Agenda View are configurable in the Planner Management Settings. To learn more, .

    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.

    New Shift

    Learn how to Create a New Shift from the Global Actions Menu

    How do I create an Shift from the Maica 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.

    To learn more about the details and stages of creating a New Shift, click .

    Pre-populated Fields

    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.

    You can also change your default duration in Maica Settings; click here to learn more.

    Group By

    Learn how to Group your information on the Planner

    How do Group my 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.

    This function is only available in Timeline Mode.

    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.

    As I have selected the Group By action from Shift View, the available fields are Appointment/Shift fields, as shown above. This is because Shift View organises the Planner by Shift. If you were to select the Group By action from Accomodation View, these fields would be catered to Accomodations.

    After selecting a field, click Select to finalise. Below, I have chosen to Group my Shifts by Location.

    Synchronise Participant Information

    Learn how to Synchronise Participant Information with the NDIS in Maica

    What is the 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.

    Where do I find the 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

    How do I use the 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.

    In order to retrieve Plan Budgets you must first confirm that the Participant has provided Consent to access the Data via the NDIS Participant Portal. Plan Budget data is not available to all Providers. Records will only be returned if you have the required consent in place according to the NDIS guidelines.

    • Plan Goals: These are retrieved from the NDIS Goals the Participant has set up with the agency.

    Syncing any Plan Goals will remove all current Goals and refresh them with the Data from the NDIS.

    • 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.

    Shift View

    Learn about the Shift View in Maica

    What information does the Shift View display?

    The Shift View is an overview of all Shift information.

    You have the option to display both unfilled Shifts and Shifts with allocated Resource(s). To learn more, click .

    Calendar Mode

    On Calendar Mode, Shift View will display your Planner with the above information within a grid based on the days and hours of the .

    In the above image you can see the Shift on Thursday 5th September has a red outline, this is an unfilled Shift. An unfilled Shift is any Shift that does not have the required number of Resources allocated.

    Timeline Mode

    On Timeline Mode, Roster View will organise your Planner by Shift(s). This will display all of the Shifts(s) in chronological order.

    The details displayed on each Shift cell are configurable. To learn more, click .

    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.

    For further information on these indicators, please click .

    In addition, a few useful interaction features are available on the Shift cell in Timeline Mode on Shift View. These are:

    Element
    Description

    Select Date

    Learn how to set your desired Date on the Planner

    How do select the Date on the Planner?

    You have three options on the Planner to choose the date you want to view:

    Number
    Action
    Description

    Additional Details

    Learn about capturing additional details for a new Appointment

    What does the Additional Details stage include?

    The Additional Details tab captures any extra details of the Appointment, as described in the below table:

    Captured Information
    Description

    New Appointment

    Learn how to Create a New Appointment from the Global Actions Menu

    How do I create an Appointment from the Maica 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.

    To learn more about the details and stages of creating a New Appointment, click .

    Pre-populated Fields

    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.

    You can also change your default duration in Maica Settings; click here to learn more.

    New Timesheet Entry

    Learn how to Create a New Timesheet Entry from the Global Actions Menu

    How do I create a new Timesheet Entry from the Maica 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.

    To learn more about the details and stages of creating a New Timesheet Entry, click .

    Pre-populated Fields

    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.

    You can also change your default duration in Maica Settings; click here to learn more.

    Google Maps

    Learn how to get directions on Google Maps directly from your Appointment Profile

    What does the Google Maps Action do?

    The Google Maps action opens the directions to the Appointment from a number of selectable starting points in Google Maps, directly from the Appointment.

    How do I use the Google Maps Action?

    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

    In order to use Current Location to receive directions to your Appointment, Location must be allowed on your browser or device.

    Following a selection of Location, a new tab will open in Google Maps with directions to your Appointment from your selected Location.

    If a Resource has multiple Appointments on one day, they can access a route between all Appointment on Google Maps by using the handy action accessible in Schedule View on Timeline Mode. To learn more, click .

    Service Booking Overview

    Learn about Service Bookings and how they are managed in Maica

    What is a Service Booking?

    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.

    NDIS Funding

    Learn how Maica manages Funding from the NDIS

    How is NDIS Funding Managed in Maica?

    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.

    Emailing Upcoming Appointments

    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

    What are Upcoming Appointments?

    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.

    Tasks

    Learn about Tasks for a new Billable Participant Note

    What does the Tasks stage include?

    The Tasks tab offers the ability to add any Tasks to your Billable Participant Note. This is a record of an action or activity that needs to be completed or has already been completed.

    Global Actions

    Learn about Global Actions in Maica

    What are Global Actions?

    Global actions are a versatile feature that allow you to do a variety of tasks easily from anywhere in Salesforce, including the Home Page and Mobile App. The Maica Actions offer easy and instant access to important Maica functions, including:

    Roster View

    Learn about the Roster View in Maica

    What information does the Roster View display?

    The Roster View is an overview of all Shift and Unavailability information.

    Accomodation View

    Learn about the Accomodation View in Maica

    What information does the Accomodation View display?

    The Accomodation View is organised by Accomodations.

    An Accomodation

    Checklists

    Learn about Checklists within an Appointment

    How do I access Appointment Checklist(s)?

    To view your Appointment Checklist(s), simply open an and then click the Checklist button at the bottom of the screen to bring up the dialogue box. Once selected, you will see the allocated Checklist(s) to your Appointment grouped by Appointment Service.

    Location

    Discover how to specify the Shift location

    What does the Location stage include?

    Within 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.

    Unlike an Appointment, a Shift permits you to only select a Location from your stored Locations.

    Open Appointment Profile

    Learn about the Appointment Profile Record in Maica

    How do I open the Appointment Profile?

    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

    Appointment Expenses

    Learn how to record Appointment Expenses

    How do I record an Appointment Expense?

    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.

    Learn how to extend the underlying Salesforce Platform
    Planner Overview
    Invoicing Overview
    Salesforce Reporting
    Salesforce Development Tools
    here
    Note
    Take a Note
    Note
    here
    Shifts
    Shifts
    Basic Details
    Shifts
    here
    Appointment
    Appointment
    Basic Details
    Appointment
    here
    Timesheet Entry

    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)

    Shift(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.

    Checklist(s)
    Key Terms

    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:

    Maica Key Term
    Description

    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

    Participant Record Actions

    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.

    Synchronise Participant Information

    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.

    Create Service Booking

    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.

    If your Participants are PACE Participants Service Bookings will not be required and hence this Action will not be visible.

    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.

    below
    You will only see Checklist Item(s) that are set to an execute status of During or Either. Any other Checklist Item(s) will be shown at either the Check-In or Check-Out stage.

    Checklist Actions

    1. Checklist Item Note

    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.

    You can also change the Status of the Checklist Item by clicking on the Item itself.

    Checklist Item Notes can be configured directly from a Checklist. To learn more about Checklist Item Notes, click here.

    Appointment

    Schedule

    New Appointment

    Participant View

    New Appointment

    Asset View

    New Appointment

    Accomodation View

    New Appointment

    Roster View

    New Shift

    Shift View

    New Shift

    here
    View
    View
    here
    Basic Filters
    Advanced Filters
    Participant Record

    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).

    here
    selected period
    here
    Roster View
    here
    here
    Timesheet
    Timesheet

    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.

    What are the components a Service Booking Record?

    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)

    Service Booking Statuses

    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.

    Status
    API Name

    In Process

    INPR

    Awaiting Participant Approval

    APAP

    Awaiting Provider Approval

    APRO

    Change Awaiting Participant

    APAC

    Change Awaiting Provider

    APRC

    Rejected

    REJT

    The Deleted Status does not actually delete the Service Booking record from Maica. When an NDIS staff member deletes a Service Booking in PRODA, it may be assigned this Status value. This value cannot be set via the Maica functionality.

    If you want to cancel (or stop) a Service Booking, utilise the Manage Service Booking Quick Action, specifically the Reduce stop Date option. To learn more about managing a Service Booking, click .

    When generating Reports for your Service Bookings, Salesforce will refer to them by their API Name rather than the Status name.

    How do I create Service Bookings?

    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.

    How do I Email Upcoming Appointments to a Participant?

    Step 1: Select the Upcoming Appointments Quick Action

    1. Open the Participant’s Contact record in Maica.

    2. In the top-right corner of the record, click the Upcoming Appointments Quick Action.

    Step 2: Choose the Date Range

    1. In the pop-up modal, begin by entering a Start Date and End Date.

    This defines the window of appointments you want to include in the email.

    1. Select the Status

    This filters which appointments will be included.

    Step 3: Apply Additional Filters (Optional)

    You can further narrow down the list of appointments by applying any of the following filters:

    • Appointment Service

    • Resource

    • Location

    Note, If no filters are applied, all values will be included by default.

    Appointments are selected based on whether they are linked to the Participant (Contact) through:

    • Appointment → Location

    • Appointment → Delivery Activity → Appointment Service

    • Appointment → Appointment Resource → Resource

    Only appointments falling within the filter criteria are displayed and sent.

    Step 4: Click Generate

    Once all filters are set:

    1. Click Generate.

    2. Maica will create an email using your organisation’s Upcoming Appointments template.

    3. The list of matching appointments will be included directly in the body of the email.

    The email will be sent using the From Email Address and Email Template set in the Upcoming Appointments settings. To learn more about these Settings, .

    FAQs

    Can I customise the appointment email format?

    Yes. A default Lightning Email Template called Upcoming Appointments Email Template is provided. It can be cloned and tailored to match your organisation's branding.

    Can appointments be sent as a PDF attachment?

    No. As of now, appointments are sent embedded within the email body only.

    What happens if no appointment status is selected?

    All statuses will be included by default if none are selected in the filter.

    Why am I not seeing the Quick Action?

    Access to the Quick Action depends on your user role and page layout configuration. Contact your administrator if it is not visible.

    How do I add a Tasks to my Billable Participant Note?

    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 assign a task to any other Maica user within your organisation.

    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.

    Things to look out for: Tasks

    1. Unsaved Changes

    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.

    New Billable Participant Note

  • New Timesheet Entry

  • How do I access Global Actions?

    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.

    If you do not see the Maica Actions in your dropdown menu, you may need to enable them in your Salesforce instance. To learn how to do so, please click here.

    To learn more about Salesforce Global Actions, click here.

    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:

    To show and hide the Maica Actions, simply click the Header.

    New Appointment
    You have the option to display both unfilled Shifts and Shifts with allocated Resource(s), as well as showing only Resource(s) with Shifts in Timeline Mode. To learn more, click here.

    Calendar Mode

    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.

    Roster View on Calendar Mode

    Please note that both the colour theming of the cells and the information presented within the cells are configurable. To learn more, click .

    Timeline Mode

    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.

    You can also display all Resource(s), not just those with allocated Shifts. To learn more, click here.

    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).

    An unfilled Shift is any Shift that does not have the required number of Resources allocated.

    is a specific area within a
    Location
    record. The
    Accomodation
    view will be grouped by
    Location
    by default on Timeline Mode.

    In Calendar Mode, Accomodation View shows all Appointment related Planner information, and in Timeline Mode it organises all Appointments by associated Accomodations.

    Calendar Mode

    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.

    Please note that both the cascade effect shown above and the information presented within the cells are configurable. To learn more, click .

    Timeline Mode

    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.

    In Timeline Mode, Accomodation View will be Grouped By Location by default.

    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.

    Timezone Selection

    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.

    How It Works:

    • 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, .

    Key Behaviour

    • 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.

    Shift
    , simply by clicking the Expand Profile button located in the bottom right corner of any
    , as shown below.

    Appointment Profile Actions

    1. Generate Invoice

    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.

    Maica will automatically generate Invoices for completed Appointments through its Automation. This process is for situations where manual Invoice Generation is required, or, Automation is toggled off. To learn more about Invoice Automation, click .

    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.

    The quantity is based on the Service Time dropdown. For example, if the Check-Out time for your Appointment was different to the Scheduled End, and you wanted to bill accordingly, Maica will automatically update the quantity and cost of the delivery.

    Appointment
    Appointment
    Checklists
    Delivery Activities
    Planner
    Appointment

    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.

    Expenses will be stored as Expense Records against the Resource and will be accessible on the Resource Profile

    Appointment Expense Actions

    1. Attach Files

    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.

    This is a useful tool to track and verify expenses.

    Views
    Modes
    Actions
    Filters
    Planner Views & Modes
    Planner Actions
    Planner Filter
    here
    selected period
    here
    Participant View on Calendar Mode
    here
    selected period
    Asset View on Calendar Mode
    Asset View on Timeline Mode
    Schedule
    Roster
    Shift
    The Maica Planner in Agenda View

    Planner Actions

    Learn about the Planner Actions within Maica

    What are the Planner Actions?

    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:

    Number
    Planner Actions
    Description

    The Period, Views & Modes are not listed in the above table and are further explained .

    To dive deeper into each Action, please visit the specific pages for detailed information on every Action.

    Participant Notes

    Learn about taking Participant Notes within an Appointment

    How do I record a Participant Note(s)?

    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.

    Note, this can also be accessed from the Appointment Quick Action box directly from the Planner, or from anywhere within Maica using the Client Note action from the Maica Global Actions menu.

    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.

    In order to open and close the text input box, select the arrow on the far right hand side of the screen, as shown below.

    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.

    Please note, this Blue Tick may also be a Save button depending on your Maica version. If you happen to click close without saving, you will be prompted with a confirmation message.

    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.

    Participant Note Actions

    Once you have create a Participant Note(s), additional actions will become available. These actions are detailed below.

    1. Attach Files

    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.

    2. Manage Tasks

    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.

    You can assign a task to any other Maica user within your organisation.

    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.

    Check-In

    Learn how to Check Into Appointments

    What does the Check-In Action include?

    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.

    Appointment Date Information

    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.

    Who is Checking-In?

    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.

    The status of the Appointment changes from Scheduled to In Progress after the first Resource(s) checks in.

    Appointment Checklist Information

    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.

    This stage will only show Checklist Item(s) that are set to an execute status of Before or Either

    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.

    Check-In Location

    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.

    In order for a Location to be obtained, the User must have Location Permissions set to Allowed on their Device or Browser.

    Home Care Package Funding

    Learn how Maica manages Funding from the Home Care Packages

    How is Home Care Package Funding Managed in Maica?

    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.

    What is included in a Home Care Package Funding Record?

    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

    What are the key components of a Home Care Package Funding Record?

    The key components of a Home Care Package Funding Record are the Funding Items, these are explained in further detail below.

    Funding Item

    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:

    What other information is stored in a Funding Record?

    Participant Budget Information

    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:

    Field Name
    Notes

    Cancellation

    Learn about Cancelling an Appointment

    What does cancelling an Appointment involve?

    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:

    1. 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.

    2. 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.

    If you select to cancel the selected Appointment only, then Maica will remove this Appointment from the Recurring Schedule and effectively turn this Appointment into a single Appointment with all changes reflected.

    Cancellation Requested Date

    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.

    For example:

    • 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.

    Cancellation Reason

    When cancelling an Appointment, Maica asks for a Cancellation Reason. If a Cancellation Reason is selected, Maica requires a Cancellation Date.

    To learn more about how Maica validates the parameters of an Appointment cancellation, click .

    The Cancellation UI with all the above fields is shown below.

    Quick Completion

    Learn how to Quick Complete an Appointment

    What is Quick Completing 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.

    What does the Quick Complete Action include?

    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.

    Check In/Out Location

    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.

    In order for a Location to be obtained, the User must have Location Permissions set to Allowed on their Device or Browser.

    Appointment Date & Time Information

    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.

    Manage Travel

    When Quick Completing an Appointment, you can also Manage Travel. To learn more about the Manage Travel Action, please click here:

    Appointment Services

    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.

    To learn more about the quantity function, click .

    Schedule

    Learn about the Schedule View in Maica

    What information does the Schedule View display?

    The Schedule View is the default view in Maica. It is an overview of all Planner information and hence displays Appointments & Shifts .

    Please note, in Calendar View, Shifts will be hidden by default. They can be toggled on with a Show Shifts filter.

    Calendar Mode

    On Calendar Mode, Schedule View will display your Planner with the above information within a grid based on the days and hours of the .

    Please note that both the cascade effect shown below and the information presented within the cells are configurable. To learn more, click .

    If an Appointment is part of an , it will be locked on the Planner and the drag and drop prevented. This same application applies to Completed or Cancelled Appointments.

    Timeline Mode

    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.

    You can also display all Resource(s), not just those with allocated Appointments, Shifts or Unavailability. To learn more, click .

    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.

    Please note that both the Resource Name and their Title presented beneath their name within the Resource cells are configurable. To learn more, click .

    A few useful interaction features are available on the Resource cell in Timeline Mode on Schedule View. These are:

    Number
    Element
    Description

    Manage Unavailability

    Learn about how Resources can manage their Unavailability within Maica

    What does the Manage Unavailability Tool do?

    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.

    Manage Service Booking

    Learn how to manage Service Bookings in Maica

    How do I manage a Service Booking 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

    Create an Appointment

    Learn about the process of creating a new Appointment.

    How do I create an Appointment?

    A quick and efficient way to create is directly through the the Maica . Maica has an interactive user mechanism where you can simply drag and release your mouse on the in order to prompt the creation of an .

    Create Service Booking

    Learn how to create Service Bookings in Maica

    How do I create a Service Booking in Maica?

    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

    Maica Usage Rules

    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.

    Direct Data Object Access

    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.

    Object

    Planner Views & Modes

    Learn about the different Views & Modes in the Maica Planner

    What is a Planner View?

    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.

    Schedule

    Learn about creating Recurring Schedules for Shifts

    What is Scheduling in Maica?

    Maica scheduling allows you to create a recurring schedule for your new . Recurring Shifts happen on a regular schedule and Maica will create these based on the populated information from completing the following fields:

    Field Name
    Field Type
    Description

    Advanced Filters

    Learn about the Advanced Planner Filters in Maica

    What are the Advanced Filters in Maica?

    The Advanced Filters in Maica allow you allows you to create highly targeted filters and views of the Planner through filtering specific attribute fields from Appointments, Shifts, Participants or Resources.

    Create a Shift

    Learn about the process of creating a new Shift.

    How do I create an Shift?

    A quick and efficient way to create is directly through the the Maica . Maica has an interactive user mechanism where you can simply drag and release your mouse on the in order to prompt the creation of an .

    Creating an Shift is dependant on what

    Maica | Leading NDIS & Aged Care Software for Providerswww.maica.com.au

    Approved

    APPR

    Completed

    CMPD

    Deleted

    DELE

    here
    Participant Note
    Check In
    Out
    Quick Complete
    Participant Note Action
    Appointments
    Appointment
    Resource(s)
    Appointment
    Resource(s)
    Appointment
    Resource(s)
    Appointment
    Resource(s)
    Appointment
    Checklist(s)
    Appointment
    Checklist(s)
    Appointment
    Checklist
    Appointments

    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

    Order By

    Enables the ability to sort fields by specific criteria, such as date or name.

    2

    Group By

    Enables the ability to Group Appointments, Shifts, Participants or Resources based on selected attributes, such as location or Postal Code.

    3

    Select Date

    Allows you to choose a specific date for viewing information within the Planner.

    4

    Create new Appointment or Shift

    Allows you to schedule a new Appointment or Shift within the Planner.

    5

    Appointment Optimiser

    6

    here

    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.

    Creating a new Unavailability Record

    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.

    Where multiple Resources are selected, any future Recurring Unavailability records will be created via Maica's batch feature so you might not see these in the Planner straight away.

    Field
    Description
    1. 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).

    1. 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.

    1. Resource(s)

    The Resource(s) for whom the Unavailability record will be created.

    1. Type

    The type of Unavailability being created. This list is configurable via Maica .

    1. Status

    The status of Unavailability being created. This list is configurable via Maica .

    1. 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.

    The Recurring Unavailability follows the same execution logic as Appointments and Shifts which is further described .

    Please note, when an Unavailability Record is created, Maica will automatically remove the associated Resource from any assigned Appointments or Shifts during the Unavailability period.

    Example Scenarios

    Example
    Outcome

    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.

    Resource
    Appointment
    Shift
    Planner
    . It connects a variety of common PRODA operations directly into
    Maica
    , eliminating the need for you to handle updates twice and split your work between two applications.

    Please follow the steps below to manage a Service Booking:

    1. Use the Manage Service Booking Quick Action

    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:

    2. Select Management Action

    Once you clicked on the Quick Action above, you will be shown the Manage Service Booking pop-up, as shown below:

    Please note that if the Service Booking Start Date is before 1 Jul 2024 then the only available option will be Reduce End Date.

    Here you will be asked to select which management action you wish to perform. Each action is explained further below:

    Update (Extend, Reallocate CORE Budget)

    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.

    Make sure to tick the box indicating that you discussed this update with the Participant before submitting it to the NDIS.

    Once the update has been successfully completed, the Booking Item records will be modified to reflect the budget reallocation.

    Whilst Maica will not prevent you from exceeding the Remaining Amount, a warning will be displayed that the Service Booking Remaining Amount is being exceeded.

    Reduce End Date

    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.

    For more information regarding how to Cancel or End a Service Booking correctly and what happens in PRODA, please refer to the NDIS reference linked here.

    Approve

    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.

    Reject

    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.

    Delete

    The Delete function provides the ability to update the Service Booking Status to Deleted. This will not delete the Service Booking record in Maica.

    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.

    Force Sync

    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.

    Please note: any manual data updates you have made to the Maica fields on the Service Booking and Booking Item records will be overwritten when the records by the force sync.

    Any custom fields (i.e. created by you and not Maica during the sync process) will not be affected.

    Creating an Appointment is dependant on what
    you are in within the Planner. You need to be in one of Schedule, Participant, Asset or Accomodation View in order to create an Appointment, otherwise you will
    .

    Please see below for an example:

    You can also create an Appointment through the Planner Quick Action. To learn more, click here.

    Pre-populated Fields

    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:

    Planner View
    Pre-populated fields

    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

    Appointment Stages

    After the new Appointment is created, a few stages must be completed before the Appointment can be confirmed.

    The available sections during the creation or management of the Appointment are are configurable and determined by the selected Appointment Services and the Maica Settings. For further information, see the Administration Guide.

    Below is a list of these stages:

    1. Basic Details

    2. Location

    3. Schedule

    4. Additional Details

    To dive deeper into each stage, please visit the specific pages for detailed information on every stage.

    Appointments
    Planner
    Planner
    Appointment
    View
    create a Shift
    that will Sync directly with the NDIS.

    Please follow the steps below to create a Service Booking:

    1. Use the Create Service Booking Quick Action

    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:

    In the screenshot above you can see that PACE Plan is not checked. If this was to be checked, the Create Service Booking Quick Action would not be available.

    2. Service Booking Setup

    Once you clicked on the Quick Action above, you will be shown the Create Service Booking pop-up, as shown below:

    Please confirm the details below to create a Service Booking and associated Service Items. Two types of Service Bookings can be created, depending on the Participant’s Plan, a Standard Booking or a Plan Managed Booking. A Standard Booking is available when the Participant’s funds are Agency Managed. A Plan Managed Booking is only available to Plan Managers.

    In order to successfully create the Service Booking, please ensure:

    • The Service Booking is being created for Support(s) you are registered to Provide

    • There is sufficient Budget available in the

    • The Start and End Dates sit within the Start and End Dates of the Participant’s Plan

    • For Plan Managed Service Bookings, a Standard Service Booking under the CB Choice and Control Category must first exist between the Plan Manager and the Participant

    • If a Participant has a Stated Item, the Stated Item must be selected in the Support Item list below

    • Declare that this Service Booking has been discussed with and agreed by the Participant

    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.

    3. Populate Booking Items

    Once you have setup your Service Booking, it is time to add your Booking Items.

    Booking Items refer to the specific services or supports that are allocated under a Service Booking.

    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:

    Field
    Description

    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.

    Please note that if you do not have access to a Participants Plan Budgets or you haven't synced them into Maica, you can still create a Service Booking to submit to the NDIS, however the NDIS may return an error if there is insufficient or no funding associated to the selected Support Category.

    4. Confirm and Finalise

    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.

    API Name

    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

    If you change any of Maica's default configurations, including User Permissions, Page Layouts, Lightning Pages, and User Access, this will be done at your discretion and responsibilty.

    The below list outlines the available views on the Maica Planner:
    • Schedule

    • Agenda View

    • Participant View

    • Asset View

    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.

    Please note, the following descriptions of each View are explained per Maica's default settings. To learn how to customise your displays further, please refer to the Planner Filter.

    What is a Planner Mode?

    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.

    How do I select my display options in the Planner?

    When in the Planner, you can adjust your display options by simply using the following buttons:

    Number
    Display Option
    Description

    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.

    If you do not want to make a Recurring Shift Schedule, simply toggle the This is a Recurring Shift button to off and move on to the next stage.

    Inheriting Attributes from Master Shifts

    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.

    Inheritance Options

    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.

    Note:

    • You can choose to exclude certain attributes from being inherited. For example, you might leave Checklists unticked to assign them manually later.

    Additional Details:

    When making Recurring Shifts, you have two more configurable options.

    1. Exclude Public Holidays:

    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.

    Maica will alert you if a Public Holiday falls within your schedule. For more information on how to configure Public Holidays within your organisation, click .

    2. Schedule by Number of Appointments:

    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.

    Shift

    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.

    What does the Advanced Filter allow you to do?

    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

    This filter is optional but extremely useful when working with large schedules or teams.

    How do you apply an Advanced Filter in Maica?

    In order to show you how you apply an advanced filter in Maica, let's use an Appointment Attribute as an example:

    1. Navigate to the Advanced Filter Tab

    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.

    The Advanced Filter uses criteria blocks. Each block contains:

    • Field – the field being evaluated

    • Operator – how the value is compared

    • Value – the value the field must match

    Resources, Appointments/Shifts, and Participants remain visible only if they meet all criteria you add.

    2. Add 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.

    3. Select Fields

    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

    4. Operator and Value

    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.

    As mentioned, the values will automatically change based on the field selected.

    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.

    5. Apply your changes

    Once done, click the Green Tick at the top of the Filter to apply your changes.

    If you want to remove your Advanced Filters, you can either use the Undo arrow, or the Remove All button to the right of Add Criteria. You will then need to reselect the Green Tick.

    Once your filters have been applied, the outline of the criteria will change from Yellow to Grey to indicate it has been saved.

    If you were to click Add Criteria again to create more conditions. Then Maica's AND logic would be respected. Meaning, a record must meet every specified condition to appear in the Planner.

    you are in within the Planner. You need to be in one of Roster or Shift View in order to create a Shift, otherwise you will
    .

    Please see below for an example:

    You can also create a Shift through the Planner Quick Action. To learn more, click here.

    Pre-populated Fields

    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:

    Planner View
    Pre-populated fields

    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

    Shift Stages

    After the new Shift is created, a few stages must be completed before the Shift can be confirmed.

    The available sections during the creation or management of a Shift are determined by the Maica Settings. For further information, see the .

    Below is a list of these stages:

    1. Basic Details

    2. Location

    3. Schedule

    4. Additional Details

    To dive deeper into each stage, please visit the specific pages for detailed information on every stage.

    Shift
    Planner
    Planner
    Shift
    View
    create an Appointment

    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.

    selected period
    Appointment Schedule
    here
    Schedule View on Calendar Mode
    Schedule View on Timeline Mode
    Delivery Activities
    Appointment
    Appointments
    Recurring Schedule
    Appointment
    Appointments
    Appointments
    Appointment
    Manage Travel Tool for Users
    Appointment Service(s)
    Appointment
    Participant
    Appointment Service
    Appointment
    here

    Schedule Manager Actions

    Learn about the Schedule Manager Actions within Maica

    What are the Schedule Manager Actions?

    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 following actions are also accessible from the Schedule Manager, however, their detailed functionality is described in other areas of the Knowledge Base. Please click each action below for more information.

    The sections below describe each of these actions in more detail

    Bulk Actions

    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:

    Resource Allocation

    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.

    To learn more about how Resources are scored and matched, refer to the article and Matching Score Importance Level in the .

    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.

    Change Status

    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.

    Cancel

    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.

    Quick Complete

    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.

    Bulk Actions Interactive Overview

    For a hands-on walk-through of the Bulk Actions in the Schedule Manager, you can access the Interactive Overview below.

    Additional Actions

    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.

    Note: You can order information in the Schedule Manager by clicking on the header of any column. For example, clicking Scheduled Start will toggle the table between earliest-first and latest-first order.

    You can also drag the edges of any column header to adjust its width. This allows you to customise the table layout for easier readability.

    Select Fields to Display

    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:

    1. In Available Fields (left), click the field you want to add.

    2. Click the right arrow to move it into Visible Fields (right).

    3. To remove a column, select it in Visible Fields and click the left arrow.

    4. To change the display order, use the up/down arrows

    Custom columns, such as formula fields, will appear in Available Fields once created.

    Manage Preferences

    Learn how to Manage Preferences of Participant(s) in Maica

    What are Participant Preferences?

    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:

    Preference State
    Description

    Required

    How do I Manage Participant Preferences?

    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.

    What types of Preferences can I manage?

    There are three types of Participant Preference Categories you can manage, these include:

    Preference Category
    Description

    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).

    If you are adding a Resource Attribute Preference, and a Resource Attribute is selected, then a second input is shown to capture the value of this attribute. For example, if you choose a Resource attribute of Gender , an additional input will show to allow you to assign a specific Gender to it.

    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.

    Input Field
    Description

    Basic Filters

    Learn about the Basic Planner Filters in Maica

    What are the Basic Filters in Maica?

    Once you have chosen the Filter from the Planner, you may switch between Basic and Advanced Filters. The table below describes the Basic Filters in more depth.

    Please keep in mind that some Filter options will apply to either Appointments or Shifts depending on what View your Planner is in. As a general rule; Schedule, Participant, Asset and Accomodation Views apply to Appointments, whilst Roster and Shift Views apply to Shifts.

    Filter
    Description

    Please keep in mind that the Filter options available will vary depending on the you select on your Planner. The table above shows all available Filter options.

    Summary

    Learn about the information in an Appointment Summary

    What does the Summary stage include?

    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:

    Reference
    Description

    Things to look out for: Summary

    1. Adjusted Quantity

    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 unit of measurement for the quantity is dependant on the service delivered and its associated .

    2. Quantity Unit of Measure

    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

    Please note, the Appointment Service Quantity Unit of Measure will take on the majority selection of the encompassing Support Items within the Service. To learn more, click .

    If the Quantity Unit of Measure field is anything other than Hourly, Maica will default this field to 1.

    Basic Details

    Learn about capturing basic details for a new Shift

    What does the Basic Details stage include?

    The Basic Details tab captures the basic details of the Shift, as described in the below table:

    Captured Information
    Description

    Things to look out for: Basic Details

    1. Resource(s) have a Roster Mode conflict

    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.

    Roster Mode in Maica is used to define the behaviour and validation applied when scheduling Shifts for a Resource. When selecting a Roster Mode for a Resource, there are two selectable options. These are:

    • Appointment

    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.

    It is important to note that if a Resource has a Roster Mode set on their Resource Record that is different to the Roster Mode set for a specific Availability Record, the Availability Record Mode will take precedent during the Availability period. If No Availability Records are found and the Roster Mode is not set on the Resource Record: the

    2. Shift Allocation Incomplete

    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.

    Schedule

    Learn about creating Recurring Schedules for Appointments

    What is Scheduling in Maica?

    Maica scheduling allows you to create a recurring schedule for your new . Recurring Appointments happen on a regular schedule and Maica will create these based on the populated information from completing the following fields:

    Field Name
    Field Type
    Description

    Schedule Manager Overview

    Learn about the Schedule Manager within Maica

    What is the Schedule Manager?

    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

    Manage Unavailability
    Billable Participant Note
    Billable Participant Notes

    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.

    1. 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.

    1. 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.

    1. Preference State

    This allows for the Preference to be assigned one of three possible states, including: 1. Required 2. Excluded 3. Preferred

    1. Start Date

    This allows for a Start Date to be selected in which the Preference becomes effective.

    1. 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.

    1. 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.

    below
    Participant’s Plan
    New Participant Note
  • Single Appointment Line Actions

  • to the right of the
    Visible Fields
    column.
  • Click Confirm to apply the layout to the table.

  • Bulk Actions
    Resource Allocation
    Change Status
    Cancel
    Additional Actions
    Select Fields to Display
    New Appointment
    Appointment Optimiser
    Find Resource
    Smart Selection Filter
    Quick Complete

    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.

    View
    Monthly
  • Yearly

  • 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.

    Appointment
    Participant
    Appointment
    Appointment
    Participant(s)
    Appointment Service
    Appointment
    Participant(s)
    Support Items
    : 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.

  • Roster Mode
    for the
    Resource
    will be defined by the
    Global Roster Mode
    setting. This is configurable in the
    Maica
    settings.

    This 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).

    Asset(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.

    Resource Profile
    Availability Records
    Resource(s)
    Resource(s)
    For example
    Resource(s)
    Rostering Management

    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.

    If you do not want to make a Recurring Appointment Schedule, simply toggle the This is a Recurring Appointment button to off and move on to the next stage.

    Inheriting Attributes from Master Appointments

    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.

    Inheritance Options

    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.

    Note:

    • You can choose to exclude certain attributes from being inherited. For example, you might leave Participants unticked to assign them manually later.

    • These settings only apply when generating Appointments. For Shifts, inheritance behaves differently (see here).

    Additional Details:

    When making Recurring Appointments, you have two more configurable options.

    1. Exclude Public Holidays:

    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.

    Maica will alert you if a Public Holiday falls within your schedule. For more information on how to configure Public Holidays within your organisation, click .

    2. Schedule by Number of Appointments:

    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.

    Recurring Appointment Cost Breakdown

    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:

    Data Location
    Description

    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.

    These costs are calculated based on the Participant(s) selected Service Agreement Price List or inputted cost.

    Things to look out for: Cost Breakdown

    1. Insufficient Budget

    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.

    2. No Service Agreement

    When the budget data does not show, it means that there is no Service Agreement for the selected Participant(s).

    Appointment
    Schedule Manager Function Overview

    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.

    Schedule Manager Components

    The Schedule Manager includes several components located in the top toolbar and row level. These are outlined below:

    #
    Component
    Description

    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.

    Interactive Overview:

    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.

    Appointments
    Shifts
    Planner
    1. Notes

    Additional notes that can be taken during the creation of the Unavailability.

    1. Create a corresponding Timesheet

    This indicates that a corresponding timesheet activity will be generated for each Unavailability.

    1. This is a Recurring Unavailability

    If a Recurring Unavailability is required, this enables the capturing of the required details as documented further .

    Managing Unavailability
    Custom Fields
    Summary
    Schedule
    Participant View
    Asset View
    Accomodation View
    Roster View
    Shift View
    Accomodation View
    Roster View
    Shift View
    above
    above
    Shift Instructions
    Custom Fields
    Participant Notes
    Summary
    Schedule
    Participant View
    Asset View
    Accomodation View
    Roster View
    Shift View

    Take a Note

    Learn about capturing Note details for a new Billable Participant Note

    What does the Take a Note stage include?

    The Take a Note tab captures the basic details of the Billable Participant Note, as described in the below table:

    Information Field
    Description

    Category

    If the Participant Note is not to be billable, then simply disable the Billable Participant Note toggle.

    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

    Things to look out for: Take a Note

    1. No Agreement for Appointment Service

    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:

    Reference
    Description

    Running the Optimiser

    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.

    If you have not yet reviewed the Resource Optimiser article, we recommend you do so. This will provide helpful context to the tools and functionality mentioned in this article.

    1. Define the Resource Pool

    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.

    1. Select Resource Pool.

    2. Click Add Criteria.

    3. Choose a Field (e.g., Resource → Work Type).

    4. 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.

    2. Define the Ranking Criteria

    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.

    Remember, Resource Pool = Who is considered & Ranking Criteria = How well they score

    If a Ranking rule is too strict (e.g., a value that no Resources have), optimisation may return no matches.

    3. Configure Settings

    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:

    Category
    Weight
    Description

    We leave everything at 25%, except Travel = 0%.

    This means each of the four categories contributes equally to the final Matching Score.

    We also confirm that Only use allocated Resources is disabled, allowing all 68 Resources in the pool to be considered.


    4. Run the Optimiser

    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:

    1. It checks if the Appointment can be filled using the 68 Resources in the Pool.

    2. It scores each eligible Resource against the Ranking Criteria and weightings.

    3. It assigns the highest-scoring Resource(s).

    4. 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.

    6. Re-run the Optimiser for Remaining Appointments

    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.

    We recommend this process. Tight Pool first → run Optimiser → broaden → run again. This ensures the strongest possible matches before widening your options.

    7. Respond to Changes — Manually Adjust an Appointment

    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:

    1. Open the dropdown menu on the Resource’s pill.

    2. 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:

    1. In the same Appointment, select Find Resource Manually.

    2. The modal shows all eligible Resources based on our updated 122-person Pool.

    3. We scroll to find Nicolette O’Mahony (who scored 52%) and select her.

    4. 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.

    8. Confirm All Records

    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.

    Check-Out

    Learn about checking out of Appointments

    What does the Check-Out Action include?

    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.

    Appointment Date Information

    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.

    You cannot set a Check-Out Date/Time before your Check-In Date/Time. In this instance, Maica will display an error. To learn more about how Maica validates the parameters of an appointment, click .

    Who is Checking-Out?

    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.

    The status of the Appointment changes from In Progress to Completed after the last Resource(s) checks out.

    Appointment Service Information

    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.

    To learn more about the quantity function, click .

    Check-Out Location

    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.

    In order for a Location to be obtained, the User must have Location Permissions set to Allowed on their Device or Browser.

    Appointment Checklist Information

    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.

    This stage will only show Checklist Item(s) that are set to an execute status of After or Either

    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.

    Manage Travel

    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 following sections explain the Manage Travel tool from a User Experience perspective. If you wish to dive deeper into the logic behind how Maica handles travel, click .

    1. Time and Distance

    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 would like to make this information adjustable, this can be managed via Permissions Sets.

    2. Resource Tabs

    If you have multiple Resource(s) assigned to a particular Appointment, this section allows you switch between each one and adjust their Travel individually.

    3. Time Based Travel Breakdown

    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.

    In the Travel Management Settings, you can select how you wish to charge for Travel. The options include; Do not charge, Charge travel to an Appointment, Charge Travel from an Appointment, Charge for both. To learn more, click .

    4. Create a Timesheet Entry

    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.

    To learn more about the Payable Travel Setting, click .

    5. Non-Time Based Travel Breakdown

    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.

    Travel distances can be recorded with up to two decimal places. Please note:

    • If you attempt to add more than two decimal places in the total distance travelled, Maica will display an error.

    • If you attempt to add more than two decimals to either the distance travelled before or after an Appointment, Maica will round this to two decimal places automatically.

    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.

    To learn more about the Travel Management Settings, click .

    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.

    6. Create an Expense Claim

    Finally, once the above stages have been completed, the Manage Travel Tool will create an Expense Claim.

    An Expense Claim essentially represents the amount required to pay the Resource for any expenses they might have incurred.

    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.

    Incident Management

    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.

    Purpose of Incidents

    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

    Creating an Incident

    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, .

    Regardless of where the Incident is created, the same structured form and fields are captured to ensure consistent data collection.

    First, you must open the form:

    • Mobile App: Navigate to Appointment → Incidents → New Incident.

    • Desktop: Go to the Incidents tab and click New.

    The Incident form is divided into logical sections to make data entry easier. These sections are detailed below.

    1. Incident Information

    This section captures the essential details of the event.

    Field
    Description

    2. Incident Details

    Field
    Description

    3. Impact and Harm

    Field
    Description

    4. Actions Taken

    Field
    Description

    5. Additional Details

    Field
    Description

    6. Investigation Conducted

    This section is used once internal investigation or review has been completed.

    Field
    Description

    Status Path

    Incidents progress through the following stages:

    1. New — The incident has been logged and requires review.

    2. Under Investigation — An internal investigation is underway.

    3. Escalated — Incident requires additional oversight or external reporting.

    4. Closed — All actions complete and the incident is finalised.

    A Lightning Path at the top of the record guides users through these stages.

    Viewing Incidents Related to Records

    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.

    Location

    Discover how to specify the Appointment location

    What are the Location Selection Options?

    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:

    1. Location

    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.

    2. Participant 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.

    3. Manual Entry

    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.

    4. Digital Location

    If your is not at a physical address, simply click the toggle to turn off all Location selection options and proceed with the setup.

    Timezone Selection

    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.

    How It Works:

    • 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, .

    Key Behaviour

    • 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, .

    Google Maps Integration

    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 .

    The Google Maps integration will display on all Location Selection Options that include a physical address.

    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:

    Travel Option
    Description

    Travel Alert

    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:

    Basic Details

    Learn about capturing basic details for a new Appointment

    What does the Basic Details stage include?

    The Basic Details tab captures the basic details of the , as described in the below table:

    Captured Information
    Description

    Appointment Actions

    Discover the Appointments Actions possible in Maica.

    What are Appointment Actions?

    Appointment actions refer to actions and tasks related to managing and handling your . There are several actions you can take within an in Maica, including the following:

    Appointment Actions
    Description

    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.

    Resource Profile

    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.

    Participant(s)
    Agreement
    Appointment Service
    Participant(s)
    Appointment Service
    Participant(s)
    Agreement
    Participant(s)
    Agreement
    Appointment Service
    The Maice Lifecycle in 90 seconds
    Create an Appointment
    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.

  • For edge cases (e.g. border towns or cross-timezone Appointments), you can manually override the timezone selection.

    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

    Appointment
    Participant
    Appointment
    Participants
    Appointment
    Appointment
    Appointment
    Google Maps Integration
    Appointment
    Appointment
    click here
    Appointment
    Appointment
    Appointment
    Appointment
    Appointment
    Appointment

    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.

    Things to look out for: Basic Details

    1. Incorrect Ratio

    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.

    A ratio is an NDIS concept where the number of Resource(s) to Participant(s) for the Appointment, expressed as (Required Resources) : (Required Participants) e.g. 1 Resource supporting 3 Participants would be 1:3. To learn more about Ratios, click here

    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.

    2. Participant(s) have no Agreement for selected Appointment Service.

    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:

    1. Provides an overview of the selected service and the available funding in the Participant(s) plan for said service.

    2. Indicates that the service will be billed against a Category Agreement Item

    3. Indicates that the service will be billed against a Statement Agreement Item

    4. 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.

    3. Resource(s) have a Roster Mode conflict

    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.

    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, 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.

    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.

    It is important to note that if a Resource has a Roster Mode set on their Resource Record that is different to the Roster Mode set for a specific Availability Record, the Availability Record Mode will take precedent during the Availability period. If No Availability Records are found and the Roster Mode is not set on the Resource Record: the Roster Mode for the Resource will be defined by the Global Roster Mode setting. This is configurable in the Maica settings.

    Participant(s)

    Appointment

    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.

    How do I access the Appointment Actions?

    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.

    These Actions are configurable in the Settings.

    Appointment Actions Visibility based on Appointment Status

    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.

    Appointment Status
    Available Actions

    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

    Appointment Resource Status & Actions Visibility based on Resource Status

    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.

    Statuses can be set automatically based on your organisation’s configuration in the , or manually by users with the correct permissions. By default, Maica sets the status to Accepted

    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:

    1. Check In/Out

    2. Quick Complete

    3. Cancel Appointments

    Note, Appointments with Pending or unaccepted Resources are also displayed as Unfilled in the Planner.

    Appointment Resource Status for Recurring 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.

    Unaccepted Resources will not be copied into recurring Appointments if validation rules are enabled.

    Appointment Resource Status Examples

    The table below outlines a few common scenarios around Resource Status and Scheduler Permissions and how Maica handles them in each case.

    Example
    Outcome

    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

    Check-In

    Appointment
    Appointment

    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.

    click here

    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.

    Check-In
    Appointments
    Appointment
    Appointment
    Check-In
    Resource(s)
    Appointment
    Resource(s)
    Appointment
    Resource(s)
    Appointment
    Resource(s)
    Appointment
    Appointment Service(s)
    Appointment
    Participant
    Appointment Service
    Appointment
    here
    Appointments
    Checklist(s)
    Appointment
    Checklist(s)
    Appointment
    Check-In
    Checklist
    Location
    Appointment
    Appointment
    Participants
    Service Agreement
    Participants
    Service Agreement

    Smart Selection Filter

    Learn about how the Smart Selection Filter works in Maica

    What is the Smart Selection Filter?

    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.

    Manage an Appointment

    Learn about managing Appointments in Maica.

    How do I manage an Appointment?

    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.

    Logo
    What does the Smart Selection Filter do?

    The Smart Selection Filter helps end users choose the most suitable:

    • Participant(s)

    • Resource(s)

    • Asset(s)

    for an Appointment or Shift by:

    1. Filtering out anyone who fails key requirements

    2. Scoring everyone who remains

    3. 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.

    Where do I find the Smart Selection Filter?

    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

    Smart Selection Filter Elements

    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:

    Element
    Description
    1. 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.

    1. 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.

    1. 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 .

    1. 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.

    1. 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.

    Smart Selection Filter Dropdown Criteria Sections

    The Dropdown Criteria Sections are only relevant when selecting a Resource(s). When selecting Participant(s) or Asset(s), your Score will be a number based purely on the number of matching Attributes.

    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:

    Category
    Description

    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.

    How do I use the Smart Selection Filter?

    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,

    To learn about the logic behind Ranking Criteria, click here.

    1. Click Add Criteria.

    2. A new filter row will appear where you can specify the Field, Operator, and Value.

    3. Multiple criteria can be added to refine the criteria further.

    Understanding Filter Components

    Each criterion is made up of three components:

    Component
    Description

    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 uses the same scoring, ranking, and weighting logic as Maica’s Optimisation Engine to calculate scores.

    For a detailed explanation of how scores are calculated (Availability, Workload, Skills, Attributes, Travel, and weighted scoring), refer to the article.

    How Smart Selection Differs for Resources, Participants, and Assets

    The Smart Selection Filter adapts depending on the type of record you are selecting.

    Resource Selection (Most Comprehensive)

    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.

    Participant Selection

    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 Selection

    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:

    Target Type
    Skills
    Attributes
    Availability
    Workload
    Travel
    Score Model

    Resource

    ✔

    ✔

    ✔

    ✔

    ✔

    Overall Matching Score (weighted)

    Participant

    Participant(s)
    Resource(s)
    Asset(s)
    Appointment
    Appointment
    Manage an Appointment

    Which Appointment sections can I manage?

    Once editing, you are able to manage the following sections:

    Basic Details

    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.

    Appointment Services

    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:

    Number
    Detail

    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.

    Location

    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.

    Additional Details

    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.

    Custom Fields

    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.

    Recurring Schedule

    To learn about creating a Recurring Schedule for an Appointment, please click here.

    When editing a Recurring Schedule, you have the following options:

    Please note, when an Appointment is part of a Recurring Schedule, the drag and drop functionality will be prevented.

    1. Edit the First Appointment

    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.

    2. Edit a Subsequent Appointment

    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:

    Apply changes only to this Appointment Logic

    When editing a singular Appointment from a Schedule, Maica uses the following logic:

    • The updated Appointment retains its link to the parent Appointment Schedule.

    • Maica identifies the modified Appointment as a "gap" in the schedule and hence prevents the creation of any replacement or duplicate Appointment records.

    • This logic aligns with how the Maica handles Appointment records, where the Appointment remains linked to the Appointment Schedule without triggering replacements.

    An example of this logic is shown below:

    Example Inputs:

    • Week Starting: Monday, 2nd December

    • Frequency: Daily

    • Scheduled Time: 9:00 AM - 10:00 AM

    Modification: Appointment for Wednesday, 4th December

    • Moved to 1:00 PM - 2:00 PM

    • Apply Changes Only to This Appointment = TRUE

    When the Appointment for Wednesday, 4th December, is modified, Maica:

    • Retains the link between the modified Appointment and the parent Appointment Schedule

    • Populates the Original Scheduled Start Date field with 4th December, 9:00 AM and the Original Scheduled End Date field with 4th December, 10:00 AM

    During the daily batch process or reevaluation of the Appointment Schedule:

    • The system references the Original Scheduled Start Date and identifies that this Appointment is still linked to the Appointment Schedule

    • No replacement Appointment is created for the original time (9:00 AM - 10:00 AM)


    Outcome:

    • The Appointment for Wednesday, 4th December, reflects the updated time (1:00 PM - 2:00 PM) while remaining part of the parent Appointment Schedule

    • The system doesn't generates a duplicate Appointment for the original time (9:00 AM - 10:00 AM), maintaining consistency and avoiding unintended records.

    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.

    Note, the same logic will be extended to Manage Unavailability, where the split schedule pattern is also used.

    The original Schedule is preserved with all its original values (e.g. Frequency, Interval) intact. Only the End Date of the original Schedule is updated to one day before the new Schedule starts.

    This prevents unintended changes from being applied to both Schedules and ensures historical accuracy is maintained. The logic is further detailed below:

    Apply changes to all future Appointments Logic

    An example of this logic is shown below:


    Example Inputs:

    • Week Starting: Monday, 2nd December

    • Frequency: Weekly

    • Scheduled Time: 10:00 AM - 11:00 AM

    Modification: Appointment for Wednesday, 11th December

    • Changed to Fortnightly, 2:00 PM - 3:00 PM

    • Apply Changes to Future Appointments = TRUE


    When this Appointment is modified, Maica:

    • Creates a new Schedule starting from 11th December, with the updated values.

    • Sets the 11th December Appointment as the new Master.

    • Updates the original Schedule to end on 10th December, retaining its original settings (Weekly, 10:00 AM - 11:00 AM).

    • Ensures no unintended extra Appointments are created on the original Schedule.


    Outcome:

    • A clean schedule split occurs: The original Schedule ends as expected, and a new one begins with the updated settings.

    • Changes are only applied to future Appointments, avoiding duplication and misalignment between schedules.

    Saving your Appointment

    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.

    Appointment
    created
    Appointment
    Appointment
    Rostering Management
    Participant(s)
    Smart Selection
    Participant(s)
    Resource(s)
    Resource(s)
    Smart Selection
    Resource(s)
    Asset(s)
    Asset(s)
    Smart Selection
    Asset(s)
    Planner
    Appointment Service
    Appointment Service(s)
    Appointment Service
    Check-Out
    Quick Completion
    Cancellation
    Attach Files
    Participant Signatures
    Appointment Breaks
    Appointment Expenses
    Participant Notes
    Checklists
    Open Appointment Profile
    Google Maps

    Funding Record Overview

    Learn about the Funding Record and what information it captures in Maica

    What is a Funding Record?

    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)

    You can also create a Service Booking in Maica and PRODA directly from the Funding record. Click to learn more about creating Service Bookings.

    How do I create a Funding Record?

    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.

    What are the key components of a Funding Record?

    A Funding Record contains a number of components, these are explained in further detail below.

    Funding Item

    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 Period

    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.

    Please note: Maica does not create or determine this information. All Funding Period information is retrieved directly from the NDIS and is presented in Maica for visibility only.

    Depending on your version of Maica, Funding Periods may also be displayed as Plan Periods.

    On the Funding Item, there will be two sections related to Funding Periods:

    1. Funding Period Information

    This section provides an overview of the Funding Period Information, including:

    Field
    Description

    2. List of Funding Periods

    Then, each individual Funding Period record is displayed in the table at the bottom of the Funding Item, including:

    Field
    Description

    In order to learn more about Participant Funding Periods, click .

    Please note, both Support Coordinators & Plan Managers, based on their authority, have limited access to the budget. This is not determined by Maica.

    Funding Goal

    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 order to learn more about Participant Plan Goals, click .

    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.

    Service Booking

    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.

    Similar to the Funding and Funding Goal information, the NDIS provides a number of Service Booking resources you can refer to for more information. Please click to learn more.

    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.

    What other information is stored in a Funding Record?

    Budget Information

    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.

    Field Name
    Notes

    NDIA Synchronisation Information

    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.

    Field Name
    Notes

    Things to be aware of: NDIS Funding Records

    1. Automatic Plan Extensions

    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.

    2. Service Booking Extensions

    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.

    Participant Profile

    Learn about the Participant Profile and its components in Maica

    Participant Profile Overview

    In Maica, Participants are managed as Salesforce Contact Records.

    Plan Goals
  • Service Bookings

  • in
    Maica
    without retrieving the information directly from PRODA first.

    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.

    here
    Synchronise Participant Information
    here
    here
    here
    here
    here
    Canceled
    Appointment Service
    Participant
    Appointment
    Appointment Service
    here
    Appointment Service
    Appointment Service
    Appointment
    If you are looking for an overview of how 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

    Participant Record Summary Components

    The Participant Record includes handy Summary Components containing key information about the Participants Funding , Service Bookings , Service Agreements and Schedule. These components are:

    Note, Service Booking components are only for non-PACE NDIS Participants.

    Funding Summary Component

    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.

    Service Booking Summary Component

    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.

    This component is hidden if the Participant has no active record(s)

    Active Service Agreement Summary Component

    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.

    For more information on how Funding is managed in Maica, please go here for NDIS Funding and here for Home Care Package funding.

    Active Schedule

    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

    Please note, only Schedule records that meet all of the following conditions appear:

    • Under Evaluation = TRUE

    • The related Master Appointment is not cancelled

    • The Master Appointment has a valid 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:

    Upcoming Schedule

    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

    For optimal Maica performance, a maximum of 1,000 future Appointments can be displayed for a single Participant.

    Appointment records are accessible via the Scheduled Start Date link.

    Participant Record Related Lists

    The Participant Record also includes handy Related Lists containing key information about the Participants. The key lists are further detailed below:

    Connections

    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.

    Connections can be found under Related by default, however your team can change where this appears by customising your Salesforce Page Layouts.

    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.

    Participant Resources

    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 Resource list is directly related to the Resources Participant list on the Resource Profile. This means, if multiple Participants are receiving care from a given Resource, this will be reflect on the Resource Participants list and display on the Resource Profile under the Profile Management tab. This list will be dynamically updated if an update occurs on the Resource Profile.

    Participant Goals

    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.

    Archiving Participant Goals The Archived checkbox allows Goals to be marked as inactive once they are complete, expired, or no longer relevant. Archived Goals are excluded from all lookup fields and will not appear when linking Goals in other forms such as Participant Notes or Appointment completion flows. Only active (non-archived) Goals remain available for selection.

    Below are some example scenarios of how Participant Goals will behave in Maica:

    Scenario
    Behaviour

    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.

    Participant Record Automated Geographical Classification

    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:

    Fields Populated on the Participant Profile:

    • MMM Classification (maica_cc__MMM_Classification__c)

    • PHN (Primary Health Network) (maica_cc__PHN__c)

    • LGA (Local Government Area) (maica_cc__LGA__c)

    For example:

    1. User enters the following on a Participant record:

    • Mailing Postal Code: 3184

    • Mailing City: Elwood

    2. Maica searches for a Postcode record where:

    3. A match is found in the Postcode object with the following details:

    • LGA: Port Phillip

    • PHN: South Eastern Melbourne

    • MMM Classification: 1

    4. Participant record is updated automatically with the above details

    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.

    The Modified Monash Model (MMM) defines whether a location is a city, rural, remote or very remote.

    ✖

    ✔

    ✖

    ✖

    ✖

    Attribute match count

    Asset

    ✖

    ✔

    ✖

    ✖

    Optional (location-based)

    Attribute match count

    below
    Optimiser
    Postcode Suburb Key = 3184Elwood
    Funding Records
    Payment Methods
    Active Schedule
    Upcoming Schedule

    Resource Profile

    Learn about the Resource Profile and its components in Maica

    Resource Profile Overview

    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 Profile Attributes

    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.

    Whilst each Record Type may have different attributes, both Record Types share the same Related Lists. These are also explained in further detail .

    Asset Attributes

    The table below outlines the attribute fields related to the Asset Record Type.

    Field Name
    Field Type
    Notes

    All standard Maica Picklist fields can be extended to suit your needs. To learn more, click .

    To learn more about each Field Type, click .

    Resource Attributes

    In Maica, a Resource is linked to a standard Salesforce object called User. A User is the profile with which a person logs into Salesforce, hence the relationship between Resource and User implies that each Resource (or care worker) will have a matching User profile in Salesforce.

    The table below outlines the attribute fields related to the Resource Record Type.

    Field Name
    Field Type
    Notes

    Resource Related Lists

    In addition to the standard attributes described above, Maica also provides a variety of related information to further manage the configuration of a Resource.

    Resource Participants

    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.

    The Resource Participants list is directly related to the Participant Resources list on the . This means, if multiple Resources are caring for a given Participant, this will be reflect on the Participant Resources list and display on the under the Client Care tab. This list will be dynamically updated if an update occurs on the Resource Profile.

    Skills

    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 learn how to import your set ofResource Skills into your Maica instance, click .

    Once Skills have been assigned to a Resource, they are used in the .

    Skill Level indicates the Resources level of competence in the associated Skill.

    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 Resources

    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

    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.

    Appointments

    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.

    Timesheets

    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.

    Availability

    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:

    Field
    Description

    Per Maica's validation, Availability Records will take precedence over Global Settings.

    Please note that Roster Mode field cannot be null. To learn more about the validation enforcing this rule, click .

    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.

    When no Availability records exist for a Resource, Maica will interpret this as the Resource being available to work at any time by default. This is configurable in the settings.

    If you wish to assign overnight Availability to a Resource, you will need to configure the required Operating Hour records to support it. To learn how to do so, click .

    Unavailability

    An Unavailability Record is used in Maica to record when a particular Resource is not available for accepting either Shifts or Appointments.

    Unavailability can be self managed by Resources using the Salesforce1 mobile application.

    Resources can simply populate the Date and Reason for their Unavailability, and it will be created as a record on their profile.

    When an Unavailability Record is created, Maica will automatically remove the associated Resource from any assigned Appointments or Shifts during the Unavailability period.

    Unavailability can also be managed directly from the .

    Roster Mode Overview

    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.

    It is important to note that if a Resource has a Roster Mode set on their Resource Record that is different to the Roster Mode set for a specific Availability Record, the Availability Record Mode will take precedent during the Availability period. If No Availability Records are found and the Roster Mode is not set on the Resource Record: the

    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 Mode
    for the
    Resource
    will be defined by the
    Global Roster Mode
    setting. This is configurable in the
    Maica
    settings.

    ID 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.

    below
    here
    here
    Participant Profile
    Participant Profile
    Smart Selection Filter
    Appointments
    Planner
    Timesheet Management
    Planner

    Indicates if the Resource record is Active and available within Maica

    Ability to enable or Disable for your Resource

    Timesheet Management
    below
    Smart Selection Filter
    Smart Selection Filter
    Smart Selection Filter
    Click here
    settings
    Billing Management
    Invoicing Management
    Travel Management
    knowledge base
    permission sets
    NDIS
    Xero
    Stripe
    Google
    NDIS APIs
    here
    Planner Management
    here
    here
    here
    click here
    click here
    here
    here
    click here
    here
    here
    Manage Travel Logic for Administrators
    here
    here
    Planner Management
    here
    Administration Guide
    Rostering Management Settings
    here
    Global Setting
    here
    here
    Settings
    Settings
    here
    here
    here
    here
    here
    here
    Travel Management Settings
    click here
    click here
    Global Setting
    Planner Management
    Service Management Settings
    click here
    Optimisation Engine Logic
    here
    here
    Validation Management
    here
    Rostering Management

    Resource Optimiser

    Learn about the Resource Optimiser in Maica

    What is the Resource Optimiser?

    The Resource Optimiser is a tool within the Maica Planner used to identify and fill unfilled Appointments or Shifts using Maica's Optimisation Engine.

    Please note, you can also access the Resource Optimiser from the Schedule Manager.

    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.

    To learn more about the logic behind Maica's Optimisation Engine, please .

    Where do I find the Resource Optimiser?

    The Resource Optimiser can be accessed directly from the Planner Toolbar, as shown below.

    To find it, simply:

    1. Open the Planner.

    2. Select the Optimiser icon from the toolbar at the top of the screen.

    3. The Optimiser panel will open, displaying a list of all unfilled Appointments or Shifts within the date range currently shown in the Planner.

    What gets pulled into the Optimiser?

    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.

    For example, a Shift requiring two staff members but currently assigned only one will appear in the Optimiser until the second Resource is confirmed.

    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.

    For example, if you have an unfilled Appointment in the following week to the one set in your Planner, that Appointment will not display in the Optimiser.

    Optimiser Parts

    The Optimiser is made up of a range of different parts, each are described in the table below:

    Please note, key parts of the Optimiser are described in further detail below. Please click the Part name to learn more.

    No.
    Part
    Description

    Please refer to the sections below for further detail on the above described Optimiser parts:

    Resource Pool

    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:

    1. Click Add Criteria.

    2. A new filter row will appear where you can specify the Field, Operator, and Value.

    3. Multiple criteria can be added to refine the pool further.

    4. 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:

    Component
    Description

    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.

    The Resource Pool does not impact the order of Resource ranking — only which Resources are included for evaluation.

    Ranking 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:

    1. An inclusion rule (must meet at least one), and

    2. A prioritisation rule (more matches = stronger candidate).

    Example 1:

    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.

    Example 2: Two Different Criteria

    Criteria added:

    1. Resource → Region equals East Metro

    2. Resource → Language contains Mandarin

    Here is how Resources are treated:

    Resource
    Matches Region?
    Matches Language?
    Included?
    Relative Ranking

    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.

    Removing or changing Ranking Criteria only affects optimisation runs with that criteria applied, it has no impact on previously optimised records.

    Optimiser Settings

    Matching Score Importance Level

    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:

    Category
    Description

    For example, if Attributes and Skills are set to 40% each, and Travel is set to 0%, the Optimiser will focus almost entirely on matching qualities and skill requirements, ignoring distance as a factor.

    Please note, weighting does not filter Resources — it influences how strongly each matching criterion affects the total score.

    Only use allocated Resources

    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.

    Resource Column

    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.

    Resource Statuses

    Each Resource is displayed as a pill with a distinct border colour and style to indicate its current status.

    Status
    Visual Indicator
    Description

    Available Actions

    Each Resource pill includes a dropdown menu providing context-sensitive actions. The available actions depend on the Resource’s current status.

    Action
    Description
    Available When

    Example Scenarios

    Scenario
    Starting Status
    Action Taken
    Result

    Appointment Insights

    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:

    Field
    Description

    Manually Assign Resources

    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.

    To learn more about the Find Resource modal, please .

    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.

    How Manual Assignment Works

    1. Click the Resource Column in the Optimiser to open the Find Resource modal.

    2. 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.

    3. Use the Search Bar or Sort By options to locate preferred Resources.

    4. Tick the checkbox beside each Resource you wish to assign.

    Manual Assignment Scenarios

    Scenario
    Configuration
    Action
    Outcome

    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.

    A Resource who meets more criteria will rank higher than a Resource who meets fewer.

    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

    Resource Pool

    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

    Ranking Criteria

    Criteria you add adjust Resource scoring. (Described further below)

    3

    Settings

    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.

    click here
    Participant Resource
    Find Resource
    click here
    click here

    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.

    Resource Column
    Appointment Insights
    Manual Assignment
    Planner Management Settings