Troubleshoot QuickBooks Issues
Solutions for common QuickBooks integration problems including authentication errors, sync failures, missing data, and performance issues.
What this guide covers
This guide provides solutions for the most common QuickBooks integration problems. Use this as a reference when you encounter sync errors, connection issues, or unexpected behavior.
Connection issues
The Connect button does nothing
Cause: Pop-ups are blocked by your browser.
Fix: Allow pop-ups from app.jobsiteon.com in your browser settings
and try again.
"Access denied" during authorization
Cause: Your QuickBooks account does not have admin permissions. Fix: Sign in with a QuickBooks admin account or ask your QuickBooks admin to authorize the connection.
Connection drops after a few weeks
Cause: QuickBooks OAuth tokens expire after approximately 100 days.
Fix: Go to /settings > Integrations and click Reconnect
on the QuickBooks card. Re-authorize to refresh the token.
Screenshot: The QuickBooks integration card showing a "Reconnect" button with an orange warning badge indicating the token has expired.
Sync failures
Invoices are not appearing in QuickBooks
- Verify the invoice is finalized, not a draft.
- Check the sync log for errors on that invoice.
- Click Sync Now to trigger an immediate sync.
- Verify the linked customer exists in QuickBooks.
Contacts appear as duplicates in QuickBooks
Cause: The email-based matching failed because emails differ. Fix: Merge the duplicate in QuickBooks. Update the email in one system to match the other for future syncs.
Payment not syncing back to JobsiteOn
- Verify the payment in QuickBooks is applied to a synced invoice.
- Wait for the next pull cycle (up to 15 minutes).
- Click Sync Now if you need it immediately.
Animation: Opening the sync log, filtering by status "Error", and clicking Retry on a failed invoice sync that then succeeds.
Data issues
Invoice totals do not match
Cause: Tax calculation differences between systems. Fix: Compare line items and tax rates. Ensure your JobsiteOn tax rates match your QuickBooks tax settings.
Customer names are truncated
Cause: QuickBooks has a 100-character limit on display names. Fix: Shorten the contact name in JobsiteOn.
Pricebook items created as wrong type
Cause: The item type mapping is incorrect. Fix: Update the field mapping in integration settings to map Services to "Service" and Parts to "NonInventory."
Performance issues
Sync is slow
Cause: Large data volume or QuickBooks API rate limits. Fix: This is normal during initial sync or bulk operations. Allow up to an hour for large datasets.
Sync log shows "Rate limit exceeded" errors
Cause: Too many API calls to QuickBooks. Fix: These resolve automatically. The system retries after a cooldown period. No action needed.
When to contact support
Contact support@jobsiteon.com if:
- Errors persist after following the troubleshooting steps above.
- The sync log shows errors you do not recognize.
- Data is missing or corrupted after a sync.
Include the error timestamp, entity type, and sync log details in your support request.
Tip: Before contacting support, try disconnecting and reconnecting the integration. This refreshes the connection and resolves many transient issues.
Related articles
Did this answer your question?