The most common reasons a QBO file is rejected
When QuickBooks refuses a Web Connect file, the error message rarely says why. In practice, nearly every failure comes from a short list of causes, and each one can be detected by reading the file:
- It isn't really a QBO file. A CSV or a generic OFX renamed to
.qbohas no Intuit sign-on data. QuickBooks needs the OFX header, a sign-on section and anINTU.BID. - The INTU.BID is missing or not recognized. This produces the "unable to verify the financial institution" style of errors.
- The file is over 350 KB. QuickBooks Online has a hard limit per upload. QuickBooks Desktop doesn't.
- Dates are invalid or out of order. A start date after the end date, or transaction dates that can't be read, stop the import.
- Amounts are formatted for people, not software.
$1,250.00is not a valid OFX amount;1250.00is. - Transaction IDs are missing or repeated. Missing FITIDs can block the import; repeated ones make QuickBooks skip transactions without telling you.
- Wrong account type. A credit card file imported into a checking account fails, and vice versa.
How to read the report
Problems marked with a red cross will almost certainly stop the import. Amber warnings are things that some versions of QuickBooks accept and others don't, or that won't stop the import but can cause surprises, like garbled characters in payee names. Green checks are listed too, so you can see exactly what was verified.
Below the report, the file details show the identifiers QuickBooks uses: the OFX version, ORG, FID, INTU.BID, the account type, the last four digits of the account number and the statement period. If you're comparing a file that works with one that doesn't, these values are usually where the difference is.
Importing a QBO file once it passes
QuickBooks Online
- Go to Transactions > Bank transactions.
- Open Link account and choose Upload from file.
- Drag in the .qbo file, pick the matching bank or credit card account, and continue to review.
QuickBooks Desktop
- Choose File > Utilities > Import > Web Connect Files.
- Select the .qbo file and link it to an existing account, or create a new one.
- Review the downloaded transactions in the Bank Feeds center.
When the file can't be fixed by hand
Editing OFX files in a text editor is possible but risky: one stray character can break the whole file. If the report shows structural problems, such as a missing header, a missing INTU.BID or a file that's simply too large, it's usually faster to convert the bank's original export (CSV, OFX or PDF) into a fresh QBO file that's built to pass these checks.