ofx2qfx Convert | Help

Getting Started

OFX2QFX Convert is a single step financial data translator to from generic OFX format to QFX format suitable for Quicken® software.

Use OFX2QFX Convert to import transaction data into Quicken when you are only able to download OFX format from your bank.

To get started first set your Quicken account information with the Settings menu.

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

Read the QFX file from within Quicken using File, File Import, Web Connect File. Do NOT try to read as a Quicken Transfer File (.QXF) which is something else entirely.

Installation

  • Microsoft Windows® full install
    • Download OFX2QFX.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 OFX2QFX.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 OFX2QFX.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 OFX2QFXportable.jar should be in your user download folder.
      • If running on other operation systems run zip or winzip on OFX2QFX.zip and extract OFX2QFXportable.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 OFX2QFX.lic from the product confirmation e-mail to the same folder where you installed OFX2QFX Convert – i.e. C:\Program Files\MoneyThumb\OFX2QFX.

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.

Preparation

There are two things to do before running OFX2QFX Convert:

  1. Create a OFX file. Most of the time this will be downloaded from a bank site, or perhaps created by another software application.
  1. Get the account number of the Quicken 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 Quicken will match up the account numbers, and you will want to import into the correct account.

 

Running OFX2QFX Convert

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

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

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

Setting Quicken Account Info

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

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

Set Quicken Account Info

Select “Lookup…” in the dialog and it will bring up a window with all the Quicken 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 or brokerage is not listed, then Quicken will not import QFX 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 Quicken 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 OFX2QFX Convert will run without one, it will give a warning, and Quicken will give an error when reading the QFX file.

QFX files are required to have account information. All files require an account number and bank accounts also require a bank routing number. Both of these should be present in your OFX file, and assuming that they are, you do not need to enter them. However, if you want to override that information, you can do so in this dialog. The OFX2QFX Convert log will display the routing number and account number which are used, and if they are not correct, you can change that here. Note that OFX2QFX 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.

Converting the OFX File to QFX

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

All of the data in a OFX file will be converted directly into the QFX file. You can verify the transactions in the OFX2QFX Convert log.

Automation

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

OFX2QFX inputfile.ofx

Or for the portable version

OFX2QFXportable.jar inputfile.ofx

There is no need to specify an output file name, OFX2QFX Convert will use the same name and an QFX 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:

OFX2QFX “input file.ofx”

Importing QFX files into Quicken

The easiest way to import the QFX file is simply to double-click it from Windows Explorer or Max OS X Finder. You can also read the QFX file while running Quicken. Simply select File, then from the pull-down menu select File 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 Quicken.

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’ Quicken 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.

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

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

OFX2QFX Convert will only display those FID’s that are listed as being able to import Web Connect files of the account type you selected. If you don’t see your bank or brokerage, Quicken will not accept Web Connect files from that financial institution. Quicken tends to have different names for banks and brokerages at the same financial institution and if your financial institution does not support web connect for the type of account you are trying to import, then even though you choose a bank with the same name as your brokerage, you will get the error listed above when trying to import into Quicken. Also, even though a bank may be listed, Quicken may still give this error. That problem seems mostly to occur with small banks, perhaps they did not stay current with Quicken.

If you are running into a brick wall with Quicken FID’s, one 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 Quicken is refusing to link a QFX import to an existing account, then make sure that the account type was set correctly – see the section above on Setting Quicken Account Info. Quicken will only allow you to import credit card QFX files to credit cards accounts, bank account QFX files to bank accounts, and so forth. If the account number was not specified accurately in the Quicken Account Info, then Quicken will generally allow you to do a manual match, but it will also change the account number in Quicken.


No transactions visible in Quicken when you import the QFX file

The most common reason for this is that you need to accept the transactions into the Quicken account register. In Quicken, go to the account register, select the Downloaded Transactions tab at the bottom of the register, and accept the transactions.

Saving the OFX2QFX Convert Log

After OFX2QFX 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.