# Sage Business Cloud Integration Setup Guide

## Overview

Sage Business Cloud Accounting is trusted by thousands of UK and Irish businesses. This guide walks you through connecting Sage to Load Éireann to automate your invoicing workflow.

## Prerequisites

- ✅ Active Sage Business Cloud Accounting account ([Sign up here](https://www.sage.com/en-gb/sage-business-cloud/accounting/))
- ✅ Administrator access in Sage
- ✅ Active Load Éireann account

**Note:** This integration is for Sage Business Cloud Accounting (cloud version), not Sage 50 Desktop.

## Step-by-Step Setup

### Step 1: Access Integrations

1. Log in to Load Éireann
2. Navigate to **Settings → Integrations**
3. Locate **Sage Business Cloud** in the accounting platforms list

### Step 2: Initiate Connection

1. Click the **Connect** button next to Sage
2. You'll be redirected to Sage's secure authorization portal
3. Keep this window open during the process

### Step 3: Sign In to Sage

On the Sage One authorization page:

1. **Enter your Sage credentials:**
   - Email address
   - Password

2. **Select your Sage Business:**
   - If you manage multiple businesses, choose the one to connect

### Step 4: Authorize Access

Review the permissions Load Éireann requests:

- ✅ Full access to Sales Invoices
- ✅ Full access to Contacts
- ✅ Read access to Business Settings

Click **Authorize application** to proceed.

### Step 5: Success Confirmation

After authorization:
- Automatic redirect to Load Éireann
- Success message displayed
- Sage business name shown
- Connection status: "Connected" (green)

## What Gets Synced?

### Automatic Sync Triggers

- **Warehouse Invoice (Sent)** → Creates Sales Invoice in Sage
- **Warehouse Invoice (Paid)** → Updates invoice to Paid
- **Payment Recorded** → Logs payment against invoice
- **Customer Created** → Adds contact in Sage

### Manual Sync Available

Sync individual items anytime:
- Any invoice (Draft, Sent, Paid)
- Any customer
- Any payment

## Data Mapping: Load Éireann → Sage

| Load Éireann Field | Sage Field | Notes |
|-------------------|-----------|-------|
| Invoice Number | Reference | Unique identifier |
| Customer Name | Contact Name | Auto-creates contact |
| Issue Date | Date | Invoice date |
| Due Date | Due Date | Payment deadline |
| Line Items | Invoice Lines | Each line synced |
| Description | Description | Item description |
| Quantity | Quantity | Number of units |
| Unit Price | Unit Price | Price per unit |
| VAT Rate (23%) | Tax Rate (Standard) | Ireland: 23% |
| VAT Rate (20%) | Tax Rate (Standard) | UK: 20% |
| VAT Rate (0%) | Tax Rate (Zero) | Zero-rated items |
| Subtotal | Net Amount | Before VAT |
| VAT Amount | Tax Amount | Calculated VAT |
| Total | Gross Amount | Including VAT |
| Currency | Currency | EUR, GBP, etc. |

### Customer Mapping

| Load Éireann | Sage |
|-------------|------|
| Customer Name | Organisation Name |
| Email | Email |
| Phone | Telephone |
| Address | Main Address |
| City | City/Town |
| Postal Code | Postcode |
| VAT Number | Tax Number |

## Configuration Options

### Customize Auto-Sync

1. Settings → Integrations
2. Click gear icon next to **Sage Business Cloud**
3. Adjust settings:
   - ☑️ Auto-sync invoices when sent
   - ☑️ Auto-sync invoices when paid
   - ☑️ Auto-sync customers
   - ☑️ Auto-sync payments

### Manual Sync Process

To manually sync an invoice:

1. Open invoice in Load Éireann
2. Click **More Actions → Sync to Sage**
3. Confirmation appears when complete
4. Check Sage to verify

## Troubleshooting

### "Authorization Failed"

**Symptoms:** Can't complete connection

**Solutions:**
1. Verify you have Administrator role in Sage
2. Ensure Sage subscription is active and not expired
3. Try different browser (Chrome recommended)
4. Clear browser cache and cookies
5. Check no popup blockers are enabled

### "Invoice Reference Already Exists"

**Symptoms:** Duplicate invoice number error

**Solutions:**
Sage requires unique invoice references:
1. Check if invoice previously synced
2. In Sage, delete or void the duplicate invoice
3. Retry sync from Load Éireann
4. Ensure invoice numbering is sequential

### "Tax Rate Not Found"

**Symptoms:** VAT calculation error

**Solutions:**
1. Verify tax rates configured in Sage:
   ```
   Settings → Financial Settings → Tax Rates
   ```
2. Ensure you have:
   - Standard Rate (20% UK, 23% IE)
   - Zero Rate (0%)
   - Exempt (if applicable)
3. Load Éireann auto-maps to standard rates

### "Contact Doesn't Exist"

**Symptoms:** "Must create contact before invoice"

**Solutions:**
1. Customers auto-sync before first invoice
2. If sync failed, check customer data:
   - Name is required
   - Email recommended
   - Valid address format
3. Manually sync customer:
   ```
   Warehouse → Customers → [Select] → Sync to Sage
   ```

### "API Rate Limit Exceeded"

**Symptoms:** Temporary sync failure with rate limit message

**Solutions:**
Sage has API rate limits (5000 requests/day):
1. This is rare for normal use
2. Wait 5-10 minutes and retry
3. If syncing bulk invoices, do in batches of 50
4. Contact support if persistent

## Viewing Sync History

### Access Sync Logs

1. Settings → Integrations
2. Click **Sage Business Cloud**
3. Select **View Sync History**

### Understanding Sync Status

- ✅ **Completed** (Green) - Successfully synced
- ⏳ **Pending** (Yellow) - In progress
- ❌ **Failed** (Red) - Error occurred

### Retry Failed Syncs

1. Locate failed sync in history
2. Read error message
3. Fix underlying issue
4. Click **Retry** button

## Disconnecting Sage

If you need to disconnect:

1. Settings → Integrations
2. Click **Disconnect** next to Sage
3. Confirm disconnection

**Note:**
- Existing data remains in both systems
- Future automatic syncing stops
- You can reconnect at any time

## Best Practices

### ✅ Do

- **Test first invoice** - Verify data appears correctly in Sage
- **Keep customer data complete** - Full address helps with accuracy
- **Use consistent numbering** - Sequential invoice numbers
- **Monitor sync history weekly** - Catch and fix errors early
- **Set clear invoice statuses** - Draft vs Sent vs Paid

### ❌ Don't

- **Don't edit synced invoices in Sage** - Changes won't reflect in Load Éireann (yet)
- **Don't delete contacts** - Can cause future sync failures
- **Don't create duplicate invoices** - Always use Load Éireann as source of truth
- **Don't sync same invoice twice** - Check history first

## Security & Privacy

### Data Protection

- **OAuth2 Authentication** - Bank-level security standard
- **No password storage** - We never see your Sage password
- **AES-256 encryption** - All tokens encrypted at rest
- **Automatic token refresh** - No manual re-authentication needed
- **Full audit trail** - GDPR compliant logging

### Minimum Required Permissions

Load Éireann only requests:
- ✅ Sales invoice management
- ✅ Contact management
- ✅ Read business settings

We never request:
- ❌ Bank account access
- ❌ Purchase invoices/expenses
- ❌ User/employee data
- ❌ Payroll information

## Sage Plan Compatibility

This integration works with all Sage Business Cloud Accounting plans:

- ✅ **Accounting Start** (£12/month)
- ✅ **Accounting** (£27/month)
- ✅ **Accounting Extra** (£40/month)

All plans include API access required for integration.

## Getting Help

### Support Channels

- **Email:** support@loadeireann.ie
- **Live Chat:** Available in-app (Mon-Fri 9am-5pm GMT)
- **Phone:** +44 20 XXXX XXXX (UK) | +353 1 XXX XXXX (IE)

### Useful Resources

- [Sage Help Centre](https://help.accounting.sage.com/)
- [Sage API Documentation](https://developer.sage.com/accounting/)
- [Load Éireann Support](https://help.loadeireann.ie)

## Frequently Asked Questions

**Q: Does this work with Sage 50 Desktop?**
A: No, this integration is for Sage Business Cloud Accounting (cloud version) only. Sage 50 Desktop requires different approach.

**Q: Can I connect multiple Sage businesses?**
A: One Sage business per Load Éireann company account. To switch, disconnect and reconnect.

**Q: Will past invoices automatically sync?**
A: Only new invoices created after connection sync automatically. Use manual sync feature for existing invoices.

**Q: What happens to invoice attachments?**
A: Currently, PDFs aren't attached to Sage invoices. You can download invoice PDF from Load Éireann and upload to Sage manually if needed.

**Q: Can my accountant access the data?**
A: Yes! If your accountant has access to your Sage account, they'll see all synced invoices in real-time.

**Q: Do credit notes sync?**
A: Not yet. Create credit notes manually in Sage. This feature is on our roadmap.

**Q: What if I change Sage subscription plan?**
A: Integration continues working seamlessly. No action required.

**Q: How quickly do invoices appear in Sage?**
A: Typically within 5-10 seconds of marking invoice as "Sent" in Load Éireann.

**Q: Can I customize which fields sync?**
A: Field mapping is automatic. Custom field mapping coming in future update.

**Q: Is there a limit to how many invoices I can sync?**
A: No limit from Load Éireann. Sage has 5000 API calls/day, which equates to ~1000 invoices/day.

---

**Ready to get started?** [Connect Sage Now →](/settings/accounting)

---

*Last updated: December 2025 | Sage Integration v1.0*
