Knowledgebase: Installation
[QODBC-Desktop] QODBC Quick Start Guide
Posted by Jack - QODBC Support on 09 September 2016 12:00 PM

QODBC Quick Start Guide

Download: QODBC 2023 Quick Start Guide (PDF)

QODBC Driver License Agreement



What is ODBC?

ODBC (Open DataBase Connectivity) is a specification designed by Microsoft to:

1. Allow Windows applications to access multiple data sources through a single method regardless of the underlying file formats;
2. Overcome the problem of different databases having different means of providing access to the information contained within them and;
3. Simplify access requirements so that the user does not need special skills to access databases.
4. In the same way that Windows has created an environment where all applications have a similar look and feel, ODBC drivers make all database formats look the same.


What is QODBC?

QODBC is an ODBC driver (DLL) for QuickBooks data. QuickBooks by default stores its data in its own proprietary database file format (.qbw). Our driver allows users of any application that can connect to ODBC data sources to read and write data contained in QuickBooks format files.

QODBC works by accepting SQL (Structured Query Language) commands through the ODBC interface, then converting those calls to navigational commands to the QuickBooks application interface (QuickBooks SDK) and returning record sets that qualify for the query results. QODBC will not work without an installed QuickBooks application and SDK layer to read the data from the proprietary internal database.

If you are not familiar with the SQL language, you can find a tutorial here:


What can I do with QODBC?

QODBC opens up your QuickBooks data to a whole new world of database connectivity.

·         If you own Microsoft Office, you can use Excel to extract company accounting or invoice information directly into a spreadsheet and create a chart.

·         Microsoft Word can run a customer mail merge for a customized batch letter directly from QuickBooks files.

·         Crystal Pro Report writer can create multi-file reports from QuickBooks data.

·         Microsoft Access or Embarcadero Delphi can be used to merge QuickBooks data with other data sources to produce complex reports, or to run mass file updates based on multiple criteria.

Best of all, this driver is transparent, invisible, and works just like any other ODBC driver. QuickBooks application developers now can offer this driver to their customers to allow them direct access to data important to them through custom third-party applications. Business owners who require up-to-the-minute data to make informed business decisions can have that real-time data instantly available in any one of hundreds of desktop applications.




Initial Setup

First, make sure the QuickBooks application is installed on the machine. QODBC cannot access your QuickBooks company file data unless QuickBooks is installed on the machine. Click here to get the specifics on why the QuickBooks application is required.

Right-Click on the Install program (qodbc.exe) and click “Run as Administrator” to install the driver. For more information or help regarding installation, please click here.

You will be asked to select the Region of QuickBooks you are using, this should match the version of the driver you purchased.


Next, select the destination directory to install the QODBC support files. You can skip the Activation Key if you want to evaluate the product before purchase. Click "Next" to continue.



The FLEXquarters QODBC Driver for QuickBooks® has been successfully installed on your computer. You can begin to use it immediately under the terms of the free 30-day evaluation. It will work with all editions of QODBC, depending on how it is configured. Note that the evaluation version limits inserts of records into QuickBooks to 20 per session.

Windows 8 and higher users click here for additional details.

To install a fully purchased QODBC registration code to an evaluation copy from a previous download, see the Icons that have been added to your Start Menu under QODBC Driver for QuickBooks®


The first step in configuring the driver is to click on the QODBC Setup Screen icon. The following screen will be displayed.




Click on the "Test Connection to QuickBooks" button to determine if you have a proper installation and settings with QuickBooks and a company file open. The following popup screen should appear:



Note: If you encounter a Windows security issue or Test Connection fails, please click here.

See QODBC Setup Options for more details on options available.


First use of QODBC after setup is complete

Start the QuickBooks Application. QODBC cannot access your QuickBooks data unless QuickBooks itself is running.

Note: QuickBooks application and QODBC Test tool should be launched normally. Do not start the application as "Run as Administrator". 

Both applications should be running under the same Windows User context (Elevated=No)


If the QuickBooks application is as “Run as Administrator” (Elevated=Yes). Close QuickBooks and start QuickBooks normally. If QuickBooks by default runs in Elevated Mode = Yes, then make sure Windows UAC is set to “Default” level, check QuickBooks application shortcut properties, and remove “Run as Administrator”. Restart the machine and start the QuickBooks application again.



Log in to your company file as QuickBooks user “Admin”. Switch to Single User Mode.

Click on the “QODBC Support Wizard” icon from the Windows start menu.

Follow the wizard instructions.

On the QODBC DSN Verification step, make sure it passes all the checks.

In case you see a warning icon.

Please check the "FIX" button so the QODBC Support Wizard can automatically fix the issue.


Troubleshooting with QODBC Support Wizard.

In case you are not able to connect to QuickBooks, re-run the Support Wizard and select “No, I am not able to connect to QuickBooks” and click “Next”

From the FAQs and Knowledgebase, you may select a more relevant topic or use the search button to search our knowledgebase for a more specific keyword.

If you are still facing any issues, report the issue to us by creating a support ticket.


QODBC Test Tool


    • Start the QODBC Test Tool from the "Start" and "Programs" and locate QODBC Driver for the QuickBooks program group. Click on the QODBC Test Tool icon to launch the program supplied with QODBC.

    • To establish the connection, select "QuickBooks Data"(Default DSN) and click on "Connect"

After you click "Connect" a QODBC splash screen will pop up if you are using the QODBC Evaluation version of the product, and a mouse click will allow you to continue. No splash screen appears in the registered version.


When QODBC tries to access the company file for the first time, QuickBooks will ask you for permission to allow the driver to access your QuickBooks company file.



Note: QODBC does have a digital certificate, but since another application (QODBC Test Tool) is trying to access QuickBooks through QODBC and QuickBooks does not know what the application is, it must ask you for permission.




  • Check "Allow this application to access this company file."
  • Uncheck "Prompt before Allowing Access."
  • Check "Allow this application to log in automatically."
  • Check “Allow this application to access Social Security Numbers, cc information, and other personal data" if appropriate.


This procedure needs only be done once on a computer for QODBC to be able to connect with QuickBooks data from any other ODBC compliant application in the future.


Additionally, if you plan to modify the files, you will also need to choose “Multi-User Mode” from the Files menu in QuickBooks to allow this.






To change any of these options, from the QuickBooks Edit menu, select "Preferences" and then select "Integrated Applications".


  • Click the Company Preferences tab and make sure the "Don't allow any applications to access this company file" checkbox is not checked.
  • The "Notify the user before running any applications whose certificate has expired" checkbox can be checked.  If it is, however, automatic access will be suspended if the application's certificate expires.
  • Select the FLEXquarters QODBC driver you want to run automatically and click Properties.


After accepting the certificate, you can see we are connected to the QuickBooks company file.

You can view your customer data by clicking on the Run button, or you can remove the default SQL statement and type in your own SQL statement to view the data you wish to be displayed. To explore the data available in QuickBooks via QODBC, click here.


Testing Driver Capabilities

Once permissions have been granted in QuickBooks for QODBC to access the company file via the QODBC Test Tool and the Current Connection Window shows “QuickBooks Data”, you can obtain a list of all the QuickBooks tables by executing SP_TABLES



To disconnect the QODBC Test Tool from your QuickBooks company file, Click the "Disconnect" button.


QODBC Frequently Asked Questions

The Frequently asked questions about this product are constantly changing, so we have a web page set up with these questions and answers. A more detailed FAQ can be found at:


Tutorials and Documentation

Additional information can be found on our website, including a full manual, step-by-step tutorials for popular applications, FAQs, data layout of QuickBooks, and video tutorials.



·         Data Layouts (Schema)

·         FAQ

·         QODBC Manual & QODBC White Papers


Step by Step Tutorials

·         Connecting to QuickBooks for the First Time

·         64-bit Applications

·         Microsoft Access

·         Microsoft Visual Basic and ADO

·         Microsoft Excel

·         Microsoft Word

·         Microsoft Office

·         Crystal Reports

·         Alpha Five

·         Microsoft SQL Server

·         Web Edition/Cold Fusion

·         Web Edition/PHP

·         Create Sales Receipts

·         Create Invoices

·         Purchase Orders

·         Create Bills

·         Deposits

·         Inventory Adjustments


Windows Support

QODBC version 2023 supports Microsoft Windows XP, Windows Vista, Windows 7, Windows 8, Windows 8.1, Windows 10 and Windows 11.


Product Support

We offer a free fully functional trial copy of QODBC limited to selected elements in the QuickBooks system. An FAQ section and a Help Desk support system are available for registered users and those evaluating QODBC. Those purchasing the product will receive installation support at no charge for 30 days from the date of purchase. Program anomalies will be addressed at no charge and updates posted on our website. Other issues may be subject to a fee.


Support can be obtained by the following methods:


Forum Online Support:


Mail:                                      FLEXquarters USA Sales

                                       P.O. Box 1466  Clarkston, MI 48347

The most effective of these methods is the online support system via our website since you can attach an ODBC or SDK trace log to the message, and we can attach an updated product to you if we have a patch.


Product Updates


The latest updated versions will always be available online at our web page:


QODBC Credits

QODBC versions 2.x thru 23.x

For Microsoft Windows, Windows XP, Vista, Windows 7, Windows 8, Windows 10, and Windows 11.


© Copyright 1995-2023, Limited, All Rights Reserved Worldwide


Portions of this product © Copyright Intuit Incorporated

QODBC is a trademark of Limited

QuickBooks Pro, QuickBooks Premier, QuickBooks Enterprise Solution, and QuickBooks Online Edition are registered trademarks of Intuit Incorporated

Windows, Vista, Windows 7, Windows 8, Windows 10, and Windows 11 are registered trademarks of Microsoft Corporation All other trademarks are the property of their respective holders.


Version 2.0 First released October 2002
Version 3.0 First released January 2003
Version 4.0 First released November 2003
Version 5.0 First released October 2004
Version 6.0 First released November 2005
Version 7.0 First released October 2006
Version 8.0 First released September 2007
Version 9.0 First released October 2008
Version 10.0 First released September 2009
Version 11.0 First released October 2010
Version 12.0 First released October 2011
Version 13.0 First released September 2012
Version 14.0 First released September 2013
Version 15.0 First released September 2014
Version 16.0 First released September 2015
Version 17.0 First released September 2016
Version 18.0 First released September 2017
Version 19.0 First released September 2018
Version 20.0 First released September 2019
Version 21.0 First released September 2020
Version 22.0 First released August 2021
Version 23.0 First released September 2022


Program published and supported by:

USA Mailing Address:
2620 S Maryland Pkwy Ste 14-557
Las Vegas, NV 89109-1692



Fax:                               801-306-6619


USA Sales Office:

FLEXquarters USA Sales

P.O. Box 1466

Clarkston, MI 48347


Voice:                           248-620-2400

Licensing Support:        248-620-2406 (Registered user activation/deactivation issues only)


Other Regional Sales Numbers:

Australia/New Zealand/Southeast Asia:   +61 3 9761 3644

International:   +1 248-620-2400


The program developed by Brad Waddell and Matthew Froncek.

Documentation produced by Mark Kuznar, Brad Waddell, Rajendra Dewani and

Matthew Froncek.



Tags: configurations, permissions, user rights 

(0 vote(s))
Not helpful

Comments (0)
Post a new comment
Full Name:
CAPTCHA Verification 
Please complete the captcha below (we use this to prevent automated submissions).