Biometric Integration

The Attendance Punch Logs from the biometric device is a type of Check-in and Check-out log of an employee.
OneHash has a provision to store these logs in a document called Employee Checkin.
Attendance can then be marked based on the Employee Checkin records and the shift Auto Attendance Settings of the employee by using Auto Attendance
Hence, integrating your Biometric Device --or any access control system that collects IN/OUT--, can be done by the following steps:

Setting up Auto Attendance to mark attendance from the Employee Checkin

Before you import employee's Check-in and Check-out logs into your OneHash system, you would have to set up the employees and their shifts to be able to generate attendance using the Auto Attendance feature in OneHash.

Once you have set up the Employee and assigned shifts to the employees, you are now ready to proceed to the next step.

Populating the Biometric Punch Logs into OneHash's Employee Checkin

Depending on your biometric system and its features, there can be a lot of ways you can import the Punch logs into OneHash:

Use OneHash Data Import Tool:

The simplest possible solution (in terms of implementation complexity) would be to generate an Excel/CSV of the Check-in/Check-out and use the built-in data import tool in OneHash to periodically import to your Employee Checkin Document
Please refer to OneHash's Documentation on Data Import Tool for more on how to do this.

API Integration:

You can automate the process of importing the Biometric Punch Logs by integrating it with the available API in OneHash.
This API can be accessed at:
/api/method/erpnext.hr.doctype.employee_checkin.employee_checkin.add_log_based_on_employee_field
This method requires technical knowledge and you should probably get in touch with your OneHash implementor or Biometric system vendor.

Set up a python script on your computer to integrate ZKTeco or similar devices:

This method works only for ZKTeco or similar devices that use the ZKProtocol to communicate over TCP/IP.
This script is available at: Click Here
Please follow the instructions given in the script page to set it up on your computer.
This Script pulls biometric logs from a supported device and uses the API mentioned in the above step to push the data into OneHash.

Updated on: 21/03/2023