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?
-
How to Get API Keys to Create Connection with QuickBooks Online
-
Video tutorials: from connecting your company to syncing payments