4.38.0

• Build from OpenAPI v2.40.3

Full Changelog: 4.37.0...4.38.0

4.37.0

Accounting API

• Compliance with new IRAS GST rate of 9% starting 2024

Files API

• Paging parameters have been added to the associations/{objectid} endpoint

4.36.0

All APIs

• Added Idempotency-Key as optional header param for all PUT, POST, PATCH requests

Accounting API

• Updated 1099 report sample JSON response.
• Remove the Contact's SkypeUserName field, from the API.Accouting Contact's endpoints.
• Adds the deletion of allocations to Credit Notes, Prepayments and Overpayments
• Removed random character in getPurchaseOrderAttachmentByFileName
• Removed PAYGLIABILITY, SUPERANNUATIONEXPENSE, SUPERANNUATIONLIABILITY, WAGESEXPENSE from AccountType enum

Payroll AU

• Added two new enum values in LeavePeriodStatus

Finance

• Cash Validation Api now has rate limiting, there is a new response type added to reflect that.

4.35.0

AU Payroll API

New endpoints added for expanding Leave functionality for AU Payroll

• LeaveApplications/v2 GET includes REQUESTED and REJECTED leave applications
• LeaveApplications/{id}/approve allows for approval of REQUESTED leave applications
• LeaveApplications/{id}/reject allows for rejection of REQUESTED or SCHEDULED leave applications
  Added detail to LeaveApplications POST example to indicate expected inclusion of other attributes

Accounting API

Create compliance tax rates

4.34.0

Description

Finance API

• Updates import source description and the example in the BankStatementsPlus Api response doc

Accounting API

• Added all missing currency codes CLF, EEK, LVL, MRO, MXV, SKK, SLE, STD, VES to enum
• Fixed 2023 Reverse Charge tax rates for Singapore

4.33.0

Generates Xero-Node 4.33.0 from Xero-OpenAPI 2.36.0

Description

Files API

• Adds getAssociationsCount method to the Files API

Payroll AU API

• Adds new property PaidLeaveEarnings to the OpeningBalance schema definition
• Adds new property PayOutType to the LeaveApplication and LeaveEarningsLine schema definitions

Release Notes

• getAssociationsCount enables developers to fetch a count of associations for a list of objects. Previously, developers had to call separately for each object.
• https://developer.xero.com/documentation/api/payrollau/stp-changes#opening-balance-paid-leave-earnings
• https://developer.xero.com/documentation/api/payrollau/stp-changes/#cashed-out-leave

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)

4.32.0

Generates Xero-Node 4.32.0 from Xero-OpenAPI 2.35.0

Finance API

• Adds Indicative Balances and Payee to BankStatementsPlus

Payroll AU API

• Adds AllowanceContributesToAnnualLeaveRate and AllowanceContributesToOvertimeRate booleans to EarningsRate model

Payroll UK API

• Update the case in BackPay property of earningsType

Release Notes

• As part of STP2, two new checkboxes were added for allowance pay items.
• Resolves Xero-Ruby #241

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)

4.31.0

XeroClient

• Adds optional configurable httpTimeout
• Adds optional configurable clockTolerance

Release Notes

• Resolves #614, shoutout to @daffron for the PR

const xero = new XeroClient({
  clientId: 'YOUR_CLIENT_ID',
  clientSecret: 'YOUR_CLIENT_SECRET',
  redirectUris: [`http://localhost:${port}/callback`],
  scopes: 'openid profile email accounting.transactions offline_access'.split(" "),
  state: 'returnPage=my-sweet-dashboard', // custom params (optional)
  httpTimeout: 3000, // ms (optional)
  clockTolerance: 10 // seconds (optional)
});

public async initialize(): Promise<XeroClient> {
    if (this.config) {
      custom.setHttpOptionsDefaults({
        retry: {
          maxRetryAfter: this.config.httpTimeout || 3500
        },
        timeout: this.config.httpTimeout || 3500
      })

      const issuer = await Issuer.discover('https://identity.xero.com');
      this.openIdClient = new issuer.Client({
        client_id: this.config.clientId,
        client_secret: this.config.clientSecret,
        redirect_uris: this.config.redirectUris,
      });

      this.openIdClient[custom.clock_tolerance] = this.config.clockTolerance || 5;
    }

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)

4.30.0

Generates Xero-Node 4.30.0 from Xero-OpenAPI 2.33.1

Accounting API

• Adds BatchPayment property in Payment model
• Adds Singapore tax rates for 2023
• Updates CreateBrandingThemePaymentServices method to accept an array of PaymentService objects instead of just one PaymentService object to match API functionality
• Updates data type of IsReconciled property of BatchPayment to boolean.
• Updates data type of TotalAmount property of BatchPayment to decimal

Release Notes

• Resolves Xero-NetStandard #449
• Resolves Xero-NetStandard #453
• Resolves Xero-Node #605

This will result in a small breaking change where any projects currently using the CreateBrandingThemePaymentServices method will need to wrap their PaymentService object in a PaymentServices object like so:

{ "PaymentServices": [ { "PaymentServiceID": "54b3b4f6-0443-4fba-bcd1-61ec0c35ca55", "PaymentServiceName": "PayUpNow", "PaymentServiceUrl": "https://www.payupnow.com/", "PaymentServiceType": "Custom", "PayNowText": "Time To Pay" } ] }

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)

4.29.0

Generates Xero-Node 4.29.0 from Xero-OpenAPI 2.31.0

App Store API

• Adds usage/metered api end points and usage record models for app store. Further details here

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)