CSV to QBO troubleshooting

Fix CSV to QBO conversion errors: dates, amounts, and import tests.

A source-file validation issue is different from a QuickBooks Web Connect rejection. Fix the local table first, then treat the generated QBO beta as a separate, cautious import test.

Updated July 24, 2026 · Examples use fictional data.

Use the next step nowInspect source mappings and row-level issues in the browser before generating a candidate QBO.
Check a CSV to QBO file locally

Separate two kinds of errors

BankFileKit can report a source-file issue before download, such as an invalid date or amount. A later Web Connect error comes from the target QuickBooks workflow. Do not treat a changed file extension as a fix for either category.

Fix local source-file issues first

Visible issueLikely source problemSafe correction
Date missing or ambiguousMixed formats, an invalid value, or a heading row mapped as a transaction.Choose one date convention and remove non-transaction rows.
Amount missing or invalidCurrency text, a blank cell, or a non-numeric value.Use a clean signed Amount field or valid Credit/Debit fields.
Credit and Debit conflictBoth sides of a row contain a non-zero value.Keep one side populated for each transaction.
Description empty warningThe mapped Description cell is blank.Map a readable Details, Payee, Memo, or Description column and recheck the preview.
No usable transactionsThe table contains only headers, notes, or invalid rows.Export the actual transaction table rather than a statement summary.

Confirm the mapping, not just the headers

Bank exports use different words for the same concept. Check that the selected Date, Description, Amount, Credit, and Debit columns match a known fictional or non-sensitive example. A header named Balance is not a transaction Amount.

Review date and amount direction

  • Choose the source date convention before reading ambiguous values.
  • Check one known payment and one known deposit against the preview.
  • Do not fill both Credit and Debit on the same row.
  • Remove totals and running balances, which can distort the transaction count.

If the downloaded QBO is rejected

BankFileKit's CSV-to-QBO result is an unverified beta. A structurally generated file can still be rejected because of a QuickBooks release, account state, institution information, or Web Connect requirement. Back up first, test in a blank company, and follow Intuit's current Web Connect guidance rather than repeatedly importing into production books.

Use a fictional reproduction

Date,Description,Amount
07/20/2026,Fictional Refund,24.00
07/21/2026,Fictional Software License,-79.00

Keep troubleshooting local

The converter reads and generates the file in the browser. Analytics receives only allow-listed aggregate event fields—not filenames, source text, account information, transaction amounts, dates, or descriptions. If support needs context, send a generic error category and a fully invented example.

When not to continue

Stop and preserve the original export if transactions are missing, duplicated, reversed, or connected to a live QuickBooks account. A converter cannot make bookkeeping or reconciliation decisions, and a browser download is not proof of an accurate import.