How can we help you?

Integrating with iPayroll - FAQ

Follow

iPayroll

iPayroll is a proven cloud-based payroll solution developed in New Zealand, for New Zealand businesses of all sizes.

This article lists a number of frequently asked questions that have when setting up the integration between enableHR/HRA and iPayroll.

 

How does it work?


The integration allows enableHR/HRA clients in New Zealand to sync their employee data between enableHR and iPayroll through integration Hub (iHUB). Our integration will sync employee’s personal, employment, payroll, bank, Kiwisaver and tax data from enableHR/HRA to iPayroll.

The below are the pre-requisites to enable integration between both the systems.

  • Setup account in enableHR
  • Setup account in iPayroll
  • Client have to sign the "Use of enableHR API and Other Integration Services" authorisation form to allow iPayroll to access the unmasked IRD details. Please reach to  api@enablehr.com for further details.

How can I setup the integration?

Integration can be setup through Integration Hub (iHUB - https://ihub.enablehr.com/) portal by account admins itself. 

EnableHR's Client Services team can help you setup the initial iHUB access, after that account admins can manage the integration by themselves to setup the connection, run/schedule job and to view the details of the data synced from enableHR/HRA to iPayroll. To learn more about iHUB refer this article.


I have an issue and an employee record is not syncing, who do I contact?

You can view the integration details and any data synchronisation issues under the 'Reports' section in iHUB.

If you are unable to resolve the issue, your first point of contact for assistance is the enableHR's Client Services Team. We recommend reaching out to them at support@enablehr.com


Is it a 2-way integration?

Its a one-way integration that sends data from enableHR/ HRA to iPayroll. See the notes below for the mapped fields and limitations

 

Is there a fee to use the integration?

The enableHR Client Services Team will advise you on any costs based on your subscription. 


Is it automated?

Once the integration is setup and the connector job is scheduled the integration happens automatically at set intervals. If there is a need to sync the data outside of scheduled run, you can run the integration job manually to immediately sync the data between both the systems. 

 

Is there anything this integration cannot support?

  • Employee’s with only one bank account in enableHR/HRA can be synced with iPayroll

  • Terminations (Finish Date and Termination Reason in iPayroll) are not added/updated through this connector.

  • Special Earner Levy is not captured in enableHR, so this information can’t be syced with iPayroll.

  • Exempting Kiwisaver for Casuals can’t be easily identified in enableHR.

  • Age range for Kiwisaver is not captured in enableHR , so this information is not synced with iPayroll.

Field Mapping:

* Mandatory fields necessary to create an employee in iPayroll

enableHR Field

iPayroll Field

Notes

First Name* First Names (S)  
Last Name* Sur Name  
Preferred Name Preferred Name  
Date of Birth* Date of Birth  
Email Email Address

1st preference Work email address

2nd preference Personal email (when work email doesn’t exist)

Hours Per Week* F.T Hrs/Week  
Gender* Gender

EnableHR → iPayroll

Male → Male

Female → Female

Non Binary → Intersex/Indeterminate

Not Stated → Not Stated

Pay Schedule* Pay Frequency

EnableHR → iPayroll

Weekly → W

Fortnightly → F

Monthly → M

Twice_Monthly → B

Mobile Phone Phone Number  
Commencement Date* Start Date  
Branch* State Employee’s Home Branch’s setup → Contact → State is used 
Position Title Job Title  
Account Number* Bank Account

xx-xxxx-xxxxxxx-xxx

BSB (6 digits)

Account No. (7 digits)

Suffix (3 digits)

dashes should be included

IRD Number* IRD Number  
Tax Code Tax Code

enableHR → iPayroll

CAE → CAE

M → M

M SL → M_SL

ME → ME

ME SL → ME_SL

ND → ND

NSW → NSW

S → S

S SL → S_SL

SA → SA

SA SL → SA_SL

SB → SB

SB SL → SB_SL

SH → SH

SH SL → SH_SL

ST → ST

ST SL → ST_SL

STC → STC

WT → WT

When No tax code details exists in enableHR use ‘None’ in iPayroll

Student Loan % Special Student Loan  
KiwiSaver Status KiwiSaver Status

enableHR → iPayroll

Active → Pre-existing member ( kiwiSaverRate, employerSubsidy, esctRate are Mandatory)

Opt-Out → Opted Out (kiwiSaverOptOutDate, addressLine1, city and postCode are mandatory)

Savings Suspension → Saving Suspension IRD Approved with Employer Contribution (kiwisaverHolidayEndDate and employerSubsidy is mandatory)

Not a Member → Not Eligible (kiwiSaverRate & employerSubsidy must be 0.00)

Employee Contribution % KiwiSaver Employee Rate  
Employer Contribution % Employer Subsidy  
Employer Contribution Tax (ESCT%) ESCT Rate

Valid options:

10.5%

17.5%

30.0%

33.0%

Opt Out Date Opt Out Date

Status = Opt-out and Opt Out Date from enableHR.

Mandatory if kiwiSaverStatus is Opted Out Address Line 1, City and Post Code are mandatory if an Opt Out Date exists

Suspension End Date Suspension End Date

KiwiSaver Status = Savings Suspension and Suspension End date from enableHR.

Mandatory Date on which the KiwiSaver savings suspension will end

Street Address Address Line 1 Personal address from enableHR is first preference, if not exists use the mailing/postal address.
Street Address Address Line 2  
suburb suburb  
State State  
Post Code Post Code  
     

* = Required Fields

Have more questions? Submit a request

Comments