Skip to content

Bank Transaction

Use this type to set up a reusable Bank Transaction variable.

TypeSee Bank Transaction Types
ContactSee Contacts
LineitemsSee LineItems. The LineItems element can contain any number of individual LineItem sub-elements.
BankAccountBank account for transaction. See BankAccount
IsReconciledBoolean to show if transaction is reconciled
DateDate of transaction - YYYY-MM-DD
ReferenceReference for the transaction. Only supported for SPEND and RECEIVE transactions.
CurrencyCodeThe currency that bank transaction has been raised in (see Currencies). Setting currency is only supported on overpayments.
CurrencyRateExchange rate to base currency when money is spent or received. e.g. 0.7500 Only used for bank transactions in non base currency. Setting currency is only supported on overpayments.
UrlURL link to a source document - shown as “Go to App Name”
StatusSee Bank Transaction Status Codes
LineAmountTypesSee Line Amount Types
SubTotalTotal of bank transaction excluding taxes
TotalTaxTotal tax on bank transaction
TotalTotal of bank transaction tax inclusive
BankTransactionIDXero generated unique identifier for bank transaction
PrepaymentIDXero generated unique identifier for a Prepayment. This will be returned on BankTransactions with a Type of SPEND-PREPAYMENT or RECEIVE-PREPAYMENT
OverpaymentIDXero generated unique identifier for an Overpayment. This will be returned on BankTransactions with a Type of SPEND-OVERPAYMENT or RECEIVE-OVERPAYMENT
UpdatedDateUTCLast modified date UTC format
HasAttachmentsBoolean to indicate if a bank transaction has an attachment
Elements for Line Items
DescriptionThe description of the line item
QuantityLineItem Quantity
UnitAmountLineitem unit amount. By default, unit amount will be rounded to two decimal places. You can opt in to use four decimal places by adding the querystring parameter unitdp=4 to your query. See the Rounding in Xero guide for more information.
AccountCodeSee Accounts
ItemCodeItemCode can only be present when the Bank Transaction Type is SPEND or RECEIVE.
LineItemIDThe Xero generated identifier for a LineItem.
TaxTypeUsed as an override if the default Tax Code for the selected AccountCode is not correct - see TaxTypes.
LineAmountThe total of the line including discount
TrackingOptional Tracking Category - see Tracking. Any LineItem can have a maximum of 2 TrackingCategory elements.
Elements for Bank Account
CodeBankAccount code (this value may not always be present for a bank account)
AccountIDBankAccount identifier

Xero Developer: Bank Transaction