AbaClock (Time Clock)
In AbaNinja, you can track the hours of up to 21 employees or 21 users (including account owners). With the integration of the AbaClock clock-in/clock-out system, your employees can clock in and out independently. The hours worked are automatically sent to AbaNinja.
This guide will show you step by step how to connect your AbaClock to your AbaNinja account.
For questions or to purchase an AbaClock, please contact our colleagues at www.abaclock.ch
Prerequisites
To synchronize an AbaClock with AbaNinja, the following prerequisites are necessary:
You have an AbaNinja account.
You have at least a basic subscription to Swiss21.
You have an AbaClock, an AbaClock app, and corresponding tokens/badges for your employees.
You have recorded the corresponding users or employees in AbaNinja (Settings > Company > User Management and Time Tracking > Employees).
Setting up AbaClock
Before setting up AbaClock, update the AbaClock app in your app store or download the latest version.
Connecting AbaNinja and AbaClock 3
AbaNinja is the central source for the data displayed on the AbaClock. This means that any changes made in AbaNinja are checked before any action is taken on the AbaClock, and the latest data is used. However, it may happen that an out-stamping in AbaNinja overwrites an out-stamping from the AbaClock. This occurs when the out-stamping is recorded on the AbaClock, but the view in AbaNinja is outdated and has not yet displayed the out-stamping. By manually saving the clock-in/clock-out in AbaNinja, the clock-in/clock-out from the AbaClock is overwritten. The following chapters explain the connection between AbaNinja and AbaClock and highlight the most important points.
To use AbaNinja with AbaClock 3, an API connection is required. This requires a paid subscription. Additionally, the employees who will be clocking in and out must be recorded in AbaNinja and be in an active employment relationship.
Note: If the token is deleted, the AbaClocks that used this token must also be reconnected.
Creating the API token
For the connection, an API token is required. This can be created under "Settings / Automation / API Tokens". This will only be displayed once, so the AbaClock must be connected in this step or the QR code must be saved.
The new token can be generated at the top right by "Create". A dialog box will open where a name can be assigned. In the next field, a description can be added, such as what exactly is being processed and which iPad it is connected to. It is recommended to create a separate token for each AbaClock.
A validity period must also be defined. It is recommended to create this for a longer period of a few years or to use calendar entries to remind you that the AbaClock needs to be reconnected.
Under permissions, the following must be granted:
Addresses
Settings
Profile
Time recording
The token can then be completed at the top right by "Save".
Connecting AbaClock via QR code
After saving, the token will be displayed once, which can be copied or displayed as a QR code.
Note: With the code, data can be recorded and read via an interface. Please treat this like access data for online banking and do not entrust it to anyone.
Save the token or if you have an iPad, you can display the QR code and scan it with the AbaClock. To do this, open the AbaClock 3 app and press the "Scan QR Code" button in the menu on the left via "AbaNinja Company". The front camera of the iPad will then open and the QR code can be scanned.
Once the QR code is scanned, the technical connection between the 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 can be used to define after how long after the badge recognition the automatic in or out punching should be done. The following options are available:
Never
Always requires user integration so that a punch can be recorded.
Immediately
After the badge is recognized, the employee is immediately punched in or out without any interaction.
3 seconds
After the badge is recognized, the employee is automatically punched in or out after 3 seconds. During this time, the process can still be canceled.
5 seconds
After the badge is recognized, the employee is automatically punched in or out after 5 seconds. During this time, the process can still be canceled.
Employees
This shows the employees. It is also possible to capture, change or delete the badge.
Delete
Deletes the connection to AbaNinja if it is no longer needed or a new token has been created.
In addition to the API token, the badge ID on the employee can also be changed online, as well as whether the employee should have access to the AbaClock menu or not. This is defined by the "Is Admin" setting. These settings are possible in AbaNinja under "Time Tracking / Employees". To do this, an employee must be selected and called up via the 3-point menu under "Connection Configuration (Apps)". In this, the badge ID can be recorded, for example with a table reader, and the checkbox can be activated whether the employee is an "AbaClock Admin" and thus the settings on the AbaClock can be called up and changed.
Recorded working hours
The working hours are now transmitted to AbaNinja.
Information about AbaClock
Further information and answers about AbaClock can be found here: https://help.abaclock.ch/.