Sync logic

Sync logic

Sync logic

LivionKey Smart service uses various parameters to determine the type of operation that should be synced (Pick up, RetThe LivionKey Smarturn or both) , whether a locker should be reserved, which device should be used for the reservation, and for how long the reservation should be made.

The main use case for automated key handling is to allow a customer to pick up and return a key to a LivionKey automat.

Default Locker Contract

If the reservation duration is shorter or equal to the defaultDuration, LivionKey Smart service will consider this as a short term reservation and will associate a locker to this reservation for its duration. The end user will be then able to use the same pincode to fetch and return the key.

This pincode will be synchronised to the LivionKey automate a certain number of days before the start of the reservation, as specified by the defaultSyncTime.

Fetch and Return Locker Contracts

In the case of a long-term or permanent reservation, the locker is only reserved during the pickup and/or return phases. To manage these types of reservations, two LockerContracts can be generated.

The first LockerContract allows the user to retrieve the key. This contract starts at the same time as the reservation start time, and lasts for the duration specified by fetchDuration. The pin code will be synchronized fetchSyncTime days before the reservation starts, allowing the user to have access to the pin code in advance.

💡
Once the key is fetched, The LivionKey Smart service will clear the locker. allowing it to be used for another reservation. By clearing, the system can ensure that no lockers remain reserved for long periods of time and helps to optimize the usage of lockers.

The second LockerContract allows the user to return the key. This contract starts returnDuration days before the reservation ends and lasts until the end of the reservation. The pin code will be synchronized returnSyncTime days before the reservation ends, again allowing the user to have access to the pin code in advance. This way, the user can return the key at their convenience.

💡
Make sure returnSynctime is set to a value that is greater than or equal to the returnDuration. This way the return Locker Contract pincode will always be synced just before the user can retrieve the key.

General settings

The LivionKey Smart service offers the following settings:

defaultStartTime is the default start hour for a reservation. If set to 9, this means that the pin code will be valid from 9 am on the start date of the reservation.

defaultEndTime is the default end hour for a reservation. If set to 9, this means that the pin code will be valid until 9 am on the end date of the reservation.

freeLockersLimit refers to the lowest free locker percentage in a device group before triggering a warning. This allows the system to alert the administrator when a certain threshold of lockers are occupied, so that they can take action if necessary.

timezone is the time zone that is used for all date handling in the system. This ensures that all date and time related information, such as reservation start and end times, default start and end times, and synchronization times, will be based on the specified time zone.

onlyBusinessDays is a setting that determines whether the duration settings exclude holidays and days off. When this setting is enabled, reservations will not be allowed to start or end on holidays or days off, as specified by the system.

Default values

Parameter
Default
tz
‘Europe/Helsinki’
defaultStartTime
9
defaultEndTime
9
fetchSyncTime
14
fetchDuration
7
returnSyncTime
20
returnDuration
20
defaultSyncTime
14
defaultDuration
14
freeLockersLimit
20
onlyBusinessDays
false