> 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/troubleshooting/general-troubleshooting.md).

# General Troubleshooting

Get an overview of General Troubleshooting in Maica.

This article provides solutions to common issues users may encounter while using **Maica**. The table below outlines frequent problems, their possible causes, and recommended fixes. If you experience an issue, follow the suggested steps to resolve it.

For more complex issues or if the problem persists, please [contact Maica Support](https://www.maica.com.au/contact-us).

{% hint style="info" %}
Please note, some of the issues listed below may not be directly related to Maica but could be caused by external factors such as browser settings or device configurations. Where applicable, we have provided external links to relevant documentation for further guidance.
{% endhint %}

<table data-full-width="false"><thead><tr><th>Issue</th><th>Error Message</th><th>Fix</th></tr></thead><tbody><tr><td>Appointments are not visible in the Planner</td><td></td><td><ul><li>Check Setup > Session Settings > Enable Lightning Web Security</li><li>Clear Cache and Refresh</li><li>Ensure the user has the necessary <a href="https://knowledge.maica.com.au/maica-knowledge-base/maica-administration-guide/data/permission-sets.md">Permission Sets</a></li><li>Check the <strong>Appointment Resource Status</strong> filter. It starts from the <strong>Default Appointment Resource Status</strong> setting, so Appointments whose Resources are in other statuses, such as Pending, are hidden until the filter includes those statuses</li><li><p>Toggle the <a href="https://knowledge.maica.com.au/maica-knowledge-base/the-planner/planner-filter.md">Planner Filters</a></p><ul><li>Unfilled Only</li><li>My Appointments Only</li></ul></li></ul></td></tr><tr><td>No Agreement Item found for this Appointment Service Error</td><td><mark style="color:red;"><code>We could not find the required Service Agreement Item for the selected Appointment Service for this Appointment Date: DD/MM/YYY</code></mark></td><td><ul><li>Reconcile Agreement Items with Support Items in chosen Appointment Service and the Service Time, Service Day of the Support Item with the time/day you are scheduling the Appointment</li></ul></td></tr><tr><td>Resource not Available error</td><td><p>Maica names the cause for each Resource, with the date and time it checked. The message is one of:</p><p><mark style="color:red;"><code>&#x3C;Resource> is not active for Sat 17 Oct 10:00 am - 11:00 am (employment dates).</code></mark></p><p><mark style="color:red;"><code>&#x3C;Resource> is unavailable for part or all of Sat 17 Oct 10:00 am - 11:00 am (&#x3C;Type>).</code></mark></p><p><mark style="color:red;"><code>No availability has been recorded for &#x3C;Resource>.</code></mark></p><p><mark style="color:red;"><code>&#x3C;Resource> has no availability covering Sat 17 Oct 10:00 am - 11:00 am.</code></mark></p><p><mark style="color:red;"><code>&#x3C;Resource> has no availability covering Sat 17 Oct 10:00 am - 11:00 am at &#x3C;Location>.</code></mark></p><p><mark style="color:red;"><code>&#x3C;Resource>'s availability for Sat 17 Oct 10:00 am - 11:00 am is set to Shift, which does not match this Appointment.</code></mark></p><p>When the check blocks a save, the message begins <mark style="color:red;"><code>We have found an Availability Conflict.</code></mark> and lists one sentence for each Resource.</p></td><td><ul><li>Check Maica Settings > <a href="https://knowledge.maica.com.au/maica-knowledge-base/maica-administration-guide/settings/validation-management.md">Validation Settings</a> > Availability Settings</li><li><strong>Not active (employment dates):</strong> check the Resource's Start Date and End Date</li><li><strong>Unavailable (leave or other type):</strong> check the Resource > <a href="https://knowledge.maica.com.au/maica-knowledge-base/resources/resource-profile.md#unavailability">Unavailability records</a></li><li><strong>No availability recorded or not covering the time:</strong> check the Resource > <a href="https://knowledge.maica.com.au/maica-knowledge-base/resources/resource-profile.md#availability">Availability Records</a> and the Availability Consideration setting</li><li><strong>At a Location:</strong> the Resource has availability for the time, but not at the Appointment's Location. Check the Location on the Availability record</li><li><strong>Set to Shift or Appointment:</strong> the Roster Mode on the Availability record does not match the record being scheduled</li></ul></td></tr><tr><td>Resource has Roster Mode conflict error</td><td><mark style="color:red;"><code>&#x3C;Resource>'s Roster Mode is Appointment, which does not match this Shift.</code></mark></td><td><ul><li>Check the Resource > <a href="https://knowledge.maica.com.au/maica-knowledge-base/resources/resource-profile.md#roster-mode-overview">Roster Mode</a></li><li>Check the Resource > <a href="https://knowledge.maica.com.au/maica-knowledge-base/resources/resource-profile.md#availability">Availability Records</a></li><li>Check Maica Settings > <a href="https://knowledge.maica.com.au/maica-knowledge-base/maica-administration-guide/settings/rostering-management.md">Rostering Management</a></li><li>Where availability is enforced and the Resource also fails an availability check, the availability message is shown first and the Roster Mode message appears once that is resolved</li></ul></td></tr><tr><td>Resource has no Shifts at the Appointment date &#x26; time error</td><td><mark style="color:red;"><code>This Resource has no Shifts at the Appointment date &#x26; time</code></mark></td><td><ul><li>Ensure the Resource is assigned to a Shift during the date &#x26; time the Appointment is being scheduled</li></ul></td></tr><tr><td>User specific errors in the Salesforce Mobile Application</td><td></td><td><ul><li>Ensure your device’s Operating System is using the latest version</li><li>Ensure your Salesforce Application is using the latest version</li><li>Clear your Salesforce Application cookies. Directions <a href="https://help.salesforce.com/s/articleView?id=000386491&#x26;language=en_US&#x26;type=1">here</a>.</li><li>Refresh your session by logging out and then logging in</li></ul></td></tr><tr><td>User specific errors in Salesforce on a Desktop device</td><td></td><td><ul><li>Ensure your device’s Operating System is using the latest version</li><li>Ensure your web browser is using the latest version</li><li>Clear your cookies and cache for the browser you’re using</li><li>Refresh your session by logging out and then logging in</li></ul></td></tr><tr><td>Inability to scroll horizontally in the Planner on Timeline View</td><td></td><td><ul><li>If your computer has a precision trackpad, swipe left or right horizontally with two fingers on the touchpad</li><li>If your computer does not have a precision touchpad, hold shift and swipe vertically on your touchpad or mouse</li><li>Enable horizontal scrolling in touchpad settings on your computer</li></ul></td></tr><tr><td>Start and End Time fields appear blank when editing Appointments or Service Agreements</td><td></td><td><p><strong>Note</strong>: Confirm the Chrome browser is up to date. This issue is usually caused by outdated Chrome versions failing to render standard date/time values. Hence, values are still present in the system and used in calculations, but do not display.</p><p><strong>Fix</strong>: Update Chrome and refresh the page.</p></td></tr><tr><td>Appointment updates or completions not processing as expected</td><td></td><td><ul><li>Check if any custom automation (such as Flows, Apex Triggers, or Managed Packages) may be temporarily disabling or interfering with Maica’s core Appointment processes.</li><li>Ensure all Appointment-related automations are re-enabled if temporarily disabled.</li></ul></td></tr><tr><td>Maica Settings rendering in sections that belong to other areas of the Settings</td><td>Detected by inability to interact with Settings (eg: No picklist values presented). Settings that are rendering in where they should not be will not be able to be interacted with.</td><td><ul><li>Refresh the page</li><li>Clear cache, then refresh the page</li></ul></td></tr><tr><td>Production Record IDs copied into Sandbox after a refresh</td><td><em>Please bare in mind that when a Sandbox is refreshed from Production it will copy Production Record ID's into the Maica Settings which can cause issues checking out of Appointments. For example the Travel Timesheet Activity lookup in Travel Settings</em><br></td><td>Update all Maica Settings that reference record IDs to point to valid <strong>Sandbox</strong> records instead of Production records.</td></tr><tr><td>Planner or mobile app fails to load on an Apple device</td><td></td><td>This can occur when <strong>Lockdown Mode</strong> is enabled on an iPhone or iPad. Lockdown Mode restricts certain web technologies that the Salesforce mobile app relies on to render Maica.<br><br><strong>Fix:</strong> On the device, go to <strong>Settings > Privacy &#x26; Security > Lockdown Mode</strong><br><br>Either turn Lockdown Mode off, or (if the user needs it enabled generally) exclude the Salesforce app / your org from Lockdown Mode<br><br>Force-quit and relaunch the Salesforce app</td></tr><tr><td>Travel values not calculating for Appointment or Shift desptie Location being at a valid address and Google API Key being populated</td><td><code>Error Routes API - Bad Request</code></td><td>This can occur when the Google API Key stored in Maps Management may need updating in the Google Console, to find out the steps on how to do so, please refer to <a href="https://knowledge.maica.com.au/maica-knowledge-base/maica-administration-guide/settings/maps-management.md">Maps Management</a></td></tr><tr><td>An Appointment is Under Review after a travel proposal</td><td>The review reason reads <code>Travel review required for &#x3C;Resource>: proposed travel on a sequential Appointment.</code></td><td><ul><li>This is expected under Sequential travel. Every proposal on a later leg of a sequence is reviewed, whatever the tolerances are set to</li><li>A user with the Manage Travel permission chooses <strong>Keep predicted</strong> or <strong>Approve proposed</strong> on <strong>Confirm Completion</strong> or <strong>Quick Complete</strong>. See <strong>Reviewing Proposed Travel</strong></li></ul></td></tr></tbody></table>
