Resolve Sync Errors

What this guide covers

This guide helps you identify and resolve sync errors that occur between JobsiteOn and connected integrations. You will learn how to read the sync log, diagnose common errors, and take corrective action.

Before you begin

• You need Owner or Admin permissions.
• Sync errors are logged automatically. No setup is required to capture them.

Step 1: Open the sync log

1. Go to /settings > Integrations.
2. Click the integration card (e.g., QuickBooks Online).
3. Click the Sync Log tab.

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

Each error row shows:

• Timestamp -- when the sync attempt occurred.
• Entity -- the record type (contact, invoice, item, payment).
• Direction -- push (to integration) or pull (from integration).
• Status -- error (red), warning (yellow), or info.
• Details -- a description of what went wrong.

Step 3: Diagnose common errors

Authentication expired

Cause: The integration's OAuth token has expired. Fix: Go to the integration card and click Reconnect. Re-authorize the connection and the sync resumes automatically.

Duplicate record

Cause: A record with the same name or identifier already exists. Fix: Rename or merge the duplicate in the target system, then click Retry on the error row.

Record not found

Cause: The linked record was deleted in the target system. Fix: Re-create the record or unlink the JobsiteOn record and let the next sync create a fresh copy.

Rate limit exceeded

Cause: Too many API calls in a short period. Fix: This resolves automatically. Wait 15 minutes and click Sync Now to retry.

Animation: Clicking the Retry button on an error row and watching the status change from Error to Synced with a green checkmark.

Field validation error

Cause: A required field in the target system is empty or invalid. Fix: Open the record in JobsiteOn, fill in the missing field, save, and the next sync attempt will succeed.

Total mismatch

Cause: Calculated totals differ between systems due to tax or rounding. Fix: Compare line items and tax rates in both systems. Adjust the JobsiteOn record to match the target system's calculation.

Step 4: Retry failed syncs

Click Retry on individual error rows to re-attempt the sync for that specific record. Alternatively, click Retry All Errors to re-attempt all failed syncs at once.

Step 5: Prevent future errors

• Keep records consistent. Use the same email addresses and names across systems.
• Check the sync log weekly. Early detection prevents error accumulation.
• Reconnect before tokens expire. Reconnect proactively every 90 days.

Tip: Set a calendar reminder to check the sync log 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.

Related articles

• Connect QuickBooks Online
• Sync Contacts with QuickBooks
• View Integration Logs