JobsiteOn

Resolve Sync Errors

How to identify, diagnose, and fix common sync errors between JobsiteOn and connected integrations like QuickBooks Online.

Ethan Rivera
Written by Ethan RiveraUpdated over a week ago8 min readBeginner

What this guide covers

This guide helps you find and fix sync errors between JobsiteOn and QuickBooks Online. You will learn where the sync log and the sync errors are, how to read them, and how to fix the most common problems.

Before you begin

Step 1: Open the sync log and the sync errors

  1. Go to /settings and click Marketplace.
  2. Open QuickBooks Online and click Manage integration.
  3. Click View log to see each record JobsiteOn sent or brought in.

The sync errors page is at /settings/marketplace/quickbooks/manage/errors. Whenever a sync error is open, the QuickBooks page shows a banner with a View sync errors link to it, such as "3 sync errors need a look". When a payment may be counted twice, the banner reads "A QuickBooks payment may be counted twice" instead, and when other sync errors are open too, it says how many. If JobsiteOn can't count the open errors, the QuickBooks page shows "QuickBooks sync errors unavailable" with a Retry sync errors button, so check the sync errors page yourself.

Screenshot: The sync log showing a table with columns for timestamp, entity type, direction, status, and error details, with three error rows highlighted in red.

Step 2: Read the error details

The sync errors page has two tabs:

JobsiteOn saves incoming changes before confirming receipt to QuickBooks. If sync stops while a saved change is waiting, it stays queued until sync resumes. A stopped sign-in needs Reconnect QuickBooks; a disabled record type needs its sync switch turned back on. Retry uses the same QuickBooks company that sent the change. It refuses a different company connected later.

Step 3: Diagnose common errors

QuickBooks asks you to reconnect

Cause: Your QuickBooks sign-in stopped working, for example because someone disconnected JobsiteOn inside QuickBooks. JobsiteOn renews the sign-in every hour, so you don't need to reconnect on a schedule. Fix: Click Reconnect QuickBooks in the red banner on the QuickBooks page and sign in to the same QuickBooks company.

Duplicate customer

Cause: JobsiteOn added a customer because QuickBooks had none with the same email address or display name. Fix: Use the same email address in both systems so future contacts match. A customer merge in QuickBooks moves the JobsiteOn link to the surviving customer. If both QuickBooks customers already have separate JobsiteOn contacts, JobsiteOn asks you to merge those contacts too. See Sync Contacts with QuickBooks.

Rate limit exceeded

Cause: QuickBooks limits how many requests an app can make each minute. Fix: JobsiteOn waits at least a minute before sending more changes to that QuickBooks company, or longer if QuickBooks asks it to. Your changes stay queued. Waiting for the request limit does not use up a change's retry attempts, so you don't need to keep clicking Sync now.

If a change fails for another reason after its retries, it appears on the Dead letter queue tab. Fix the reported problem, then click Retry.

The QuickBooks dashboard counts the records linked to the connected company. Editing the same record again does not increase that count. Errors stay visible even when other records have synced successfully.

Animation: Clicking Retry on a failed change in the Dead letter queue tab and watching it leave the list.

A record QuickBooks rejected

Cause: QuickBooks turned the record down, for example because an invoice's customer is inactive in QuickBooks. Fix: Correct the problem in QuickBooks or JobsiteOn, then click Retry on the Dead letter queue tab, or save the record again in JobsiteOn. See Troubleshoot QuickBooks Issues.

A payment that may be counted twice

Cause: Payments sync both ways. A payment entered in QuickBooks landed on an invoice that also has a JobsiteOn payment for the same amount that was never sent to QuickBooks. JobsiteOn links a single clear match using the customer, amount and date. If it cannot confirm that match, it asks you. The error reads one of these:

Fix: Answer it with the buttons on the error:

See "Possible duplicate payment" in Sync Invoices with QuickBooks.

Total mismatch

Cause: JobsiteOn doesn't send tax. QuickBooks works out the tax on each invoice from its own settings, and line rounding can differ. Fix: Compare the line items and tax on both invoices, and make the customer's tax settings in QuickBooks match the tax you charge in JobsiteOn.

Step 4: Retry or clear errors

Step 5: Prevent future errors

Tip: Set a calendar reminder to check the sync errors every Monday. A 2-minute review can prevent hours of cleanup later.

Note: If an error persists after retrying, contact JobsiteOn support with the error timestamp and details for further investigation.

Did this answer your question?

Related Articles