Troubleshooting Common Bank2QBO Import Errors (and Fixes)
1. Import fails — “File type not supported” or QuickBooks rejects file
- Cause: QBO file header/structure incorrect or file extension changed.
- Fix:
- Re-export the file from Bank2QBO ensuring QBO format selected.
- Open the file in a text editor and confirm it starts with: and contains OFX or QBO-specific tags.
- If extension was renamed (e.g., .txt → .qbo), rename back to .qbo and retry.
2. Duplicate transactions after import
- Cause: Previously imported transactions present in QuickBooks or duplicate import session.
- Fix:
- In QuickBooks, compare dates/amounts and remove duplicates via Banking → Transactions → Reviewed Transactions.
- Use Bank2QBO’s unique ID/transaction ID settings to include or strip identifiers so QuickBooks recognizes duplicates properly.
- When re-importing, enable the “append without duplicates” option (if available) or import into a new account and then reconcile.
3. Balances don’t match account register
- Cause: Missing opening balance or partial date range in the QBO.
- Fix:
- Verify the QBO contains the account’s opening balance entry and correct start date.
- Export a wider date range from your bank and re-convert.
- Manually add the missing opening balance in QuickBooks and reconcile.
4. Transactions show wrong payee or category
- Cause: Bank descriptions differ from QuickBooks payees/memo mapping.
- Fix:
- Edit the transaction mapping rules in Bank2QBO (merchant name normalization).
- Use QuickBooks bank rules to auto-categorize by description.
- Run a find-and-replace or CSV cleanup before conversion to standardize merchant names.
5. Import times out or fails with large files
- Cause: File exceeds QuickBooks import limits or conversion tool memory limits.
- Fix:
- Split the source file into smaller date-based chunks and convert/import sequentially.
- Close other applications to free memory, or run Bank2QBO on a machine with more RAM.
- Check for updates to Bank2QBO — newer versions often handle larger files better.
6. Invalid character / encoding errors
- Cause: Non-UTF-8 characters in bank descriptions break the QBO XML.
- Fix:
- Re-save the source file in UTF-8 encoding before conversion.
- Use a text-cleaning step (search/replace problematic characters) or the tool’s encoding option.
- Validate the QBO XML in a validator and remove offending characters.
7. “Account mismatch” or wrong account number
- Cause: QBO account ID doesn’t match QuickBooks’ account.
- Fix:
- In Bank2QBO, ensure the account number/ID is set to match the QuickBooks target account or leave it blank so QuickBooks prompts for account selection.
- When importing, choose the correct QuickBooks account manually.
8. Transactions import as deposits or withdrawals reversed
- Cause: Sign convention mismatch (credit vs debit) between bank file and QuickBooks.
- Fix:
- In Bank2QBO settings, toggle the “invert signs” or “credit/debit mapping” option.
- Test with a small sample file to confirm correct orientation before full import.
9. Error messages from QuickBooks connector (WebConnector/OAuth)
- Cause: Authentication or WebConnector configuration problems.
- Fix:
- Re-authenticate the connection between Bank2QBO and QuickBooks.
- Update WebConnector and ensure the .qwc file is correct.
- Check firewall/antivirus blocking ports and add exceptions.
Troubleshooting checklist (quick)
- Re-export source data with full date range.
- Validate encoding as UTF-8.
- Test with a small sample file.
- Ensure account IDs and opening balance present.
- Update Bank2QBO and QuickBooks to latest versions.
- Use import logs to identify specific failing records.
If you want, I can provide: a short script to split large CSVs by date, a sample QBO header to compare, or specific step-by-step actions based on the exact error message you’re seeing.
Leave a Reply