All Versions
Latest Version
Avg Release Cycle
168 days
Latest Release
1702 days ago

Changelog History

  • v2.20.0 Changes

    October 17, 2019

    ๐Ÿ”„ Changes

    ๐Ÿ› Bug fixes

    • ๐Ÿ‘‰ Make sure we can convert to BigDecimal with discount_amount (@jasonheecs)

    ๐Ÿ“„ Docs

    • #491 Add example for fetching ProfitAndLoss using date range (@dcrtantuco)
    • #487 Document how to provide a private key directly (@matt17r)
    • โšก๏ธ #476 Update comment about nonce being used (@austinmckinley)
  • v2.19.0 Changes

    July 05, 2019

    ๐Ÿ”„ Changes

  • v2.18.1 Changes

    March 07, 2018

    "Never say goodbye because goodbye means going away and going away means forgetting" - Peter Pan

    โฌ†๏ธ Wrong. Peter obviously never had to upgrade his TLS version. You can forget all about TLS 1.0, forever. I promise. It's going away, and it's never coming back.

    ๐Ÿš€ A big thank you to all those that contributed to this release: @nnc @stellard @dhurba87 @pareeohnos

    ๐Ÿ‘ And a big shoutout to @CloCkWeRX for his continued support in maintaining the repo.

    ๐Ÿš€ Important notes on this release

    ๐Ÿ—„ Xero is deprecating support for TLS 1.0. You must use TLS 1.1 or TLS 1.2 (1.2 suggested) for requests to the Xero API. For most ruby users, no changes will be required. Tests have been added to the gem to test which version of TLS your application is using. For more information on the deprecation of TLS 1.0 please see this notification:

    ๐Ÿ”„ Changes to Save Method

    Important: A save! method has been added, and changes have been made to the save method to bring it in line with how these functions work in ActiveRecord.

    ๐Ÿ’พ save : Will return true/false. This function will not raise an exception if there is a validation error.
    ๐Ÿ’พ save! : Will raise an exception if it does not succeed, ie: if there is a validation error.

    If you're unclear, take a look at the code changes: 3b6485c

    Some other highlights

    Online Invoice URL:

    The online invoice url for an invoice has now been exposed via the gem. OnlineInvoice has been implemented as it's own model as it could have additional features exposed in the future, and it requires an additional API call to retrieve the details.

    Example usage:

    @invoice = client.Invoice.all(:where =\> 'Type=="ACCREC"')[email protected]\\_invoice\_url=\> ""

    GET invoices createdByMyApp

    ๐Ÿ‘Œ Support for the createdByMyApp param has been added to the gem. This param is only applicable to the invoices endpoint. Setting this param to true will retrieve only invoices that have been created by your application.

    โž• Add Currency

    ๐Ÿ“š You can now add (subscribe) a new currency to a Xero org. Note: You can not create new currencies, only subscribe the org to a currency that Xero already supports.
    ๐Ÿ‘€ For more details see:

    โž• Added save! method

    ๐Ÿ‘ป The gem now supports save & save! The save method still returns true/false, the save! will raise a exception if the save is not successful.

  • v2.18.0

    March 07, 2018
  • v2.17.0 Changes

    October 19, 2017

    ๐Ÿ‘ Big thanks to @waynerobinson for his support on this SDK historically. Thanks to @CloCkWeRX for taking on the reigns over the past 6 months. And everyone else who pushed a commit for this new version: @kushalsinghbajra @chrisgreen1993 @wosigor @danielfone @timrossinfo @CharlesHarley @sktocha @fimmtiu @lonnv @hinammehra

    Some highlights:

    Partner App:

    ๐Ÿ†• New Models / Endpoints:

    • BankTransfers
    • OverPayments
    • InvoiceReminderSettings

    Attachments included for endpoints:

    • CreditNotes
    • ManualJournals
    • Contacts
    • BankTransfers

    RuboCop has been added to the repository.

  • v2.16.5

    December 06, 2016
  • v2.16.4

    March 01, 2016
  • v2.16.3

    March 01, 2016
  • v2.16.2

    October 21, 2015
  • v2.16.1

    August 31, 2015