Xero (Xero v1.0.0)

A complete, production-grade Elixir client for all 13 Xero APIs.

Supported APIs

Module	API
`Xero.Accounting.*`	Accounting API (invoices, contacts, payments, reports, …)
`Xero.Assets`	Fixed asset management
`Xero.BankFeeds`	Push bank statement data
`Xero.Files`	Document and attachment management
`Xero.Finance`	Financial statements for lending
`Xero.Projects`	Project time and cost tracking
`Xero.Payroll.AU`	Australian payroll
`Xero.Payroll.NZ`	New Zealand payroll
`Xero.Payroll.UK`	UK payroll and HMRC
`Xero.PracticeManager`	Accounting practice management
`Xero.AppStore`	Subscription and billing management
`Xero.EInvoicing`	PEPPOL-compliant e-invoicing

Quick Start

# 1. Configure
config :xero,
  client_id: System.fetch_env!("XERO_CLIENT_ID"),
  client_secret: System.fetch_env!("XERO_CLIENT_SECRET"),
  redirect_uri: "https://yourapp.com/oauth/callback",
  scopes: ~w(openid profile email offline_access accounting.transactions accounting.contacts)

# 2. Generate the auth URL
{:ok, url, state} = Xero.Auth.authorize_url()

# 3. Exchange the callback code for tokens
{:ok, tokens} = Xero.Auth.fetch_token(code)

# 4. List connected tenants
{:ok, [tenant | _]} = Xero.Auth.connections(tokens)

# 5. Make API calls
{:ok, result} = Xero.Accounting.Invoices.list(tokens, tenant.tenant_id, page: 1)

Summary

Functions

version()

Returns the library version.

Functions

version()

@spec version() :: String.t()

Returns the library version.