JobsiteOn

Troubleshoot QuickBooks Issues

Solutions for common QuickBooks integration problems including authentication errors, sync failures, missing data, and performance issues.

Ethan Rivera
Written by Ethan RiveraUpdated over a month ago3 min readBeginner

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

  1. Verify the invoice is finalized, not a draft.
  2. Check the sync log for errors on that invoice.
  3. Click Sync Now to trigger an immediate sync.
  4. 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

  1. Verify the payment in QuickBooks is applied to a synced invoice.
  2. Wait for the next pull cycle (up to 15 minutes).
  3. 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:

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.

Did this answer your question?

Related Articles