Troubleshooting Your Access Control System
Learn about ACS-related errors and warnings, as well as how to resolve them.
The Seam API provides a set of errors and warnings that help you to troubleshoot your ACS.
On-Premises Access Control System Errors
These errors alert you to issues involving the connection between your on-premises ACS and Seam.
acs_system.errors.seam_bridge_disconnected
acs_system.errors.seam_bridge_disconnectedThis error indicates that the Seam API cannot communicate with your Seam Bridge, for example, if the Seam Bridge executable has stopped or if the computer running the Seam Bridge executable is offline. This error might also occur if your Seam Bridge is connected to the wrong workspace.
To troubleshoot this error:
Make sure that you are running the latest version of the Seam Bridge. If not, reinstall and then start the Seam Bridge executable. See the Seam Bridge installation instructions.
Reconnect the Seam Bridge. To reconnect, you can go to your ACS in the Access Systems area of the Seam Console or use a Connect Webview. For more information, see Pairing the Seam Bridge with Your Workspace.
Restart the Seam Bridge executable.
acs_system.errors.visionline_instance_unreachable
acs_system.errors.visionline_instance_unreachableThis error indicates that your Seam Bridge is functioning correctly and the Seam API can communicate with your Seam Bridge, but the Seam API cannot connect to your on-premises Visionline ACS. For example, the IP address of the on-premises ACS may be set incorrectly within your Seam workspace.
To troubleshoot this error:
Reconnect your on-premises ACS to correct the IP address configuration. To reconnect, you can go to Access Systems in the Seam Console or use a Connect Webview. See the setup instructions within the system integration guide for your on-premises ACS.
Make sure that your on-premises ACS is running correctly.
Cloud-based Access Control System Errors
These errors alert you to issues involving your cloud-based ACS.
acs_system.errors.salto_ks_subscription_limit_exceeded
acs_system.errors.salto_ks_subscription_limit_exceededYou have reached the maximum number of users allowed for your site. This means that new access codes cannot be created.
To troubleshoot this error, contact Salto support to increase your user limit, or delete some users from your site.
acs_system.errors.acs_system_disconnected
acs_system.errors.acs_system_disconnectedYour access system has been disconnected.
To troubleshoot this error:
Use a Connect Webview to reconnect the account.
Unblock the "Seam Integration" user within the Salto KS dashboard.
acs_system.errors.account_disconnected
acs_system.errors.account_disconnectedYour login credentials for your ACS account are invalid.
To troubleshoot this error, use a Connect Webview to reconnect the account.
Cloud-based Access Control System Warnings
These warnings alert you to issues involving your cloud-based ACS.
acs_system.warnings.salto_ks_subscription_limit_almost_reached
acs_system.warnings.salto_ks_subscription_limit_almost_reachedthe Salto KS site has exceeded 80% of the maximum number of allowed users.
To troubleshoot this warning, contact Salto support to increase your subscription limit, or delete some users from your site.
ACS User Errors
These errors alert you to issues involving your ACS users.
acs_user.errors.salto_ks_subscription_limit_exceeded
acs_user.errors.salto_ks_subscription_limit_exceededThis Salto KS user could not be subscribed on Salto KS because the site's user subscription limit has been exceeded.
To troubleshoot this error, increase your subscription limit, or delete some users from your site.
acs_user.errors.failed_to_create_on_acs_system
acs_user.errors.failed_to_create_on_acs_systemThe ACS user was not created on the ACS system. This is likely due to an unexpected internal error.
This error occurs in any of the following situations:
The site user role does not exist.
The email address provided is already in use.
To troubleshoot this error, contact Seam support or, if applicable, consider updating the user's email address.
acs_user.errors.failed_to_update_on_acs_system
acs_user.errors.failed_to_update_on_acs_systemThe ACS user was not updated on the ACS system. This is likely due to an unexpected internal error. This error also occurs if the provided email address is already in use.
To troubleshoot this error, contact Seam support or, if applicable, consider updating the user's email address.
acs_user.errors.failed_to_delete_on_acs_system
acs_user.errors.failed_to_delete_on_acs_systemThe ACS user was not deleted on the ACS system. This is likely due to an unexpected internal error.
To troubleshoot this error, contact Seam support.
acs_user.errors.deleted_externally
acs_user.errors.deleted_externallyThe ACS user was deleted from the ACS system outside of Seam.
ACS User Warnings
These warnings alert you to issues involving your ACS users.
acs_user.warnings.salto_ks_user_not_subscribed
acs_user.warnings.salto_ks_user_not_subscribedThis ACS user is not subscribed on Salto KS, so they cannot unlock doors or perform any actions.
This warning occurs in any of the following situations:
The ACS user's access schedule has not started yet.
The ACS user's access schedule has ended.
The site has reached its limit of active users (subscription slots).
The ACS user has been manually unsubscribed.
acs_user.warnings.being_deleted
acs_user.warnings.being_deletedThe ACS user is being deleted from the ACS system. This is a temporary state, and the deletion will complete shortly.
Last updated
