Smart HR adds what a company in Saudi Arabia or Egypt needs on top of Frappe HR v16: a labour law profile per company with effective dates, an attendance engine that turns punches into deductions, overtime and penalties ready for payroll, employee requests approved on mobile through Smart Go, and social insurance, end of service, provisions, Saudization and ready letters. All inside ERPNext, with standard documents and no core changes.
A labour law profile per companyZK and BioTime devicesFingerprint approval on mobile
Labour Law ProfileAttendance PolicyAttendance ProcessingBiometric devicesLocations and spoof detectionEmployee requestsInsurance and taxEnd of service and provisionsDiscipline and custodyAdvances, incentives and daily wagesMedical insurance and expatsLetters and print formatsLabour Law ProfileAttendance PolicyAttendance ProcessingBiometric devicesLocations and spoof detectionEmployee requestsInsurance and taxEnd of service and provisionsDiscipline and custodyAdvances, incentives and daily wagesMedical insurance and expatsLetters and print formats
v16Built on Frappe HR and ERPNext v16
2Ready labour law profiles: Saudi Arabia and Egypt
8Self-service requests on one approval path
20Ready letters in Arabic and English
Before & after
A month in HR before and after Smart HR
The same monthly tasks, now with an engine that calculates, documents you can review and labour law kept in settings.
Frappe HR alone
Collecting punches
Exporting each device's log into Excel and matching employee numbers by hand.
Deductions and overtime
Spreadsheet formulas only one person understands, with errors found after payday.
Permissions and missions
Paper slips and chat approvals that never reach the attendance sums.
End of service and insurance
Manual sums on old rates, and forgotten document expiries.
vs
With Smart HR
All punches in one place
Automatic device pulls or a file import, without duplicates, matched by device ID.
One-click processing
The engine calculates each day by policy; a posting table is reviewed, then approved.
Requests on mobile
Employees ask in Smart Go, managers approve by fingerprint, and the request feeds the calculation.
Obligations calculated
Insurance, end of service and provisions from the labour law profile, with alerts before expiry.
Product video
Meet Smart HR
A quick motion tour of what the product does.
Feature tour
Key screens up close
Six screens the HR team works on every month, from setup to final settlement.
01Start here
One workspace for all of HR
Frappe HR and Smart HR screens in one workspace ordered by the employee journey, topped by a ten-step setup checklist that ticks itself as you go.
Setup checklist from the profile to the first month
Attendance, request and document indicators
Sidebar by the employee lifecycle
A next-step button on each document
Setup checklistMonth indicators
02Labour law
Every legal figure in its place
A labour law profile per company with tabs for insurance, leave, end of service and tax. Any amendment is a new row with its own effective date.
Employee and employer rates per category
Insurable wage floor and cap
Working hours and Ramadan hours
Maximum deduction from pay
Rule tabsDated rates
03The core
Calculate, review, post
Attendance Processing reads the period punches for everyone at once, calculates each day by policy, then shows a posting table of every document before approval.
Absence days, overtime hours and late minutes
Additional Salary per line
Deduct from leave balance when enough
Cancelling reverses everything
Month summaryPosting table
04End of service
The award, calculated by the law
The Saudi end-of-service award by service bands and the entitlement rate for each reason, added to the standard full and final statement.
Base wage from flagged components
Half a month then a month per year
Entitlement rate on resignation
A line on the Full and Final Statement
Service bandsAward due
05Discipline
Fair penalties that escalate
Employee Penalty works out the occurrence and amount, checks the monthly deduction cap from the labour law profile, then creates Additional Salary.
Warning, then quarter, half and full day
A reset period
Investigation first when required
Processing penalties pass the same checks
Escalation ladderMonthly cap
06Smart Go
Attendance and requests on mobile
Employees check in inside the geofence with location and photo, see today's shift and the month summary, and send a permission or mission straight to their manager.
Geofenced check-in with spoof checks
Today's shift and month summary
Eight self-service requests
Manager approval by fingerprint
Check-in buttonMonth summary
Setup checklistMonth indicators
Rule tabsDated rates
Month summaryPosting table
Service bandsAward due
Escalation ladderMonthly cap
Check-in buttonMonth summary
Every feature
Everything it adds on top of Frappe HR
From the first punch in the morning to the final settlement, every step is a standard ERPNext document that payroll, accounting and reports can read.
Labour Law Profile
Every legal figure lives in settings, not code: rates, limits and periods with effective dates, one profile per company.
Ready Saudi and Egyptian profiles as a starting point
Insurance rates for nationals and expats with wage floor and cap
Notice periods, deduction and penalty limits
A new row for each amendment keeps past periods correct
Attendance Policy
All attendance rules on one tabbed screen per employee group: office, factory or sites.
Grace minutes and late bands with factors
Automatic or request-only overtime with daily and monthly caps
Absence and missed punch with escalating penalties
Shift and mission allowances
Attendance Processing
Calculate the month, review the results, then approve and post to payroll, leave and penalties in one click.
Daily metrics: late, early exit, overtime, absence
A posting table listing every document created
Deduct from salary or from leave balance
Cancelling reverses everything it created
Biometric devices
Four punch sources on one screen, and every punch is stored once so nothing is duplicated.
Direct pull from ZK devices
BioTime integration
Push API with an integration user key
Excel or CSV import from any device
Locations and spoof detection
Several geofences per branch or project, with fake-location detection on mobile.
Branch locations or a work location per employee and period
Optional location tracking during the shift
Flag for review or reject spoofed check-ins
Suspicious locations and compliance reports
Employee requests
Eight requests on one approval path, shown automatically in Smart Go for employees and managers.
Permission, mission, overtime and leave return
Air ticket, salary advance, letter and separation
Fingerprint approval on mobile
Day and count limits stop late requests
Insurance and tax
An insurable wage built from flagged components, and clear formulas in the salary structure instead of payslip overrides.
GOSI in Saudi Arabia and social insurance in Egypt
Egyptian payroll tax brackets on Income Tax Slab
Periodic increment run
Minimum wage warning
End of service and provisions
From resignation to final settlement, plus the company's monthly obligations to its people.
Saudi end-of-service award by termination reason
Separation request with notice and payment in lieu
Monthly provisions for EOS, leave and tickets
Clearance and full and final settlement created for you
Discipline and custody
One penalty schedule with automatic escalation, investigation before penalty, and custody recovered on exit.
Escalation by occurrence and reset period
Monthly deduction cap from the labour law profile
Custody issued with a stock entry
Clearance items per department
Advances, incentives and daily wages
Everything added to or deducted from pay outside the fixed structure, as reviewable documents.
Salary advances within the deduction cap, in instalments
Incentives on sales, collections or production
Daily wage sheets per worker and project
Performance bonus on appraisal approval
Medical insurance and expats
Costs the company carries for employees and dependants, with document alerts before expiry.
Medical policies with classes and bulk enrolment
Expat costs posted and recovered
Iqama, passport and contract expiry alerts
Probation end dates
Letters and print formats
Twenty ready letters in Arabic and English, and an Operion-style print format for every document.
Salary certificate, resignation acceptance, clearance and more
Hijri and Gregorian dates
Created in one click when a request is approved
Reports export to Excel and print in Operion style
For every role in your company
For every role the screen it needs
Mobile first for employees and managers; the desk for HR and finance.
Employee
Attendance, requests and balances in the pocket
Check-in with location and photo in Smart Go
Permission, mission, advance and letter requests
Monthly attendance summary and payslips
Line manager
Approves the team's requests anywhere
An approvals inbox on mobile
Fingerprint approval
Sees only what is shared with them
HR
A clear monthly cycle from processing to bank
A ten-step setup checklist
Attendance processing, penalties and letters
Document, Saudization and insurance reports
Finance and payroll
Figures ready for payroll and the books
Additional Salary ready for the payslip
A monthly provision entry by cost centre
Bank file and wage protection file
How it works
From punch to payslip
Every process starts with an event, a punch, a request or month end, and ends in a standard document with an effect on payroll or the books.
01Punch
From a ZK or BioTime device or an Excel file, or from Smart Go with location, photo and spoof checks.
02Request & approval
Permissions, missions and pre-approved overtime are approved by fingerprint and feed the calculation.
03Processing
The engine calculates each day by the employee's policy: late, overtime, absence, missed punch, allowances.
04Review
HR reviews the results and the posting table before approving.
05Posting
Additional Salary, leave entries and employee penalties are created and reversed on cancel.
06Payroll
The standard payslip, payroll entry, bank file and wage protection file.
Product screenshots
A tour of Smart HR
Screens drawn in the Operion theme after the real app UI on ERPNext 16, with demo data.
Smart HR workspaceA ten-step setup checklist and HR indicators in one place.
Labor Law ProfileInsurance rates for nationals and expats with effective dates, plus deduction and notice limits.
Attendance PolicyGrace minutes, late bands with factors and penalty types on one tab.
Attendance ProcessingCalculate the month, review metrics and the posting table, then approve.
Biometric devicesZK, BioTime, Push and file import with each device status and last sync.
End of Service CalculationThe Saudi award by service band and entitlement rate for the reason.
Employee PenaltyOccurrence, amount and remaining monthly cap are calculated for you.
Saudization ratio reportWeighted Saudization per company and branch, with the insurance register.
HR Letter RequestA salary certificate with Hijri and Gregorian dates in Operion style.
Check-in in Smart GoCheck-in inside the geofence with the month summary.
Approvals on mobileThe manager's approvals inbox with permission and mission requests.
Comparison
The difference in daily detail
Frappe HR aloneWith Smart HR
Labour law rulesSet by hand or outsideA profile per company with effective dates
Lateness and overtimeManual sums, then data entryAn engine that calculates and posts
Biometric devicesLimited integrationZK, BioTime, Push and file import
Permissions and missionsNot available as requestsEight requests approved on mobile
End of service and provisionsCalculated outsideStatutory calculation and monthly provisions
LettersTemplates typed by handTwenty letters, Hijri and Gregorian
The challenge
HR still lives outside the system
Frappe HR covers the essentials well, but local labour law and the daily attendance maths usually stay in spreadsheets on one person's desk.
Deductions and overtime in Excel
Punches are exported, lateness and overtime are worked out by hand every month, then keyed into payroll line by line.
Labour law is not in the system
Insurance rates, leave rules, end-of-service and deduction limits live in memory or separate files, and change with every amendment.
A Saudi company with an Egyptian branch
Groups working in both countries end up with separate tools or manual sums for each country.
Paper requests, late approvals
Permissions, missions and pre-approved overtime are asked for on paper or in chats, with no effect on attendance or pay.
Scattered attendance apps
One app for devices, another for location, a third for attendance, on different versions, with clashing data and security gaps.
Statutory duties without follow-up
Expiring iqamas and contracts, the wage protection file, Saudization and end-of-service provisions are noticed too late.
Components
Six components in one app
Smart HR merges four older attendance, device and location apps into one clean app, and adds labour-law obligations on top.
Core
Smart HR Settings, Labor Law Profile, official document types and dependants.
Attendance
Attendance Policy and Processing, seasonal shifts, crew rotation and on-call duty.
Requests
Permission, overtime, mission, leave return, air ticket, advance, letter and separation.
Devices & location
Biometric devices, punch import, BioTime, work location assignment and location pings.
Compliance
End of service, provisions, increments, medical insurance, expat costs and bank file formats.
Discipline
Penalty types, investigations, employee penalties, custody and clearance items.
Who it is for
Built for companies with big teams
Groups in Saudi Arabia and Egypt
A Saudi company and its Egyptian branch or sister company on one system, each with its own rules.
Factories
Fixed and rotating shifts, several devices, night overtime and production incentives.
Contracting and projects
Many work sites, daily labour and labour cost by project.
Distribution and field sales
Mobile check-in by location, missions and incentives on sales and collections.
Retail and branches
An attendance policy per branch and seasonal shifts for Ramadan and summer.
HR and payroll teams
A ten-step setup checklist and a clear monthly cycle from processing to bank file.
Integration & tech
Built inside ERPNext and Frappe HR
A standard Frappe app on Frappe HR v16. No parallel database, no sync.
Requires ERPNext and Frappe HR v16; runs on Frappe Cloud or self-hosted
No override of ERPNext or HRMS classes: document events and custom fields only, so upgrades stay safe
Everything it produces is standard: Employee Checkin, Attendance, Additional Salary, Leave Ledger Entry, Journal Entry
Works with Smart Go with no setup: requests appear on mobile and are approved by fingerprint
Mobile endpoints take the employee from the user session; device passwords are encrypted
Matches the Operion Theme in Arabic, English and dark mode, with Hijri dates
A standalone, unit-tested calculation engine and standard Frappe roles for employee, approver and HR
FAQ
Make labour law part of your system
Talk to the Operion team for a Smart HR demo on your data and a rollout plan for your branches in Saudi Arabia and Egypt.
No, it builds on it. Leave, payroll, appraisal and recruitment stay in Frappe HR; Smart HR adds labour-law rules, attendance, requests and statutory obligations on top.
Can it run Saudi and Egyptian companies together?
Yes. Each ERPNext company links to a labour law profile and employees follow their company, so a Saudi company and its Egyptian branch run on the same system with their own rules.
Are the legal rates hard-coded?
No. Every legal figure sits in the labour law profile with an effective date. The starting values come from published regulations and should be reviewed by the company's legal and payroll advisers before go-live.
Which biometric devices are supported?
ZK devices by direct pull, BioTime, Push API, and any other device through an Excel or CSV export, with no duplicate punches.
Do employees need a mobile app?
Smart HR works with Smart Go: check-in with location and photo, requests, balances and payslips, and fingerprint approvals for managers, with no extra setup.
How does attendance reach payroll?
Attendance Processing calculates the month and creates Additional Salary, leave entries and employee penalties that appear on the standard payslip, without changing the payslip.
Does it calculate the Saudi end-of-service award?
Yes, by service bands and entitlement rates per termination reason from the labour law profile, and adds it to the full and final statement or as Additional Salary.
What about Egypt?
Social insurance on an insurable wage between the floor and cap, payroll tax brackets, periodic increments, a minimum wage warning and leave rules under Labour Law No. 14 of 2025.
Does it cover the wage protection file and Saudization?
Yes: a Mudad file report from the payroll run, a Saudization ratio per company and branch, and the social insurance register and movements. Direct links with government platforms are on the roadmap.
Will Frappe HR upgrades break it?
Smart HR does not override any core class; it uses document events and custom fields only, so upgrades stay safe.