NNeevHR
Migration guide

HRMS Data Migration: What Moves, and How

Published: 24 Sept 2026 · Updated: 24 Sep 2026 · Author: NeevHR team

Migration decides how quickly a new HRMS becomes trustworthy. This guide lists what data to bring across, what NeevHR imports, and the workflow that gets you from spreadsheets to a reconciled first payroll.

What data moves into NeevHR

Month-by-month historical payslips are not imported. Keep them in your previous system or an archive for reference.

DataHow it is handled
Employee masterCSV import with dry-run validation of every row
Organisation structureEntities, locations, departments, grades and cost centres as masters
Salary structurePay structures configured, then assigned to employees with effective dates
AttendanceAttendance history import where needed; live punches from devices after go-live
Leave balancesOpening balances imported per leave type
DocumentsEmployee documents uploaded against the record
Payroll historyYear-to-date opening balances (gross, TDS, PF, ESI) so the current year computes correctly
LoansOutstanding loan balances and remaining EMIs
Statutory informationPAN, UAN, ESI number and bank details, encrypted at field level
Pending arrearsArrears owed from before go-live imported for payment

The migration workflow

  1. 1

    Data assessment

    List every source (spreadsheets, old HRMS, payroll bureau) and decide what is needed in the new system.

  2. 2

    Mapping

    Map source fields to NeevHR fields and masters, and decide how to handle gaps.

  3. 3

    Validation

    Run each import as a dry run; every error is reported by row before anything is saved.

  4. 4

    Dry run

    Load a full data set into a test setup and compute a payroll month.

  5. 5

    Reconciliation

    Compare employee by employee against your current payroll and fix the causes of differences.

  6. 6

    Parallel payroll

    Run a live month in both systems and reconcile again.

  7. 7

    Go live

    Pay from NeevHR and retire the old process.

Practical tips

  • Fix duplicate employee IDs, missing joining dates and inconsistent department names before import.
  • Confirm each employee's work location, because PT and LWF depend on it.
  • Take year-to-date figures from the last closed payroll month.
  • Freeze master changes in the old system during the final import window.

Frequently asked questions

Can payroll history be migrated?

Year-to-date opening balances are migrated so the current financial year computes correctly. Month-by-month historical payslips are not imported.

What happens if the import file has errors?

The dry run reports errors by row without saving anything, so you fix the file and re-run until it is clean.

Related

Talk to us about your migration

A walkthrough on your own policies and data.

Book a Demo