Skip to content
 


TYPES AND CODES

Below is a detailed list of all the types and codes the Xero API uses:

Accounts

Account Class Types

ASSET
EQUITY
EXPENSE
LIABILITY
REVENUE

Account Types

BANK
CURRENT
CURRLIAB
DEPRECIATN
DIRECTCOSTS
EQUITY
EXPENSE
FIXED
LIABILITY
NONCURRENT
OTHERINCOME
OVERHEADS
PREPAYMENT
REVENUE
SALES
TERMLIAB

Account Status Codes

ACTIVE
ARCHIVED

System Accounts

Accounts Receivable (610)
Accounts Payable (800)
Bank Revaluations(497)
GST(820)
GST On Imports (821)
Historical Adjustment (840)
Realised Currency Gains (499)
Retained Earnings (960)
Rounding (860)
Tracking Transfers (877)
Unpaid Expense Claims (801)
Unrealised Currency Gains (498)

Bank Transactions

Types

RECEIVE
SPEND

Bank Transaction Status Codes

ACTIVE
DELETED

Contacts

Contact Status Codes

ACTIVE
The following value is only supported via the GET method
DELETED

Addresses

Addresses

AddressType
AddressLine 1,2,3,4
City
Region
PostalCode
Country
AttentionTo

Address Types

POBOX (default mailing address for Invoices)
STREET

Phones

Phones

PhoneType
PhoneNumber
PhoneAreaCode
PhoneCountryCode

Phone Types

DEFAULT
DDI
MOBILE
FAX

Invoices

Invoice Types

ACCPAY An Accounts Payable(supplier) invoice
ACCREC An Account Receivable(customer) invoice

Invoice Status Codes

DRAFT A Draft Invoice (default)
SUBMITTED An Awaiting Approval Invoice
DELETED A Deleted Invoice
AUTHORISED An Invoice that is Approved and Awaiting Payment
PAID An Invoice that is completely Paid
VOIDED A Voided Invoice

LineAmount Types

Exclusive Invoice lines are exclusive of tax (default)
Inclusive Invoice lines are inclusive tax
NoTax Invoices lines have no tax

LineItems

Tax Types

New Zealand

TAX TYPE RATE  
INPUT 12.50 GST on Expenses (old rate)
INPUT2 15.00 GST on Expenses
NONE 0.00  
OUTPUT 12.50 GST on Income (old rate)
OUTPUT2 15.00 GST on Income

United Kingdom

TAX TYPE RATE  
CAPEXINPUT 17.50 VAT on Capital Purchases
CAPEXOUTPUT 17.50 VAT on Capital Sales
CAPEXINPUT2 20.00 VAT on Capital Purchases (new rate from 4 Jan 2011)
CAPEXOUTPUT2 20.00 VAT on Capital Sales (new rate from 4 Jan 2011)
ECZRINPUT 0.00  
ECZROUTPUT 0.00  
EXEMPTINPUT 0.00  
EXEMPTOUTPUT 0.00  
INPUT 17.50 VAT on Expenses
INPUT2 20.00 VAT on Expenses (new rate from 4 Jan 2011)
NONE 0.00  
OUTPUT 17.50 VAT on Income
OUTPUT2 20.0 VAT on Income (new rate from 4 Jan 2011)
RRINPUT 5.00  
RROUTPUT 5.00  
SRINPUT 15.00 VAT on Expenses(old rate)
SROUTPUT 15.00 VAT on Income(old rate)
ZERORATEDINPUT 0.00  
ZERORATEDOUTPUT 0.00  

Australia

TAX TYPE RATE  
CAPEXINPUT 10.00  
EXEMPTEXPORT 0.00  
EXEMPTINPUT 0.00  
EXEMPTOUTPUT 0.00  
INPUT 10.00 GST on Expenses
INPUTTAXED 0.00  
NONE 0.00  
OUTPUT 10.00 GST on Income

Global

TAX TYPE RATE  
INPUT 0.00 Tax on Expenses
NONE 0.00  
OUTPUT 0.00 Tax on Income

New tax rates can be setup for a Xero organisation. All new tax rates added have a TaxType of the format TAX001, TAX002 etc.

Credit Notes

Credit Note Types

ACCPAYCREDIT An Accounts Payable(supplier) Credit Note
ACCRECCREDIT An Account Receivable(customer) Credit Note

All other types are identical to Invoices.

User Roles

Xero User Roles

READONLY Read only user – Further info
INVOICEONLY Invoice only user – Further info
STANDARD Standard user – Further info
FINANCIALADVISER Financial adviser role – Further info
MANAGEDCLIENT Managed client role (Partner Edition only) – Further info
CASHBOOKCLIENT Cashbook client role (Partner Edition only) – Further info