Who is ePayroll?

Ready Pay powered by ePayroll is an integrated online payroll solution designed for Australian businesses of all sizes. Since 2002, it has provided a smart, dynamic, and easy-to-set-up system that ensures compliance with Single Touch Payroll and the latest ATO regulations. It helps businesses optimise operations by reducing errors and boosting accuracy. Key features include a mobile-friendly interface, employee self-service, time and attendance tracking, on-demand reporting, leave management, and an innovative pay-as-you-go pricing model​ (ReadyTech Workforce)​. For more information, please visit ⭧ePayroll's official website.

What this article covers

This document outlines the functions and options available by integrating Humanforce Workforce Management (WFM) and ePayroll in the Humanforce Cloud. It is crucial to set up the integrations correctly to prevent data issues. If you require assistance or are unsure about setting up the integration, please reach out for help before starting to avoid additional fees for support packages.

What does the integration do?

The integration between Humanforce WFM and ePayroll facilitates the transfer of crucial employee data, ensuring accuracy and efficiency in workforce management.

Here's what the integration accomplishes:

• Employee Personal Details:

  • Humanforce WFM to ePayroll

    • New employee profiles and updates to existing profiles in Humanforce WFM will be sent to ePayroll.

Prerequisites

Before proceeding with the integration, ensure the following prerequisites are met:

• Humanforce Cloud Customer: This integration is exclusive to Humanforce Cloud customers.
• API Credentials: Obtain API credentials from ePayroll with comprehensive permissions to facilitate data exchange between the platforms.
• Source of Truth: Humanforce WFM serves as the primary repository for employee data.
• Change Approvals: The "Changes Require Approval" permission must be enabled for changes to flow via the Change Approvals page into ePayroll.

Integration Setup

API Documentation

Humanforce WFM uses its REST API to push and pull data between the systems. More information on the Humanforce REST API is available in this article ⭧Humanforce REST API Overview.

Integration Workflow

Follow these steps to set up the integration between Humanforce WFM and ePayroll:

1. Prepare your data:

• In WFM: Create access levels, clock-in settings, qualification types, visa types, employment types, locations, departments, roles, award profiles, and areas if required.
• In Both Systems: Create public holidays, pay rates, pay types, and leave types. Match gender, title, and pay company in both WFM and ePayroll.

2. Set up integration:

• Complete payroll company setup in WFM > Admin > Payroll companies.
• Obtain API credentials for ePayroll.
• Set up the integration in WFM > Integration Central.
• Test the connection and resolve any errors.

3. Configure mapping:

• Enable relevant employee upload options for accurate data transfer.
• Configure additional detail mappings.

4. Review and Troubleshoot:

• Monitor the import log and address any errors for a successful data transfer.

Supported Data Mapping

Employee Details

The table below outlines the field mapping between Humanforce WFM and ePayroll.

Default Values for New Profiles

When a new profile is created in Humanforce WFM and sent to ePayroll for the first time, the following fields will be populated in ePayroll based on the default values shown:

• PayLocationId - Per selected default in setup
• Roles - "EmployeeSelfServiceUser"
• Initial Accruals - Not Set
• costCentre - Per selected default in setup
• Taxation Details
  • FamilyTaxBenefit - false;
  • TfnReason - "NoReason"
  • ThresholdClaimed - true
  • AustralianForTax - true
  • SuperAuthorised - true
  • MedicareExemption - true
  • FcrlExempted - true
  • Help - true
  • Sfss - true
  • Cdep - true
  • InvalidRelative - true
  • DependentParent - true
  • DependentSpouse - true
  • SoleParent - true
  • ZoneA - true
  • ZoneB - true
  • paygVariation - Variation - false
  • Salary - 0
• Payment Details
  • superFund - Per selected default in setup
  • superFund - MembershipNumber - "0"
  • payCode - Per selected default in setup
  • payCode - DefaultValue - 0
  • InputSheetViewId - Per selected default in setup
  • PaymentGroupId - Per selected default in setup