Overview
QuickBooks Online is the world's leading cloud accounting software, used by millions of businesses globally. This guide will help you connect QuickBooks to Load Éireann in under 5 minutes.
Prerequisites
- ✅ Active QuickBooks Online account (Sign up here)
- ✅ Company Admin or Accountant role in QuickBooks
- ✅ Active Load Éireann account
Note: QuickBooks Desktop is not currently supported. This integration works with QuickBooks Online only.
Step-by-Step Setup
Step 1: Navigate to Integrations
- Log in to Load Éireann
- Go to Settings → Integrations
- Find QuickBooks Online in the list
Step 2: Start Connection
- Click Connect next to QuickBooks Online
- You'll be redirected to Intuit's secure login page
- Keep the window open throughout the process
Step 3: Sign In to QuickBooks
On the Intuit authorization page:
Enter your Intuit credentials:
- Email or User ID
- Password
Complete two-factor authentication (if enabled)
- Enter code from SMS or authenticator app
Select your company:
- If you have multiple QuickBooks companies, choose the one to connect
Step 4: Grant Permissions
Review what Load Éireann can access:
- ✅ Read and write invoices
- ✅ Read and write customers
- ✅ Read and write payments
- ✅ Read company information
Click Authorize to proceed.
Step 5: Confirmation
After authorization:
- You'll return to Load Éireann automatically
- Success message: "Successfully connected to QuickBooks Online"
- Your company name from QuickBooks will be displayed
- Status shows "Connected" with green indicator
What Happens Next?
Automatic Sync
Once connected, data syncs automatically:
- Warehouse invoices → When marked "Sent" or "Paid"
- Load invoices → When marked "Paid"
- Customers → Before first invoice sync
- Payments → When recorded
Test Your Connection
Create a test invoice:
Warehouse → Billing → Generate InvoiceMark it as "Sent"
Check QuickBooks:
Sales → InvoicesYour invoice should appear within seconds
Data Mapping: Load Éireann → QuickBooks
| Load Éireann | QuickBooks | Notes |
|---|---|---|
| Invoice Number | DocNumber | Unique reference |
| Customer Name | DisplayName | Auto-creates if new |
| Issue Date | TxnDate | Transaction date |
| Due Date | DueDate | Payment due by |
| Line Items | Line[] | Each item synced |
| VAT 23% | Tax (OUTPUT2) | Standard rate |
| VAT 0% | Tax (NON) | Zero-rated |
| Subtotal | Subtotal | Before tax |
| Total | TotalAmt | Including tax |
| Currency | CurrencyRef | EUR, GBP, USD |
Status Mapping
| Load Éireann | QuickBooks |
|---|---|
| Draft | Draft (not synced) |
| Sent | Not paid |
| Paid | Paid |
Configuration Options
Adjust Auto-Sync Settings
- Settings → Integrations
- Click gear icon next to QuickBooks
- Toggle preferences:
- Auto-sync invoices
- Auto-sync customers
- Auto-sync payments
Manual Sync
For individual invoices:
- Open the invoice
- Click Sync to QuickBooks button
- Monitor in Sync History
Troubleshooting
"Connection Failed During Authorization"
Solutions:
- Ensure you're using Company Admin or Accountant role
- Check QuickBooks subscription is active
- Try incognito/private browsing mode
- Disable ad blockers and try again
- Use Chrome browser (most compatible)
"Invoice Already Exists"
Symptoms: Error: "Duplicate document number"
Solutions:
QuickBooks requires unique invoice numbers:
- Check if invoice was previously synced
- In QuickBooks, delete or void the duplicate
- Retry sync from Load Éireann
"Tax Rate Not Found"
Symptoms: Tax calculation incorrect
Solutions:
- Verify tax rates in QuickBooks:
Settings → All Lists → Sales Tax - Ensure you have:
- Standard rate (23% Ireland, 20% UK)
- Zero rate (0%)
- Contact support if rates are missing
"Customer Sync Failed"
Symptoms: "Contact must exist before invoice"
Solutions:
- Customers auto-sync before invoices
- If sync fails, check customer has:
- Name (required)
- Valid email address
- Manually sync customer:
Warehouse → Customers → [Customer] → Sync
"SyncToken Invalid"
Symptoms: "Object has been modified externally"
Solutions:
This occurs when invoice was edited in QuickBooks:
- Load Éireann fetches latest version automatically
- Retry the sync - should work on second attempt
- If persistent, contact support
QuickBooks Sandboxversus Production
Sandbox (Testing)
For testing the integration:
- Uses sandbox.quickbooks.com
- Separate from your live data
- Free developer accounts available
- Set
QUICKBOOKS_ENVIRONMENT=sandboxin system
Production (Live)
For real business data:
- Uses quickbooks.intuit.com
- Your actual company data
- Requires paid QuickBooks subscription
- Set
QUICKBOOKS_ENVIRONMENT=productionin system
Note: Admin will configure this. Default is production for customers.
Sync History & Monitoring
View All Syncs
- Settings → Integrations
- Click QuickBooks Online
- Select Sync History
Sync Details
Each entry shows:
- Entity (Invoice, Customer, Payment)
- Time & date
- Status (Success/Failed)
- Error message (if failed)
- QuickBooks ID
- Retry option
Retry Failed Syncs
- Find failed sync in history
- Click Retry button
- Monitor result
Disconnecting QuickBooks
To disconnect:
- Settings → Integrations
- Click Disconnect next to QuickBooks
- Confirm
Important:
- Data remains in both systems
- Future syncing stops
- You can reconnect anytime
Best Practices
✅ Recommended
- Test with one invoice first - Verify mapping is correct
- Keep customer info complete - Name, email, address
- Use unique invoice numbers - Avoid duplicates
- Monitor sync history weekly - Catch errors early
- Mark invoices "Sent" - Triggers auto-sync
❌ Avoid
- Editing synced invoices in QuickBooks - Changes don't sync back (yet)
- Deleting customers in QuickBooks - May break future syncs
- Creating duplicate invoices manually - Use Load Éireann as source
- Frequent disconnect/reconnect - Can cause token issues
Security & Privacy
How We Protect Your Data
- OAuth2 - Industry standard (same as banking)
- No password storage - We never see your QuickBooks password
- AES-256 encryption - Tokens encrypted at rest
- Auto token refresh - Seamless, no re-auth needed
- Complete audit trail - GDPR compliant logging
Permissions Requested
Load Éireann only requests:
- ✅ Read/write invoices and customers
- ✅ Read company information
- ✅ Offline access for token refresh
We never request:
- ❌ Banking data
- ❌ Employee payroll data
- ❌ Admin/user management
QuickBooks Plans Compatibility
This integration works with:
- ✅ Simple Start (€12/month)
- ✅ Essentials (€24/month)
- ✅ Plus (€36/month)
- ✅ Advanced (€60/month)
Note: All plans support API access required for integration.
Support
Get Help
- Email: support@loadeireann.ie
- Live Chat: In-app (bottom right)
- Phone: +353 1 XXX XXXX (Mon-Fri 9-5 IST)
Resources
FAQ
Q: Do I need QuickBooks Desktop or Online?
A: QuickBooks Online only. Desktop version is not supported.
Q: Can I connect to multiple QuickBooks companies?
A: One company per Load Éireann account. To switch, disconnect and reconnect.
Q: Will existing invoices sync?
A: Only new invoices sync automatically. Use manual sync for existing ones.
Q: What about expenses/bills?
A: Currently invoices and customers only. Expense sync coming soon.
Q: Do refunds/credit notes sync?
A: Not yet. Create credit memos manually in QuickBooks for now.
Q: Can my accountant access synced data?
A: Yes! If they have QuickBooks access, they'll see everything in real-time.
Q: What if I change my QuickBooks plan?
A: Integration continues to work. No action needed.
Q: How often does data sync?
A: Immediately when invoice is marked "Sent" or "Paid". Near real-time.
Ready to connect? Go to Integrations →
Last updated: December 2025 | QuickBooks Integration v1.0