> For the complete documentation index, see [llms.txt](https://knowledge.maica.com.au/maica-knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledge.maica.com.au/maica-knowledge-base/appointments/manage-an-appointment/standard-experience.md).

# Standard Experience

Learn how to manage an Appointment using the Standard experience in Maica

{% hint style="info" %}
Maica offers two experiences for creating and managing Appointments, **Standard** and **Legacy**. The experience you see depends on your organisation's settings. If your screen does not look like the one described below, contact your administrator.
{% endhint %}

In the Standard experience, an existing Appointment opens in a single screen with two steps. In the first step you review and change the details, editing each one in place. In the second, the **Summary** shows what will be delivered, to whom and at what cost, before you save.

{% @arcade/embed url="<https://app.arcade.software/share/eflavDWLGcemDDq0kxeO>" flowId="eflavDWLGcemDDq0kxeO" %}

## Opening an Appointment

To open an Appointment, click on it in your [Planner](https://knowledge.maica.com.au/maica-knowledge-base/the-planner/planner-overview.md).

The Appointment opens ready to edit. Each detail can be changed directly, subject to your permissions, with no separate edit step. The **Actions** menu sits beside the heading at the top of the details.

Where an Appointment has been Completed or Cancelled, a banner above the details states this, and only the actions that still apply are offered.

The footer shows where you are in the process, as **Step 1 of 2** or **Step 2 of 2**.

## The Actions menu

The **Actions** menu holds everything you can do with the Appointment beyond editing its details. It is available at any time while the Appointment is open, including while you are making changes. Each action is only listed when it applies to the Appointment and to you.

| Action                          | When it is listed                                                                                                                                                                                                |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Check-In**                    | When the Appointment can be checked into                                                                                                                                                                         |
| **Check-Out**                   | When the Appointment can be checked out of, including once it is Completed                                                                                                                                       |
| **Quick Complete**              | When the Appointment can be quick completed                                                                                                                                                                      |
| **Cancel**                      | When the Appointment can be cancelled                                                                                                                                                                            |
| **Participant Notes**           | When you have permission to manage Participant Notes, including once the Appointment is Completed or Cancelled                                                                                                   |
| **Participant Signature**       | When check-in and check-out are available and the Appointment has at least one Participant                                                                                                                       |
| **Checklist**                   | When check-in and check-out are available and the Appointment has Checklists to complete during delivery                                                                                                         |
| **Attach Files**                | When Appointment files are enabled for your organisation                                                                                                                                                         |
| **Manage Appointment Break**    | When Appointment breaks are enabled for your organisation                                                                                                                                                        |
| **Manage Appointment Expenses** | When Appointment expenses are enabled for your organisation, including once the Appointment is Completed                                                                                                         |
| **Appointment Incidents**       | When you have permission to manage incidents                                                                                                                                                                     |
| **Open Appointment**            | When you have permission to open Appointment records. The record opens in a new tab                                                                                                                              |
| **Directions from...**          | When Google Maps is configured for your organisation. Directions are offered from the Home Address, the Primary Location and the Previous Appointment, where each has an address, and from your Current Location |

Once an Appointment is Completed or Cancelled, **Check-In**, **Quick Complete**, **Cancel**, **Participant Signature**, **Checklist**, **Attach Files**, **Manage Appointment Break** and **Appointment Incidents** are no longer listed. **Check-Out** and **Manage Appointment Expenses** remain available on a Completed Appointment, but not on a Cancelled one.

Each action opens its own dialog. To learn more about each one, see [Appointment Actions](https://knowledge.maica.com.au/maica-knowledge-base/appointments/appointment-actions.md).

## Step 1: reviewing and changing the details

<figure><img src="https://2670482622-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhehRshYIRk6XUlay9L3b%2Fuploads%2F7SyivDRYTuSsfgTOiM7D%2Fimage.png?alt=media&#x26;token=97a48082-80da-47d2-b2ba-8eeb401ebbec" alt="The details step of an Appointment in the Standard experience"><figcaption><p>The details of an Appointment</p></figcaption></figure>

Each detail of the Appointment is a row. Click a row to open it, make your change, and move on to the next. When you have finished, click **Next** to move to the Summary.

{% hint style="info" %}
The rows shown depend on the **Available Sections** configured on the Appointment's Services and the default sections in Maica Settings, so you only see the details your organisation uses.
{% endhint %}

### Date and time

Change the start and end, or the start and duration, and Maica works out the other. If you move the end to before the start, Maica moves the start back to keep the Appointment's length. The times are read in the time zone shown on the row, which you can change. Beneath the row, a subtitle shows the time zone and whether the Appointment repeats.

### Participants

Search for Participants by name, or click the filter icon to open **Find Participants** for a more detailed search. To learn more, see [Smart Selection Filter](https://knowledge.maica.com.au/maica-knowledge-base/appointments/create-an-appointment/general/smart-selection-filter.md).

Beneath the list, **Required Participants** shows how many Participants the Appointment needs. Click the number to change it, then tick to confirm. The icon beside the count tells you whether the Participants selected match the number required.

When you add a Participant, each Service on the Appointment is added for them as well. Their lines appear on the Summary, where any line they do not need can be unticked before you save.

### Resources

Search for active Resources by name, or click the filter icon to open **Find Resources**. Beneath the list, **Required Resources** shows how many Resources the Appointment needs, and can be changed in the same way.

Where a Resource carries a warning, such as a possible conflict with their availability, it is shown in amber on that Resource. The warning names the cause for that Resource, together with the date and time that was checked, for example that no availability covers the period, that the Resource is on leave, or that their availability is at a different Location. Click it to confirm that the Resource should still be allocated.

Availability is checked again whenever the Appointment's Location changes, so a Location mismatch is shown even when the Resource was added first.

### Services

Search for an Appointment Service by its name or its tags to add it. Each Service is shown as one row for each Claim Type it is delivered under, showing its name, its **Claim Type** (click to change it) and an icon showing whether it can be funded:

| Icon          | Meaning                                                                                                   |
| ------------- | --------------------------------------------------------------------------------------------------------- |
| Green tick    | The Service can be delivered and billed                                                                   |
| Padlock       | The Service is billed against a stated Service Agreement Item, or against the funding source you selected |
| Amber warning | A funding decision is needed. Make it in [Select Funding Source](#select-funding-source)                  |
| Red error     | The Service cannot be delivered as it stands, for example because no funding covers it                    |

To deliver the same Service under another Claim Type, search for the Service again. A new row is added with the Standard Claim Type, which you can then change.

Hover over any icon to see why it is shown.

One Service is the **Primary Support**, marked with a star. To make a different Service the Primary Support, click its arrow icon.

To remove a Service, click its remove icon. A Service already saved on the Appointment is marked for removal and removed when you save, so it can be restored before then.

### Location

The **Location** row offers three types of location:

| Location type      | What to enter                                                                                                                                                               |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Online**         | Nothing further. The Appointment takes place online                                                                                                                         |
| **Location**       | Choose an existing Location. Its address is shown beneath as the **Location Address**. Where Accommodation is in use, you can also choose an Accommodation at that Location |
| **Manual Address** | Enter an address, or search for one. A Street is required                                                                                                                   |

Beside the Location search, the people icon switches the search to the selected Participant's own addresses.

Once the Appointment has a Location, or a manual address with a Street, and at least one Resource is assigned or selected, click **Click Here to Manage Travel** to open the Manage Travel dialog and work out travel to and from the Appointment for each Resource. When travel has been calculated, the link reads **Travel Calculated. Click here to Manage**.

The link is also shown where the Appointment holds only an Asset, and it is not shown for a Shift, because travel does not apply to a Shift. On an existing Appointment, every selected Resource already has a travel row, so opening Manage Travel does not rebuild anything or create duplicate Appointment Resources.

### Schedule

Where the Appointment belongs to a recurring series, the **Schedule** row shows a one-line summary of the recurrence, and opening it shows the schedule's details.

| Indicator               | Meaning                                                                                                                             |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| **Open Schedule**       | Shows whether this is the Master Appointment of its schedule or one Appointment in the series. Click it to open the Schedule record |
| **Unapproved Schedule** | The schedule has not been approved, so it will not generate ongoing Appointments until it is                                        |
| **Approve Schedule**    | Shown in place of Unapproved Schedule when you have permission to approve schedules. Click it to approve the schedule               |

To make a one-off Appointment repeat, click **Add Schedule** in the row, then set the start and end dates, how often it repeats and at what interval. For a weekly schedule, choose the days of the week. A schedule can create up to 730 occurrences.

A new schedule whose start date is on or before today creates this Appointment and then only the occurrences dated after today that are not on leave. The Schedule row shows the number of Appointments that will actually be created and names the dates that will not be created, and the **Cost Breakdown** leaves those dates out. When you save, Maica asks you to confirm the dates that will not be created. This applies to a new schedule only, and an existing series is not affected.

#### Removing a schedule

To stop an Appointment repeating, click **Remove Schedule** (the X on the row) and save. Maica asks you to confirm in a **Remove Schedule** dialog that shows how many future Appointments, or Shifts, will be deleted. These are the Appointments on the same Schedule that start in the future and are still in the default status. Maica then deletes them and the Schedule record.

The Appointment you are editing, the Master Appointment, past Appointments and Appointments that are no longer in the default status are kept, with the Schedule removed from them. Select **Cancel** in the dialog to return to the Appointment with the schedule still removed, or click **Add Schedule** to restore the original schedule.

#### Schedule End

The earliest **Schedule End** you can enter depends on which Appointment in the series you have open.

* **The Master Appointment:** the Schedule End cannot be earlier than that Appointment's own end date.
* **Any other Appointment in the series:** the earliest Schedule End allowed is the **Schedule Start**. This means you can change an unrelated field on a later Appointment and save it for that Appointment only, even where its date falls after the Schedule End.

When you choose to apply your changes to all future Appointments from an Appointment that is not the Master, the new schedule starts on that Appointment. Where the **Schedule End** is before that Appointment's date, the save is refused with the message "Schedule End cannot be before this Appointment's date when applying changes to future Appointments." Nothing is saved, and the schedule is unchanged. For a Shift, the message names the Shift. A Schedule End on the Appointment's own date is accepted, and the series splits as described in [Manage an Appointment](https://knowledge.maica.com.au/maica-knowledge-base/appointments/manage-an-appointment.md).

#### Cost forecast

For a recurring Appointment, the cost forecast shows what each occurrence will cost. The forecast is shown a page at a time, using **Previous Page** and **Next Page**, and can be filtered to a single Participant or exported to CSV.

Click an occurrence's cost to see a **Cost Breakdown so far**, with the **Total Utilised** and **Total Remaining** figures for the funding it draws on.

### Other details

| Row                  | What it holds                                             |
| -------------------- | --------------------------------------------------------- |
| **Assets**           | The Assets used during the Appointment                    |
| **Appointment Type** | The Type of the Appointment                               |
| **Status**           | The status of the Appointment                             |
| **Checklist**        | The Checklists that apply to the Appointment              |
| **Instructions**     | Instructions for the Resources delivering the Appointment |
| **Custom Fields**    | Any fields your organisation has added to Appointments    |

## Step 2: the Summary

<figure><img src="https://2670482622-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhehRshYIRk6XUlay9L3b%2Fuploads%2F6XAGrFzDFI93YhVI4viZ%2Fimage.png?alt=media&#x26;token=c7463f5a-3ff2-4783-b6c3-7060a19ded61" alt="The Summary step of an Appointment in the Standard experience"><figcaption><p>The Summary</p></figcaption></figure>

The Summary shows what will be delivered before you save. At the top are the **Date and Time**, the **Location** and, where the Appointment repeats, the **Schedule**.

Beneath them, the Services are listed by Participant. Each Participant's Services are shown under their name, with the Claim Type beneath each Service. Every Service on the Appointment is listed under every selected Participant, and each line can be unticked if that Participant does not need that Service.

### Quantity

Each line shows its **Scheduled Quantity**, in the Service's unit, and the Ratio it is delivered at. Where no quantity has been set, the line reads **not set**. Where you are permitted to, click the quantity to change it, then tick to confirm.

### Cost

Where your organisation shows Appointment costs, each line shows its cost, coloured by its funding position:

| Colour | Meaning                                                                                                          |
| ------ | ---------------------------------------------------------------------------------------------------------------- |
| Green  | The cost is within the Participant's remaining budget                                                            |
| Amber  | The Participant is on leave during the Appointment. Hover to see the details                                     |
| Red    | The indicative cost of this Service exceeds the current remaining budget for the Participant's Service Agreement |

Where a cost could not be calculated, a retry icon is shown instead. Click it to calculate the cost again.

From the Summary you can also open the [Select Funding Source](#select-funding-source) and [Adjust Ratio Matrix](#adjust-ratio-matrix) dialogs, described below.

## Select Funding Source

{% @arcade/embed url="<https://app.arcade.software/share/JUUBDfV983P4snq1N1TN>" flowId="JUUBDfV983P4snq1N1TN" %}

The **Select Funding Source** dialog is where you decide which funding pays for each Service. You open it from the Summary.

The dialog shows one tab per Participant. Inside a tab, the funding options are listed in a single table, grouped by Service, so the options for one Service read as one block. Each tab carries a status icon:

| Icon          | Meaning                                        |
| ------------- | ---------------------------------------------- |
| Green tick    | Every Service on this tab has a funding source |
| Amber warning | At least one Service still needs a selection   |

### What each column shows

| Column                 | What it holds                                                                                                                                                                |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Service**            | The Appointment Service, named on the first line of its group                                                                                                                |
| **Select**             | The tick that chooses this option                                                                                                                                            |
| **Support Item**       | The Support Item the Agreement Item funds, or the **Support Category** where the Agreement Item is category funded. On an unfunded line, this cell holds a Price List search |
| **Funding Type**       | The Agreement Item's Funding Type, or **Unfunded** on an unfunded line                                                                                                       |
| **Funding**            | **Category Funding** or **Stated** for an Agreement Item, or **Price List** on an unfunded line                                                                              |
| **Amount / Remaining** | The Agreement Item's Remaining Amount                                                                                                                                        |

{% hint style="info" %}
Hover over a **Support Item** to see the Agreement Item's record number alongside its name.
{% endhint %}

{% hint style="info" %}
The **Amount / Remaining** figure is only shown to users permitted to see Appointment costs. The funding options themselves are shown to everyone who can select them.
{% endhint %}

### Choosing a funding source

Where Maica has resolved the funding for a Service on its own, that line is ticked and locked. This happens when the Participant has only one Agreement Item that can fund the Service, or when the cost calculation has already resolved one.

Where the Service requires a funding source to be selected and the Participant has more than one Agreement Item that could fund it, no line is ticked and the tab stays amber until you choose. The dialog states: *We've found more than one Funding Source that can be used for this Service.*

Where the Service can be delivered unfunded, an **Unfunded** line closes its group. Tick it and choose a Price List. Only active Price Lists with at least one active entry are offered. Until a Price List is chosen, the line shows an amber **Selection Required** badge.

Choosing an Agreement Item clears any Price List on that line, and choosing a Price List clears any Agreement Item.

Where no Agreement Item covers the Service and it cannot be delivered unfunded, the group shows: *No Agreement Item covers this Appointment Service for this Participant, and it cannot be delivered unfunded.*

{% hint style="info" %}
Whether you are asked to choose a funding source, and whether a Service can be delivered unfunded, is set for each Appointment Service by your administrator.
{% endhint %}

{% hint style="warning" %}
A funding source saved on a Service is carried forward only while it is still valid. An Agreement Item that has since expired is no longer offered, and the Service asks for a selection again.
{% endhint %}

The funding you select is saved with the Appointment, and is used whenever the Appointment is costed or billed.

## Adjust Ratio Matrix

The **Adjust Ratio Matrix** shows every Participant against every Service in one grid, so you can set the figures for one Participant and Service without affecting the others. You open it from the Summary.

Participants run down the side and Services across the top. Each cell holds one Participant's figure for one Service. A dash means that Participant is not receiving that Service, and the cell cannot be edited.

The toggle at the top right switches the grid between two figures:

| Figure                 | What it holds                                                                                                                                                        |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Scheduled Quantity** | The amount scheduled for that Participant, in the Service's unit. Enter a number of zero or more, to two decimal places                                              |
| **Ratio**              | The support ratio, written workers first as two whole numbers separated by a colon, for example `1:3`. A muted ratio means the cell uses the Appointment's own ratio |

Click a cell to edit it, then tick to confirm. Changing a Ratio does not change the Scheduled Quantity, and nothing is saved until you click **Confirm**.

## Saving your changes

While Maica is checking the Participants, Resources and Services, **Next** and the save button are greyed out. Anything that stops the Appointment being saved is listed above the details, including any Participant who has no Service and any Service still waiting on a funding decision.

Where the Appointment belongs to a recurring series, Maica asks on save whether your changes apply to this Appointment only or to all future Appointments in the series. To learn how each option affects the schedule, see [Manage an Appointment](https://knowledge.maica.com.au/maica-knowledge-base/appointments/manage-an-appointment.md).

## Shifts

The Standard experience is also used for Shifts. For a Shift:

* The Participants row is not shown
* The Location is required, and is chosen from existing Locations only
* Travel does not apply
* Labels read in Shift terms, for example **Shift Service**, **Shift Notes**, **Manage Shift Break**, **Shift Incidents** and **Open Shift**
