Migrate your ZenHR data

Employees is the central object in ZenHR, holding Personal, Professional, and Financial information sections. Custom fields can be defined per-tenant for employee profiles. We map all standard fields 1:1; custom fields are identified during scoping and mapped individually.

ZenHR supports custom fields for employee profiles, requests, and workflows. Field types and mandatory/optional flags vary by tenant. We discover all active custom fields during the pre-migration audit and map each to a corresponding destination field or property.

Documents are stored with expiry alerts and e-signature metadata. We transfer document records alongside their owning Employee, preserving upload date, document type, and expiry information. Binary files are downloaded and re-uploaded via API with original filenames intact.

Timeoff records include balance, request status, and transaction history. We sequence all Timeoff Transactions in date order to preserve accrual and deduction history. Pending requests are flagged during scoping — customers decide whether to migrate open requests or reset balances post-migration.

ZenHR generates Financial Transactions from payroll runs and off-cycle payments. Journal entries can be exported to external financial systems. We map payroll runs with line-item detail, but off-cycle entries and in-advance salary payments require special sequencing to avoid balance discrepancies in the destination system.

Employee loans are a distinct object with repayment schedules tied to payroll deductions. We migrate loan principal and remaining balance, then map the active repayment schedule. Historical loan records with fully paid status are migrated as closed records.

Overtime records are tied to specific employees and date ranges. ZenHR defines Overtime Types as configurable objects. We map overtime entries with their type classification, hours, and rate for accurate payroll reconstruction in the destination.

Branches, Organization Levels, and Positions are structural objects that reference each other. We map the full hierarchy to maintain the org chart in the destination, including any cross-branch assignments at the employee level.

Terminations trigger EOSB (End of Service Benefits) and gratuity calculations under MENA labor law. We migrate termination records with effective dates and associated settlement amounts. EOSB calculation logic is preserved as a field rather than re-computed, since local labor law varies by country.

ZenATS is a separate ATS module integrated with ZenHR. Candidates, Vacancies, Stages, and Interview records are migrated with pipeline stage history preserved. SMS and email communication logs are metadata-only — attachment bodies are not available via the standard API.

Users are distinct from Employees — a person can exist as an Employee without system login access. We map User records with their assigned Roles and Permissions separately from the Employee profile to preserve access control configuration.

Branch Employee Shifts and Attendance Details tie employees to shift schedules. We migrate shift assignments by branch and date range. Attendance raw data (clock-in/clock-out events) is voluminous — we scope this with the customer and migrate aggregated attendance summaries unless real-time attendance records are specifically required.

Business Trip records include travel policy, destinations, and associated cost information. We migrate trip records with itinerary details and expense metadata. Approval workflows are mapped as status fields rather than recreated in the destination.

HR Letters are generated from templates with e-signature history. We migrate letter templates and the generated letter records for each employee, preserving the e-signature audit trail as metadata.