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:
- In QBO, go to Accounting > Chart of Accounts.
- Find your bank account and click View Register.
- Locate the deposit with the payment.
- Open the deposit and uncheck/remove the payment.
- 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:
- Docket sends 3.735 × $115.00 = $429.52
- QBO rounds 3.735 × $115.00 = $429.53
- To fix, adjust quantity to 3.73 × $115.00 = $428.95 and retry.
Recommended Troubleshooting Steps
- Verify all customers, accounts, and products exist and are active in QBO.
- Confirm account mappings in Docket are to correct account types.
- Make sure names in Docket match QBO exactly (including spelling and punctuation).
- 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.