Biotime

An integration of biotime ZKTeco 8.5 machine to ERPNext

Install Biotime

bench get-app https://github.com/aliraxa29/biotime

Tags

  • biometric
  • biometricmachine
  • biotime
  • erpnext
  • frappe-framework
  • hrms
  • integration
  • zkteco

Add the Frappe Gems badge to your README

Maintain Biotime? Paste this into your README:

[![Listed on Frappe Gems](https://frappegems.com/api/method/frappe_gems.seo.badge?app=aliraxa29%2Fbiotime)](https://frappegems.com/gems/apps/aliraxa29/biotime)

About Biotime

Biotime

MIT License Security Policy Code of Conduct Contributing

BioTime 8.5 attendance integration for ERPNext/HRMS. Sync devices, employees, and transactions, then create Employee Checkin records automatically.

Features

  • Two token types supported: JWT and General auth tokens
  • Full entity sync: devices, employees, departments, areas, positions
  • Transaction log sync with punch state to IN/OUT mapping
  • Automatic Employee Checkin creation in HRMS
  • Employee mapping using Employee.attendancedeviceid
  • Sync audit trail with detailed logs
  • Admin tools to test connection, run full sync, or sync single entities
  • Workspace with stats, shortcuts, and charts

DocTypes

  • BioTime Settings (single)
  • BioTime Device
  • BioTime Employee
  • BioTime Department
  • BioTime Area
  • BioTime Position
  • BioTime Transaction Log
  • BioTime Sync Log

Workspace Widgets

  • Number cards: devices, mapped employees, unmapped employees, today transactions
  • Charts: checkins this month, sync activity by status
  • Shortcuts and link cards for quick navigation

Installation

Install using Frappe Bench:

cd /path/to/your/bench
bench get-app https://github.com/yourorg/biotime.git
bench install-app biotime

Setup

  1. Go to BioTime Settings and enter server URL, username, and password.
  2. Click Test Connection to store the token.
  3. Configure auto sync interval and which entities to sync.
  4. Run Full Sync or Sync Transactions from the settings page.

Notes

  • Employee mapping defaults to Employee.attendance_device_id.
  • Sync jobs create BioTime Sync Log records with counts and errors.
  • Scheduled sync runs every 5 minutes and respects the interval in settings.

Contributing

We welcome contributions! Please see CONTRIBUTING.md and CODEOFCONDUCT.md.

This app uses pre-commit for code formatting and linting. To set up:

cd apps/biotime
pre-commit install

Pre-commit checks: - ruff - eslint - prettier - pyupgrade

Security

Please review our SECURITY.md for reporting vulnerabilities and supported versions.

Code of Conduct

All contributors and participants are expected to follow our Code of Conduct.

CI

This app uses GitHub Actions for CI: - Installs this app and runs unit tests on every push to main or develop. - Linters: Frappe Semgrep Rules, pip-audit.

License

This project is licensed under the MIT License.

Related HR & Payroll apps for Frappe & ERPNext

  • Hrms — Open Source HR and Payroll Software
  • Huf — Open-source, self-hosted multi-agent AI infrastructure for teams and apps with support for cloud and local models, tool integrations, workflows, and automation across business systems including Slack, ERPNext, Discord & Gmail.
  • Bookings — Hotel Management App for Erpnext
  • Employee Self Service — This is the backend component for Nesscale ESS - a mobile app that brings ERPNext to your phone. Employees can manage their HR tasks, sales activities, and projects right from their mobile devices.
  • Inventory Tools — A collection of features to streamline and enhance inventory management and manufacturing workflows in ERPNext.
  • Check Run — Payables utility for ERPNext
  • Next Ai — NextAI is an AI-powered app for Frappe and ERPNext, delivering seamless content generation, automation, and productivity enhancements.
  • Projectit — Open Source PWA mobile app to track the Employees out in the field. This mobile app is developed on Frappe Framework and it is integrated with the Project functionalities of ERPNext and integrated tightly with Frappe HR.