The Tech bonuses top menu now goes to /tech_bonuses/current, which redirects to the week containing today. The index (week picker and weeks run) is limited to Run tech bonuses: View tech bonuses only covers a week's page, whose title links to the index only for those who can run the bonus. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
4.2 KiB
Redmine QBO Bonus
The weekly billable hours bonus for shop technicians (SOP-OPS-012, Weekly Billable Hours Bonus Program), paid as QuickBooks Online credit memos on each technician's customer account.
The bonus is a team goal. Everyone's billable hours count toward the shop's weekly total. That includes the technicians, the Foreman, and anyone else picked in the settings, such as front desk staff who help in the shop. Only the bonus technicians get the bonus.
- Week: Sunday through Saturday. It's named like Redmine's time report weeks (
2026-47), by the year and ISO week number of its Monday. - Billable hours: the time logged that week on the picked projects (with their subprojects), on every tracker except the picked ones (or only the picked ones).
- Target: 110 shop hours. A shop that reaches it earns each technician $100 and the Foreman $150.
- Tiers: every full 15 hours above the target (125, 140, ...) earns each technician another $100 and the Foreman another $150.
- Eligibility: a technician in their 90-day probation that week gets no bonus. Neither does one who missed any part of a scheduled shift; that one is unchecked when the week is run.
All the numbers can be changed in the settings.
The credit memo
Each qualifying technician gets one credit memo per week on their QuickBooks customer account. It's emailed to the email on that account.
Tech Bonus 2026-47 127.5/110 hours (total/goal) 1 x $100.00 $100.00
Tier Bonus 2026-47 1 x 15 hours over goal 1 x $100.00 $100.00
The tier line is only there when a tier was reached. Both lines use the product/service picked in the settings, which sets the account the bonuses are booked to. They're non-taxable.
Running a week
Tech bonuses (top menu) opens this week, so far. For those who run the bonus, its title links to the weeks run so far and a week picker. A week shows:
- the shop's hours, the goal, the tiers reached and the hours to the next tier;
- each technician's hours and bonus, with an Attended box. Uncheck a technician who missed part of a scheduled shift;
- the hours of everyone whose time counted, with a link to Redmine's time report using the same filters, to check them.
Once the week is over, Create & email credit memos makes and emails the credit memos. The page then links each one in QuickBooks and shows whether it was emailed. A week can be run again, for example after fixing a technician's customer account or attendance. Running it again only makes the credit memos still missing, so nobody is credited twice. Email again resends a credit memo.
Requirements
- Redmine 7
- redmine_qbo 2026.11.0 or later, connected to QuickBooks Online
Installation
cd /path/to/redmine/plugins
git clone https://gitea.rickbarrette.org/ricky/redmine_qbo_bonus.git
cd ..
bundle exec rake redmine:plugins:migrate
Restart Redmine, then:
- In QuickBooks, make a service (e.g. Tech Bonus) booked to the account the bonuses should go to, then sync products/services in Redmine (Administration » Items).
- Administration » Plugins » Redmine QBO Bonus plugin » Configure:
- Pick the projects, the trackers to leave out, and anyone besides the technicians whose time counts. With no users picked, everyone's time counts.
- Check the target and amounts.
- Pick the product/service.
- Administration » Bonus technicians: add each technician and the Foreman. Give each one their role, the QuickBooks customer account their bonus is credited to, and the last day of their probation if they're in it.
- Administration » Roles and permissions: give Run tech bonuses to the roles that run the bonus, and View tech bonuses to those who only see a week's hours and bonuses (e.g. the Foreman), without the weeks run. They're global permissions, so they apply to any role the user has in any project.
View tech bonuses shows the weeks and each week's hours, tiers and bonuses, read-only. It doesn't show the technicians' customer accounts, the attendance boxes, or the credit memos' QuickBooks and PDF links, and it can't run a week or email a credit memo.
Tests
RAILS_ENV=test bundle exec rake redmine:plugins:test NAME=redmine_qbo_bonus