AbaClock (Time Clock)

In AbaNinja, the working hours of a maximum of 21 employees or 21 users (including the account owner) can be recorded. By connecting the AbaClock time clock, your employees can also clock in and out independently. Working hours are automatically transmitted to AbaNinja.

In this guide, you will learn step by step how to connect AbaClock to your AbaNinja account.

For questions or to purchase an AbaClock, please contact our colleagues: www.abaclock.ch

Prerequisites

The following requirements must be met in order to synchronize an AbaClock with AbaNinja:

• You have an AbaNinja account.

• You have at least a Basic subscription for Swiss21.

• You have an AbaClock, an AbaClock app, and the corresponding tokens / badges for your employees.

• You have created the relevant users or employees in AbaNinja (Settings > Company > User management and Time tracking > Employees).

Setting up AbaClock

Before setting it up, update the AbaClock app in your App Store or download the latest version.

AbaNinja is the central source for the data displayed on AbaClock. This means that every change in AbaNinja is queried before an action is performed on AbaClock and is therefore used as the most up-to-date version of the data. However, an out clocking in AbaNinja may overwrite an out clocking from AbaClock. This happens when the out clocking was recorded on AbaClock, but the view in AbaNinja is outdated and has therefore not yet displayed this out clocking. Saving a manually recorded clocking in AbaNinja then overwrites the clocking from AbaClock. The following chapters explain the connection between AbaNinja and AbaClock and cover the most important points.

To use AbaNinja with AbaClock 3, an API connection is required. This requires a paid subscription. In addition, employees who are to clock their in and out times must be recorded in AbaNinja and have an active employment relationship.

Attention: If the token is deleted, the AbaClocks that used this token must also be reconnected.

An API token is required for the connection. It can be created under “Settings / Automation / API Tokens”. It is displayed only once, so AbaClock must be connected during this step or the QR code must be saved.

The new token can be generated via “Create” in the top right-hand corner. This opens a dialog in which a label can be assigned. In the next field, a description can be added, for example including information on what is processed through it and which iPad has been connected to it. It is recommended to create a separate token for each AbaClock.

A validity period must also be defined. It is recommended to set this for a longer period of several years or to use calendar entries as reminders that AbaClock needs to be reconnected.

The following permissions must be granted:

• Addresses

• Settings

• Profile

• Time tracking

The token can then be completed by clicking “Save” in the top right-hand corner.

After saving, the token is displayed only once; it can be copied or displayed as a QR code.

Attention: The code makes it possible to enter and retrieve data via an interface. Please treat it like online banking login credentials and do not share it with anyone.

Save the token or, if you have the iPad at hand, display the QR code and scan it with AbaClock. To do this, open the AbaClock 3 app and click the “Scan QR code” button via “AbaNinja company” in the menu on the left. The iPad’s front camera will then open and the QR code can be scanned.

Once the QR code has been scanned, the technical connection between AbaClock and AbaNinja is complete.

After connecting, the following options are available in addition to the company UUID and the authentication token:

Field descriptions

Auto-badge after

This setting defines after what period following badge recognition the employee should automatically be clocked in or out. The following options are available:

• Never
  User interaction is always required for a clocking to be recorded.

• Immediately
  After the badge is recognized, the employee is immediately clocked in or out without requiring any interaction.

• 3 seconds
  After the badge is recognized, the employee is automatically clocked in or out after 3 seconds. The process can still be cancelled during this time.

• 5 seconds
  After the badge is recognized, the employee is automatically clocked in or out after 5 seconds. The process can still be cancelled during this time.

Employees

This displays the employees. It can also be used to record, edit, or delete the badge.

Delete

Deletes the connection to AbaNinja when it is no longer needed or when a new token has been created.

In addition to the API token, the employee’s BadgeID can also be updated online, as well as whether the employee should have access to the AbaClock menu. This is defined using the “Is admin” setting. These settings are available in AbaNinja under “Time tracking / Employees”. To do this, select an employee and open “Configuration of connections (apps)” via the three-dot menu. There, the BadgeID can be entered, for example using a desktop reader unit, and the checkbox can be enabled to specify whether the employee is an “AbaClock admin” and may therefore access and change the settings on AbaClock.

Recorded working hours

The working hours are now transmitted to AbaNinja.

Information about AbaClock

You can find further information and answers about AbaClock here:

• FAQ / Updates: https://downloads.abacus.ch/downloads/weitere-applikationsdokumente/zeiterfassung

• AbaSupport (for sales partners): https://app.abasupport.abacus.ch/kb/KB-8302