Release Notes – Payroll API


To be notified as we release new features, subscribe to the Xero Developer mailing list.


Version 1.8

Date: October 15, 2014

New features and improvements
1. POST Employees – DateOfBirth and HomeAddress are now required to submit a POST request. Creating an employee without FirstName, LastName, DateOfBirth & HomeAddress will result in a validation error.
2. AddressLine3 and AddressLine4 are now deprecated on Employee HomeAddress. POST requests containing these fields will return a 200 response, but data provided for Addressline3 & AddressLine4 will not be stored. Existing data for AddressLine3 & AddressLine4 will be migrated into AddressLine1 & AddressLine2.
3. The maximum length of AddressLine1 & AddressLine2 on Employee Homeaddress has decreased from 100 characters to 50 characters.


Version 1.7

Date: August 18, 2014

New features and improvements
1. Payroll is now integrated with the general ledger. Find out all the details on the Xero blog.
2. As part of the GL integration, there is a new Wages Payable Account setting on the Setting endpoint.
3. A new account type has been created, called “WAGESPAYABLELIABILITY”, has been added. It will appear in all Xero Orgs by default with account code 804, it has also been created for all existing Xero Orgs and set as the default in the Payroll settings. If a Xero Org is already using account code 804 they will receive a validation error when posting a Payrun prompting them to update their Payroll settings.

Bug fixes
1. An issue involving Employee PayTemplates & FixedAmount has been resolved. You can now set the Amount of a FixedAmount EarningsRate via the Employee endpoint.


Version 1.6

Date: June 25, 2014

New features and improvements
1. Improved how the LeaveApplications endpoint handles POST /LeaveApplications requests. POST /LeaveApplication requests that specify <LeavePeriods> with an incorrect <PayPeriodEndDate> will now raise a validation error “Invalid LeavePeriod provided”.


Version 1.5

Date: April 30, 2014

New features and improvements
1. The PayRuns endpoint has been updated to provide a more comprehensive response to POST /PayRuns requests


Version 1.4

Date: February 24, 2014

Bug fixes
1. Resolves an issue related to JSON requests that result in a 400 validation error being returned as 500 errors.
2. Approved timesheets can no longer be created against a POSTED Payrun.
3. Resolves being updated on the LeaveApplications endpoint.
4. Resolves changing Employees BankAccounts fixed & percentage values.


Version 1.3

Date: October 15, 2013

New features and improvements

1. Added TaxTypeName to TaxLines on the Payslip endpoint.
2. Improved handling of duplicate timesheets when in draft mode.

Bug fixes
1. Resolves issue related to providing the ABN when requesting a Superfund.


Version 1.2

Date: September 12, 2013

New features and improvements

1. A new endpoint for Settings


Version 1.1

Date: August 5, 2013

New features and improvements

1. Changes to TFN Exemption handling via the Employees endpoint.

There has been a breaking change to the employee’s endpoint. TFNPendingOrExemptionHeld has been deprecated and replaced with a TFNExemptionType.


Version 1.0

Date: May 28, 2013

New features and improvements

1. Public release of the Xero Payroll API
2. API Previewer support


Version 0.2

Date: March 25, 2013

New features and improvements

1. Added support for private applications
2. New endpoints for

  • LeaveApplications
  • Timesheets

Version 0.1

Date: Dec 10, 2012

New features and improvements

1. Initial support for public and partner applications
2. Endpoints for

  • Employees
  • PayItems
  • PayrollCalendars
  • Payruns
  • Payslip
  • Superfunds
  • TaxDeclaration