Installation of QuickBooks Online Connector

This article explains how to install the QuickBooks Online Connector on Odoo.sh and on an on-premise Odoo server.

Installation on Odoo.sh

Step 1: Add the connector to your repository

Add the connector modules to your Odoo.sh repository and push them. The connector needs two Python libraries; if your repository doesn’t install them yet, add them to requirements.txt at its root:

python-quickbooks==0.9.1
pycountry==20.7.3

Step 2: Configure Queue Job

Open the Odoo.sh Shell and edit the configuration file:

nano /home/odoo/.config/odoo/odoo.conf

Add the following settings:

server_wide_modules = base,rpc,web,integration_queue_job

; Keep the [queue_job] section at the end of the file
[queue_job]
channels = root:1
scheme = https
host = <your_odoo_host>
port = 443

Step 3: Restart Odoo.sh

Save the file and restart your instance from the Shell:

odoosh-restart http

Step 4: Install the module

In Odoo, activate developer mode, open Apps and click Update Apps List. Then search for QuickBooks and install Odoo QuickBooks Online Connector PRO.

Installation on an on-premise server

Step 1: Add the connector to your addons

Copy the connector modules into a folder listed in the addons_path of your Odoo server.

Step 2: Install the Python libraries

Install them in the same Python environment that runs Odoo:

pip install python-quickbooks==0.9.1
pip install pycountry==20.7.3

Step 3: Configure Queue Job

Add the same settings to your odoo.conf file. Its location depends on your server setup.

server_wide_modules = base,rpc,web,integration_queue_job

; Keep the [queue_job] section at the end of the file
[queue_job]
channels = root:1
scheme = https
host = <your_odoo_host>
port = 443

Queue Job needs Odoo to run in multi-worker mode: make sure workers is set to 2 or more in odoo.conf.

Step 4: Restart Odoo

Restart the Odoo service, for example:

sudo systemctl restart odoo

The exact command depends on how Odoo is deployed (systemd, Docker and so on).

Step 5: Install the module

In Odoo, activate developer mode, open Apps and click Update Apps List. Then search for QuickBooks and install Odoo QuickBooks Online Connector PRO.

Check the installation

  • The QuickBooks Online app appears in the Odoo main menu.

  • After you connect your QuickBooks Online company and run the Initial Import, the jobs in QuickBooks Online → Jobs move from Pending to Done.

What’s next?