Skip to content

Releases: XeroAPI/Xero-Java

4.1.0

03 Jun 22:15
5f243a0

Choose a tag to compare

Built with OpenAPI Generator 4.2.3 - all tests passed
UK Payroll Unit exit beta as all unit test complete and object/methods fixes

Release built from

https://github.com/XeroAPI/Xero-OpenAPI/releases/tag/2.1.6
https://github.com/XeroAPI/Xero-OpenAPI/releases/tag/2.1.7
https://github.com/XeroAPI/Xero-OpenAPI/releases/tag/2.2.0

4.0.2

20 May 23:54
aaea61c

Choose a tag to compare

Built from OpenAPI Spec version 2.1.5 and 2.1.4
https://github.com/XeroAPI/Xero-OpenAPI/releases/tag/2.1.5

ACCOUNTING
Add getContactByContactNumber method
Remove erroneous method getPrepaymentAsPdf removed.
BankTransfer amount changed from String to Number format: float

AU PAYROLL
UpdatePayslips response changed to Payslips
Example response for UpdatePayslips added

Data-type fix
ACCOUNTING
LineItem Quantity change from float to double
LineItem UnitAmount change from float to double
BankTransfer Amound change from float to double
Item QuantityOnHand change from float to double
PurchaseOrder UnitPrice change from float to double

ASSETS, PAYROLL AU and PAYROLL UK
All numbers with format float changed to double

4.0.1

15 May 20:55

Choose a tag to compare

See README for more information on breaking changes between 3.x and 4.x

ACCOUNTING (and all other APIs)
XeroApiException class deprecated in favor or error code specific exceptions

400 XeroBadRequestException
401| XeroUnauthorizedException
403 XeroForbiddenException
404 XeroNotFoundException
405 XeroMethodNotAllowedException
429 XeroRateLimitException
500 XeroServerErrorException

Refactor XeroApiExceptionHander to process unique exceptions
Update methods to throw unique 400 and 405 errors with validation data compatiable to that API set

Change date and datetime for Accounting to string with new method "AsDate" to converstion of MS Datetimeformat in the models and not during deserialization
Fix StringUtil to convert date to milliseconds using UTC timezone

LOGGING
Log4J replaced with logging facade,
Started added some "debug" level logging mesages
Note: open to suggestions for where you'd like to see logging

AU PAYROLL

  • New model Payslips
  • method updatePayslip response type changed to Payslips

UK PAYROLL
Unit tests added
EmployeeLeaveBalances
EmployeeLeavePeriods
EmployeeLeave
EmployeeLeaveTypes
EmployeeOpeningBalances
EmployeeStatutoryLeaveBalances
EmployeeStatutoryLeavesSummary
EmployeeStatutorySickLeave
EmployeeTax
Employee
Employment

Models and Methods modified to support Unit tests

3.6.0

21 Apr 18:36
0208db2

Choose a tag to compare

Build from OAS 2.1.0 https://github.com/XeroAPI/Xero-OpenAPI/releases/tag/2.1.0

UK Payroll initial commit - beta

  • PayrollUkApi class with all methods for interacting with UK Payroll API
  • Models for all UK Payroll objects
  • TODO: unit tests for all models

ACCOUNTING
IncludeOnline boolean fixed to be a query Param for creditNote and invoice Attachments

ASSETS
assetTypeId property added to Asset object

IDENTITY
tenantName property added to the Connection object

AU PAYROLL

  • allowanceType added with enum values
  • earningsType added some missing enum values

ErrorHandler

  • Look for Status code 401 and pass code and message in XeroApiException object

3.5.2

08 Apr 00:11
8e3dd44

Choose a tag to compare

Built from OAS 2.0.8
https://github.com/XeroAPI/Xero-OpenAPI/releases/tag/2.0.8

ACCOUNTING
Add getPurchaseOrderAsPdf method

ASSETS
Add Error objects and Validation arrays

GET Assets requires a Status in ALL Caps otherwise you'll recieve a 403 Forbidden.

CREATE or GET Assets deserializes JSON responses into the Assets object where the Status is Init Caps.

For this reason the same component in our OpenAPI spec will not support both use cases without throwing an error for missing enums due to case sensitivity.

3.5.1

03 Apr 23:42
619a928

Choose a tag to compare

Built off version 2.0.7 of Xero-OpenAPI
https://github.com/XeroAPI/Xero-OpenAPI/releases/tag/2.0.7

2.0.7
AU PAYROLL
Add enums for LeaveLineCalculation Type

ACCOUNTING
All date add

All date-time add
example
-readOnly=true

All HasAttachments add
default: "false"
example: "false"

CreditNote
Add property StatusAttributeString

2.0.6
ACCOUNTING

updateEmployee singular not supported by API - removed
Add getQuotesAsPDF
ASSETS

enums capitalized for assets status
AssetStatus component added

3.5.0

16 Mar 20:53
800bea8

Choose a tag to compare

Build off OpenAPI Spec v 2.0.5
https://github.com/XeroAPI/Xero-OpenAPI/releases/tag/2.0.5

ACCOUNTING

  • Change deletePayment method to accept a default PaymentDelete object that has a single property - status with a default value of "DELETED"

Missing ENUM ARPREPAYMENT added to Invoice Type

PROJECTS
ProjectsApi (plural) replaced with ProjectApi class

PAYROLL AU

  • Official support for AU Payroll added
  • Unit tests written
  • All Dates are in MS DateFormat - for this reason they are typed as Strings.

Each date has an additional getter in the model that returns the native date. Use getXXXXDateAsDate() to retrieve Java dates.

i.e. getStartDateAsDate() returns native date 2019-11-12 or datetime 2019-11-12T21:05:24.755-08:00

i.e. getStartDate() returns a string /Date(322560000000+0000)/

StringUtil

  • convertStringToDate method added
  • convertStringToDateTime method added

These are based off the CustomDateDeserializer code

PaySlip and PayItem create operation does NOT return an empty JSON object - this is a known issue with the API and is not an problem with the SDK.

3.4.0

05 Mar 05:52
ca40b73

Choose a tag to compare

Update based on OAS version 2.0.3
https://github.com/XeroAPI/Xero-OpenAPI/releases/tag/2.0.3

PurchaseOrder
Add operation for getPurchaseOrderByNumber

AppliedAmount property added to the following models
CreditNote
Prepayment
Overpayment

Update projects - add misisng getTask operation
Unit tests for Projects API added

Add getTask by ID and return a single task
Add missing "description" property from Task model

3.3.2

29 Feb 04:19
cd4c771

Choose a tag to compare

This release is based off changes in OAS 2.0.2
https://github.com/XeroAPI/Xero-OpenAPI/releases/tag/2.0.2

3.3.1

19 Feb 19:22
1395f02

Choose a tag to compare

Release based on changes in OpenAPI spec.

See release notes
https://github.com/XeroAPI/Xero-OpenAPI/releases/tag/2.0.1