Nic at 05:06, 12 February 2025

2025-02-12T05:06:57Z

← Older revision		Revision as of 00:06, 12 February 2025
Line 64:		Line 64:
	:A [[Field Type: Text\|text field]] that provides the termination reason code of the employee.		:A [[Field Type: Text\|text field]] that provides the termination reason code of the employee.
	:Possible values are:		:Possible values are:
	:* '''V''': This indicates the employee resigned, retired, or ~~abandonned~~ employment.		:* '''V''': This indicates the employee resigned, retired, or abandoned employment.
	:* '''I''': This indicates the employee resigned due to medical condition that prevents the continuation of employment, such as for illness, ill-health, medical unfitness or total permanent disability.		:* '''I''': This indicates the employee resigned due to medical condition that prevents the continuation of employment, such as for illness, ill-health, medical unfitness or total permanent disability.
	:* '''D''': This indicates the employee is deceased.		:* '''D''': This indicates the employee is deceased.

Nic at 03:49, 4 October 2021

2021-10-04T03:49:12Z

← Older revision		Revision as of 22:49, 3 October 2021
Line 307:		Line 307:
	;NormalNumberOfUnits		;NormalNumberOfUnits
	:A [[Field Type: Decimal\|decimal field]] that provides the normal number of hours worked.		:A [[Field Type: Decimal\|decimal field]] that provides the normal number of hours worked.

			;FixedAmount
			:A [[Field Type: Decimal\|decimal field]] that provides the fixed amount of hours worked.

Nic at 04:20, 23 September 2021

2021-09-23T04:20:34Z

← Older revision		Revision as of 23:20, 22 September 2021
Line 236:		Line 236:

	;Remainder		;Remainder
	:A [[Field Type: ~~Booelan~~\|true/false field]] that indicates if the balance remaining of any payments will be distributed to this bank account.		:A [[Field Type: Boolean\|true/false field]] that indicates if the balance remaining of any payments will be distributed to this bank account.

	;Amount		;Amount

Nic at 04:20, 23 September 2021

2021-09-23T04:20:00Z

Show changes

Nic: Created page with "== Overview == The Xero '''EmployeesExpanded''' endpoint provides the list of employees. This endpoint provides all detailed informati..."

2021-09-23T03:53:55Z

Created page with "== Overview == The Xero '''EmployeesExpanded''' endpoint provides the list of employees. This endpoint provides all detailed informati..."

New page

== Overview ==

The Xero '''EmployeesExpanded''' [[Xero Payroll (Australia) Endpoints|endpoint]] provides the list of employees.

This endpoint provides all detailed information for employees.

You can also integrate with [[Xero Payroll (Australia) Endpoint: Employees|Employees]] which provides more summarised information and may perform better but doesn't have access to all fields.

== Fields ==

The following fields are available for the EmployeesExpanded endpoint.

;EmployeeID
:A [[Field Type: GUID|guid field]] that provides the id of the employee.

;FirstName
:A [[Field Type: Text|text field]] that provides the first name of the employee.

;MiddleNames
:A [[Field Type: Text|text field]] that provides the middle name of the employee.

;LastName
:A [[Field Type: Text|text field]] that provides the last name of the employee.

;HomeAddress
:A [[Field Type: Record|record field]] that provides the home address details of the employee.
:See [[#HomeAddress Fields|HomeAddress Fields]] for more information.

;DateOfBirth
:A [[Field Type: Date|date field]] that provides the date of birth of the employee.

;Gender
:A [[Field Type: Text|text field]] that provides the gender of the employee.

;Email
:A [[Field Type: Text|text field]] that provides the email address of the employee.

;Phone
:A [[Field Type: Text|text field]] that provides the phone number of the employee.

;Mobile
:A [[Field Type: Text|text field]] that provides the mobile phone number of the employee.

;TwitterUserName
:A [[Field Type: Text|text field]] that provides the twitter user name of the employee.

;JobTitle
:A [[Field Type: Text|text field]] that provides the job title of the employee.

;Classification
:A [[Field Type: Text|text field]] that provides the classification of the employee.

;EmployeeGroupName
:A [[Field Type: Text|text field]] that provides the employee group name of the employee.

;StartDate
:A [[Field Type: Date|date field]] that provides the start date of the employee.

;TerminationDate
:A [[Field Type: Date|date field]] that provides the end date of the termination date of the employee.

;TerminationReason
:A [[Field Type: Text|text field]] that provides the termination reason code of the employee.
:Possible values are:
:* '''V''': This indicates the employee resigned, retired, or abandonned employment.
:* '''I''': This indicates the employee resigned due to medical condition that prevents the continuation of employment, such as for illness, ill-health, medical unfitness or total permanent disability.
:* '''D''': This indicates the employee is deceased.
:* '''R''': This indicates the employee was made redundant due to a genuine redundancy or approved early retirement scheme.
:* '''F''': This indicates the employee was terminated due to dismissal, inability to perform the required work, misconduct or inefficiency.
:* '''C''': This indicates the employee was termminated due to natural conclusion of a limited employment relationship such as contract/engagement duration or task completion, seasonal work completion, or to cease casuals that are no longer required.
:* '''T''': This indicates the employee was transfered across payroll systems, moved temporarily to another employer (machinery of government for public servants), transferred to another business, moved to outsourcing arrangements or other such technical activities.

;Status
:A [[Field Type: Text|text field]] that provides the status of the employee.
:Possible values are:
:* '''ACTIVE''': Indicates the employee is active.
:* '''TERMINATED: Indicates the employee has been terminated.

;OrdinaryEarningsRateID
:A [[Field Type: GUID|guid field]] that provides the [[Xero Payroll (Australia) Endpoint: PayItemsEarningsRates|earnings rate id]] used for ordinary wages.

;PayrollCalendarID
:A [[Field Type: GUID|guid field]] that provides the [[Xero Payroll (Australia) Endpoint: PayrollCalendars|payroll calendar id]] of the employee.

;IsAuthorisedToApproveLeave
:A [[Field Type: Boolean|true/false field]] that indicates if the employee is authorised to approve leave.

;IsAuthorisedToApproveTimesheets
:A [[Field Type: Boolean|true/false field]] that indicates if the employee is authorised to approve timsheets.

;TaxDeclaration
:A [[Field Type: Record|record field]] that provides additional tax declaration fields.
:See [[#TaxDeclaration Fields|TaxDeclaration Fields]] for more information.

;BankAccounts
:A [[Field Type: Table|table field]] that provides bank account details.
:See [[#BankAccounts Fields|BankAccounts Fields]] for more information.

;SuperMemberships
:A [[Field Type: Table|table field]] that provides superannuation membership details.
:See [[#SuperMemberships Fields|SuperMemberships Fields]] for more information.

;PayTemplate
:A [[Field Type: Record|record field]] that provides the pay template.
:See [[#PayTemplate Fields|PayTemplate Fields]] for more information.

;OpeningBalances
:A [[Field Type: Record|record field]] that provides opening balances
:See [[#OpeningBalances Fields|OpeningBalances Fields]] for more information.

;LeaveBalances
:A [[Field Type: Record|record field]] that provides closing leave balances as at the end of time.
:See [[#LeaveBalances Fields|LeaveBalances Fields]] for more information.

;UpdatedDateUTC
:A [[Field Type: DateTimeOffset|date time field]] that indicates the last time this record was updated.

== HomeAddress Fields ==

The [[#Fields|HomeAddress Fields]] include the following sub fields.

;AddressLine1
:A [[Field Type: Text|text field]] that provides the first line of the address of the employee.

;AddressLine2
:A [[Field Type: Text|text field]] that provides the second line of the address of the employee.

;City
:A [[Field Type: Text|text field]] that provides the city of the employee.

;Region
:A [[Field Type: Text|text field]] that provides the state of the employee.

;PostalCode
:A [[Field Type: Text|text field]] that provides the post code of the employee.

;Country
:A [[Field Type: Text|text field]] that provides the country of the employee.

== TaxDeclaration Fields ==

The [[#Fields|TaxDeclaration Fields]] include the following sub fields.

;EmploymentBasis
:A [[Field Type: Text|text field]] that provides the employment basis of the employee.
:Possible values are:
:* '''FULLTIME'''
:* '''PARTTIME'''
:* '''CASUAL'''
:* '''LABOURHIRE'''
:* '''SUPERINCOMESTREAM'''

;ResidencyStatus
:A [[Field Type: Text|text field]] that provides the residency status of the employee.
:Possible values are:
:* '''AUSTRALIANRESIDENT''': Indicates the employee is an Australian resident for tax purposes.
:* '''FOREIGNRESIDENT''': Indicates the employee is a foreign resident for tax purposes.
:* '''WORKINGHOLIDAYMAKER''': Indicates the employee is a working holiday maker for tax purposes.

;TFNExemptionType
:A [[Field Type: Text|text field]] that provides the residency status of the employee.
:Possible values are:
:* '''NOTQUOTED''': Indicates the employee has not provided a TFN.
:* '''PENDING''': Indicates the employee has made a separate application or Enquiry to the ATO for a new or existing TFN.
:* '''PENSIONER''': Indicates the employee is claiming that they are in receipt of a pension, benefit or allowance.
:* '''UNDER18''': Indicates the employee is claiming an exemption as they are under the age of 18 and do not earn enough to pay tax.

;TaxFileNumber
:A [[Field Type: Text|text field]] that provides the tax file number of the employee.

;AustralianResidentForTaxPurposes
:A [[Field Type: Boolean|true/false field]] that indicates if the employee is a resident for tax purposes.
:This field will be set to '''true''' if '''ResidencyStatus''' is set to '''AustralianResidentForTaxPurposes'''. Otherwise, it will be set to '''false'''.

;TaxFreeThresholdClaimed
:A [[Field Type: Boolean|true/false field]] that indicates if the employee is claiming the tax free threshold for this employer.

;HasHELPDebt
:A [[Field Type: Boolean|true/false field]] that indicates if the employee has a HELP or HECS debt.
:This field is deprecated and only provided for backwards compatibility reason.

;HasSFSSDebt
:A [[Field Type: Boolean|true/false field]] that indicates if the employee has a SFSS or financial supplement debt.
:This field is deprecated and only provided for backwards compatibility reason.

;HasTradeSupportLoanDebt
:A [[Field Type: Boolean|true/false field]] that indicates if the employee has a trade support loan.
:This field is deprecated and only provided for backwards compatibility reason.

;HasStudentStartupLoan
:A [[Field Type: Boolean|true/false field]] that indicates if the employee has a student startup loan.
:This field is deprecated and only provided for backwards compatibility reason.

;HasLoanOrStudentDebt
:A [[Field Type: Boolean|true/false field]] that indicates if the employee has one of the following loans.
:* Higher Education Loan Program (HELP/HECS)
:* VET Student Loan (VSL)
:* Financial Supplement (FS)
:* Student Start-up Loan (SSL)
:* Trade Support Loan (TSL).

;EligibleToReceiveLeaveLoading
:A [[Field Type: Boolean|true/false field]] that indicates if the employee is eligible to receive an additional percentage on top of ordinary earnings when they take leave (typically 17.5%).

;IncludeLeaveLoadingInSGC
:A [[Field Type: Boolean|true/false field]] that indicates leave loading is included in superannuation guarantee contribution.

;TaxOffsetEstimatedAmount
:A [[Field Type: Decimal|decimal field]] that provides the tax offset estimated amount.

;UpwardVariationTaxWithholdingAmount
:A [[Field Type: Decimal|decimal field]] that provides the additional tax amount if the employee elected to have additional tax withheld.

;ApprovedWithholdingVariationPercentage
:A [[Field Type: Decimal|decimal field]] that provides the approved withholding variation percentage.

== BankAccounts Fields ==

The [[#Fields|BankAccounts Fields]] include the following sub fields.

;BSB
:A [[Field Type: Text|text field]] that provides the BSB of the employee.

;AccountNumber
:A [[Field Type: Text|text field]] that provides the bank account number of the employee.

;AccountName
:A [[Field Type: Text|text field]] that provides the bank account name of the employee.

;StatementText
:A [[Field Type: Text|text field]] that provides the text to include on statement for the employee.

;Remainder
:A [[Field Type: Booelan|true/false field]] that indicates if the balance remaining of any payments will be distributed to this bank account.

;Amount
:A [[Field Type: Decimal|decimal field]] that provides a fixed amount that will be applied to this bank account first.

== SuperMemberships Fields ==

The [[#Fields|SuperMemberships Fields]] include the following sub fields.

;SuperMembershipID
:A [[Field Type: GUID|guid field]] that provides the super membership ID.

;SuperFundID
:A [[Field Type: GUID|guid field]] that provides the super fund ID.
:This field can be linked to the [[Xero Payroll (Australia) Endpoint: SuperFunds|SuperFunds]] endpoint.

;EmployeeNumber
:A [[Field Type: Text|text field]] that provides the employee numnber for the super fund.

== PayTemplate Fields ==

The [[#Fields|PayTemplate Fields]] include the following sub fields.

;EarningsLines
:A [[Field Type: Table|table field]] that provides earning lines for this emplopyee.
:See [[#PayTemplate.EarningsLines Fields|PayTemplate.EarningsLines Fields]] for more information.

;DeductionLines
:A [[Field Type: Table|table field]] that provides deduction lines for this emplopyee.
:See [[#PayTemplate.DeductionLines Fields|PayTemplate.DeductionLines Fields]] for more information.

;SuperLines
:A [[Field Type: Table|table field]] that provides superannuation lines for this emplopyee.
:See [[#PayTemplate.SuperLines Fields|PayTemplate.SuperLines Fields]] for more information.

;ReimbursementLines
:A [[Field Type: Table|table field]] that provides reimbusrement lines for this emplopyee.
:See [[#PayTemplate.ReimbursementLines Fields|PayTemplate.ReimbursementLines Fields]] for more information.

;LeaveLines
:A [[Field Type: Table|table field]] that provides leave lines for this emplopyee.
:See [[#PayTemplate.LeaveLines Fields|PayTemplate.LeaveLines Fields]] for more information.

== PayTemplate.EarningsLines Fields ==

The [[#PayTemplate Fields|PayTemplate.EarningsLines Fields]] include the following sub fields.

== PayTemplate.DeductionLines Fields ==

The [[#PayTemplate Fields|PayTemplate.DeductionLines Fields]] include the following sub fields.

== PayTemplate.SuperLines Fields ==

The [[#PayTemplate Fields|PayTemplate.SuperLines Fields]] include the following sub fields.

== PayTemplate.ReimbursementLines Fields ==

The [[#PayTemplate Fields|PayTemplate.ReimbursementLines Fields]] include the following sub fields.

== PayTemplate.LeaveLines Fields ==

The [[#PayTemplate Fields|PayTemplate.LeaveLines Fields]] include the following sub fields.

== OpeningBalances Fields ==

The [[#Fields|OpeningBalances Fields]] include the following sub fields.

== LeaveBalances Fields ==

The [[#Fields|LeaveBalances Fields]] include the following sub fields.

== Xero API ==

For a detailed run through of the endpoint, you can see the [https://developer.xero.com/documentation/api/payrollau/employees Xero API].

== Related Fields ==

:None

== Related Endpoints ==

:[[Xero Payroll (Australia) Endpoint: EmployeesExpanded|EmployeesExpanded]]
:[[Xero Payroll (Australia) Endpoint: PayItems|PayItems]]
:[[Xero Payroll (Australia) Endpoint: PayItemsEarningsRates|PayItemsEarningsRates]]
:[[Xero Payroll (Australia) Endpoint: PayrollCalendars|PayrollCalendars]]

== Related Topics ==

:[[Xero Payroll (Australia) Models]]
:[[Xero Payroll (Australia) Endpoints]]

Xero Payroll (Australia) Endpoint: EmployeesExpanded - Revision history

Nic at 05:06, 12 February 2025

Nic at 03:49, 4 October 2021

Nic at 04:20, 23 September 2021

Nic at 04:20, 23 September 2021

Nic: Created page with "== Overview == The Xero '''EmployeesExpanded''' endpoint provides the list of employees. This endpoint provides all detailed informati..."