xero-ruby 1.2.0 → 2.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b7e332228c5727298e0b8c261d41c8045836097801b3394df3e4162113ddcac1
-  data.tar.gz: f140c421f16483696de6b103c9a56abdb38719174a11ac8d64aa14bf3c29a41b
+  metadata.gz: 50e381e3e8975dd61f56fa2607644c0cdcdb5f726e6f87a72d0a7226a68ac366
+  data.tar.gz: c93ed7a03a843e4afd2edf231c06b65acfe8d0fe9d0fafeaafd7f4bfbff5c4f9
 SHA512:
-  metadata.gz: 23448878790a25e553a847cab323c44b8588d18bd365a5dd0c9f32fefad1c38cdad24647fbd84935c4d75e15d725829ba8a12072561615c1ff90635b69ce098c
-  data.tar.gz: a63e52f263263545f63e1b402ffb29d1ada1d5dff9bdb7ccc9ba0a728458d8e18643f144590f41948f356b9b00b32135a00e06aefe4bc57cbddb41efc5876c7d
+  metadata.gz: b8293bbec6977ebf1f596e6c79b951b3d8751755fee5fb694e292580640f76d590e5a51b632a151657dc0534ee05bba85b4c37576be1ed91fb1195cf95b568ef
+  data.tar.gz: 1066cb551c1431139e3d2efd3a63235c527198e6fe3f07819cad9f77234f7644e1a3387c2af187f0182baa4f1da7205fbb69e8181643275d3087e2b771b903bc

data/README.md

@@ -1,32 +1,43 @@
 # xero-ruby
-Xero Ruby SDK for OAuth 2.0 generated from [Xero API OpenAPI Spec](https://github.com/XeroAPI/Xero-OpenAPI)
+Xero Ruby SDK for OAuth 2.0 generated from [Xero API OpenAPI Spec](https://github.com/XeroAPI/Xero-OpenAPI).
 
 [![RubyGem](https://img.shields.io/badge/xero--ruby%20gem-v0.2.4-brightgreen)](https://rubygems.org/gems/xero-ruby)
 
-## Current release of SDK with OAuth 2.0 support
-Xero Ruby SDK supports Xero's OAuth2.0 authentication (token generation & refresh) and supports the following Xero API sets.
-* [accounting](https://developer.xero.com/documentation/api/api-overview)
-* [assets](https://developer.xero.com/documentation/assets-api/overview)
+# Documentation
+Xero Ruby SDK supports Xero's OAuth2.0 authentication and supports the following Xero API sets.
 
-Coming soon
-* bank feeds
-* payroll (AU))
+## APIS
+* [Accounting Api Docs](/docs/accounting/AccountingApi.md)
+* [Asset Api Docs](/docs/assets/AssetApi.md)
+* [Project Api Docs](docs/projects/ProjectApi.md)
+
+## Models
+* [Accounting Models Docs](/docs/accounting/)
+* [Asset Models Docs](/docs/assets/)
+* [Project Models Docs](/docs/projects/)
+
+### Coming soon
+* payroll (AU)
 * payroll (NZ/UK)
 * files
-* projects
 * xero hq
+* bank feeds
+
+## Sample Apps
+We have two apps showing SDK usage.
+* https://github.com/XeroAPI/xero-ruby-oauth2-starter (**Sinatra** - session based / getting started)
+* https://github.com/XeroAPI/xero-ruby-oauth2-app (**Rails** - token management / full examples)
 
 ## Looking for OAuth 1.0a support?
-Check out the [Xeroizer](https://github.com/waynerobinson/xeroizer) gem (maintained by community)
+Check out the [Xeroizer](https://github.com/waynerobinson/xeroizer) gem (maintained by community).
 
 ---
 ## Installation
-This SDK is published as a gem on RubyGems as [xero-ruby](https://rubygems.org/gems/xero-ruby) To install this gem to your current gemset, run:
-
+To install this gem to your current gemset.
 ```
 gem install 'xero-ruby'
 ```
-Or, add this to your gemfile:
+Or add to your gemfile and run `bundle install`.
 ```
 gem 'xero-ruby'
 ```
@@ -36,16 +47,12 @@ gem 'xero-ruby'
 * Login to your Xero developer [/myapps](https://developer.xero.com/myapps) dashboard & create an API application and note your API app's credentials.
 
 ### Creating a Client
-Require the gem:
+* Get the credential values from an API application at https://developer.xero.com/myapps/.
+* Include [neccesary scopes](https://developer.xero.com/documentation/oauth2/scopes) as comma seperated list
+    * example => "`openid profile email accounting.transactions accounting.settings`"
 ```
 require 'xero-ruby'
 ```
-Then create a client by passing in a named hash object `credentials:`.
-
-> *client_id*, *client_secret*, *redirect_uri*: Get this from your API application in /myapps dashboard.
-  *scopes*: Include scopes as comma seperated list, https://developer.xero.com/documentation/oauth2/scopes
-  **ex:** 'openid profile email accounting.transactions'
-
 ```ruby
 creds = {
   client_id: ENV['CLIENT_ID'],
@@ -56,48 +63,63 @@ creds = {
 xero_client ||= XeroRuby::ApiClient.new(credentials: creds)
 ```
 
-## Authorization & Callback
-All API requests require a valid access token to be set on the client. If this is the first time you are calling the Xero API on a users behalf you will need to generate an authorized token set, which will look something like this:
-```json
-{
-  "id_token": "xxx.yyy.zz",
-  "access_token": "xxx.yyy.zzz",
-  "expires_in": 1800,
-  "token_type": "Bearer",
-  "refresh_token": "xxxxxx",
-  "scope": "email profile openid accounting.transactions offline_access"
-}
-```
+## User Authorization & Callback
+All API requests require a valid access token to be set on the client.
 
-To generate a valid token_set with this SDK from Xero, have your user follow the authorization url:
+To generate a valid `token_set` send a user to the `authorization_url`:
 ```ruby
 @authorization_url = xero_client.authorization_url
-# https://login.xero.com/identity/connect/authorize?response_type=code&client_id=<xxx>&redirect_uri=<redirect_uri>&scope=<scopes>
+
+redirect_to @authorization_url
 ```
 
-> The `get_token_set_from_callback` method will set the `token_set` on the client, however you can also initialize a client and set the `token_set` explicitely using `set_token_set` or `refresh_token_set`.
+Xero will then redirect back to the URI defined in your ENV['REDIRECT_URI'] variable.
+*This must match **exactly** with the variable in your /myapps dashboard.*
 
+In your callback route catch, calling `get_token_set_from_callback` will exchange the temp code in your params, with a valid `token_set` that you can use to make API calls.
 ```ruby
-# /my-redirect-uri
+# => http://localhost:3000/oauth/callback
+
 token_set = xero_client.get_token_set_from_callback(params)
 
-# this is where you will want to save the token set for future API usage..
-# ex: user.update!(xero_token_set: token_set)
+# save token_set JSON in a datastore in relation to the user authentication
+```
 
-# if you already saved a token_set you don't need the user to authenticate via UI
-# and can just set the token on the client by refreshing it.
+## Making API calls once you have a token_set
+For use outside of the initial auth flow, setup the client by passing the whole token_set to `refresh_token_set` or `set_token_set`.
+```ruby
 xero_client.refresh_token_set(user.token_set)
+
+xero_client.set_token_set(user.token_set)
 ```
+A `token_set` contains data about your API connection most importantly :
+* `access_token`
+* `refresh_token`
+* `expiry`
 
-## Token & SDK Helpers
+**An `access_token` is valid 30 minutes and a `refresh_token` is valid for 60 days**
 
-Token Sets contain information about your API connection, but most important are the access_token, refresh_token, and the expiry:
-* An `access_token` is valid 30 minutes and a `refresh_token` is valid for 60 days
+Example Token set:
+> You can decode the `id_token` & `access_token` for additional metadata by using a [decoding library](https://github.com/jwt/ruby-jwt):
+```json
+{
+  "id_token": "xxx.yyy.zz",
+  "access_token": "xxx.yyy.zzz",
+  "expires_in": 1800,
+  "token_type": "Bearer",
+  "refresh_token": "xxxxxx",
+  "scope": "email profile openid accounting.transactions offline_access"
+}
+```
 
+## Token & SDK Helpers
+Refresh/connection helpers
 ```ruby
 @token_set = xero_client.refresh_token_set(user.token_set)
 
-# TIP: the `updatedDateUtc` will show you the most recently authorized Tenant (AKA Organisation)
+# Xero's tokens can potentially facilitate (n) org connections in a single token. It is important to store the `tenantId` of the Organisation your user wants to read/write data.
+
+# The `updatedDateUtc` will show you the most recently authorized Tenant (AKA Organisation)
 connections = xero_client.connections
 [{
   "id" => "xxx-yyy-zzz",
@@ -108,57 +130,144 @@ connections = xero_client.connections
   "updatedDateUtc" => "2020-04-15T22:37:10.4943410"
 }]
 
-# disconnect an org from a user's connections. Pass the connection ['id'] not ['tenantId'].
+# disconnect an org from a user's connections. Pass the connection ['id'] not ['tenantId']. Useful if you want to enforce only a single org connection per token.
 remaining_connections = xero_client.disconnect(connections[0]['id'])
 
-# set token_set
+# set a refreshed token_set
 token_set = xero_client.set_token_set(user.token_set)
 
-# access token_set
+# access token_set once it is set on the client
 token_set = xero_client.token_set
 ```
 
+Example token expiry helper
+```ruby
+require 'jwt'
+
+def token_expired?
+  token_expiry = Time.at(decoded_access_token['exp'])
+  token_expiry > Time.now
+end
+
+def decoded_access_token
+  JWT.decode(token_set['access_token'], nil, false)[0]
+end
+```
+
 ## API Usage
 ```ruby
   require 'xero-ruby'
 
-  # reference `Authorization & Callback` to first store a valid token_set on the `xero_client`
   xero_client.refresh_token_set(user.token_set)
 
-  # Accounting API set (https://github.com/XeroAPI/xero-ruby/blob/master/accounting/lib/xero-ruby/api/accounting_api.rb)
-  invoices = xero_client.accounting_api.get_invoices(user.active_tenant_id).invoices
-  accounts = xero_client.accounting_api.get_accounts(user.active_tenant_id).accounts
-  contacts = xero_client.accounting_api.get_contacts(user.active_tenant_id).contacts
+  tenant_id = user.active_tenant_id
+  # example of how to store the `tenantId` of the specific tenant (aka organisation)
+
+  # https://github.com/XeroAPI/xero-ruby/blob/master/accounting/lib/xero-ruby/api/accounting_api.rb
+  
+  # Get Accounts
+  accounts = xero_client.accounting_api.get_accounts(tenant_id).accounts
+
+  # Create Invoice
+  invoices = { invoices: [{ type: XeroRuby::Accounting::Invoice::ACCREC, contact: { contact_id: contacts[0].contact_id }, line_items: [{ description: "Big Agency", quantity: BigDecimal("2.0"), unit_amount: BigDecimal("50.99"), account_code: "600", tax_type: XeroRuby::Accounting::TaxType::NONE }], date: "2019-03-11", due_date: "2018-12-10", reference: "Website Design", status: XeroRuby::Accounting::Invoice::DRAFT }]}
+  invoice = xero_client.accounting_api.create_invoices(tenant_id, invoices).invoices.first
+
+  # Create History
+  payment = xero_client.accounting_api.get_payments(tenant_id).payments.first
+  history_records = { history_records: [{ details: "This payment now has some History!" }]}
+  payment_history = xero_client.accounting_api.create_payment_history(tenant_id, payment.payment_id, history_records)
 
-  # Asset API set (https://github.com/XeroAPI/xero-ruby/blob/master/accounting/lib/xero-ruby/api/asset_api.rb)
+  # Create Attachment
+  account = xero_client.accounting_api.get_accounts(tenant_id).accounts.first
+  file_name = "an-account-filename.png"
+  opts = {
+    include_online: true
+  }
+  file = File.read(Rails.root.join('app/assets/images/xero-api.png'))
+  attachment = xero_client.accounting_api.create_account_attachment_by_file_name(tenant_id, @account.account_id, file_name, file, opts)
+
+  # https://github.com/XeroAPI/xero-ruby/blob/master/accounting/lib/xero-ruby/api/asset_api.rb
+  
+  # Create Asset
   asset = {
     "assetName": "AssetName: #{rand(10000)}",
     "assetNumber": "Asset: #{rand(10000)}",
     "assetStatus": "DRAFT"
   }
-  asset = xero_client.asset_api.create_asset(current_user.active_tenant_id, asset)
+  asset = xero_client.asset_api.create_asset(tenant_id, asset)
+
+  # https://github.com/XeroAPI/xero-ruby/blob/master/docs/projects/ProjectApi.md
+
+  # Get Projects
+  projects = xero_client.project_api.get_projects(tenant_id).items
 ```
 
-If you have use cases outside of these examples or this readmy, please let us know!
+## BigDecimal
+All monetary and fields and a couple quantity fields utilize BigDecimal
+```ruby
+  puts invoice.unit_amount
+  => 0.2099e2
+  
+  puts invoice.unit_amount.class 
+  => BigDecimal
 
-## Sample App
-The best resource to understanding how to best leverage this SDK is to clone down our Sample Rails application which showcases all the features of this project. The sample app can help you quickly understand how to:
-> https://github.com/XeroAPI/xero-ruby-oauth2-app
+  puts invoice.unit_amount.to_s("F")
+  => "20.99"
 
-* Complete the OAuth2.0 Authorization flow
-* Store token_sets against a user object in a DB
-* Storing info about active connections
-* Change the active tenant & make api calls to multiple orgs
-* Refreshing your token sets
-* Decoding your token_set items and strategy around how/when to refresh
-* Disconnecting a connection for a user
+  # Rails method-number_to_currency
+  number_to_currency(invoice.unit_amount, :unit => "$")
+```
 
-## Additional Documentation for API Endpoints
+## Querying & Filtering
+Examples for the `opts` (_options_) parameters most endpoints support.
+```ruby
+# Invoices
+opts = { 
+  statuses: [XeroRuby::Accounting::Invoice::PAID],
+  where: { amount_due: '=0' },
+  if_modified_since: (DateTime.now - 1.hour).to_s
+}
+xero_client.accounting_api.get_invoices(tenant_id, opts).invoices
+
+# Contacts 
+opts = {
+  if_modified_since: (DateTime.now - 1.weeks).to_s,
+  order: 'UpdatedDateUtc DESC',
+  where: {
+    is_customer: '==true',
+    is_supplier: '==true',
+  }
+}
+xero_client.accounting_api.get_contacts(tenant_id, opts).contacts
+
+# Bank Transactions
+opts = {
+  if_modified_since: (DateTime.now - 1.year).to_s,
+  where: { type: %{=="#{XeroRuby::Accounting::BankTransaction::SPEND}"}},
+  order: 'UpdatedDateUtc DESC',
+  page: 2,
+  unitdp: 4 # (Unit Decimal Places)
+}
+xero_client.accounting_api.get_bank_transactions(tenant_id, opts).bank_transactions
+
+# Bank Transfers
+opts = {
+  where: {
+    amount: "> 999.99"
+  },
+  order: 'Amount ASC'
+}
+xero_client.accounting_api.get_bank_transfers(tenant_id, opts).bank_transfers
+```
+### NOTE
+1) Not all `opts` parameter combinations are available for all endpoints, and there are likely some undiscovered edge cases. If you encounter a filter / sort / where clause that seems buggy open an issue and we will dig.
 
-### APIS
-* [Accounting Api Docs](/docs/accounting/AccountingApi.md)
-* [Asset Api Docs](/docs/assets/AssetApi.md)
+2) Some opts string values may need PascalCasing to match casing defined in our [core API docs](https://developer.xero.com/documentation/api/api-overview).
+    * `opts = { order: 'UpdatedDateUtc DESC'}`
 
-## Models
-* [Accounting Models Docs](/docs/accounting/)
-* [Asset Models Docs](/docs/assets/)
+3) If you have use cases outside of these examples let us know.
+
+## Sample App
+The best resource to understanding how to best leverage this SDK is the sample applications showing all the features of the gem.
+> https://github.com/XeroAPI/xero-ruby-oauth2-starter (Sinatra - simple getting started)
+> https://github.com/XeroAPI/xero-ruby-oauth2-app (Rails - full featured examples)

data/build_notes.md

@@ -0,0 +1,52 @@
+# Developing gem locally
+
+> xero-ruby
+```bash
+gem build
+mv xero-ruby-<vsn>.gem xero-ruby.gem
+```
+
+> xero-ruby-oauth2-app
+Replace gem file with local path:
+```bash
+gem 'xero-ruby', path: '/Users/chris.knight/code/sdks/xero-ruby/'
+bundle install
+```
+
+# Deploying to Rubygems
+
+```bash
+gem build
+gem push xero-ruby-<vsn>.gem 
+```
+
+# manual updates
+account.rb 
+```ruby
+# duplicate definitions generated: https://github.com/XeroAPI/xero-ruby/issues/53#issuecomment-668893305
+# EMPTY = "".freeze
+```
+
+organisation.rb
+```ruby
+# duplicate definitions generated: https://github.com/XeroAPI/xero-ruby/issues/53#issuecomment-668893305
+# NONE = "NONE".freeze
+
+# duplicate definitions generated: https://github.com/XeroAPI/xero-ruby/issues/53#issuecomment-668893305
+# ACCOUNTING_PRACTICE = "ACCOUNTING_PRACTICE".freeze
+# COMPANY = "COMPANY".freeze
+# CHARITY = "CHARITY".freeze
+# CLUB_OR_SOCIETY = "CLUB_OR_SOCIETY".freeze
+# LOOK_THROUGH_COMPANY = "LOOK_THROUGH_COMPANY".freeze
+# NOT_FOR_PROFIT = "NOT_FOR_PROFIT".freeze
+# PARTNERSHIP = "PARTNERSHIP".freeze
+# S_CORPORATION = "S_CORPORATION".freeze
+# SELF_MANAGED_SUPERANNUATION_FUND = "SELF_MANAGED_SUPERANNUATION_FUND".freeze
+# SOLE_TRADER = "SOLE_TRADER".freeze
+# SUPERANNUATION_FUND = "SUPERANNUATION_FUND".freeze
+# TRUST = "TRUST".freeze
+```
+
+# Debugging in mustache templates + open api generator
+{{{this}}}
+{{{.}}}

data/docs/accounting/Account.md

@@ -47,7 +47,7 @@ instance = XeroRuby::Accounting::Account.new(code: 4400,
                                  reporting_code: null,
                                  reporting_code_name: null,
                                  has_attachments: false,
-                                 updated_date_utc: null,
+                                 updated_date_utc: /Date(1573755038314)/,
                                  add_to_watchlist: null,
                                  validation_errors: null)
 ```

data/docs/accounting/AccountingApi.md

@@ -6,7 +6,7 @@ Method | HTTP request | Description
 ------------- | ------------- | -------------
 [**create_account**](AccountingApi.md#create_account) | **PUT** /Accounts | Allows you to create a new chart of accounts
 [**create_account_attachment_by_file_name**](AccountingApi.md#create_account_attachment_by_file_name) | **PUT** /Accounts/{AccountID}/Attachments/{FileName} | Allows you to create Attachment on Account
-[**create_bank_transaction_attachment_by_file_name**](AccountingApi.md#create_bank_transaction_attachment_by_file_name) | **PUT** /BankTransactions/{BankTransactionID}/Attachments/{FileName} | Allows you to createa an Attachment on BankTransaction by Filename
+[**create_bank_transaction_attachment_by_file_name**](AccountingApi.md#create_bank_transaction_attachment_by_file_name) | **PUT** /BankTransactions/{BankTransactionID}/Attachments/{FileName} | Allows you to create an Attachment on BankTransaction by Filename
 [**create_bank_transaction_history_record**](AccountingApi.md#create_bank_transaction_history_record) | **PUT** /BankTransactions/{BankTransactionID}/History | Allows you to create history record for a bank transactions
 [**create_bank_transactions**](AccountingApi.md#create_bank_transactions) | **PUT** /BankTransactions | Allows you to create one or more spend or receive money transaction
 [**create_bank_transfer**](AccountingApi.md#create_bank_transfer) | **PUT** /BankTransfers | Allows you to create a bank transfers
@@ -186,7 +186,7 @@ Method | HTTP request | Description
 [**get_users**](AccountingApi.md#get_users) | **GET** /Users | Allows you to retrieve users
 [**update_account**](AccountingApi.md#update_account) | **POST** /Accounts/{AccountID} | Allows you to update a chart of accounts
 [**update_account_attachment_by_file_name**](AccountingApi.md#update_account_attachment_by_file_name) | **POST** /Accounts/{AccountID}/Attachments/{FileName} | Allows you to update Attachment on Account by Filename
-[**update_bank_transaction**](AccountingApi.md#update_bank_transaction) | **POST** /BankTransactions/{BankTransactionID} | 
+[**update_bank_transaction**](AccountingApi.md#update_bank_transaction) | **POST** /BankTransactions/{BankTransactionID} | Allows you to update a single spend or receive money transaction
 [**update_bank_transaction_attachment_by_file_name**](AccountingApi.md#update_bank_transaction_attachment_by_file_name) | **POST** /BankTransactions/{BankTransactionID}/Attachments/{FileName} | Allows you to update an Attachment on BankTransaction by Filename
 [**update_bank_transfer_attachment_by_file_name**](AccountingApi.md#update_bank_transfer_attachment_by_file_name) | **POST** /BankTransfers/{BankTransferID}/Attachments/{FileName} | 
 [**update_contact**](AccountingApi.md#update_contact) | **POST** /Contacts/{ContactID} | 
@@ -360,7 +360,7 @@ Name | Type | Description  | Notes
 
 > Attachments create_bank_transaction_attachment_by_file_name(xero_tenant_id, bank_transaction_id, file_name, body)
 
-Allows you to createa an Attachment on BankTransaction by Filename
+Allows you to create an Attachment on BankTransaction by Filename
 
 ### Example
 
@@ -394,7 +394,7 @@ bank_transaction_id = '00000000-0000-0000-000-000000000000' # String | Xero gene
 file_name = 'xero-dev.jpg' # String | The name of the file being attached
 body = 'body_example' # String | Byte array of file in body of request
 begin
-  #Allows you to createa an Attachment on BankTransaction by Filename
+  #Allows you to create an Attachment on BankTransaction by Filename
   result = api_instance.create_bank_transaction_attachment_by_file_name(xero_tenant_id, bank_transaction_id, file_name, body)
   p result
 rescue XeroRuby::Accounting::ApiError => e
@@ -1132,7 +1132,7 @@ api_instance = xero_client.accounting_api
 api_instance = xero_client.asset_api
 # :projects_api
 api_instance = xero_client.projects_api
-contacts = { contacts: [{ contactID: "a3675fc4-f8dd-4f03-ba5b-f1870566bcd7" }, { contactID: "4e1753b9-018a-4775-b6aa-1bc7871cfee3" }]}
+contacts = { contacts: [{ contact_id: "a3675fc4-f8dd-4f03-ba5b-f1870566bcd7" }, { contact_id: "4e1753b9-018a-4775-b6aa-1bc7871cfee3" }]}
 
 begin
   #Allows you to add Contacts to a Contact Group
@@ -1305,7 +1305,7 @@ Name | Type | Description  | Notes
 
 ## create_credit_note_allocation
 
-> Allocations create_credit_note_allocation(xero_tenant_id, credit_note_id, allocations)
+> Allocations create_credit_note_allocation(xero_tenant_id, credit_note_id, allocations, opts)
 
 Allows you to create Allocation on CreditNote
 
@@ -1336,9 +1336,13 @@ api_instance = xero_client.asset_api
 api_instance = xero_client.projects_api
 allocations = { allocations: [{ amount: 1.0, date: "2019-03-05", invoice: { invoice_id: "c45720a1-ade3-4a38-a064-d15489be6841", line_items: [], type: XeroRuby::Accounting::Invoice::ACCPAY, contact: {} }}]}
 
+opts = {
+  summarize_errors: false # Boolean | If false return 200 OK and mix of successfully created obejcts and any with validation errors
+}
+
 begin
   #Allows you to create Allocation on CreditNote
-  result = api_instance.create_credit_note_allocation(xero_tenant_id, credit_note_id, allocations)
+  result = api_instance.create_credit_note_allocation(xero_tenant_id, credit_note_id, allocations, opts)
   p result
 rescue XeroRuby::Accounting::ApiError => e
   puts "Exception when calling AccountingApi->create_credit_note_allocation: #{e}"
@@ -1353,6 +1357,7 @@ Name | Type | Description  | Notes
  **xero_tenant_id** | **String**| Xero identifier for Tenant | 
  **credit_note_id** | [**String**](.md)| Unique identifier for a Credit Note | 
  **allocations** | [**Allocations**](Allocations.md)| Allocations with array of Allocation object in body of request. | 
+ **summarize_errors** | **Boolean**| If false return 200 OK and mix of successfully created obejcts and any with validation errors | [optional] [default to false]
 
 ### Return type
 
@@ -12874,9 +12879,9 @@ Name | Type | Description  | Notes
 
 ## update_bank_transaction
 
-> BankTransactions update_bank_transaction(xero_tenant_id, bank_transactions)
-
+> BankTransactions update_bank_transaction(xero_tenant_id, bank_transaction_id, bank_transactions, opts)
 
+Allows you to update a single spend or receive money transaction
 
 ### Example
 
@@ -12903,10 +12908,15 @@ api_instance = xero_client.accounting_api
 api_instance = xero_client.asset_api
 # :projects_api
 api_instance = xero_client.projects_api
-{ bank_transactions: [{ type: XeroRuby::Accounting::BankTransaction::SPEND, date: "2019-02-25", reference: "You just updated", status: XeroRuby::Accounting::BankTransaction::AUTHORISED, bank_transaction_id: "00000000-0000-0000-000-000000000000", line_items: [], contact: {}, bank_account: { account_id: "00000000-0000-0000-000-000000000000" }}]} summary: Allows you to update a single spend or receive money transaction parameters: - required: true in: path name: BankTransactionID description: Xero generated unique identifier for a bank transaction example: "00000000-0000-0000-000-000000000000" schema: type: string format: uuid - $ref: 
+{ bank_transactions: [{ type: XeroRuby::Accounting::BankTransaction::SPEND, date: "2019-02-25", reference: "You just updated", status: XeroRuby::Accounting::BankTransaction::AUTHORISED, bank_transaction_id: "00000000-0000-0000-000-000000000000", line_items: [], contact: {}, bank_account: { account_id: "00000000-0000-0000-000-000000000000" }}]}
+
+opts = {
+  unitdp: 4 # Integer | e.g. unitdp=4 – (Unit Decimal Places) You can opt in to use four decimal places for unit amounts
+}
 
 begin
-  result = api_instance.update_bank_transaction(xero_tenant_id, bank_transactions)
+  #Allows you to update a single spend or receive money transaction
+  result = api_instance.update_bank_transaction(xero_tenant_id, bank_transaction_id, bank_transactions, opts)
   p result
 rescue XeroRuby::Accounting::ApiError => e
   puts "Exception when calling AccountingApi->update_bank_transaction: #{e}"
@@ -12919,7 +12929,9 @@ end
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
  **xero_tenant_id** | **String**| Xero identifier for Tenant | 
+ **bank_transaction_id** | [**String**](.md)| Xero generated unique identifier for a bank transaction | 
  **bank_transactions** | [**BankTransactions**](BankTransactions.md)|  | 
+ **unitdp** | **Integer**| e.g. unitdp=4 – (Unit Decimal Places) You can opt in to use four decimal places for unit amounts | [optional] 
 
 ### Return type