Zeyora Documentation

Zeyora HRM documentation

A practical guide to the HRM system, its employee workflows, payroll records, approvals and attendance integrations.

What the HRM system covers

Zeyora HRM is a dedicated employee management system, not just a small HR tab inside CRM. The scanned HRM application includes employee master records, attendance, timesheets, leave, annual leave policies, approvals, payroll, loans, training, performance, assets, travel, requests, tickets, announcements, documents, reports and mobile self-service.

The HRM workflow is built around a tenant/root account, user roles, employee records and configured company structure. Departments, designations, locations, office shifts, banks and roles should be configured first because they are reused by attendance, payroll, approvals and reports.

Employee records and organisation setup

The employee module manages the full employee profile. HR teams can maintain basic details, profile photo, contact details, emergency contacts, documents, immigration records, qualifications, work experience, bank accounts, contracts, salary records, leave allocation, annual leave details, shifts and work locations.

  • Company structure: company, department, designation, location, bank and role masters.
  • Employee directory: searchable employee list and employee profile detail pages.
  • Profile documents: employee documents, image documents, immigration files and contract records.
  • Movement records: promotion, transfer, resignation, termination, employee exit and warning records.
  • Hierarchy: reporting map used by approval workflows and manager-level review.

Attendance, timesheet and shifts

The timesheet area covers daily attendance, date-wise attendance, all-employee attendance views, attendance import, manual attendance updates, office shifts, holidays, leave calendar data and task time tracking. Attendance records can store clock-in and clock-out activity, location data, status labels and working hours.

  • Attendance views: daily attendance, date-wise attendance and all-employee date-wise reporting.
  • Attendance operations: import attendance, update attendance, add manual attendance and edit attendance records.
  • Shift setup: office shifts, default shift handling, holiday setup and leave calendar visibility.
  • Exceptions: missing checkout auto handling, attendance exceptions and utilization required hours.
  • Daily notes: employees can save notes against attendance days; HR can review those notes.
  • Time-change requests: mobile users can request clock-in or clock-out corrections for HR review.

Leave and annual leave

The HRM system has both general leave and annual leave workflows. Annual leave includes policy-based counting, balance management, employee requests, HR review, manager approvals, rejoin requests and cancellation handling.

  • Leave requests: employees can apply for leave with start/end dates, half-day/full-day options, reason and remarks.
  • Annual leave policies: policy setup supports working-day and calendar-day models such as 22 working days or 30 calendar days.
  • Balance management: HR can view employee annual leave balances and adjust balances where required.
  • Validation: balance checks prevent requests above allowed policy limits unless company settings allow flexibility.
  • Rejoin workflow: approved annual leave can move through rejoin approval or rejection actions.
  • Cancellation: approved leave can be cancelled through controlled actions where the workflow allows it.

Approvals and workflow rules

HRM includes multi-level approval setup for leave and employee requests. Workflow records define the item key, ordered approval steps and approver rules. Employee hierarchy mapping supports manager, plus-one and reporting partner style approval chains.

  • Approval flow setup: create, update and delete workflow definitions and ordered steps.
  • Annual leave approval: supports active workflow keys such as LEAVE_ANNUAL with fallback behavior for default leave flows.
  • Current-step control: only the current approver step should act on a pending request.
  • Skipped approvals: when one approver in the same step approves, remaining approvers in that step can be marked skipped.
  • Request approval inbox: HR approvers can review configured employee requests and act on them from a central screen.

Payroll, loans and end-of-service records

The payroll module manages salary templates, hourly wages, monthly pay, hourly pay, payslips, payment history, advance salary, loans, loan reports, payslip PDFs and bulk payslip generation. The HRM system also includes gratuity, leave salary, end-of-service, employee exit and liability-related records.

  • Salary setup: salary templates, employee salary assignment and hourly wage templates.
  • Payroll runs: generate monthly or hourly payslips and record payments.
  • Loans and advances: maintain employee loans, advance salary records and repayment reporting.
  • Payslip output: print, download, email and bulk-generate payslips.
  • Final settlement support: gratuity, leave salary, employee exit and end-of-service records support separation workflows.

Assets, requests and employee services

The scanned HRM application includes a detailed asset management controller. HR and admin teams can maintain assets, categories, vendors, locations, consumables, contracts, licenses, audits, warehouses, storage transfers, asset requests, operations, compliance, financials and document uploads.

  • Asset register: asset list, asset history, categories and attached asset documents.
  • Asset operations: assignment, return, maintenance-style operations and asset request approval.
  • Compliance and audit: compliance list, audit records, depreciation list and financial views.
  • Storage: warehouses, warehouse inventory, storage transfers, receiving and disposal actions.
  • Employee self-service: employee-facing asset views, requests, tickets, complaints, travel, business trips and announcements.

Recruitment, training and performance

HRM includes job posting, public job application, job candidates, job interviews, training types, trainers, employee training, performance indicators and performance appraisals. These records help HR teams manage hiring and employee development without keeping separate spreadsheets.

  • Recruitment: job posts, public jobs, applications, candidates and interviews.
  • Training: training types, trainers, employee training records and training status updates.
  • Performance: performance indicators and appraisal records.
  • Recognition and conduct: awards, complaints, warnings and announcements.

ZKTeco BioTime attendance sync

The HRM project includes a standalone ZKTeco BioTime sync package. It can run outside the HRM application, pull attendance transactions from BioTime and store them in staging tables before HRM imports them. This is useful when biometric devices or BioTime are hosted on a separate network.

  • Source API: BioTime transactions endpoint /iclock/api/transactions/.
  • Authentication: JWT token flow through /jwt-api-token-auth/.
  • Timezone: designed around Asia/Dubai / UTC+04:00 deployments.
  • Employee mapping: BioTime emp_code should match the Zeyora HRM employee code.
  • Run modes: daily sync, monthly backfill, cron execution and protected web-token execution.
  • Safety: staging rows use sync status values so HRM can import pending punches and mark them synced.
# Daily sync
php sync_daily.php --date=2026-07-14

# Monthly backfill
php sync_month.php --month=2026-07

# Typical cron, every 15 minutes
*/15 * * * * /usr/bin/php /path/to/zkteco_biotime_sync/sync_daily.php >/dev/null 2>&1