qif2qbo Convert | Help

Getting Started

QIF2QBO Convert is a single step financial data translator to convert QIF files into QBO files suitable for QuickBooks® software. Use QIF2QBO Convert to import transaction data into QuickBooks when you are only able to download QIF format from your bank or create it from another financial application.

To get started first export or download your QIF file from your bank, and set your QuickBooks account information with the Settings menu.

Then use the File menu, Open QIF File to run the conversion and create your QBO file in a single step.


  • Microsoft Windows® full install
    • Download QIF2QBO.exe for Windows, save the file to your computer, and run the installation program by double clicking the file.
    • If you do not have have Java installed it will be automatically downloaded during the installation.
  • Mac OS X® full install
    • Download QIF2QBO.dmg for Mac OS X, save the file to your computer. Locate the file in the download area, open it by double clicking, then and run the installer.app by double clicking it.
    • If you do not have have Java installed it will be automatically downloaded during the installation.
  • Portable Installation
    • Download QIF2QBO.zip and save the file to your computer.
      • If running on Mac OS X the unzip will be done automatically as part of the download, and QIF2QBOportable.jar should be in your user download folder.
      • If running on other operation systems run zip or winzip on QIF2QBO.zip and extract QIF2QBOportable.jar to a suitable folder such as C:\Program Files\MoneyThumb.
    • Make sure you have Java installed on your computer. If you do not have Java already installed, download it for free at www.java.com.

Entering License Information

On Microsoft Windows, the easiest way to enter the license is to copy the license file QIF2QBO.lic from the product confirmation e-mail to the same folder where you installed QIF2QBO Convert – i.e. C:\Program Files\MoneyThumb\QIF2QBO.

Otherwise enter the license by copying the license string (CTRL-C) from the confirmation e-mail and pasting it (CTRL-V) into the license dialog. To enter the license string manually from within the program select Help, and Enter License, and paste (or type) the full license code into the dialog.

After you enter your license, your license email will be shown in the program title bar, and in Help, About.


There are two things to do before running QIF2QBO Convert

  1. Create a QIF file

You need to create a QIF file before running QIF2QBO Convert. This could be created by your financial software such as Quicken, or your bank or brokerage. This is the procedure to create a QIF file with a single account from Quicken.

  • Start Quicken
  • Select the account that you wish to export.
  • Choose the menu File and select the Export menu entry, and the QIF File sub-menu entry.
  • This will bring up the QIF Export dialog.

You will want to create a QIF file with a single account, and select only the Transactions checkbox. Then Select OK to create the QIF file.

  1. Get the account number of the QuickBooks account into which you want to import transactions. If you are creating a new account, then any number will suffice. If you wish to import transactions into an existing account, then QuickBooks will match up the account numbers, and you will want to import into the correct account.

Running QIF2QBO Convert

On Windows or Mac OS X, double click the QIF2QBO Convert icon on your desktop.

You may also run QIF2QBO Convert from the Windows Start Menu, or run QIF2QBO.exe on Windows or QIF2QBO Convert.app on Mac OS X.

If you are running the portable version, run QIF2QBOportable.jar by double clicking it, or starting it as a Java program.


Setting QuickBooks Account Info

When the QBO file is created, first it needs to be of the correct type – Bank or Credit Card. In addition there are four pieces of account information that may be inserted into the QBO file when it is created. The only one of these that is critical is the QuickBooks FID. This is a four or five digit number that QuickBooks uses to identify the financial institution. QuickBooks will validate the FID over the Internet when reading in the QBO file, and it must be correct and valid, or QuickBooks will abort the file import.

Set the QuickBooks account information with the Settings menu, and Set QuickBooks Account Info. This will bring up the dialog below. First, select the Account Type as Bank or Credit Card in the drop down list.


Select “Lookup…” in the dialog and it will bring up a window with all the QuickBooks Financial Institutions that are listed for that type of account. Type some or all of the name of your financial institution into the search box at the top to search within the list. Scroll down the list to find your bank and select it. The bank URL is also included to help resolve ambiguity if your bank has a name that is similar to other banks.

If your bank is not listed, then QuickBooks will not import QBO files (Web Connect files) that are identified as being from that financial institution. The only workaround is to use an FID from some other bank. You can still name the account to include the name of your financial institution. So long as you as not also doing QuickBooks Direct Connect downloads into the same account, it will work just fine. There are some Financial Institutions that provide Direct Connect, but do not support Web Connect, and if you use one of these, you will have to create two accounts and move transactions from one to the other.

Just remember that the FID is critical, and although QIF2QBO Convert will run without one, it will give a warning, and QuickBooks will give an error when reading the QBO file.

QBO files are required to have account information. All files require an account number and bank accounts also require a bank routing number. If you don’t want to save your accounts numbers for security reasons, then you can skip entering this this information. If you do provide your account number to be inserted into the QBO file, then QuickBooks uses that number to automatically determine which account to import into. If you are always importing into the same account, then QIF2QBO Convert will save the information from session to session, so you do not have to re-enter it. For PayPal users, your account number is the email address you use to sign into PayPal. Note that QIF2QBO Convert does not access the Internet at all, so any information entered is only saved on your computer, and is not sent over other web or to any other computers.

To determine the account number to use in the QBO file, QIF2QBO Convert will look in the following locations, in order.

      1. Values from the QuickBooks Account Info dialog window (see above). Once again, if you are concerned about entering your account number, then don’t, and either manually edit the QBO file after it is created, or match up accounts when doing the QuickBooks import.
      2. The QIF file name, if it is a number without any letters.
      3. As a last resort, QIF2QBO Convert will use an arbitrary default number for the routing number and account number. You will then have to manually match accounts when reading the QBO file into QuickBooks.

The bank account routing number is required by QBO for bank accounts (but not for credit card accounts). However, it is not actually used by QuickBooks, so if you don’t specify one, QIF2QBO Convert will insert a default value and QuickBooks will accept it.

Lastly, the currency needs to be specified. US Dollars are the initial setting, use the drop down to select a different currency.

Date Formats

QIF2QBO Convert can read dates either in US format (month-day-year) or European format (day-month-year). Use the Settings menu to select the date format that is used in your QIF file. If your file came from a US bank or Quicken, it will be in US format. If your dates have the month name or abbreviation rather than a number, then this setting is not applicable. Note that there is no need to specify a date format for QBO files.

Converting the QIF File

Select File, Open QIF File and this will bring up a file chooser dialog. Navigate to the folder containing the QIF file, select the file, and then select Open at the bottom of the dialog. QIF2QBO Convert will run, giving some statistics on how many lines were processed and create a QBO file with the same name. If a QBO file with that name already exists you will be prompted to overwrite it.

Most of the data in a QIF file will be converted directly into the QBO file. However, QuickBooks does not support investment accounts, and if your QIF file contains an investment account it will only be partially converted. The investment account will be converted to a bank account, and only bank related transactions (transfer, checks, deposits) will be transferred. Since QuickBooks can not contain stock purchases and similar investment transactions, they will not be transferred.


To run QIF2QBO Convert from the command line or a script simply invoke it on Windows as:

QIF2QBO inputfile.qif

Or for the portable version

QIF2QBOportable.jar inputfile.qif

There is no need to specify an output file name, QIF2QBO Convert will use the same name and an QBO extension. The log will be written to a file with the same name and a .log extension, or ERROR.log if the input file name is invalid.

Note that if the output file already exists, it will be overwritten. And if your input file name has any spaces in it, remember to use quotes – for example:

QIF2QBO “input file.qif”

Importing QBO files into QuickBooks

The easiest way to import the QBO file into QuickBooks is simply to double-click it from Windows Explorer or Max OS X Finder. You can also read the QBO file while running QuickBooks. Simply select File, then from the pull-down menu select Utilities, then Import, and then Web Connect File... This will bring up the standard File Open dialog, select the file, and then select Open. The transactions should be read into QuickBooks.

If you are using QuickBooks Online, then open the account into which you want to import the QBO file. There is an Update menu in the upper right. Select the down-arrow next to Update, and then select File Upload.  Select Browse, navigate to the QBO file on your computer, select it, and select Open, and Next. The transactions should be read into QuickBooks Online.

Trouble Shooting

Cannot find your Financial Institution in the list of FID’s.

If your Financial Institution is not listed for the type of account your are imported (bank or credit card) then you will have to ‘fool’ QuickBooks by using the FID of some other Financial Institution. QuickBooks will NOT import transactions with FID’s from banks that are not QuickBooks affiliates. You can use pretty much any other FID you want, one would suggest a similar name to your Financial Institution and/or a large bank that is unlikely to drop QuickBooks support. See the following section for more details as well.

QuickBooks Error: “QuickBooks is currently unable to verify the financial institution for this download. Please try again later.

When you import the QBO file into QuickBooks, if you receive an error “QuickBooks is currently unable to verify the financial institution for this download. Please try again later.” then the FID is incorrect. QuickBooks is very picky about this. The financial institution must be currently in good standing with QuickBooks for Web Connect download, and the account must be of the correct type. QuickBooks distinguishes between financial institution support of bank versus credit card transactions.

QIF2QBO Convert will only display those FID’s that are listed as being able to import Web Connect files, so if you don’t see your bank or brokerage, QuickBooks will not accept Web Connect files from that financial institution. Also, even though a bank may be listed, QuickBooks may still give this error. That problem seems mostly to occur with small banks, perhaps they did not stay current with QuickBooks.

If you are running into a brick wall with QuickBooks FID’s, the workaround is to use an FID for some other financial institution other than the one you actually use. However, if you already are downloading from your financial institution, then you would have to have two accounts and copy transactions from one to the other. Therefore, this is practical only if you don’t already download directly from that financial institutional, or you import transactions very infrequently.

If QuickBooks is refusing to link a QBO import to an existing account, then make sure that the account type was set correctly – see the section above on Setting QuickBooks Account Info. QuickBooks will only allow you to import credit card QBO files to credit cards accounts, and bank account QBO files to bank accounts. If the account number was not specified accurately in the QuickBooks Account Info, then QuickBooks will generally allow you to do a manual match, but it will also change the account number in QuickBooks.

Multiple Accounts in a singe file

Because a QBO file can only contain transactions from a single financial institution, QIF2QBO Convert will only process the first account found in a QIF file when creating a QBO file.

Saving the QIF2QBO Convert Log

After QIF2QBO Convert has run, you may wish to save the log information to a file. Select the File menu, and the Save Log menu entry. This will bring up a File Save dialog. Simply specify a file name and select Save.