Situation needs to be considered or evaluated for integrations

Created by Qiang Zheng, Modified on Wed, 15 Jun, 2022 at 9:57 AM by Qiang Zheng

The Salto KS system is working based on an assumption the components are online most of the time, the UX will be improved if you have thought for the exception cases, like IQ offline, lock offline, below is a table with different situations, so you can prepare accordingly.

If you are looking for different event type, please check this page, KS web UI and mobile app is using the same set of API, so there are no differences in the events: https://claysolutions.freshdesk.com/a/solutions/articles/101000415998

Lock status	IQ status	API status	Expected results	Suggestions
Online*	Online*	Online*	The lock can be opened pin, remote opening, tag, digital key under the user who has valid access in the given time
Online to the IQ	Offline (e.g. internet disconnected)	Online	The existing access will work for the locks under the IQ. new access or updated access will not be propagated to the IQ, hence will not work. Remote opening will not work	Having backup network option set for the IQ. Prepare plan B for heavily remote opening uses
Offline to IQ	Online	Online	Pin, remote opening will not work Credentials granted with offline access will work (normal offline access & offline access by audit trail)	Adjust the local connection, present maintenance card Set offline access for important users Set offline access by audit trail for places where allowed
Offline	Offline (IQ unplugged)	Online	same above	same above
Online to IQ	Not applicable	Offline	The existing access will work for the locks under the IQ. new access or updated access will not be propagated to the IQ, hence will not work. Remote opening will not work	Check https://status.saltoks.com/

*Lock status is indicated through API, KS web UI as well in KS mobile app, the online/offline status is updated by the IQ. The IQ use heartbeat to keep the lock online, if the IQ missed 5 times heartbeat, the IQ will mark the lock as offline, and forward to the backend, more details can be found here: https://claysolutions.freshdesk.com/a/solutions/articles/101000412438

So it is possible the lock is offline, but still online in the dashboard. Presenting the maintenance card on the lock, if flashing green, then the lock is online, red means offline

*IQ status is indicated through API, KS web UI as well in KS mobile app, the online/offline status is updated by the backend. The backend use heartbeat to keep the IQ online, it would take up to 30 min for the backend to determine the IQ is offline. The true status of the IQ is indicated by IQ LED, flashing red means offline, flashing green every 5 min means connected.

*API status can be checked with https://status.saltoks.com/

* Details about https://claysolutions.freshdesk.com/a/solutions/articles/101000412432