Ready to get started?

Download a free trial of the QuickBooks POS Driver to get started:

 Download Now

Learn more:

QuickBooks POS Icon QuickBooks POS JDBC Driver

Complete read-write access to QuickBooks Point of Sale enables developers to search (Customers, Transactions, Invoices, Sales Receipts, etc.), update items, edit customers, and more, from any Java/J2EE application.

Connect to QuickBooks POS Data in JRuby

Create a simple JRuby app with access to live QuickBooks POS data.

JRuby is a high-performance, stable, fully threaded Java implementation of the Ruby programming language. The CData JDBC Driver for QuickBooks POS makes it easy to integrate connectivity to live QuickBooks POS data in JRuby. This article shows how to create a simple JRuby app that connects to QuickBooks POS data, executes a query, and displays the results.

Configure a JDBC Connection to QuickBooks POS Data

Before creating the app, note the installation location for the JAR file for the JDBC Driver (typically C:\Program Files\CData\CData JDBC Driver for QuickBooks POS\lib).

JRuby natively supports JDBC, so you can easily connect to QuickBooks POS and execute SQL queries. Initialize the JDBC connection with the getConnection function of the java.sql.DriverManager class.

When you are connecting to a local QuickBooks instance, you do not need to set any connection properties.

Requests are made to QuickBooks POS through the Remote Connector. The Remote Connector runs on the same machine as QuickBooks POS and accepts connections through a lightweight, embedded Web server. The server supports SSL/TLS, enabling users to connect securely from remote machines.

The first time you connect, you will need to authorize the Remote Connector with QuickBooks POS. See the "Getting Started" chapter of the help documentation for a guide.

Built-in Connection String Designer

For assistance in constructing the JDBC URL, use the connection string designer built into the QuickBooks POS JDBC Driver. Either double-click the JAR file or execute the jar file from the command-line.

java -jar cdata.jdbc.quickbookspos.jar

Fill in the connection properties and copy the connection string to the clipboard.

Below is a typical JDBC connection string for QuickBooks POS:


Create a JRuby App with Connectivity to QuickBooks POS Data

Create a new Ruby file (for example: QuickBooksPOSSelect.rb) and open it in a text editor. Copy the following code into your file:

require 'java' require 'rubygems' require 'C:/Program Files/CData/CData JDBC Driver for QuickBooks POS 2018/lib/cdata.jdbc.quickbookspos.jar' url = "jdbc:quickbookspos:" conn = java.sql.DriverManager.getConnection(url) stmt = conn.createStatement rs = stmt.executeQuery("SELECT ListId, AccountLimit FROM Customers") while ( do puts rs.getString(1) + ' ' + rs.getString(2) end

With the file completed, you are ready to display your QuickBooks POS data with JRuby. To do so, simply run your file from the command line:

jruby -S QuickBooksPOSSelect.rb

Writing SQL-92 queries to QuickBooks POS allows you to quickly and easily incorporate QuickBooks POS data into your own JRuby applications. Download a free trial today!