Redmine

Redmine QuickBooks Online

A plugin for Redmine to connect to QuickBooks Online.

The goal of this project is to allow Redmine to connect with QuickBooks Online to create Time Activity Entries for billable hours logged when an Issue is closed.

Disclaimer

Note: Although the core functionality is complete, this project is still under development, and the master branch may be unstable.

Tags should be stable and are recommended.

Compatibility

Features
See README.md on Github

Usage

To enable automatic Time Activity entries for an Issue, you simply need to assign a Customer to an Issue via the dropdowns in the issue creation/update form.

Note: After the initial synchronization, this plugin will receive push notifications via Intuit's webhook service.

Prerequisites

• Sign up to become a developer for Intuit: https://developer.intuit.com/
• Create your own application to obtain your API keys.
• Set up the webhook service to `https://redmine.yourdomain.com/qbo/webhook`

1. Clone the plugin:
Clone this repo into your plugin folder and checkout a tagged version.

cd path/to/redmine/plugins
   git clone git@github.com:rickbarrette/redmine_qbo.git
   cd redmine_qbo
   git checkout <tag>

2. Install dependencies: Crucial for Redmine 6 / Rails 7 compatibility.

bundle install

3. Migrate your database:

bundle exec rake redmine:plugins:migrate RAILS_ENV=production

4. Restart Redmine: You must restart your Redmine server instance for the plugin and hooks to load.

5. Configuration:

• Navigate to the plugin configuration page (`Administration > Plugins > Configure`).

• Supply your own OAuth Key & Secret.

• After saving the Key & Secret, click the Authenticate link on the configuration page to connect to QBO.

6. User Mapping:

• Assign an Employee to each of your users via the User Administration Page.