Most blocked states or errors within ACLogics stem from five primary factors: local connectivity issues, temporary service interruptions, account access settings, monthly token usage limits, or incomplete workflow requirements.

This guide provides quick verification steps and troubleshooting strategies to get you back to work.

Troubleshooting Quick Reference

Error or Blocked State	Possible Cause	Recommended Fix
Cannot Start Diagnosis	Empty symptom input, unselected system type, or offline status.	Enter symptoms, select a system type, confirm your connection, and verify your token limit.
”Service Unavailable”	Local internet is active, but ACLogics cannot reach our servers.	Wait a moment, restart the app, and refresh. If the state persists, check our service status.
”Export PDF” is Disabled	The report is still generating, has failed, or another export is running.	Wait for the active generation to complete or restart the report compilation process.
Plan Does Not Update	Transaction sync latency between Apple and the app backend.	Tap Restore Purchases in your Account Badge area or restart the app.
Offline Changes Won’t Sync	Offline/online state conflict or lost team permission.	Ensure you are fully online, check your active account context, and confirm team membership.
Unknown Error	Outdated app version, cached app state, or temporary glitch.	Check the App Store for updates, restart/reopen the app, and try again.

Detailed Troubleshooting Steps

1. What to Check if a Diagnosis Cannot Start

If you are unable to submit a diagnostic query, verify that:

Required Fields: The symptom description is not empty and a valid HVAC system type has been selected.
Connectivity: Your device has an active internet connection.
Submissions: There are no active diagnostic requests currently pending or submitting.
Usage Limits: Your account has not exceeded its monthly token allowance.

2. Resolving “Service Unavailable”

A “Service unavailable” message usually means your local connection is active, but the app cannot establish a stable connection with ACLogics backend services.

Force close the app and wait 30 seconds.
Confirm your device can load web pages outside the app.
Reopen the app and retry the action.
If the issue continues, contact support with the exact time of the error.

3. Fixing Disabled “Export PDF” Options

If the Export PDF action is grayed out or inactive:

Generation Status: Confirm the report is fully compiled. If compilation failed, restart the report creation.
Concurrency: Ensure you do not have multiple PDF exports running in parallel.

4. Restoring Subscription Access

If you upgraded your plan but your status still displays as Free:

Tap your Account Badge in the top navigation bar.
Scroll to the subscription section.
Tap Restore Purchases to re-authenticate with the Apple App Store.
If this fails, restart the app. If the issue persists, contact support with your purchase receipt details.

5. Resolving Offline Sync Failures

If edits made in the field fail to sync upon returning online:

Active Profile: Check that you are signed in to the correct account profile (Personal vs. Organization).
Permissions: Confirm your organization membership is still active and that you have permission to edit the job.

6. Handling Unknown Errors

If you encounter an unexpected or unknown error:

Check for Updates: Visit the App Store to verify if a newer version of the ACLogics app is available.
Restart the App: Close the application completely, reopen it, and attempt the action again.

[!TIP] If you encounter a persistent failure that is not listed here, take a screenshot of the exact error code or message and email it to contact@aclogics.com for direct engineering assistance.

Troubleshoot common errors