QuickBooks
Troubleshoot QuickBooks authorization, stale mappings, failed syncs, and conflicts
Classify the failure, correct the narrow cause, and retry without duplicating external records. Follow the current customer-facing workflow and verify access, status, and resulting records before continuing.
Before you begin
- Audience: Company admin, accounting manager.
- Access to the JobBuddy source record and QuickBooks company
- exact error/status/reference
- permission to reconnect or remap.
QuickBooks integration settings/data/import pages; source invoice/payment/expense/time screen showing the failure
Troubleshoot QuickBooks authorization, stale mappings, failed syncs, and conflicts
-
Open the workspace
In JobBuddy, go to QuickBooks integration settings/data/import pages; source invoice/payment/expense/time screen showing the failure.
-
Confirm access and starting state
Access to the JobBuddy source record and QuickBooks company; exact error/status/reference; permission to reconnect or remap.
-
Complete the main setup
Use classification by error text/state: reconnect authorization, refresh/reselect removed entity, repair mapping, fix source data, resolve conflict, wait/retry service error, or reconcile an already-created record.
-
Review the important choices
Always inspect JobBuddy and QuickBooks before retrying.
-
Check status and follow-up
Review FAILED versus CONFLICT and capture identifiers without publishing sensitive data.
-
Verify the result
Classify the failure, correct the narrow cause, and retry without duplicating external records.
Expected result: Classify the failure, correct the narrow cause, and retry without duplicating external records.
Troubleshooting
The page, control, or action is unavailable.
Confirm the required access and starting state: Access to the JobBuddy source record and QuickBooks company; exact error/status/reference; permission to reconnect or remap.
The result is incomplete or unexpected.
Authentication faults, removed/merged QuickBooks entities, stale cached references, mapping gaps, validation errors, rate/service failures, conflicts, and already-created records require different recovery.
The issue remains after checking the record.
Capture the exact visible error, record status, approximate time, and intended result. Give support only the minimum customer-safe evidence needed to trace the problem.
What happens next
- Classify the failure, correct the narrow cause, and retry without duplicating external records.
- Review the resulting record, status, notifications, and related history before continuing downstream work.
- Use the related guide when the next action belongs to another JobBuddy workflow.