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.