Fix QuickBooks Online (QBO) Sync Errors in Docket

Last updated: November 9, 2026

When syncing from Docket to QuickBooks Online (QBO), you may run into errors that stop your invoices, payments, or expenses from syncing. This guide explains the most common error messages, what they mean, and how to fix them.

Before You Start

  • Make sure your Docket–QBO integration is connected.

  • Confirm your QBO subscription supports third-party integrations.

  • Always read the full error message shown in Docket—it often includes the raw QBO error response.

     

Common Error Codes and Fixes

Error Message

Cause

How to Fix

Duplicate Document Number

Invoice number already exists in QBO

Use unique invoice numbers in Docket, or turn off QBO auto-numbering

Invalid Reference ID

Customer, product, or account deleted/inactive in QBO

Re-activate/recreate in QBO, or update Docket to use a valid record

Authorization Failure (401/11014)

Connection expired or unsupported QBO plan

Reconnect QBO from Docket settings; confirm plan supports integrations

Account Type Not Valid

Expense or invoice mapped to invalid account type

Update mapping to valid Expense (expenses) or Income (invoices) account in QBO

Required Field Missing

Mandatory fields not filled (Amount, Customer, Item)

Complete all required fields in Docket, then retry sync

Object Not Found

Deleted customer, item, or account in QBO

Recreate in QBO, or update Docket to valid record

Payment Refused / Invalid Method

Payment method doesn’t exist or mismatched

Add/correct payment method in QBO, retry sync

Customer Already Exists

Duplicate customer name conflict

Rename in Docket or QBO

Currency Mismatch

Currency in transaction doesn’t match customer

Enable Multicurrency in QBO and align currencies

Special Cases

Payment Sync Error: Already Deposited

Error: “Could not sync payment: This transaction has been deposited.”

Cause: The payment is already part of a QBO bank deposit. Deposited payments cannot be edited or deleted until removed from that deposit.

Fix:

  1. In QBO, go to Accounting > Chart of Accounts.

  2. Find your bank account and click View Register.

  3. Locate the deposit with the payment.

  4. Open the deposit and uncheck/remove the payment.

  5. Save changes, then retry the sync in Docket.

⚠️ Caution: Don’t delete a deposit unless no other payments are tied to it.

Amount Is Not Equal to Unit Price × Quantity

Error: “Amount is not equal to unit price × quantity. Supplied value is [amount].”

Cause: QBO recalculates totals differently due to rounding. Even a $0.01 mismatch will block the sync.

Fix:

  • Reduce decimal precision in Docket.

  • Example:

    1. Docket sends 3.735 × $115.00 = $429.52

    2. QBO rounds 3.735 × $115.00 = $429.53

    3. To fix, adjust quantity to 3.73 × $115.00 = $428.95 and retry.

       

Recommended Troubleshooting Steps

  1. Verify all customers, accounts, and products exist and are active in QBO.

  2. Confirm account mappings in Docket are to correct account types.

  3. Make sure names in Docket match QBO exactly (including spelling and punctuation).

  4. Test a new sync after making corrections.

     

Still Need Help?

If errors continue:

  • Reconnect your Docket + QBO integration.

  • Send support a screenshot of the error, the Docket invoice/expense ID, and what you expected to happen.