1 Dashboard
2 Types
3 Codes
4 Postings
5 Rules
6 Payroll
7 Planned
1 / Dashboard Live
9:41
Commissions
Pending
$4,250
Approved
$12,800
Total Paid
$87,450
Commission Management
Commission Types
14 COES types
Commission Codes
12 active codes
Payroll Classes
6 classes
Payroll Batches
3 pending
Pending Approvals
View All (8) →
Jake Morrison L LABR-01
Job #4281 · Feb 21
$340
ST
Sarah Thompson S SALE-01
Job #4279 · Feb 20
$680
Mike Rodriguez B BONS-01
Job #4275 · Feb 19
$500
Top Earners
1
Jake Morrison
28 commissions
$14,820
2
ST
Sarah Thompson
22 commissions
$12,450
3
Mike Rodriguez
19 commissions
$9,340
4
LW
Lisa Wilson
16 commissions
$7,680
5
Tom Davis
14 commissions
$6,120
2 / Commission Types Live
9:41
Commission Types
14 COES-style commission types for categorizing all contractor compensation structures.
Bonus
Performance bonuses and incentives
3 codes
Contract
Signed agreement commissions
2 codes
Demand
Emergency dispatch commissions
2 codes
Financing
Loan and financing deal bonuses
1 code
Labor
Hourly and installation payouts
2 codes
Lead Gen
Referral generation commissions
1 code
Turnover
Equipment replacement sales
1 code
Other
Miscellaneous commissions
0 codes
Performance
KPI and review score commissions
2 codes
Quality Control
Inspection and QA bonuses
1 code
Parts/Spiffs
Manufacturer spiff incentives
2 codes
Sales
Revenue-based sales commissions
4 codes
Technician
Service and install payouts
2 codes
Tune-Up
Seasonal maintenance payouts
1 code
3 / Commission Codes Live
9:41
Commission Codes
All B C D F L M P S T
12 codes
S
SALE-01
Percentage · G/L 5100-10
8%
S
SALE-02
Flat rate · G/L 5100-20
$150
S
SALE-03
Percentage · G/L 5100-30
5%
B
BONS-01
Flat rate · G/L 5200-10
$500
B
BONS-02
Tiered · G/L 5200-20
3-tier
L
LABR-01
Percentage · G/L 5300-10
12%
C
CNTR-01
Percentage · G/L 5400-10
6%
D
DMND-01
Flat rate · G/L 5500-10
$75
P
PERF-01
Tiered · G/L 5600-10
5-tier
4 / Commission Postings Live
9:41
Commission Postings
All Pending Approved Posted Paid
8 postings
Jake Morrison L LABR-01
Job #4281 · Feb 21
$340
ST
Sarah Thompson S SALE-01
Job #4279 · Feb 20
$680
Mike Rodriguez B BONS-01
Job #4275 · Feb 19
$500
LW
Lisa Wilson D DMND-01
Job #4273 · Feb 19
$75
Tom Davis C CNTR-01
Job #4270 · Feb 18
$420
Jake Morrison S SALE-03
Job #4265 · Feb 17
$225 Approved
ST
Sarah Thompson P PERF-01
Job #4260 · Feb 16
$890 Posted
Mike Rodriguez L LABR-01
Job #4255 · Feb 15
$560 Paid
5 / Commission Rules Live
9:41
Commission Rules
Rules modify commission payouts based on conditions. Higher priority rules are evaluated first.
1
First Job Bonus
All Roles First job at property
5% + $25.00 (adds to base)
2
Weekend Premium
Technicians After hours Holiday
8% + $15.00 (overrides base)
3
Multi-Service Upsell
All Roles Multi-service job 3+ services
3% (adds to base)
4
Repeat Customer Loyalty
Inactive
Sales Repeat customer
2% + $10.00 (adds to base)
6 / Create Commission Rule Live
9:41
Create Commission Rule
Rule Information
Lower number = higher priority
All Roles Technicians Sales Installers
Conditions
First Job at Property
Triggers on first visit to a property
Repeat Customer
Customer has previous completed jobs
Multi-Service Job
Job includes multiple service types
Min services:
Holiday
Job performed on a recognized holiday
After Hours
Job outside standard business hours
Commission Payout
%
and / or
$
Override Base Commission
Replace base payout instead of adding to it
7 / Edit Commission Rule Live
9:41
Edit Commission Rule
Rule Active Active
Rule Information
Lower number = higher priority
All Roles Technicians Sales Installers
Conditions
First Job at Property
Triggers on first visit to a property
Repeat Customer
Customer has previous completed jobs
Multi-Service Job
Job includes multiple service types
Min services:
Holiday
Job performed on a recognized holiday
After Hours
Job outside standard business hours
Commission Payout
%
and / or
$
Override Base Commission
Replace base payout instead of adding to it
8 / Commission Summary Live
9:41
Commission Summary
This Week This Month This Quarter YTD
Total Earned
$24,850
+12% vs last month
Pending
$3,200
4 jobs awaiting approval
Paid Out
$18,400
Last payout: Mar 1
Approved
$3,250
Next batch: Mar 15
Commission Management
Configure types, codes, rules & payroll
Commission Types
Sales, Service, Bonus & more
Commission Codes
14 active codes
Commission Rules
3 active rules
Payroll & Batches
Next batch: Mar 15
Top Earners
This month
1
MR
Marcus Rodriguez
Sales · 18 jobs
$6,240
2
AK
Aisha Khan
Technician · 24 jobs
$5,180
3
JT
Jake Thompson
Installer · 12 jobs
$4,320

commissions.getDashboardSummary()

Owner/admin overview with period filtering, management nav, and team leaderboard

9 / Payroll Config Live
9:41
Payroll Config
Payroll Provider
3Bids Payouts Gusto ADP Manual
Connected to Stripe
Direct deposits via 3Bids Payouts. Team members receive funds automatically.
Pay Cycle
Weekly Bi-Weekly Monthly
Auto-approve commissions
Skip manual approval before payout
Role Defaults
Sales
Base: 10% New Customer: +$25
Technician
Base: 8% After Hours: +$15
Installer
Base: 12% Multi-Service: +5%

commissions.getPayrollConfig()

Owner configures payroll provider, pay cycle, and default commission rates per team role

10 / Payroll Batches Live
9:41
Payroll Batches
Create Payroll Batch
12 approved commissions · $8,450 total
Batch History
Export All
Batch #2026-005 Paid
Mar 1 · 8 team members · 22 commissions
$12,340
Batch #2026-004 Processing
Feb 15 · 6 team members · 15 commissions
$9,870
Batch #2026-003 Paid
Feb 1 · 8 team members · 19 commissions
$11,200
Batch #2026-002 Paid
Jan 15 · 7 team members · 16 commissions
$10,580
Export Options Download batch reports as CSV, PDF, or sync directly to your payroll provider.

commissions.getPayrollBatches()

Create, review, and export payroll batches with full history and status tracking

11 / Posting Presets Planned
9:41
Posting Presets
12 COES posting presets auto-calculate commission amounts based on job type, role, and conditions.
S
Standard Sale
8% of revenue · All sales roles
Active
B
Referral Bonus
$250 flat · Customer referral
Active
L
Labor Override
12% of labor cost · Install crews
Active
T
Tech Callback
$75 flat · Callback resolved
Active
D
Demand Dispatch
$100 flat · Emergency response
Draft
P
5-Star Review
$50 flat · Verified 5-star review
Active
Pro Tip Presets auto-generate commission postings when matched conditions are met on closed jobs.
12 / G/L Accounts Planned
9:41
G/L Accounts
18 accounts
5100-10 — Sales Commission
Commission Expense · 4 codes mapped
5200-10 — Bonus Expense
Commission Expense · 2 codes mapped
5300-10 — Labor Commission
Commission Expense · 2 codes mapped
5400-10 — Contract Commission
Commission Expense · 1 code mapped
5500-10 — Demand Commission
Commission Expense · 1 code mapped
5600-10 — Performance Commission
Commission Expense · 2 codes mapped
13 / Split Commission Rules Planned
9:41
Split Rules
Split commission rules divide a single job's commission across multiple team members based on roles and contribution.
1
Sales + Tech Split
Sales & Technician Multi-role job
Sales
60%
Tech
40%
2
Lead Gen + Closer
Lead Gen & Sales Referral chain
Lead Gen
25%
Closer
75%
Split Percentages All splits for a given rule must total exactly 100%. Adjust individual percentages before saving.
1 Dashboard
2 Codes
3 Postings
4 Payroll
Dashboard & Types Live
9:41
Commissions
Overview
$18,250
Total Earned
$4,800
Pending
42
Postings
7
Active Codes
Leaderboard
1
Marcus Rivera
Sales Lead
$6,420
2
Sarah Chen
Account Exec
$5,180
3
James Park
Field Rep
$3,950
4
Ana Torres
Inside Sales
$2,700
Commission Types (14 COES)
All Active
B
Base Commission
Standard percentage on closed jobs
8.5%
C
Closer Bonus
Extra for closing above target
3.0%
D
Demo Incentive
Flat fee per completed demo
$75
F
Finder’s Fee
Referral-sourced lead conversion
5.0%
L
Leadership Override
Manager override on team sales
2.0%
M
Monthly Bonus
Target-based monthly payout
$500
N
New Account
First-time customer premium
$150
+7 more types (O, P, Q, R, S, T, U)
Codes & Rules Live
9:41
Codes & Rules
Commission Codes
7 active
Code
Type
Rate
G/L
SALES-HVAC-01
B
8.5%
4010
SALES-ELEC-02
B
7.5%
4010
CLOSE-BONUS-Q1
C
3.0%
4020
DEMO-FLAT-01
D
$75
4030
LEAD-OVERRIDE
L
2.0%
4050
Commission Rules
4 rules
First Job Bonus
Priority 1
$100 flat bonus on first closed job
job_count = 1 status = closed
Monthly Target Bonus
Priority 2
Extra 2% when monthly sales exceed $10K
monthly_total > $10K type = percentage
HVAC Season Multiplier
Priority 3
1.5x multiplier on HVAC jobs Jun–Aug
category = HVAC month in [6,7,8]
Referral Premium
Priority 4
+$50 on referral-sourced jobs over $2K
source = referral job_value > $2K
Add New Rule
Postings & Approvals Live
9:41
Postings & Approvals
Pending Postings
5 pending
Marcus Rivera
HVAC Install • Job #1042
$425
pending
Sarah Chen
Electrical • Job #1038
$310
pending
James Park
Plumbing • Job #1035
$180
pending
Ana Torres
HVAC Repair • Job #1031
$220
pending
David Kim
Roofing • Job #1029
$560
pending
Marcus Rivera
Sales Lead • Posted Mar 12, 2024
Commission
$425.00
Job Value
$5,000
Code
SALES-HVAC-01
Type
B — Base
Rate
8.5%
Job
#1042 — HVAC Install
G/L Account
4010
Payroll & Export Live
9:41
Payroll & Export
Payroll Batches
Batch #2024-06
Mar 15 • 8 postings
$4,280
pending
Batch #2024-05
Mar 1 • 12 postings
$3,200
paid
Batch #2024-04
Feb 15 • 10 postings
$2,850
paid
Batch #2024-03
Feb 1 • 9 postings
$3,100
paid
Batch #2024-02
Jan 15 • 7 postings
$2,640
paid
Batch #2024-06
Created Mar 15, 2024 • Bi-weekly cycle
Pending Approval
$4,280
Total
8
Postings
4
Payees
Payee Breakdown
Marcus Rivera
$1,450
Sarah Chen
$1,180
James Park
$950
Ana Torres
$700
Export Format
CSV
PDF
1 Dashboard
2 Codes
3 Postings
4 Payroll
1 / Dashboard Live
https://app.3bids.io/contractor/commissions
Dashboard
Codes
Rules
Postings
Payroll
Summary
$18,250
Total Earned
$4,800
Pending
5
Active Codes
3
Active Rules
Recent Postings
HVAC Install — $510
Jake M. • Paid Mar 8
Electrical — $225
Sarah L. • Pending
Plumbing — $85
Tom R. • Pending
Top Earners
1
Jake Morrison
28 commissions
$14,820
2
Sarah Thompson
22 commissions
$12,450
3
Mike Rodriguez
19 commissions
$9,340
2 / Commission Codes Live
https://app.3bids.io/contractor/commissions/codes
Dashboard
Codes
Rules
Postings
Payroll
Summary
Search codes...
AllS — SalesB — BonusL — LaborT — TechnicianP — Performance
Code
Description
G/L Account
Rate
Status
SALE-01
Standard sales commission
5100-10
8%
Active
BONS-01
Performance bonus
5200-10
$500
Active
LABR-01
Labor commission
5300-10
12%
Active
CNTR-01
Contract commission
5400-10
6%
Active
3 / Postings Live
https://app.3bids.io/contractor/commissions/postings
Dashboard
Codes
Rules
Postings
Payroll
Summary
Commission Postings
AllPendingApprovedPaid
Description
Rep
Code
Amount
Status
HVAC Install — Residential
Jake Morrison
SALE-01
$510
Paid
Electrical Panel Upgrade
Sarah Thompson
SALE-01
$225
Pending
Plumbing Emergency
Mike Rodriguez
LABR-01
$340
Approved
HVAC Maintenance Contract
Lisa Wilson
CNTR-01
$180
Pending
4 / Payroll Batches Live
https://app.3bids.io/contractor/commissions/payroll
Dashboard
Codes
Rules
Postings
Payroll
Summary
Create Payroll Batch
12 approved commissions · $8,450 total
Batch History
Batch #2026-005
$12,340 • Mar 1 • Paid
Batch #2026-004
$9,870 • Feb 15 • Processing
Batch #2026-003
$11,200 • Feb 1 • Paid
Payroll Config
Provider
3Bids Payouts
Schedule
Bi-weekly
Min Threshold
$50.00
Next Pay Date
Mar 15

Data Architecture

Source Files

commission-dashboard.tsx
Dashboard — KPIs, leaderboard, trend charts
screen
commission-types.tsx
14 COES commission type definitions
screen
commission-codes.tsx
Code list — rate config, G/L mapping
screen
create-commission-code.tsx
Create/edit commission code form
screen
commission-rules.tsx
Rules list — priority, conditions, modifiers
screen
commission-postings.tsx
Postings list — per-job entries, approvals
screen
payroll-batches.tsx
Payroll batches — grouped payouts, export
screen

Convex Queries

getCommissionSummary
Aggregate pending, approved, paid totals
query
listCommissionTypes
All 14 COES types with active filter
query
listCommissionCodes
Codes with type/rate/G/L, search + filter
query
getCommissionCode
Single code with tiered rates + scope
query
listCommissionRules
Rules with priority, conditions, payout modifiers
query
listCommissionPostings
Per-job entries with status filter
query
getCommissionLeaderboard
Top earners ranked by total
query
listPayrollBatches
Grouped payouts with export status
query
getPayrollBatch
Batch detail with rep breakdown
query

Convex Mutations

createCommissionCode
Rate config + G/L account + tiered tiers
mutation
updateCommissionCode
Partial update by codeId
mutation
createCommissionRule
Priority + conditions + payout modifiers
mutation
deleteCommissionRule
Soft delete by ruleId
mutation
approveCommissionPosting
Move pending → approved
mutation
reverseCommissionPosting
Reverse with reason + audit trail
mutation
createPayrollBatch
Group approved postings into batch
mutation
approvePayrollBatch
Approve for export
mutation
exportPayrollBatch
QuickBooks, CSV, ADP, Gusto formats
mutation
initializeCommissionTypes
One-time seed of 14 COES defaults
mutation

Commission Posting Flow

pending approved posted paid
Terminal: reversed

Key Design Decisions

14 COES Types
Each mapped to a unique saturated color for instant visual identification
Tiered Calculation
Percentage, flat-fee, hourly, per-unit, formula models
G/L Account Mapping
Credit/debit/department on every code for accounting integration
Approval Workflow
pending → approved → posted → paid with reversal + audit trail
Payroll Export
QuickBooks, CSV, ADP, Gusto format support for batch payouts
Rule Priority
Higher priority rules override lower for same transaction