4.19.0

Accounting API

• Adds new methods for Repeating Invoices: createRepeatingInvoices, updateOrCreateRepeatingInvoices, and updateRepeatingInvoice

AU Payroll API

• Adds EarningsType enum values PAIDPARENTALLEAVE and WORKERSCOMPENSATION

4.18.0

Accounting API

Adds new tax rate for Singapore: TXRCTSINPUT - Imported services attributable to taxable supplies

Project API

Adds CreateTask, UpdateTask, and DeleteTask methods

4.17.0

Accounting API

Added a new organization class enum ULTIMATE to support new ultimate plan.
BADDEBTRELIEF has been added as both a TaxType and ReportTaxType
IGDSINPUT3, SROVR, TOURISTREFUND, TXRCN33INPUT, TXRCREINPUT, TXRCESSINPUT have been added as both a TaxType and ReportTaxType

SDK Updates

Updated Google API Client version from 1.23.0 to 1.34.0 (Jackson2 has been deprecated and replaced with GSON)

4.16.0

Finance API

Adds startBalance and endBalance to bank statement response

Accounting API

Adds getJournalByJournalNumber method

App Store API

Adds metered capabilities for app store subscriptions end point

4.15.0

What's Changed

App Store API

Plan.status enum updated to include CANCELED, available options are:
ACTIVE, CANCELED, PENDINGACTIVATION

Subscription.status type corrected from string to Subscription.StatusEnum, available options are:
ACTIVE, CANCELED, PASTDUE

SubscriptionItem updated to include status enum, available options are:
ACTIVE, CANCELED, PENDINGACTIVATION

Files API

Quote added to ObjectGroup enum
SalesQuote added to ObjectType enum

AU Payroll API

AllowanceCategory enum added to EarningsRate, available options are:
NONDEDUCTIBLE, UNIFORM, PRIVATEVEHICLE, HOMEOFFICE, TRANSPORT, GENERAL, OTHER

AllowanceType enum updated to include TOOLS, TASKS, QUALIFICATIONS, available options are:
CAR, TRANSPORT, LAUNDRY, MEALS, TRAVEL, JOBKEEPER, TOOLS, TASKS, QUALIFICATIONS, OTHER

Accounting API

LineItem model updated to include Item object that is returned in BankTransactions, Invoices, Credit Notes - new model is LineItemItem

Finance API

Adds Bank Statements Plus endpoint via getBankStatementAccounting method and associated models

UK Payroll API

Employee model update to include IsOffPayrollWorker boolean property

Adds IsOffPayrollWorker as an available query param for GET /Employees

4.14.0

Implements the endpoints /FinancialStatements/contacts/revenue and /FinancialStatements/contacts/expense

Description

https://developer.xero.com/documentation/api/finance/financialstatements#get-financialstatements-contacts-revenue

https://developer.xero.com/documentation/api/finance/financialstatements#get-financialstatements-contacts-expense

Release Notes

-Added ContactNumber, SalesDefaultLineAmountType, PurchasesDefaultLineAmountType and MergedToContactID to Contacts endpoint.
-Added Expense and Revenue reports to the Financial Statements API
-Added searchTerm param to Contacts endpoint

Types of Changes

• New feature (non-breaking change that adds functionality)

4.13.0

Description

Initial release of the finance API specs. https://developer.xero.com/documentation/api/finance/overview/

Access

The Finance API is a closed API that is only available to those that have an established (usually, but not limited to, financial services) partnership with Xero.
If you're an existing partner that wants access, contact your local Partner Manager.
If you're a financial institution or other partner who wants to leverage the Finance API for your business customers, contact us to become a financial services partner.

Release Notes

Finance API is a collection of endpoints which customers can use in the course of a loan application, which may assist lenders to gain the confidence they need to provide capital.
FinanceAPI adds

• getCashValidation
• getAccountingActivityAccountUsage
• getAccountingActivityLockHistory
• getAccountingActivityReportHistory
• getAccountingActivityUserActivities
• getFinancialStatementBalanceSheet
• getFinancialStatementCashflow
• getFinancialStatementProfitAndLoss
• getFinancialStatementTrialBalance

Additional changes introduced

-Add EarningsRate enum value DIRECTORSFEES to the Payroll AU SDK spec
-Add API SDK Support for LumpSumW and SCHEDULE4MANUAL tax type to the Payroll AU SDK spec
-fixes GetBudget filtering
-Adding missing params from Timesheets and Employees endpoints
-Timesheets endpoint -> filter, status, startDate, endDate and sort parameters
-Employees endpoint -> filter parameter
-adds missing UK payroll earningsrates: TipsNonDirect, TipsDirect
-adds new properties to bank transfers
-adds missing seatUnit to Product schema in app store spec
-New properties on bank transfers: FromIsReconciled, ToIsReconciled, Reference

Types of Changes

• New feature (non-breaking change that adds functionality)
• Bug fixes

4.12.0

Implements the endpoints available in Xero-Java

Description

https://developer.xero.com/documentation/guides/how-to-guides/xero-app-store-subscriptions/

https://developer.xero.com/documentation/api/xero-app-store/subscriptions

Release Notes

Subscriptions endpoints enable you to query data about the users who have paid to subscribe to your application through Xero.

AppStoreAPI adds

• getSubscription

• AppStore adds

  • Subscription
  • SubscriptionItem
  • Plan
  • Product
  • Price
  • ProblemDetails

• PayrollAu Employee adds termination_reason
V Voluntary cessation
  I Ill health
  D Deceased
  R Redundancy
  F Dismissal
  C Contract cessation
  T Transfer

• PayrollAu PayrollCalendar adds reference_date

• Payment adds bank_amount

Types of Changes

• New feature (non-breaking change that adds functionality)

4.11.1

• A few fixes to the budgets serialization thanks to @rdemarco-xero

• Fixes budgets

  • budgetLines
  • budgetBalances

• Adds TERMINATIONPAY("TerminationPay");

• Adds referenceDate to payrollCalendar

4.11.0

Added small breaking fix to reports for au/nz tax, added budgets endpoints, added the rest of the docs for api sets.. some still don't have body examples but an improvement.

🚨 🚨 🚨 MINOR BREAKING CHANGE 🚨 🚨 🚨

1. Changes param order of summaryOnly for getInvoices.

*** This was not added as the last param in the spec and was the only SDK released prior to it being fixed in the OpenAPI Spec - We are moving it as the last parameter across all SDKs it is less of a breaking change. Apologies to those users that might have implemented, and have to swap position now again.

2. getReportBASorGSTList -> getReportsList
getReportBasOrGst -> getReportFromId

Changes using previous GST BAS reports specific endpoints to support stable future state of adding reports that are unique to an org and require a uuid to be passed. New function names:

getReportsList
getReportFromId

3) Added missing endpoints:
- GET /Budgets
- GET /Budgets/{BudgetID}

🚨 🚨 🚨 END🚨 🚨 🚨

Types of Changes

• Bug fix (non-breaking change that fixes an issue)
• New feature (non-breaking change that adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)