Acctual integrates seamlessly with QuickBooks Online and Xero, automatically syncing your invoices, contacts, and payment data to keep your books up to date — whether you're invoicing in fiat or crypto.
Why connect your accounting system?
Automatic invoice sync
Every invoice you create in Acctual is automatically synced to your accounting system, including all the data needed for journal entries. Works for both fiat and crypto invoices.
Automatic contact sync
All your existing customers from QuickBooks or Xero are pulled into Acctual. When creating an invoice, you can select from customers that already exist in your accounting system — no need to re-enter information.
Save time on bookkeeping
No more manual data entry or reconciliation. Acctual populates all the necessary information for your journal entries automatically.
Support for crypto invoicing
Even if you're invoicing in crypto, Acctual handles the accounting entries correctly in your traditional accounting system.
Supported accounting systems
System | What syncs |
QuickBooks Online | Invoices, Customers, Payments |
Xero | Invoices, Customers, Payments |
How to connect your accounting system
Step 1: Navigate to settings
Log into your Acctual account
Click Settings in the sidebar
Select the Accounting tab
Step 2: Choose your accounting system
You'll see two options:
QuickBooks (QuickBooks Online)
Xero
Click on the accounting system you use.
Step 3: Sign into your accounting system
After selecting your accounting system, you'll be redirected to sign in:
For QuickBooks:
You'll see the Intuit login screen
Sign in with your QuickBooks Online account credentials
If you have multiple accounts, select the one you want to connect
Authorize Acctual to access your QuickBooks data
For Xero:
You'll see the Xero login screen
Sign in with your Xero account credentials
Select the organization you want to connect
Authorize Acctual to access your Xero data
Step 4: Automatic connection
Once you've signed in and authorized the connection, Acctual will automatically:
Link to your accounting system
Pull all your existing customers
Begin syncing new invoices and payments
You'll be redirected back to Acctual, and the connection will be active immediately.
What gets synced?
Invoices
When you create an invoice in Acctual, it automatically syncs to your accounting system with:
Customer information
Invoice number
Line items and amounts
Invoice date and due date
Payment terms
All necessary data for journal entries
This works for both:
Fiat invoices (USD, EUR, etc.)
Crypto invoices (USDT, USDC, ETH, etc.)
Acctual handles the accounting entries correctly regardless of currency type.
Contacts
When you first connect, Acctual pulls all your existing customers from your accounting system.
When you create an invoice, you can:
Select from customers that already exist in QuickBooks or Xero
Avoid re-entering customer information
Keep customer data consistent across both systems
When you create a new contact in Acctual, it also syncs to your accounting system.
Payments
When your clients pay invoices through Acctual, payment information is automatically recorded in your accounting system, including:
Payment amount
Payment date
Payment method
Matching to the correct invoice
Troubleshooting
Connection failed
If you're having trouble connecting your accounting system:
Check your credentials – Make sure you're using the correct login for QuickBooks or Xero
Verify permissions – Ensure your user account has admin access to the accounting system
Try again – Sometimes connection issues are temporary; wait a moment and retry
If the issue persists, contact support@acctual.com or file a ticket through in app messenger.
Invoices not syncing
If invoices aren't appearing in your accounting system:
Check connection status – Go to Settings → Accounting and verify the connection is active
Verify invoice is finalized – Only finalized/sent invoices sync (drafts do not sync)
Wait a moment – Syncing can take 1-2 minutes
If the invoice uses a different currency than your base or customer’s assigned currency, it may fail to sync. Make sure multicurrency is enabled and customer currency settings match. From there retry steps 1-3.
If invoices still aren't syncing after 5 minutes, contact support.
Troubleshooting multicurrency sync issues
If you’re syncing invoices that use multiple currencies, ensure multicurrency support is enabled in your accounting system. By default, both QuickBooks Online and Xero only allow syncing in a single base currency unless this feature is turned on.
QuickBooks Online
Issue: Invoices in foreign currencies don’t appear in QuickBooks or fail to sync.
How to fix it:
Go to Settings → Account and Settings → Advanced.
Scroll to the Currency section.
Toggle Multicurrency ON and confirm.
Once enabled, select your home currency and add additional currencies as needed.
Reconnect your QuickBooks account within Acctual to refresh the sync.
Important: Once multicurrency is turned on in QuickBooks, it cannot be turned off. Make sure this setting aligns with your accounting needs before enabling it.
Additional Tip: Each customer and account in QBO is assigned a currency. If an invoice is in a different currency than the customer’s default, you’ll need to edit the customer profile and update their assigned currency.
Xero
Issue: Invoices in multiple currencies are not syncing or showing incorrect currency codes.
How to fix it:
Multicurrency support in Xero is available only on the Established or higher plan.
To enable:
Go to Settings → Currencies.
Click Add Currency and select the currencies you want to use.
Ensure that the contact and account in Xero are set to the same currency as your invoice in Acctual.
Reconnect Xero within Acctual after enabling multicurrency to ensure data refresh.
Additional Tip: If you’ve upgraded your Xero plan to enable multicurrency, wait 5–10 minutes before reattempting sync to allow changes to propagate through the Xero’s system.
Contacts not appearing
If contacts from your accounting system aren't showing up in Acctual:
Refresh the page – Sometimes a simple refresh resolves the issue
Check connection – Verify your accounting system is still connected
Re-sync – Disconnect and reconnect your accounting system to trigger a fresh sync
Need to disconnect?
To disconnect your accounting system:
Go to Settings → Accounting
Click Disconnect next to your connected system
Confirm the disconnection
Note: Disconnecting will stop future syncing, but existing synced data will remain in both systems.
Frequently asked questions
Do I need a paid QuickBooks or Xero account?
Yes, you need an active subscription to QuickBooks Online or Xero to use the integration.
Can I connect both QuickBooks and Xero?
No, you can only connect one accounting system at a time.
What happens to invoices I created before connecting?
Only invoices created after connecting your accounting system will sync. Existing invoices will not be retroactively synced.
Can I sync crypto invoices to my accounting system?
Yes, Acctual handles crypto invoices correctly and populates the necessary accounting entries in your traditional accounting system.
What if I use QuickBooks Desktop?
Currently, Acctual only supports QuickBooks Online. QuickBooks Desktop is not supported at this time.
Do I need to enable multicurrency even if I only sometimes invoice in another currency?
Yes. Both QuickBooks and Xero require multicurrency to be turned on system-wide before syncing invoices in any non-base currency.
Can I turn multicurrency off after enabling it?
QuickBooks does not allow disabling multicurrency once turned on. Xero allows you to remove unused currencies but not fully disable the feature once activated.
How do I fix exchange rate discrepancies?
Both QBO and Xero use live exchange rates from their respective providers. You can manually override rates in your accounting system if needed to match Acctual’s invoice value.
My invoice synced but shows the wrong total — what should I do?
Check if the currency rounding or FX rate in QuickBooks/Xero differs from the rate applied in Acctual. Adjust the rate manually in your accounting platform to align with Acctual’s calculation.
What if I prefer to manage all my invoices in one currency?
You can continue using Acctual’s multicurrency invoicing features while syncing only invoices in your base currency. Just ensure your accounting settings reflect that preference.
Is my accounting data secure?
Yes. Acctual uses OAuth 2.0 for secure authentication and does not store your accounting system passwords. All data is encrypted in transit and at rest.
Next Steps
Once your accounting system is connected:
Create an invoice – Learn how to create and send invoices
Receiving your first payment - Setup flexible payment options and receiving your first payment
Need Help?
If you have questions about connecting your accounting system or troubleshooting sync issues:
Email: support@acctual.com
Messenger chat: Click the chat icon in your Acctual dashboard
Our team can help you get connected and ensure everything is syncing correctly.
