Skip to main content

Import employees into WageEasy

Updated over 3 weeks ago

To import employee information into WageEasy, you need to create a CSV (Comma Separated Values) format import file. This can be done by extracting information from your existing payroll system in CSV format, or if you are unable to extract straight into a CSV file, extract as an Excel spreadsheet and then convert the spreadsheet to a CSV format.

You will need to create a report from your existing payroll system with as much employee information as possible, eliminating the need for manual entries. The effectiveness of this procedure will rely on the information and what format this information can be extracted from your old payroll system.

Optionally, the first line of the file may be a comma-separated list of field names in the same order as the employee records.

The following table (Employee Importing Specification) details the data items that can be included in the import file. Data items can appear in any order in the import file. The first line of the file may be a comma-separated list of field names in the same order as the employee records.

Item

Type/Length

Comments

Employee number

String(20)

AlphaNumeric

*Last Name

String(20)

AlphaNumeric

*First Name

String(20)

AlphaNumeric

Second Name

String(20)

AlphaNumeric

Date of Birth

Date

DD/MM/YYYY

Gender

String(1)

M or F

Address Line 1

String(120)

AlphaNumeric

Address Line 2

String(120)

AlphaNumeric

City

String(40)

AlphaNumeric

State

String(3)

AlphaNumeric

Postcode

String(5)

Numeric

Country

String(40)

AlphaNumeric

Telephone

String(18)

Numeric

Email Address

String(50)

AlphaNumeric

Employee Department

String(40)

AlphaNumeric

Employment Date

Date

DD/MM/YYYY

Termination Date

Date

DD/MM/YYYY

Pay Rate

String(255)

AlphaNumeric

Employee Award

String(255)

AlphaNumeric

Employment Category

Integer

0 = Full Time
1 = Part Time
2 = Casual

Pay Period

String

AlphaNumeric

Salaried

Boolean

Y or N

**FYTD Gross

Decimal

Numeric in format 999.99 (to 2 decimals)

**FYTD Tax

Decimal

Numeric in format 999.99 (to 2 decimals)

**FYTD Before Tax Allowance

Decimal

Numeric in format 999.99 (to 2 decimals)

**FYTD After Tax Allowance

Decimal

Numeric in format 999.99 (to 2 decimals)

Pay Method

Integer

0 = Cash
1 = Cheque
2 = Bank
3 = Non-bank

Bank Name

Bank Account Name

String(30)

AlphaNumeric

Bank Account BSB

String(10)

Numeric

Bank Account Number

String(20)

AlphaNumeric

Bank Amount

Decimal

Numeric in format 999.99 (to 2 decimals)

Tax Scale

String

AlphaNumeric

Tax File Number

String(11)

Numeric

Super Fund Name

String

AlphaNumeric

Super Number

String(40)

AlphaNumeric

Super Contribution Type

String(3)

SGL = Super Guarantee
SS = Salary Sacrifice
ER = Employer Additional
EE = Employee Contribution

Super Amount

Decimal

Numeric in format 999.99 (to 2 decimals)
Per Pay Amount

Super % Amount

Boolean

Y or N

Super Include as RESC

Boolean

Y or N

**Super YTD

Decimal

Numeric in format 999.99 (to 2 decimals)

Leave Carry Forward Date

Date

DD/MM/YYYY

Personal Leave Balance

Decimal

Numeric in format 999.99 (to 2 decimals)

Annual Leave Balance

Decimal

Numeric in format 999.99 (to 2 decimals)

Leave Loading

Decimal

Numeric in format 999.99 (to 2 decimals)

Sick Leave Balance

Decimal

Numeric in format 999.99 (to 2 decimals)

Long Service Leave Balance

Decimal

Numeric in format 999.99 (to 2 decimals)

Accrued Days Off Balance

Decimal

Numeric in format 999.99 (to 2 decimals)

Compassionate Leave Balance

Decimal

Numeric in format 999.99 (to 2 decimals)

Time In Lieu

Decimal

Numeric in format 999.99 (to 2 decimals)

Family Leave Balance

Decimal

Numeric in format 999.99 (to 2 decimals)

Study Leave Balance

Decimal

Numeric in format 999.99 (to 2 decimals)

Other Leave Balance

Decimal

Numeric in format 999.99 (to 2 decimals)

*Mandatory Data Item

Each Row will contain one employee record. Each field (column) within the record is delimited from the next by a comma (,). Fields (apart from Integer, Decimal, and Date) and including the column names in the first line (if included) within each record will also be quoted with the double quote (").

**YTD values
When using STP, it is best practice to exclude YTD’s from the CSV file and not transfer them from your old payroll. YTD values have already been reported to the ATO through STP Pay Events and are on the employees’ myGov accounts. Bringing over YTDs from your old payroll will result in these values duplicating in the employees’ myGov.
Note: If you want to bring over YTD values from your old payroll, you will have to use the old payroll's STP to zero out all values for the current tax year before you import these amounts into WageEasy. Gross in WageEasy means taxable gross, i.e., the value that is reported in STP as Gross.

Example

“EmployeeNo”,“LastName”,“FirstName”,“DOB”,“StartDate”,“EmailAddress”,“PayMethod”, “YTDGross”
“1”,“Jones”,“Jason”,09/04/1972,21/05/1999,“[email protected]”,0,1994.34
“2”,“Williams”,“Susan”,18/11/1981,25/05/1999,,1,1832.61
“3”,“Martin”,“Duncan”,15/01/1966,07/08/2000,“[email protected]”,0,2107.97

CSV import file

Contents for the CSV

Get as much of the information (see table above) as possible. Entering the information in a CSV file/Excel Spreadsheet is much quicker than adding it manually into WageEasy. Once an Employee is imported into the database, any amendments must then be made through Employee Details, from Employee, Edit employee. It is not possible to import an Employee twice.

Leave balances

The leave balances must be brought forward on the actual date the report was extracted from the old payroll system. You must have reports that you can balance to in the old payroll system, ensure that the leave balances reports are up to the date you are doing the import. Leave balances are in decimal hours in the exporter. Make sure you bring in total leave balances. Leave balance means the total amount of leave the Employee is entitled to as at a certain date. i.e., entitled plus pro rata. You may need to add several values together, depending on how your system reports leave. Dates are very important as WageEasy calculates leave every day.

Banks

It is highly recommended that you have the banking details in your spreadsheet. Adding banking details manually can leave room for error. You should also import the employees’ bank account name details i.e. ,AB Smith. When you have extracted the CSV import file. Please check the following:

  • The totals for leave and YTDs (Gross, Tax, Net if importing these) to make sure they balance; add up the column, and cross reference to existing reports from the old payroll system.

  • Please check that the Date of Birth is in the correct date format dd/mm/yyyy; to check this, look for a month being greater than 12. You may need to create a custom format dd/mm/yyyy.

  • Check that Line 1 on the spreadsheet is the column headings. Make sure the field names on this report are one word or less than 8 characters to avoid it wrapping on the import-mapping screen. A column heading with two words may not work.

  • Add an additional line below the employee’s record to import secondary bank accounts and salary sacrifice. Salary Sacrifice values must be shown as negatives.

  • Check the Bank account BSB to check if the leading “0” has not been dropped i.e., 063-526 might display as 63-526.

  • Remember to rename the Tax Scale (tax tables), department names, and Awards according to WageEasy setup, the importer will pick up exact description matches.

  • Save the spreadsheet and do a backup!

Saving the spreadsheet as a CSV file:

This file needs to be saved as a CSV (comma separated values) file. Excel is not good at creating a ‘true’ CSV file. Scroll to the bottom of this article for instructions to convert an Excel file to a true CSV file.

Things to check:

Once the CSV file has been created, please take a copy of the CSV file and paste it into an alternate location. If you would like to view the contents of this copied CSV file, Opened with Word Pad. All text fields should have quotation marks around them. For example, “Joe” “Bloggs” “3 Short Street”. Date fields, etc, will have no quotations, but you will need to make sure that the date data is logical i.e.; day before month before year. If the last column on the CSV file has blank fields associated with it, the employee(s) will not import. If this is the case, cut a column (any column that is filled with data) and paste it in the last column.

Company details required in the Database:
WageEasy,Setup,

  • Banks, enter the Bank Name for each Bank, i.e., Commonwealth, ANZ, etc.

  • Superannuation Funds - add a record for each Super fund in use at your company.

  • Departments.

  • Awards (which awards employees are on, even if in name only).

  • Base Pay Rates (please see below for hints on entering salary pay rates).


Final items to check before importing:

  • Make sure that EmployeeImporter.exe is installed in the default WageEasy directory (C:\Program Files (x86)\Wage Easy Payroll\Utility) and the Import Wizard version is 5.02 (Build 7495).

  • If there are no bank details in the CSV import file, set all employees to Cash on import and then add bank details once imported. There is a user-defined query that lists the payment methods of the Employees and can be used after this Importation process.

    Employee Payment Options (Unzip the query into the Queries folder and run it from HR, UserDefined Queries).

  • When going through the importer, please make sure dates are in dd/mm/yyyy format.

  • Check if the financial year has been rolled over to the current financial year (if you are starting WageEasy at the beginning of a tax year) before extracting data.

Import process:
Once you have checked your file, you are ready to start. Warning – do not open your approved csv file. As advised before, the best option is to take a copy and then open the copy using either Wordpad or Notepad

  1. Make sure WageEasy is closed.

  2. From File Explorer, select Local Disk (C: ), Program Files (x86), Wage Easy Payroll, Utility, EmployeeImporter.exe.

  3. Next

  4. Locate the Wage Easy Database by clicking on the ellipsis button (box with three dots), navigate to the Wage Easy Database location, select the database file, Open to attach, Next.

  5. Locate your approved csv by clicking on the ellipsis button (box with three dots), navigate to the file’s location, select the file, Open to attach, Next, and then Next again on the Default Values screen.

  6. On the Data Column Mappings screen, the contents of the csv file are mapped to the corresponding fields to be populated in WageEasy. The Left Hand Side (LHS) references the CSV column headers, the Right Hand Side (RHS) are the WageEasy fields to populate. Click on LHS, then the corresponding RHS, and then click the Link button in the middle. If you have incorrectly linked two items, use the broken link to detach. Once all columns have been mapped (linked), tick the box First row of Import file contains column names (i.e., do not report). Next.

  7. On the Employee Record screen, tick the three boxes: Remember Pay Rate, Remember Award, Remember Bank. The Employee Import Wizard will take you through various screens for an employe,e and information can be edited/corrected on any screen. Continue clicking Next until all information has been imported for the employee. Once you have completed your first employee, click Next to select another employee. Only click FINISH once you have imported all employees.

Adding in additional information
You can also add:

1.Additional bank accounts. If any employees have their pay deposited into more than one bank account, that information can be added as additional lines below the employee record in the csv file. The details you will need are:

  • Bank account name

  • Bank account number

  • Bank account BSB

  • Amount paid into the secondary account

  • Once you have more than one account, please check that the correct bank account is set as the default.

2. Employee salary sacrifice can also be directly imported from the CSV import file by adding an additional line below the respective employee record with the information listed below. The value MUST be entered as a negative value in the import file:

  • YTD reportable super

  • Super Contribution Type

  • Super Amount PP(if available)

  • Super Per cent YN (if available)

  • RESC YN

3. Superannuation, Please enter in any;

  • Employee additional superannuation per pay amounts (Year-to-date figures are not importable as these are not reportable amounts).

  • Employer additional superannuation per pay amounts (These may be reportable amounts, if they are, ensure you have selected Y for RESC and the Super YTD value along with the per pay details).

Please note

  • More than one person can import information at the same time.

  • Don’t hit finish unless you want to exit the exporter!

  • If you do want to take a break, hit the ‘Finish’ button. You will need to link up the fields again. The employees who have been imported should be shaded out.

  • Note: You may encounter an error (Incomplete Payment information) due to the additional line added below the employee record to record the secondary bank account and salary sacrifice details. Manually enter the missing details to resolve the error.

  • Do lots of backups, not overriding the last!

When the import process is completed for all employees:

You would need to add, if applicable;

  1. Unions; Add unions to employee and the per period (i.e. fortnightly/weekly) amount.

  2. Add Allowances to the employee file. When you are adding to the employee file, please make sure that tool allowance and other award allowances show on the ATO payment summary.

  3. Terminate all the terminated employees – just put a termination date against their name. If any ETP payments have been made to them, you may need to adjust the lump sums on the ATO payment summaries.

  4. Additional tax contributions – if any employees pay extra tax.

  5. Additional HR information, as required. For instance, marital status and next of kin details.

Run reports

Once you have made sure that the WageEasy reports match with the previous payroll system, print them out, attach them to the previous system’s reports, and get the financial controller to sign them off. This is good to show that you have finished and for auditing purposes. You just need to keep in mind that WageEasy will begin accruing Leave daily for those Employees set on Awards that have Yearly Accruals. Therefore from the date referenced when bringing Leave balances across, WageEasy will automatically add the next date to begin accruing.

Remember, there could be a difference between the leave accruals in the old payroll system and WageEasy due to the calculation of leave accruals in the old system being in decimals and in hours and minutes in WageEasy.

Converting a file to a true CSV file:

The link Macro.xls contains an Excel spreadsheet with a Macro that will convert your Excel Spreadheet to a true CSV file. Once you have created your Excel spreadsheet containing your employee information that you want to import into WageEasy, and you have saved it in a secure location, open the Macro.xls from the link above, ensuring that the Enable Editing and Enable Macros are both active.

In your Excel spreadsheet, highlight all the columns containing information and then go to View, Macros, View Macros. Look for Macros in All Open Workbooks and find the Macro, Highlight, and Run. You are now required to enter a destination file with a complete path, i.e., c:\directory name (ensure that this directory name exists)\and then the file name with the extension .csv, i.e,. EmployeeImport.csv. Ensure that you give this file a new name, not re-using the name of your original Excel spreadsheet. The Macro will now create a true csv file for you, adding quotation marks where needed. Do not open this file.

The links below contain Excel spreadsheets, a sample file with data examples, and the second is an import template.

Import sample file with data examples

Wage Easy Employee Import template

Did this answer your question?