LogoLogo
User Guide
User Guide
  • Welcome to the Maica User Guide
  • Getting Started
    • Get Started with Maica
    • Your Maica Learning Path
    • The Maica Lifecycle
    • Salesforce Key Concepts
    • Maica Key Concepts
      • Participant
      • Resource
      • Price List
      • Asset
      • Service Agreement
      • Support Item
      • Appointment Service
      • Appointment
      • Shift
      • Location
      • Delivery Activity
      • Timesheet
      • Invoice
      • Checklist
    • Maica Usage Rules
  • Participants
    • Participant Profile
      • NDIS Funding
        • Synchronise Participant Information
        • Funding Record Overview
        • Service Booking Overview
        • Create Service Booking
        • Manage Service Booking
      • Home Care Package Funding
    • Billable Participant Notes
      • Take a Note
      • Custom Fields
      • Tasks
      • Files
    • Manage Preferences
    • Global Actions
      • New Appointment
      • New Shift
      • New Billable Participant Note
      • New Timesheet Entry
  • Resources
    • Resource Profile
  • The Planner
    • Planner Overview
    • Planner Views & Modes
      • Schedule
      • Participant View
      • Asset View
      • Accomodation View
      • Roster View
      • Shift View
    • Planner Actions
      • Order By
      • Group By
      • Select Date
      • Create new Appointment
      • Appointment Optimiser
      • Manage Unavailability
      • Billable Participant Note
    • Planner Filter
      • Basic Filters
      • Advanced Filters
  • Appointments
    • Create an Appointment
      • Basic Details
      • Location
      • Schedule
      • Additional Details
      • Custom Fields
      • Summary
      • Smart Selection Filter
    • Manage an Appointment
    • Appointment Actions
      • Check-In
      • Check-Out
      • Quick Completion
      • Cancellation
      • Attach Files
      • Participant Signatures
      • Appointment Breaks
      • Appointment Expenses
      • Participant Notes
      • Checklists
      • Open Appointment Profile
      • Google Maps
  • Shifts
    • Create a Shift
      • Basic Details
      • Location
      • Schedule
      • Additional Details
      • Shift Instructions
      • Custom Fields
      • Participant Notes
      • Summary
    • Manage a Shift
    • Shift Actions
      • Check-In
      • Check-Out
      • Quick Complete
      • Cancellation
      • Attach Files
      • Shift Breaks
      • Shift Expenses
      • Checklists
      • Shift Notes
      • Open Shift Profile
      • Google Maps
  • Timesheets
    • Timesheet Overview
      • Create a Timesheet Entry
      • Submit a Timesheet
  • Service Agreements
    • The Building Blocks
    • Agreement Management
      • NDIS Agreements
        • Manage Service Agreement
        • Manage Price List
      • Aged Care Agreements
        • Manage Budget
        • Manage Services
        • Discharge Services
  • Invoices
    • Invoice Overview
      • Invoice Line Item Overview
      • Payment Request Overview
    • Invoice Actions
      • Process an Invoice
      • Claim an Invoice
      • Reclaim an Invoice
      • Cancel an Invoice
      • Credit an Invoice
      • Sync with Xero
  • Integrations
    • Xero Integration Overview
    • Stripe Integration Overview
  • Troubleshooting
    • General Troubleshooting
  • ANNOUNCEMENTS
    • Support at Home Legislation
Powered by GitBook
On this page
  • How do I manage an Appointment?
  • Which Appointment sections can I manage?
  • Basic Details
  • Appointment Services
  • Location
  • Additional Details
  • Custom Fields
  • Recurring Schedule
  • Saving your Appointment

Was this helpful?

Export as PDF
  1. Appointments

Manage an Appointment

Learn about managing Appointments in Maica.

PreviousSmart Selection FilterNextAppointment Actions

Last updated 1 month ago

Was this helpful?

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.

Which Appointment sections can I manage?

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

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

3

4

This number outlines the number of Appointment Service(s) that are connected to your appointment.

5

The Custom Fields tab captures any information from Custom Fields that have been added to your Organisations Appointment profile beyond what Maica offers. This section allows for the management of already added fields, not the addition of new fields.

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

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.

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.

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

In this section you can manage the , and allocated to your selected Appointment. Similarly to , 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 of any of the above mentioned.

You can also adjust Date & Time Information as well as the Type of . This is aimed at showing you quickly who is attending and who is delivering services on what date and and what time.

Change the quantity of an to control how long each may spend at an . The quantity of an is further explained .

Click this button to refresh any changes to your including an adjustment of quantity. This will update any relevant information including the Service cost.

Click this button to mark this as cancelled, this will exclude this Service from your .

If the selected do not have an Agreement for the added , an error will occur. This error is further detailed .

This section enables the editing of the Location at which the is being held including a lookup to an existing Location, a Participant Mailing Address, a manually-entered Address, or a Digital Location for this only.

The focus of this section is to edit the and applicable to this . The lookup is filtered by active at the same that the is being held.

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

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

Basic Details
Participant(s)
Resource(s)
Asset(s)
Creating an Appointment
Smart Selection
Appointment
Appointment Services
Location
Appointment
Appointment
Additional Details
Shift(s)
Checklist(s)
Appointment
Shift
Shift(s)
Location
Appointment
Custom Fields
Recurring Schedule
here
Canceled
Appointment Service
Appointment Service
Appointment
Appointment
created
Appointment
Appointment
Participant(s)
Appointment Service
Appointment Service
Participant
Appointment
Appointment Service
here
Manage an Appointment
here