Migrate your Paychex data

Workers is the primary employee object in Paychex Flex containing name, address, employment status, and employment dates. We extract Workers via the standard API endpoint and map each record to the destination system's Employee object with all standard properties intact.

Paychex stores pay rates, pay frequency, and salary histories under Compensation. Rate types vary between hourly, salaried, and commission-based workers. We extract the compensation record and map pay frequency to the destination system's equivalent enum values, flagging commission-based compensation for manual review.

Health insurance, dental, vision, and voluntary benefits are tracked as enrollment records with effective dates. Paychex structures these by benefit type and carrier. We extract active enrollments and map them to the destination system's benefit plan equivalents, preserving coverage effective dates and dependent information.

Paid time off balances, accrual rates, and usage history are stored per worker. Paychex supports custom accrual policies that vary by employee type. We extract current balances and policy settings, then map to the destination system's time-off object, flagging non-standard accrual rates for manual reconciliation.

Federal and state W-4 equivalents, state tax ID mappings, and locality withholding codes are stored per Worker. We extract all tax elections and map them to the destination system's tax configuration objects, preserving year-specific election versions.

Historical payroll runs containing gross pay, deductions, net pay, and employer tax contributions are extractable per pay period. We sequence historical registers chronologically and chunk them by pay period to avoid API pagination limits, mapping each line item to the destination system's payroll journal entries.

401(k) enrollment status, contribution percentages, employer match configurations, and historical contribution totals are stored per Worker. Paychex partners with specific custodians. We extract enrollment records and map to the destination system's retirement plan object, noting that termination fees may apply when Paychex exits the recordkeeper relationship.

WC class codes, rate configurations, and coverage policies are stored at the company level and linked to Workers. We extract the policy details and worker assignments, mapping class codes to the destination system's WC configuration objects.

Custom Fields are created at the company level in Paychex and assigned to Workers. The API exposes custom field definitions and their values per worker. We extract all custom field definitions first, then pull values per worker, mapping them to the destination system's equivalent custom property mechanism.

Company departments and org hierarchy are accessible via the Paychex API and map cleanly to the destination system's organizational unit objects. We extract the full department list and parent-child relationships and reconstruct the org tree in the destination system.

Hours worked, overtime, and time-off requests are stored per Worker per pay period. Paychex Flex integrates time tracking with payroll. We extract the hours data and map it to the destination system's time entry objects, preserving pay-period associations.