By the end of this guide, you will have connected PlaneConnection to QuickBooks Online, configured data sync options, and verified the connection.
This feature requires administrator or workspace owner permissions. Changes made here
affect all users in your workspace.
You need the Admin role and an active QuickBooks Online subscription. A QuickBooks Company ID is
required for the OAuth connection.
Prerequisites
- An active QuickBooks Online account (Simple Start, Essentials, or Plus).
- Admin access to both PlaneConnection and QuickBooks Online.
- Your QuickBooks Company ID (found in QuickBooks under Company Settings).
Connect QuickBooks
Step 1: Navigate to the QuickBooks settings page
Go to Ops > Settings > Integrations > QuickBooks or Ops > Accounting > QuickBooks > Setup.
Step 2: Start the OAuth flow
Click Connect with OAuth. You are redirected to Intuit’s authorization page.
Step 3: Authorize PlaneConnection
Sign in to your QuickBooks Online account and authorize PlaneConnection to access your company data. Click Connect to grant access.
After returning to PlaneConnection, toggle the data types you want to synchronize:
| Data Type | Direction | Default |
|---|
| Invoices | PlaneConnection to QuickBooks | Enabled |
| Expenses | PlaneConnection to QuickBooks | Enabled |
| Payments | QuickBooks to PlaneConnection | Enabled |
| Chart of accounts | QuickBooks to PlaneConnection | On setup |
Step 5: Set the sync frequency
Choose how often data synchronizes:
| Option | Description |
|---|
| Hourly | Syncs every hour (recommended for active ops). |
| Every 6 hours | Moderate sync frequency. |
| Daily | Once per day at midnight UTC. |
| Manual only | Sync only when you click Refresh. |
Step 6: Map chart of accounts
Map PlaneConnection cost categories to your QuickBooks chart of accounts:
| PlaneConnection Category | Map to QuickBooks Account |
|---|
| Fuel | Fuel Expense |
| Landing Fees | Airport Fees |
| Handling | Ground Handling Expense |
| Crew Costs | Crew Payroll / Contractor |
| Catering | Catering Expense |
| Other | Miscellaneous Expense |
Click Save Settings. The connection status should show Connected.
Monitor sync status
After connecting, two live widgets appear in the Ops module widget bar:
- QB Sync Status — shows connection health and last successful sync time.
- QB Pending Exports — shows count of expenses awaiting export to QuickBooks.
Navigate to Ops > Accounting > QuickBooks to see the full sync dashboard with recent sync history and error logs.
If you see sync errors for payments, check that your QuickBooks chart of accounts mappings are
correct. Mismatched account mappings are the most common cause of payment sync failures.
Manually trigger a sync
To force an immediate sync:
- Navigate to Ops > Accounting > QuickBooks.
- Click Sync Now.
- Wait for the sync to complete. The sync log updates with the results.
Disconnect QuickBooks
- Navigate to Ops > Settings > Integrations > QuickBooks.
- Click Disconnect.
- Confirm the disconnection.
Disconnecting stops all data synchronization immediately. Previously synced data remains in both
systems. To remove synced data, you must do so manually in both PlaneConnection and QuickBooks.
Troubleshooting
| Issue | Solution |
|---|
| OAuth token expired | Re-authorize by clicking Reconnect on the QuickBooks settings. |
| Invoice not appearing in QB | Verify the invoice status is Sent or Paid in PlaneConnection. |
| Duplicate entries in QB | Check the sync log for duplicate ID warnings. Disable and re-enable the affected data type. |
| Chart of accounts not loading | Click Refresh Accounts to re-fetch the chart of accounts from QuickBooks. |
Handle Accounting
Invoices, expenses, and accounting workflows in the Ops module.
Analyze Financial Metrics
Financial analytics that use data from QuickBooks-synced transactions.
Integrations Directory
Complete list of all supported integrations.
Set Up Integrations
General integration setup process.