# Accounting Integration Overview

> **Where to find it:** Settings -> Account -> *Accounting integrations*. Owners, admins and accountants can connect one accounting package per company. Connections are encrypted; invoices sync automatically when created, paid or refunded, and failed syncs are retried automatically and shown in the sync log (with a Retry button).


> **For platform administrators:** provider credentials (the OAuth client ID and secret from each accounting provider's developer portal) are configured in the app at **Administration -> Accounting providers** (`/admin/accounting-providers`). The page shows the exact redirect URI to register, setup steps and a Test button. Secrets are stored encrypted and never shown again. Server environment variables (`XERO_CLIENT_ID` etc.) still work as a fallback; credentials saved in the app take priority. Until a provider is configured, companies see it as "Not available yet".

## What is Accounting Integration?

Accounting integration automatically synchronizes your invoices, customers, and payments from Load Éireann to your accounting software. This eliminates manual double-entry, reduces errors, and saves you valuable time.

## Benefits

### ⏱️ **Save Time**
- **No more double-entry** - Invoices sync automatically
- **Instant updates** - Changes flow in real-time
- **Batch operations** - Multiple invoices sync at once

### ✅ **Reduce Errors**
- **95% fewer mistakes** - No manual typing
- **Automatic validation** - Data verified before sync
- **Audit trail** - Complete history of all syncs

### 💰 **Save Money**
- **No aggregator fees** - Direct integration
- **Free feature** - Included with your subscription
- **Accountant savings** - Less reconciliation time

## Supported Accounting Platforms

We integrate directly with the most popular accounting software used by Irish and UK businesses:

### ![Xero Logo] **Xero**
- **Best for:** Small to medium businesses in IE, UK, AU, NZ
- **Popular in:** Ireland, United Kingdom, Australia, New Zealand
- **Starting at:** €28/month
- **[Set up Xero →](/docs/accounting/xero-setup)**

### ![QuickBooks Logo] **QuickBooks Online**
- **Best for:** Businesses of all sizes globally
- **Popular in:** United States, United Kingdom, Ireland, Canada
- **Starting at:** €12/month
- **[Set up QuickBooks →](/docs/accounting/quickbooks-setup)**

### ![Sage Logo] **Sage Business Cloud**
- **Best for:** UK & Ireland established businesses
- **Popular in:** United Kingdom, Ireland
- **Starting at:** £12/month
- **[Set up Sage →](/docs/accounting/sage-setup)**

### ![FreeAgent Logo] **FreeAgent**
- **Best for:** UK freelancers and micro-businesses
- **Popular in:** United Kingdom
- **Starting at:** £19/month
- **[Set up FreeAgent →](/docs/accounting/freeagent-setup)**

## How It Works

### 1. **Connect Your Account**
Click "Connect" next to your accounting software in Settings → Integrations. You'll be redirected to securely authorize Load Éireann.

### 2. **Automatic Sync**
Once connected, your data syncs automatically:
- **Invoices** sync when you mark them as "Sent" or "Paid"
- **Customers** sync before their first invoice
- **Payments** sync when you record them

### 3. **Monitor & Manage**
View sync history, retry failed syncs, and manage your connection from the Integrations page.

## What Gets Synced?

### ✅ Warehouse Invoices
- Invoice details (number, dates, amounts)
- Line items (descriptions, quantities, prices)
- VAT/tax calculations
- Customer information
- Payment status

### ✅ Load Board Invoices
- Transport service details
- Route information (origin to destination)
- Pricing and VAT
- Shipper/carrier information
- Payment status

### ✅ Customers
- Company name and contact details
- Email and phone number
- Billing address
- VAT/tax number

### ✅ Payments
- Payment amount and date
- Payment method
- Bank reference
- Invoice link

## Security & Privacy

### 🔒 **OAuth2 Authentication**
We use industry-standard OAuth2, the same technology used by banks. We never see your accounting software password.

### 🔐 **Encrypted Storage**
All access tokens are encrypted at rest using AES-256 encryption.

### 🛡️ **Minimal Permissions**
We only request the minimum permissions needed:
- Read/write invoices
- Read/write contacts
- Read organization settings

### 📊 **Complete Audit Trail**
Every sync operation is logged with full details for compliance and troubleshooting.

## Pricing

Accounting integration is **included free** with all Load Éireann subscriptions:
- ✅ Free Plan - Included
- ✅ Warehouse Add-on - Included

No additional fees, no hidden costs.

## Getting Started

1. **Choose your accounting software** from the list above
2. **Follow the setup guide** for your platform
3. **Connect in 5 minutes** and start syncing

Need help? [Contact Support](mailto:support@loadeireann.ie)

---

## Frequently Asked Questions

### Can I connect multiple accounting systems?
No, you can connect one accounting system per company. If you need to switch, disconnect the current one first.

### What if I disconnect?
Your data remains in both systems. Future invoices won't sync until you reconnect.

### Can I sync existing invoices?
Yes! Use the "Manual Sync" feature to sync past invoices one-by-one or in bulk.

### What happens if sync fails?
Failed syncs are logged with error details. You can retry with one click from the Sync History page.

### Is my data safe?
Yes. We use bank-level security (OAuth2, AES-256 encryption) and never store your accounting software password.

### Can I disable auto-sync?
Yes, you can turn off auto-sync for invoices, customers, or payments in Integration Settings.

### Which invoice statuses trigger sync?
- Warehouse invoices: "Sent" and "Paid"
- Load invoices: "Paid"
- You can also manually sync draft invoices.

---

**Ready to get started?** Choose your accounting platform above and follow the 5-minute setup guide!
