Purpose
BuildTools pulls cost data from QuickBooks Online (QBO) at the item (product/service) level. Payroll, however, posts directly to the general ledger (GL) without using items. This creates a gap where labor costs don’t flow into BuildTools.
This guide explains how to bridge that gap using a $0 Vendor Bill approach so labor costs appear in BuildTools job costing without affecting the books in QuickBooks.
✅ What You Need Before Starting
QuickBooks Online (QBO) with company file access.
BuildTools–QBO integration already connected.
Payroll data available in QBO (either internal QBO Payroll or outside service like ADP/Paychex).
Must be able to report labor costs by job (dollars or hours).
Product/Service Item(s) in QBO
Create at least one Service Item called Labor (or multiple: Framing Labor, Trim Labor, etc.).
Map each Labor item to a special GL account (e.g., Job Costed Wages) that will always net to zero.
🔧 Step 1: Create the Labor Service Item
In QBO, go to Settings → Products and Services.
Click New → Service.
Name it Labor (or a specific type of labor, if you want to track separately).
Link it to a GL account called Job Costed Wages (a clearing account).
This account should always remain $0 because entries will debit and credit the same account.
🔧 Step 2: Capture Payroll Dollars or Hours
From QBO payroll or outside service:
Run a P&L by Customer/Job report to see labor costs allocated by job.
If using timesheets, pull hours per job.
Decide whether to push into BuildTools as:
Actual payroll costs (wages + taxes), OR
Burdened labor rates (e.g., 40 hours × $50/hour).
🔧 Step 3: Enter a $0 Vendor Bill
This step “translates” payroll into BuildTools-readable data.
In QBO, go to + New → Vendor Bill.
Vendor = Labor Job Costing (create a dummy vendor for this purpose).
Enter line items:
Choose the Labor service item.
Assign the correct Customer/Job.
Enter the dollar amount for that job’s labor.
QBO will auto-post debit/credit to Job Costed Wages, keeping GL at zero.
Ensure the total of the bill is $0.00 (offsetting line balances).
Save.
🔧 Step 4: Sync with BuildTools
On next sync, BuildTools pulls the Labor item and assigns it to the mapped job.
Result: Labor dollars appear in BuildTools budgets/actuals just like materials or subcontractor costs.
⚖️ Why the Math Balances
Each $0 Vendor Bill debits and credits the same GL account (Job Costed Wages).
QBO’s financials remain unchanged (real payroll already posted separately).
BuildTools receives labor data as itemized job costs, aligned with budget codes.