# Xero

> Cloud accounting software for small businesses

Xero holds your accounting, contacts, invoices, bank transactions and, for Australian organisations, payroll records.

Filament syncs those records into your warehouse and reconstructs a monthly profit-and-loss general ledger for reporting and dashboards.

## Data we sync

- **Monthly general ledger**: Monthly profit-and-loss totals by account, with account codes, types and tracking-category links where activity is assigned. (`journal_date`, `account_code`, `account_type`, `net_amount`)
- **Contacts**: Customers and suppliers with contact details, status, receivable and payable balances, and default account settings. (`contact_id`, `name`, `is_customer`, `is_supplier`)
- **Invoices**: Sales invoices and bills with dates, status, contact, currency, amounts due, paid and credited, and total tax. (`invoice_id`, `type`, `status`, `contact_id`, `total`)
- **Bank transactions**: Spend and receive-money transactions with reconciliation status, bank account, contact, currency and totals. (`bank_transaction_id`, `type`, `date`, `is_reconciled`, `total`)
- **Accounts and tracking**: The chart of accounts, tracking categories and their options, plus organisation details used to interpret reports. (`account_id`, `code`, `type`, `tracking_category_id`)
- **Australian payroll**: Employees, leave applications and their pay-period breakdowns for Australian Xero organisations with payroll provisioned. The connecting user must have payroll access. Leave periods use zero-based positions within each application. (`employee_id`, `leave_application_id`, `leave_period_status`)

## How do I connect Xero?

The person connecting must be able to authorise the organisation and hold Xero’s **reports** role.

1. Open [Apps](https://filamentanalytics.com/apps) in Filament and add **Xero**.
2. Select **Connect to Xero** and authorise your organisation.
3. Choose one, two or five years of initial history.
4. Add any useful account context and complete setup.

Each source uses the first tenant returned by Xero’s consent. Connect each additional organisation separately.
