When Sharper syncs to QuickBooks Online (QBO), it maps your revenue, payment, and liability accounts to the chart of accounts in QuickBooks. If an account is missing, renamed, or misconfigured in either system, the sync fails and journal entries queue up without posting. This guide walks through the most common error messages and how to resolve them.

Before You Begin

Access the sync queue from Accounting → Accounting Sync.
Entries that fail to sync remain in the queue with a status of Failed or Error. They can be re-queued once the underlying issue is fixed.
Only accounting staff with QuickBooks access and Sharper admin access should perform these steps.
Do not delete failed sync entries — fixing the account mapping and re-queuing is the correct approach.

Common Error Messages and Fixes

"Missing acct account: [Account Name]"

What it means: Sharper is trying to post to an account (e.g., "Late Fees", "Marina Revenue") that does not exist in your QuickBooks chart of accounts, or whose name does not exactly match what Sharper expects.

How to fix:

In QuickBooks Online, navigate to Accounting → Chart of Accounts.
Check whether the account exists. If it does, compare the exact spelling to what Sharper is referencing — a trailing space, different capitalization, or a renamed account will cause this error.
If the account does not exist in QBO, create it with the correct name and account type.
Return to Sharper and navigate to Accounting → QuickBooks Settings (or the integration settings panel).
Confirm the account mapping points to the correct QBO account name.
Re-queue the failed entries.

"Invalid bank account reference"

What it means: The bank account Sharper is posting payments to does not match an active bank account in QuickBooks.

How to fix:

In QuickBooks Online, confirm your bank account is active under Accounting → Chart of Accounts → Bank.
In Sharper's QuickBooks settings, verify the bank account mapping matches exactly.
If you recently renamed or added a bank account in QBO, update the mapping in Sharper to reflect the new name.
Re-queue the affected payment entries.

"Duplicate document number"

What it means: QBO is rejecting an entry because a journal entry or invoice with the same document number already exists.

How to fix:

In QBO, search for the document number in question.
If the duplicate was created manually in QBO, delete it (if it was erroneous) or adjust the Sharper entry reference.
Contact Sharper support if duplicates are being created systematically — this may indicate a re-queue loop.

"Account type mismatch"

What it means: Sharper is posting to an account, but the account type in QBO does not match what Sharper expects (e.g., posting revenue to a bank account).

How to fix:

In QBO, find the account and confirm its type (Income, Expense, Other Current Liability, etc.).
In Sharper's account mappings, ensure each Sharper account category is mapped to an account of the correct type.
Re-queue after correcting the mapping.

How to Re-Queue Failed Sync Entries

Navigate to Accounting → Accounting Sync.
Filter by Failed status.
Select the entries you want to re-queue.
Click Re-Queue (or Retry).
Monitor the queue to confirm entries post successfully.

If the same entries fail again after re-queuing, the underlying mapping issue has not been resolved. Return to the error message and verify your fix.

Safety Notes When Editing Your Chart of Accounts

Renaming accounts in QBO will break any Sharper mappings that reference the old name. Always update Sharper's account mappings immediately after renaming a QBO account.
Merging accounts in QBO is irreversible. Do not merge accounts that are actively referenced in Sharper sync mappings without first updating the mappings.
If your accounting period is closed in QBO, entries re-queued for that period may be rejected. Coordinate with your accountant before re-queuing entries in a closed period.