Biometric attendance machine integration with ERPNext
ERPNext and Frappe HR build attendance from Employee Checkin records. This page shows how every punch on your attendance machines becomes an Employee Checkin, IN or OUT, without a sync script running on an office PC.
ERPNext
Where the punches have to go
ERPNext is Frappe's open-source ERP, and Frappe HR its HR and payroll app. Both turn Employee Checkins into attendance through shift types and auto attendance. A common way to collect checkins is Frappe's open-source sync tool, which pulls punches from machines on the local network; it needs a computer on site that stays on and can reach every machine.
An integration removes the file in the middle: every punch travels from the terminal to the Cams cloud and on to ERPNext by itself, from every site, whatever the terminal brand.
What reaches ERPNext
Punch by punch
Each punch becomes an Employee Checkin with its log type (IN or OUT) and time. ERPNext's shift types and auto attendance then mark attendance as usual.
- Employee (by the employee field you choose in ERPNext)
- Punch date and time
- Log type: IN or OUT
- The terminal's identifier
Setup
How to connect ERPNext
Connect the terminals to the Cams cloud
Cams terminals connect out of the box. For terminals you already own, check the model for free at developer.camsbiometrics.com: supported models connect directly over the internet, older ones as a Cams Open Terminal.
Line up the employee IDs
ERPNext matches each punch to an employee through the field you choose, normally the Attendance Device ID on the employee record. Set it to the user ID on the terminal.
Add ERPNext in the Cams console
Open Configurations, then Connectors, add ERPNext and enter what it asks for (list on the right). Choose which terminals send to it.
Punches flow
From then on every punch reaches ERPNext, usually within a minute. Failed deliveries are retried and listed in the console, so problems are visible instead of silent.
What you need
- Your ERPNext check-in address (the check-in API URL of your site)
- An API key and secret for a user allowed to create checkins
Good to know
- Works with Frappe HR on its own or alongside ERPNext: both use the same check-in API.
- Your site must be reachable over the internet for punches to arrive.
Hardware
Which attendance machines work with ERPNext
Every Cams terminal, and terminals from ZKTeco, eSSL, Hikvision, Suprema, Anviz and many of the 90+ other brands that connect to the Cams cloud. Fingerprint, face, palm and card punches all reach ERPNext in the same form, so you can mix technologies and brands across sites.
Choosing new terminals? Start with the types of attendance machine. Keeping the ones you have? See connecting existing machines to the cloud.
Set it up with Cams
The ERPNext integration is one of 70+ ready-made integrations on the Cams Biometric Gateway. The page on camsbiometrics.com lists every field, the licence that applies and the price.
FAQ
ERPNext attendance integration: questions
How is this different from Frappe's biometric sync tool?
The sync tool runs on a computer in your office and pulls punches from machines on the same network. Here the terminals send punches to the Cams cloud, which creates the checkins in ERPNext, so nothing has to keep running on site and terminals in other branches work the same way.
Does it work with Frappe HR without ERPNext?
Yes. Frappe HR uses the same Employee Checkin API, on its own or with ERPNext.
Does it work with a site on Frappe Cloud?
Yes, as long as the site is reachable from the internet, which Frappe Cloud sites are.
Can I keep my existing ZKTeco or eSSL machines?
In most cases, yes. Check the model for free at developer.camsbiometrics.com. Supported models connect straight to the Cams cloud; older or LAN-only models connect through the Hybrid Connector, a small program on a PC on site. Either way the ERPNext integration takes the punches from there. See keeping the machines you have.
What does it cost?
Each terminal needs a Cams API licence: a one-time activation plus a yearly fee, with no per-employee or per-punch charge. Some integrations are included with that licence and some are paid; the ERPNext page on camsbiometrics.com shows which applies and the price.
Other software