Employees


Overview

URL https://api.xero.com/payroll.xro/1.0/Employees
Methods Supported POST, GET
Description Allows you to retrieve, add and update payroll employees in a Xero organisation

Elements for Employees

The following elements are required to create a new employee
FirstName First name of employee (max length = 50)
LastName Last name of employee (max length = 50)
The following elements are optional when creating a new employee
StartDate If you aren’t sure of the exact start date for an employee, you can just enter the start of the current financial year
Title Title of the employee (max length = 10)
MiddleNames Middle name(s) of the employee (max length = 50)
Email The email address for the employee (max length = 100)
DateOfBirth Date of birth of the employee (YYYY-MM-DD)
Gender The employee’s gender (M or F)
HomeAddress Employee home address. See HomeAddress
Phone Employee phone number (max length = 50)
Mobile Employee mobile number (max length = 50)
TwitterUserName Employee’s twitter name, entered as @twittername (max length = 50)
IsAuthorisedToApproveLeave Boolean (true / false) – set this to true if the employee is authorised to approve other employees’ leave requests
IsAuthorisedToApproveTimesheets Booelan – set this to true if the employee is authorised to approve timesheets
Occupation Occupation of the employee (max length = 50)
Classification Employees under an award scheme will be covered by a modern award classification. If you record a classification, it will be included on your payslips (max length = 100)
OrdinaryEarningsRateID Xero unique identifier for earnings rate
PayrollCalendarID Xero unique identifier for payroll calendar for the employee
EmployeeGroupName The Employee Group allows you to report on payroll expenses and liabilities for each group of employees
BankAccounts See BankAccount
PayTemplate See PayTemplate
OpeningBalances See OpeningBalances
SuperMemberships See SuperMemberships
TerminationDate Employee Termination Date
Other elements
EmployeeID Xero unique identifier for an Employee
Status See Employee Status Types
UpdatedDateUTC Last modified timestamp

Elements for a HomeAddress

AddressLine1 Address line 1 for employee home address (max length = 100)
AddressLine2 Address line 2 for employee home address (max length = 100)
AddressLine3 Address line 3 for employee home address (max length = 100)
AddressLine4 Address line 4 for employee home address (max length = 100)
City Suburb for employee home address (max length = 50)
Region State abbreviation for employee home address
PostalCode PostCode for employee home address (max length = 4)
Country Country of HomeAddress

Elements for TaxDeclaration

The following are required to update a tax declaration
EmployeeID Xero employee identifier. e.g c56b19ef-75bf-45e8-98a4-e699a96609f7
EmploymentBasis See Employment Basis Types

The following are optional to add a tax declaration

TFNExemptionType See TFN Exemption Types
TaxFileNumber The tax file number e.g 123123123
AustralianResidentForTaxPurposes If the employee is Australian resident for tax purposes. e.g true or false
TaxFreeThresholdClaimed If tax free threshold claimed. e.g true or false
TaxOffsetEstimatedAmount If has tax offset estimated then the tax offset estimated amount. e.g 100
HasHELPDebt If employee has HECS or HELP dept. e.g true or false
HasSFSSDebt If employee has financial supplement dept. e.g true or false
UpwardVariationTaxWithholdingAmount If the employee has requested that additional tax be withheld each pay run. e.g 50
EligibleToReceiveLeaveLoading If the employee is eligible to receive an additional percentage on top of ordinary earnings when they take leave (typically 17.5%). e.g true or false
ApprovedWithholdingVariationPercentage If the employee has approved withholding variation. e.g (0 – 100)

Elements for a BankAccount

StatementText The text that will appear on your employee’s bank statement when they receive payment (max length = 18)
AccountName The name of the account (max length = 32)
BSB The BSB number of the account (length = 6)
AccountNumber The account number (max length = 9)
Remainder If this account is the Remaining bank account
Percentage Percentages of a pay run (for example, a 50/50 split)
Amount Fixed amounts (for example, if an employee wants to have $100 of their salary transferred to one account, and the remaining amount to another)

Elements for a PayTemplate

EarningsLines The earnings rate lines
DeductionLines The deduction type lines
SuperLines The superannuation fund lines
ReimbursementLines The reimbursement type lines
LeaveLines The leave type lines

The following are required to add a PayTemplate EarningsLine element

EarningsRateID Xero earnings rate identifier
CalculationType See Earnings Rate Calculation Type

The following elements are optional when adding a PayTemplate EarningsLine element

NumberOfUnitsPerWeek Hours per week for the EarningsLine. Applicable for ANNUALSALARY CalculationType
AnnualSalary Annual Salary of employee
RatePerUnit Rate per unit of the EarningsLine.
NormalNumberOfUnits Normal number of units for EarningsLine.

The following are required to add a PayTemplate DeductionLine element

DeductionTypeID Xero deduction type identifier
CalculationType See Deduction Type Calculation Type

The following elements are optional when adding a PayTemplate DeductionLine

Percentage The percentage of deduction line
Amount The deduction amount

The following are required to add a PayTemplate SuperLine

SuperMembershipID Xero superannuation fund membership identifier
ContributionType See Superannuation Contribution Type
CalculationType See Superannuation Calculation Type
ExpenseAccountCode  Account code for the Expense Account. i.e 478
LiabilityAccountCode  Account code for the Liability Account. i.e 826

The following elements are optional when adding a PayTemplate SuperLine

MinimumMonthlyEarnings Minimum monthly earnings. Applies for Percentage of Earnings calculation type only
Percentage The percentage of the SuperLine. Applies on Percentage of Earnings CalculationType.

The following are required to add a PayTemplate ReimbursementLine

ReimbursementTypeID Xero reimbursement type identifier

The following are optional when adding a PayTemplate ReimbursementLine

Description The description of the reimbursement type
Amount The amount of the reimbursement type

The following are required when adding a PayTemplate LeaveLine

LeaveTypeID Xero leave type identifier.
CalculationType See Leave Type Calculation Types

The following are optional when adding a PayTemplate LeaveLine

AnnualNumberOfUnits Hours of leave accrued each year
FullTimeNumberOfUnitsPerPeriod Normal ordinary earnings number of units for leave line.
NumberOfUnits Number of units for leave line.

Elements for OpeningBalances

OpeningBalanceDate Opening Balance Date.
Tax Opening Balance tax
EarningsLines The EarningsLines of the OpeningBalance.
DeductionLines The DeductionLines of the OpeningBalance.
SuperLines The SuperLines of the OpeningBalance.
ReimbursementLines The ReimbursementLines of the OpeningBalance.
LeaveLines The LeaveLines of the OpeningBalance.

The following are required to add an Opening Balance EarningsLine

EarningsRateID Xero earnings rate identifier
Amount Earnings rate amount

The following are required to add an Opening Balance DeductionLine

DeductionTypeID Xero deduction type identifier
Amount Deduction type amount

The following are required to add an Opening Balance SuperLine

SuperMembershipID Xero super membership ID
CalculationType Calculation type for Super line
Amount Super membership amount

The following are required to add an Opening Balance ReimbursementLine

ReimbursementTypeID Xero reimbursement type identifier
Amount Reimbursement type amount

The following are required to add an Opening Balance LeaveLine

LeaveTypeID Xero leave type identifier
NumberOfUnits Leave number of units

Elements for a SuperMembership

SuperFundID Xero identifier for super fund
EmployeeNumber The memberhsip number assigned to the employee by the super fund.

The following are required when updating a SuperMembership

SuperMembershipID Xero unique identifier for Super membership

GET Employees

By default using GET Employees will return a summarised list of active employees.

Example response for GET Employees

<Employees>
    <Employee>
      <EmployeeID>fb4ebd68-6568-41eb-96ab-628a0f54b4b8</EmployeeID>
      <FirstName>James</FirstName>
      <LastName>Lebron</LastName>
      <Status>ACTIVE</Status>
      <Email>JL@madeup.email.com</Email>
      <DateOfBirth>1978-08-13T00:00:00</DateOfBirth>
      <Gender>M</Gender>
      <Phone>0400-000-123</Phone>
      <Mobile> 408-230-9732</Mobile>
      <StartDate>2012-01-30T00:00:00</StartDate>
      <OrdinaryEarningsRateID>72e962d1-fcac-4083-8a71-742bb3e7ae14</OrdinaryEarningsRateID>
      <PayrollCalendarID>cb8e4706-2fdc-4170-aebd-0ffb855557f5</PayrollCalendarID>
      <UpdatedDateUTC>2013-04-01T23:02:36</UpdatedDateUTC>
    </Employee>
    <Employee>
      <EmployeeID>007ebe02-4696-4453-a37d-fcca764a35a2</EmployeeID>
      <FirstName>John</FirstName>
      <LastName>Smith</LastName>
      <Status>ACTIVE</Status>
      <UpdatedDateUTC>2013-04-01T23:27:35</UpdatedDateUTC>
    </Employee>
    <Employee>
      <EmployeeID>de8599f6-04da-429a-a0cd-74c0da042c2b</EmployeeID>
      <FirstName>Odette</FirstName>
      <LastName>Garrison</LastName>
      <Status>ACTIVE</Status>
      <Email>ogg@madeup.email.com</Email>
      <DateOfBirth>1975-05-18T00:00:00</DateOfBirth>
      <Gender>F</Gender>
      <Phone>9000 1234</Phone>
      <StartDate>2012-04-04T00:00:00</StartDate>
      <OrdinaryEarningsRateID>72e962d1-fcac-4083-8a71-742bb3e7ae14</OrdinaryEarningsRateID>
      <PayrollCalendarID>97e0784f-6c3e-4371-a177-f93fbada3c58</PayrollCalendarID>
      <UpdatedDateUTC>2013-04-01T23:02:36</UpdatedDateUTC>
    </Employee>
    <Employee>
      <EmployeeID>33c0dccf-cc2d-44ef-97d7-64041ca914cc</EmployeeID>
      <FirstName>Oliver</FirstName>
      <LastName>Gray</LastName>
      <Status>ACTIVE</Status>
      <Email>og@madeup.email.com</Email>
      <DateOfBirth>1965-12-26T00:00:00</DateOfBirth>
      <Gender>M</Gender>
      <Phone>0401 123 456</Phone>
      <StartDate>2012-07-02T00:00:00</StartDate>
      <OrdinaryEarningsRateID>72e962d1-fcac-4083-8a71-742bb3e7ae14</OrdinaryEarningsRateID>
      <PayrollCalendarID>cb8e4706-2fdc-4170-aebd-0ffb855557f5</PayrollCalendarID>
      <UpdatedDateUTC>2013-04-01T23:02:36</UpdatedDateUTC>
    </Employee>
    <Employee>
      <EmployeeID>8a1618c6-306c-4f9b-b9cd-d637cc1b3da0</EmployeeID>
      <FirstName>Sally </FirstName>
      <LastName>Martin</LastName>
      <Status>ACTIVE</Status>
      <Email>sm@madeup3993.com</Email>
      <DateOfBirth>1983-11-26T00:00:00</DateOfBirth>
      <Gender>F</Gender>
      <Phone>0400 123 456</Phone>
      <StartDate>2012-12-30T00:00:00</StartDate>
      <OrdinaryEarningsRateID>72e962d1-fcac-4083-8a71-742bb3e7ae14</OrdinaryEarningsRateID>
      <PayrollCalendarID>cb8e4706-2fdc-4170-aebd-0ffb855557f5</PayrollCalendarID>
      <UpdatedDateUTC>2013-04-01T23:02:36</UpdatedDateUTC>
    </Employee>
    <Employee>
      <EmployeeID>ff135c75-0121-48e3-8cac-128cfcc69b99</EmployeeID>
      <FirstName>Sonia</FirstName>
      <LastName>Michaels</LastName>
      <Status>ACTIVE</Status>
      <Email>som@madeup3993.com</Email>
      <DateOfBirth>1986-01-22T00:00:00</DateOfBirth>
      <Gender>F</Gender>
      <Phone>02 2345 6789</Phone>
      <Mobile></Mobile>
      <UpdatedDateUTC>2013-04-01T23:02:36</UpdatedDateUTC>
    </Employee>
    <Employee>
      <EmployeeID>e8645dca-46ab-4026-a8d1-1c389378de50</EmployeeID>
      <FirstName>Tracy</FirstName>
      <LastName>Green</LastName>
      <Status>ACTIVE</Status>
      <Email>tg@madeup.email.com</Email>
      <DateOfBirth>1985-08-04T00:00:00</DateOfBirth>
      <Gender>F</Gender>
      <Phone>0402 123 456</Phone>
      <StartDate>2012-05-01T00:00:00</StartDate>
      <OrdinaryEarningsRateID>72e962d1-fcac-4083-8a71-742bb3e7ae14</OrdinaryEarningsRateID>
      <PayrollCalendarID>97e0784f-6c3e-4371-a177-f93fbada3c58</PayrollCalendarID>
      <UpdatedDateUTC>2013-04-01T23:02:36</UpdatedDateUTC>
    </Employee>
</Employees>

Optional parameters for GET Employees

Record filter You can specify an individual record by appending the value to the endpoint, i.e. GET https://…/Employees/{identifier} This will return all employee information as well as employee’s Bank Account, Opening Balance, Pay Template and super membership
EmployeeID The Xero identifier for an employee e.g. 297c2dc5-cc47-4afd-8ec8-74990b8761e9
Modified After The ModifiedAfter filter is actually an HTTP header: ‘If-Modified-Since‘. A UTC timestamp (yyyy-mm-ddThh:mm:ss) . Only employees created or modified since this timestamp will be returned e.g. 2009-11-12T00:00:00
page By default the number of records returned per call is 100. You can add GET https://…/Employees?page=2 to get the next set of records.
Where Filter by an any element (see Filters)
order Order by any element returned (see Order By)

Example response for GET Employees/{identifier}

<Employees>
    <Employee>
      <EmployeeID>fb4ebd68-6568-41eb-96ab-628a0f54b4b8</EmployeeID>
      <FirstName>James</FirstName>
      <LastName>Lebron</LastName>
      <Status>ACTIVE</Status>
      <Email>JL@madeup.email.com</Email>
      <DateOfBirth>1978-08-13T00:00:00</DateOfBirth>
      <Gender>M</Gender>
      <HomeAddress>
        <AddressLine1>123 Main St</AddressLine1>
        <City>St. Kilda</City>
        <Region>VIC</Region>
        <PostalCode>3182</PostalCode>
        <Country>AUSTRALIA</Country>
      </HomeAddress>
      <Phone>0400-000-123</Phone>
      <Mobile> 408-230-9732</Mobile>
      <StartDate>2012-01-30T00:00:00</StartDate>
      <OrdinaryEarningsRateID>72e962d1-fcac-4083-8a71-742bb3e7ae14</OrdinaryEarningsRateID>
      <PayrollCalendarID>cb8e4706-2fdc-4170-aebd-0ffb855557f5</PayrollCalendarID>
      <UpdatedDateUTC>2013-04-01T23:02:36</UpdatedDateUTC>
      <IsAuthorisedToApproveLeave>false</IsAuthorisedToApproveLeave>
      <TaxDeclaration>
        <TFNPendingOrExemptionHeld>false</TFNPendingOrExemptionHeld>
        <AustralianResidentForTaxPurposes>true</AustralianResidentForTaxPurposes>
        <TaxFreeThresholdClaimed>true</TaxFreeThresholdClaimed>
        <HasHELPDebt>false</HasHELPDebt>
        <HasSFSSDebt>false</HasSFSSDebt>
        <EligibleToReceiveLeaveLoading>false</EligibleToReceiveLeaveLoading>
        <UpdatedDateUTC>2013-04-26T00:04:48</UpdatedDateUTC>
      </TaxDeclaration>
      <BankAccounts>
        <BankAccount>
          <StatementText>Salary</StatementText>
          <AccountName>James Lebron Savings</AccountName>
          <BSB>122344</BSB>
          <AccountNumber>345678</AccountNumber>
          <Remainder>false</Remainder>
          <Percentage>20.0000</Percentage>
        </BankAccount>
        <BankAccount>
          <StatementText>Salary</StatementText>
          <AccountName>James Lebron</AccountName>
          <BSB>123443</BSB>
          <AccountNumber>2345678</AccountNumber>
          <Remainder>true</Remainder>
        </BankAccount>
      </BankAccounts>
      <OpeningBalances>
        <OpeningBalanceDate>2012-07-01T00:00:00</OpeningBalanceDate>
        <EarningsLines>
          <EarningsLine>
            <EarningsRateID>72e962d1-fcac-4083-8a71-742bb3e7ae14</EarningsRateID>
            <Amount>13333.33</Amount>
          </EarningsLine>
        </EarningsLines>
        <DeductionLines>
          <DeductionLine>
            <DeductionTypeID>59cd9d04-4521-4cc3-93ac-7841651ff407</DeductionTypeID>
            <Amount>40.00</Amount>
          </DeductionLine>
        </DeductionLines>
        <Tax>4000.00</Tax>
        <SuperLines>
          <SuperLine>
            <SuperMembershipID>4333d5cd-53a5-4c31-98e5-a8b4e5676b0b</SuperMembershipID>
            <ContributionType>SGC</ContributionType>
            <Amount>3999.99</Amount>
          </SuperLine>
        </SuperLines>
        <ReimbursementLines />
        <LeaveLines>
          <LeaveLine>
            <LeaveTypeID>742998cb-7584-4ecf-aa88-d694f59c50f9</LeaveTypeID>
            <NumberOfUnits>100.0000</NumberOfUnits>
          </LeaveLine>
          <LeaveLine>
            <LeaveTypeID>3bc7b584-a49f-40c6-ac5e-891f382785c9</LeaveTypeID>
            <NumberOfUnits>40.0000</NumberOfUnits>
          </LeaveLine>
        </LeaveLines>
      </OpeningBalances>
      <PayTemplate>
        <EarningsLines>
          <EarningsLine>
            <EarningsRateID>72e962d1-fcac-4083-8a71-742bb3e7ae14</EarningsRateID>
            <CalculationType>ANNUALSALARY</CalculationType>
            <AnnualSalary>40000.00</AnnualSalary>
            <NumberOfUnitsPerWeek>38.0000</NumberOfUnitsPerWeek>
          </EarningsLine>
        </EarningsLines>
        <DeductionLines>
          <DeductionLine>
            <DeductionTypeID>59cd9d04-4521-4cc3-93ac-7841651ff407</DeductionTypeID>
            <CalculationType>FIXEDAMOUNT</CalculationType>
            <Amount>10.00</Amount>
          </DeductionLine>
        </DeductionLines>
        <SuperLines>
          <SuperLine>
            <SuperMembershipID>4333d5cd-53a5-4c31-98e5-a8b4e5676b0b</SuperMembershipID>
            <ContributionType>SGC</ContributionType>
            <CalculationType>PERCENTAGEOFEARNINGS</CalculationType>
            <MinimumMonthlyEarnings>450.00</MinimumMonthlyEarnings>
            <ExpenseAccountCode>478</ExpenseAccountCode>
            <LiabilityAccountCode>826</LiabilityAccountCode>
            <Percentage>9.0000</Percentage>
          </SuperLine>
          <SuperLine>
            <SuperMembershipID>4333d5cd-53a5-4c31-98e5-a8b4e5676b0b</SuperMembershipID>
            <ContributionType>SALARYSACRIFICE</ContributionType>
            <CalculationType>FIXEDAMOUNT</CalculationType>
            <ExpenseAccountCode>478</ExpenseAccountCode>
            <LiabilityAccountCode>826</LiabilityAccountCode>
            <Amount>50.0000</Amount>
          </SuperLine>
        </SuperLines>
        <ReimbursementLines />
        <LeaveLines>
          <LeaveLine>
            <LeaveTypeID>742998cb-7584-4ecf-aa88-d694f59c50f9</LeaveTypeID>
            <CalculationType>FIXEDAMOUNTEACHPERIOD</CalculationType>
            <AnnualNumberOfUnits>152.0000</AnnualNumberOfUnits>
          </LeaveLine>
          <LeaveLine>
            <LeaveTypeID>3bc7b584-a49f-40c6-ac5e-891f382785c9</LeaveTypeID>
            <CalculationType>FIXEDAMOUNTEACHPERIOD</CalculationType>
            <AnnualNumberOfUnits>76.0000</AnnualNumberOfUnits>
          </LeaveLine>
        </LeaveLines>
      </PayTemplate>
      <SuperMemberships>
        <SuperMembership>
          <SuperMembershipID>4333d5cd-53a5-4c31-98e5-a8b4e5676b0b</SuperMembershipID>
          <SuperFundID>2187a42b-639a-45cb-9eed-cd4ae488306a</SuperFundID>
          <EmployeeNumber>1234</EmployeeNumber>
        </SuperMembership>
      </SuperMemberships>
    </Employee>
</Employees>

Example of retrieving terminated employees

Using a where filter you can specify a status of TERMINATED. e.g. Status=="TERMINATED"

This translates to the following URL once percent encoded.

https://api.xero.com/payroll.xro/1.0/Employees?where=Status%3D%3D%22TERMINATED%22

<Employees>
    <Employee>
        <EmployeeID>d5057392-d676-4d31-8811-5be2edc30e42</EmployeeID>
        <FirstName>Employee FirstName</FirstName>
        <LastName>Employee LastName</LastName>
        <Status>TERMINATED</Status>
        <StartDate>2013-01-07T00:00:00</StartDate>
        <TerminationDate>2013-03-06T00:00:00</TerminationDate>
        <UpdatedDateUTC>2013-02-28T00:23:36</UpdatedDateUTC>
    </Employee>
</Employees>

POST Employees

Use this method to create, update or delete one or more payroll employee items.

Example of minimum elements required to add a new Employee

<Employees>
    <Employee>
        <FirstName>John</FirstName>
        <LastName>Smith</LastName>        
    </Employee>
</Employees>

An example showing an employees details being updated

<Employees>
  <Employee>
    <EmployeeID>509d776f-6826-4873-8d17-fea3a2a750c0</EmployeeID>
    <FirstName>FirstName</FirstName>
    <LastName>LastName</LastName>
    <Status>ACTIVE</Status>
    <HomeAddress>
      <AddressLine1>Street address 1</AddressLine1>
      <City>Wahat</City>
      <Region>ACT</Region>
      <PostalCode>1234</PostalCode>
      <Country>AUSTRALIA</Country>
    </HomeAddress>
    <StartDate>2012-10-07T00:00:00</StartDate>
    <Classification />
    <OrdinaryEarningsRateID>a24dd671-afd3-49bf-a60e-88acd7faa9e4</OrdinaryEarningsRateID>
    <PayrollCalendarID>05c5b1f2-0e64-45fa-baf3-8bb8f5a03363</PayrollCalendarID>
    <UpdatedDateUTC>2013-04-15T00:33:08</UpdatedDateUTC>
    <IsAuthorisedToApproveLeave>false</IsAuthorisedToApproveLeave>
    <IsAuthorisedToApproveTimesheets>false</IsAuthorisedToApproveTimesheets>
    <TaxDeclaration>
      <TFNPendingOrExemptionHeld>false</TFNPendingOrExemptionHeld>
      <AustralianResidentForTaxPurposes>true</AustralianResidentForTaxPurposes>
      <TaxFreeThresholdClaimed>true</TaxFreeThresholdClaimed>
      <HasHELPDebt>false</HasHELPDebt>
      <HasSFSSDebt>false</HasSFSSDebt>
      <EligibleToReceiveLeaveLoading>false</EligibleToReceiveLeaveLoading>
    </TaxDeclaration>
    <BankAccounts />
    <OpeningBalances>
      <OpeningBalanceDate>2013-04-12T00:00:00</OpeningBalanceDate>
      <EarningsLines>
        <EarningsLine>
          <EarningsRateID>b3b6448b-34f6-445a-9250-a0fbe8f42960</EarningsRateID>
          <Amount>10.00</Amount>
        </EarningsLine>
      </EarningsLines>
      <DeductionLines>
        <DeductionLine>
          <DeductionTypeID>0c29b630-4e53-453d-a2e7-e8e97a95f636</DeductionTypeID>
          <Amount>10.00</Amount>
        </DeductionLine>
      </DeductionLines>
      <SuperLines>
        <SuperLine>
          <SuperMembershipID>4fd2a28e-ac86-4726-b8d9-f449457f9984</SuperMembershipID>
          <ContributionType>SGC</ContributionType>
          <Amount>10.00</Amount>
        </SuperLine>
      </SuperLines>
      <ReimbursementLines>
        <ReimbursementLine>
          <ReimbursementTypeID>bd246b96-c637-4767-81cf-851ba8fa93c2</ReimbursementTypeID>
          <Amount>10.00</Amount>
        </ReimbursementLine>
      </ReimbursementLines>
      <LeaveLines>
        <LeaveLine>
          <LeaveTypeID>dc182d9a-a270-4f4e-acd7-af702d5a4382</LeaveTypeID>
          <NumberOfUnits>8.0000</NumberOfUnits>
        </LeaveLine>
      </LeaveLines>
    </OpeningBalances>
    <PayTemplate>
      <EarningsLines>
        <EarningsLine>
          <EarningsRateID>a24dd671-afd3-49bf-a60e-88acd7faa9e4</EarningsRateID>
          <CalculationType>ENTEREARNINGSRATE</CalculationType>
          <RatePerUnit>40.0000</RatePerUnit>
          <NormalNumberOfUnits>37.0000</NormalNumberOfUnits>
        </EarningsLine>
      </EarningsLines>
      <DeductionLines>
        <DeductionLine>
          <DeductionTypeID>0c29b630-4e53-453d-a2e7-e8e97a95f636</DeductionTypeID>
          <CalculationType>FIXEDAMOUNT</CalculationType>
          <Amount>10.00</Amount>
        </DeductionLine>
      </DeductionLines>
      <SuperLines>
        <SuperLine>
          <SuperMembershipID>4fd2a28e-ac86-4726-b8d9-f449457f9984</SuperMembershipID>
          <ContributionType>SGC</ContributionType>
          <CalculationType>PERCENTAGEOFEARNINGS</CalculationType>
          <MinimumMonthlyEarnings>450.00</MinimumMonthlyEarnings>
          <ExpenseAccountCode>478</ExpenseAccountCode>
          <LiabilityAccountCode>826</LiabilityAccountCode>
          <Percentage>9.0000</Percentage>
        </SuperLine>
      </SuperLines>
      <ReimbursementLines>
        <ReimbursementLine>
          <ReimbursementTypeID>bd246b96-c637-4767-81cf-851ba8fa93c2</ReimbursementTypeID>
          <Description>My Travel Cost</Description>
          <Amount>100.00</Amount>
        </ReimbursementLine>
      </ReimbursementLines>
      <LeaveLines>
        <LeaveLine>
          <LeaveTypeID>dc182d9a-a270-4f4e-acd7-af702d5a4382</LeaveTypeID>
          <CalculationType>FIXEDAMOUNTEACHPERIOD</CalculationType>
          <AnnualNumberOfUnits>1.0000</AnnualNumberOfUnits>
        </LeaveLine>
      </LeaveLines>
    </PayTemplate>
    <SuperMemberships>
      <SuperMembership>
        <SuperMembershipID>4fd2a28e-ac86-4726-b8d9-f449457f9984</SuperMembershipID>
        <SuperFundID>9531b699-9265-4cfc-bb99-f768f7f11d30</SuperFundID>
        <EmployeeNumber>12345676</EmployeeNumber>
      </SuperMembership>
    </SuperMemberships>
  </Employee>
 </Employees>

An example showing creating an employee with an opening balance

<Employees>
  <Employee>   
    <FirstName>John</FirstName>
    <LastName>Smith</LastName>
    <OpeningBalances>
      <SuperLines>
        <SuperLine>
          <ContributionType>SGC</ContributionType>
          <Amount>10.00</Amount>
        </SuperLine>
      </SuperLines>
    </OpeningBalances>
  </Employee>
</Employees>