Biometric Integration

ZKTeco Biometric Integration: Real-Time Attendance into Peoplifi

ZKTeco devices are deployed in warehouses, factories, retail chains, and offices around the world. Peoplifi offers the most complete ZKTeco integration in the market: real-time ADMS push, support for fingerprint and face devices, multi-device consolidation across locations, and zero manual CSV imports. Whether you run a single K40 at a warehouse or 40 SpeedFace devices across factory gates, Peoplifi pulls attendance into payroll the moment an employee punches in.

Try Peoplifi Free for 7 Days

How it works

  1. Your ZKTeco device connects over LAN or Wi-Fi to the Peoplifi cloud endpoint using the standard ADMS protocol (port 8081)
  2. Every time an employee scans, the device pushes a punch record to Peoplifi in under 2 seconds
  3. Peoplifi matches the employee PIN (or fingerprint ID) to the Peoplifi employee record
  4. Attendance, late marks, and overtime are calculated in real time against each employee's assigned shift pattern
  5. At payroll time, attendance flows directly into wage calculations — no manual export or import step

Features

✓Supports ZKTeco fingerprint (F18, K40, K50, UA100) and face (SpeedFace V4L, V5L, M4, MB360) devices
✓Real-time ADMS push — no scheduled polling or CSV imports
✓Multi-device consolidation: one employee can punch at multiple devices across locations
✓Offline fallback: if the device loses internet, punches are stored locally and synced when reconnected
✓Per-device assignment to a location, shift, or cost centre
✓Automatic employee enrolment: push new employees from Peoplifi to the device on hire
✓Buddy-punch detection with optional photo capture on face-recognition devices
✓Compatible with the FLSA-aligned overtime rules in Peoplifi (40-hour weekly threshold, daily OT for CA/NV/AK)

Setup Guide

  1. Go to Settings → Integrations → ZKTeco in Peoplifi and copy your unique ADMS endpoint URL + key
  2. On the ZKTeco device, navigate to Comm. → Cloud Server Setting
  3. Set the server address to the URL provided and the port to 8081
  4. Enable the Cloud Server Setting and reboot the device
  5. The device will connect within 30 seconds — you will see it appear in Peoplifi under Settings → Devices
  6. Map existing device PINs to Peoplifi employees (bulk mapping is available via CSV)
  7. Do a test punch — you should see the attendance record appear within 2 seconds

Frequently Asked Questions

Which ZKTeco models are supported?

All modern ZKTeco devices that support ADMS (Automatic Data Master Server) push. This includes the F18, K40, K50, UA100 fingerprint series, and the SpeedFace V4L, V5L, M4, MB360 face series. Older devices without ADMS can still use CSV import.

Do I need a static IP or open inbound ports?

No. Your ZKTeco device connects outbound to the Peoplifi cloud endpoint — no inbound connections or static IP required. Any regular internet connection works.

What if my office loses internet during business hours?

The ZKTeco device stores punches locally for up to 1 million records. When connectivity returns, buffered punches sync to Peoplifi automatically with the original timestamps preserved.

Can one device serve multiple companies?

No. Each ZKTeco device is assigned to a single Peoplifi tenant for security. If you operate multiple companies, each gets its own ADMS endpoint.

How do I enrol a new employee on the device?

After creating the employee in Peoplifi, you can either (a) push their template to the device from the Devices tab, or (b) enrol their fingerprint or face at the device and map the PIN to their Peoplifi record.

Is biometric data stored in Peoplifi?

No. Biometric templates remain on the ZKTeco device. Peoplifi only stores hashed punch events, timestamps, device IDs, and user IDs. This is by design for privacy laws like Illinois BIPA and Texas CUBI.

Ready to connect ZKTeco to Peoplifi?

Start free 7-day trial