# Appointment Actions
## What are Appointment Actions?
Appointment actions refer to actions and tasks related to managing and handling your [Appointment](https://knowledge.maica.com.au/maica-knowledge-base/getting-started/maica-key-concepts/appointment). There are several actions you can take within an [Appointment](https://knowledge.maica.com.au/maica-knowledge-base/getting-started/maica-key-concepts/appointment) in Maica, including the following:
| Appointment Actions | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Check-In ](https://knowledge.maica.com.au/maica-knowledge-base/appointments/appointment-actions/check-in) |
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.
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 Completion ](https://knowledge.maica.com.au/maica-knowledge-base/appointments/appointment-actions/quick-completion) | 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. |
| [Cancellation ](https://knowledge.maica.com.au/maica-knowledge-base/appointments/appointment-actions/cancellation) | 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. |
| [Attach Files ](https://knowledge.maica.com.au/maica-knowledge-base/appointments/appointment-actions/attach-files) | 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. |
| [Participant Signatures ](https://knowledge.maica.com.au/maica-knowledge-base/appointments/appointment-actions/participant-signatures) | 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. |
| [Appointment Breaks](https://knowledge.maica.com.au/maica-knowledge-base/appointments/appointment-actions/appointment-breaks) | 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](https://knowledge.maica.com.au/maica-knowledge-base/appointments/appointment-actions/appointment-expenses) | 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. |
| [Participant Notes ](https://knowledge.maica.com.au/maica-knowledge-base/appointments/appointment-actions/participant-notes) | It is possible to take Participant Notes during the management of an Appointment at any time, including for already completed Appointments. |
| [Checklists ](https://knowledge.maica.com.au/maica-knowledge-base/appointments/appointment-actions/checklists) | 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. |
| [Open Appointment Profile ](https://knowledge.maica.com.au/maica-knowledge-base/appointments/appointment-actions/open-appointment-profile) | This opens the Salesforce Appointment profile which allows you to see all relevant Appointment information using the native Salesforce platform. |
| [Google Maps](https://knowledge.maica.com.au/maica-knowledge-base/appointments/appointment-actions/google-maps) | 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](https://knowledge.maica.com.au/maica-knowledge-base/getting-started/maica-key-concepts/appointment), simply click on the [Appointment](https://knowledge.maica.com.au/maica-knowledge-base/getting-started/maica-key-concepts/appointment) in your [Planner](https://knowledge.maica.com.au/maica-knowledge-base/the-planner/planner-overview), then click the `View` button. Once the [Appointment](https://knowledge.maica.com.au/maica-knowledge-base/getting-started/maica-key-concepts/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.
{% hint style="info" %}
These Actions are configurable in the [Planner Management](https://app.gitbook.com/s/9selzjEx6KX7RYEawAVr/settings/planner-management) Settings.
{% endhint %}
## Appointment Actions Visibility based on Appointment Status
The visibility of the Appointment actions are dependant on the **status** of the [**Appointment**](https://knowledge.maica.com.au/maica-knowledge-base/getting-started/maica-key-concepts/appointment). Please refer to the table below to learn which action is available for each [Appointment](https://knowledge.maica.com.au/maica-knowledge-base/getting-started/maica-key-concepts/appointment) status.
| Appointment Status | Available Actions |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Scheduled` (Pre Check-In) |
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.
{% hint style="info" %}
Statuses can be set automatically based on your organisation’s configuration in the [Service Management Settings](https://app.gitbook.com/s/9selzjEx6KX7RYEawAVr/settings/service-management), or manually by users with the correct permissions.\
\
By default, Maica sets the status to **Accepted**
{% endhint %}
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
{% hint style="info" %}
Note, Appointments with Pending or unaccepted Resources are also displayed as **Unfilled** in the Planner.
{% endhint %}
### 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.
{% hint style="info" %}
Unaccepted Resources will not be copied into recurring Appointments if validation rules are enabled.
{% endhint %}
### 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 |
