Skip to main content

Recommended Workflow to Work with Contractor Foreman and QuickBooks

Skip to main content
How can we help you today?

Our Knowledge Base contains the answers to more than 500 previously asked questions.

Create a Ticket Schedule a Training

Working with Contractor Foreman and QuickBooks offers a flexible two-way sync that allows companies to adapt the system to their internal processes. Because every construction company operates differently, there is more than one way to move data between both platforms.

However, after years of training thousands of users, we have identified one workflow that consistently delivers the fewest sync issues, the fastest processing time, and the cleanest financial data. This article outlines that recommended workflow.

Before we begin, it is important to clarify the following:

Contractor Foreman does not provide training on how to use QuickBooks

We are experts in Contractor Foreman, and our responsibility is to help you use our platform correctly and efficiently. While the integration allows both systems to communicate, we cannot advise on accounting practices or how QuickBooks should be applied to your specific financial processes, your accountant can guide you on those decisions. For QuickBooks-specific questions related to functions, workflows, accounting practices, or system behavior, please reach out to your QuickBooks accountant; Smart Business Solutions is also available for a fee if additional assistance is required.

What we can do is show you the proven, reliable way to work in Contractor Foreman so your information syncs cleanly to QuickBooks.

Why We Recommend Working From Contractor Foreman to QuickBooks

Although the integration supports two-way synchronization, the workflow that produces the best results has always been:

  1. Enter your operational data in Contractor Foreman.

  2. Allow Contractor Foreman to send that data to QuickBooks.

This approach significantly reduces sync delays, manual re-entry, missing or duplicated records, and conflicts between systems. When records are created and completed in Contractor Foreman, they are transmitted to QuickBooks almost immediately, provided the data is entered correctly.

Key Requirements for a Smooth Sync

Always use cost codes

Cost codes are the backbone of the integration. Without correct cost codes, QuickBooks may not know how to receive or categorize the information. Using cost codes consistently across your items, invoices, estimates, bills, expenses, and purchase orders ensures seamless processing.

Complete all mandatory fields

If required fields are missing, QuickBooks cannot accept the record, and the sync will fail. Completing all mandatory fields from the start prevents delays.

Follow the recommended workflow

Using modules in the wrong sequence or mixing QuickBooks-first and Contractor Foreman-first workflows can create conflicts that require manual cleanup in both systems. The workflow outlined below is the method we teach during trainings.

Modules That Do Not Sync

Some features in Contractor Foreman are operational, not financial, and therefore do not sync to QuickBooks. This is expected because QuickBooks does not have equivalent modules. Examples include:

• Daily Logs
• Punch Lists
• Safety Meetings
• RFIs
• Files & Photos
• Crew Schedule

These features can be used entirely inside Contractor Foreman without affecting the financial sync.


1. Creating the Estimate and Setting Up the Project

The workflow begins inside Contractor Foreman.

Step 1: Create an Estimate in Contractor Foreman

Create your estimate in Contractor Foreman. Assign proper cost codes to every line item. Missing or incorrect cost codes are the most common cause of sync failures.

When the estimate is complete, change the estimate status to Approved.

The Approved status triggers the sync. Contractor Foreman sends the estimate to QuickBooks, and QuickBooks creates a Sub-Customer. You must manually convert this Sub-Customer into a Project in QuickBooks.

At the same time, Contractor Foreman automatically creates a Project when the estimate is approved.

At this point:
• You have a project created in Contractor Foreman
• You have converted the Sub-Customer into a Project in QuickBooks

With both projects established, you can begin creating commitments and managing financial transactions.


2. Money Out: Subcontracts, Purchase Orders, Bills, and Expenses

This section covers all transactions where money leaves your company. All project-related costs should begin in Contractor Foreman to ensure proper project association and clean syncing.


A. Subcontracts

Step 1: Create the Subcontract

Create the subcontract in Contractor Foreman, either directly or from the estimate. Use correct cost codes.

Step 2: Approve the Subcontract

Approved subcontracts do not sync with QuickBooks, as QuickBooks does not have a subcontract module.

Step 3: Receive the Subcontractor’s Bill

When your subcontractor sends their invoice, create the bill from the subcontract in Contractor Foreman. Do not create the bill from the Bills module. Creating the bill directly from the subcontract ensures the bill remains tied to the contract.

Step 4: The Bill Syncs to QuickBooks

Contractor Foreman sends the bill to QuickBooks, where it is recorded under the correct project.

Step 5: Pay the Bill in QuickBooks

Pay the bill using the Bill Payments feature in QuickBooks. The payment will sync back to Contractor Foreman automatically.

Important Note if Entering Bills Directly in QuickBooks

If you enter bills in QuickBooks first, QuickBooks requires that bills be assigned to a single project per line item. Contractor Foreman cannot split a single transaction across multiple projects. A bill in QuickBooks containing multiple projects will sync entirely to the first project listed. This is one of the main reasons we recommend creating all project-related bills in Contractor Foreman.


B. Purchase Orders

Step 1: Create the PO

Create the purchase order in Contractor Foreman. POs are commitments with suppliers, vendors, and manufacturers.

Step 2: Approve the PO

The Approved status triggers the sync and creates a matching PO in QuickBooks.

Step 3: When You Receive the Vendor’s Invoice

Create the bill directly from the purchase order in Contractor Foreman. Do not create the bill in the Bills module. This keeps the bill tied to the PO.

Step 4: Sync to QuickBooks

QuickBooks receives the bill and applies it to the correct project.

Step 5: Pay the Bill in QuickBooks

Record the payment in QuickBooks so it syncs back into Contractor Foreman.


C. Bills Without Subcontracts or POs

If you do not use subcontracts or purchase orders, create bills directly inside the Bills module in Contractor Foreman. Once submitted, QuickBooks receives the bill, and you can post the payment in QuickBooks. That payment syncs back into Contractor Foreman.


D. Project-Related Expenses Only

Use the Expenses module only for project-related expenses. Contractor Foreman does not track overhead or company-wide operating expenses. All expenses must be tied to an active project.

Once created, QuickBooks receives the expense automatically.


3. Money In: Invoices, Payments, and Revenue Tracking

This section covers all customer invoicing and payment workflows.


A. Contract Amount and the Schedule of Values

In most projects, the estimate represents the original contract amount. Contractor Foreman recommends using the Schedule of Values (SOV) to track:

• The current contract amount
• Approved change orders and work orders
• What has been invoiced
• What remains to be invoiced

Step 1: Create the Schedule of Values

Start by creating the SOV for the project. It will initially reflect only the original contract amount. If your project is Time and Material, you may skip the SOV and create invoices directly.


B. Creating and Syncing Invoices

Step 2: Create the Invoice from the SOV

Use the SOV as reference for invoicing.

Step 3: Mark the Invoice as Submitted

The Submitted status triggers the sync. Contractor Foreman sends the invoice to QuickBooks, where QuickBooks creates the matching invoice.

Step 4: Post the Payment in QuickBooks

When you receive a payment from your customer, record the payment in QuickBooks. The payment then syncs back into Contractor Foreman.


Payment Handling Rules

If you mark a payment in Contractor Foreman as anything other than Verified, QuickBooks will create a second payment in Contractor Foreman once it marks the invoice as paid.

To avoid duplicate payments:
• Only use the Verified status in Contractor Foreman for manual entry
• Always post payments in QuickBooks

This ensures a clean one-way payment sync from QuickBooks to Contractor Foreman.


C. Change Orders and Work Orders

Change Orders and Work Orders do not sync directly to QuickBooks, as QuickBooks does not have those modules.

However:
• Approved Change Orders and Work Orders update the Schedule of Values
• Their amounts increase the current contract value
• The associated invoices do sync to QuickBooks

The workflow remains:

  1. Update the SOV

  2. Create the invoice

  3. Mark it as Submitted

  4. Sync to QuickBooks

  5. Post the payment in QuickBooks

  6. Payment syncs back to Contractor Foreman


D. Standalone Invoices

If you do not use the Schedule of Values, you may create standalone invoices directly in the Invoices module. When marked as Submitted, these invoices sync to QuickBooks. Payments posted in QuickBooks sync back into Contractor Foreman.


E. Service Tickets and Billing

For service work:

  1. Complete the service ticket workflow

  2. Create an invoice from the service ticket

  3. Mark it as Submitted

  4. The invoice syncs to QuickBooks

  5. Post the payment in QuickBooks

  6. The payment syncs back to Contractor Foreman


Final Recommendations

• Begin all financial records in Contractor Foreman
• Always assign cost codes correctly
• Always post payments in QuickBooks
• Complete mandatory fields to prevent sync delays
• Contact Support if any sync issues occur

This workflow is the proven method that minimizes errors and ensures clean financial communication between Contractor Foreman and QuickBooks.

Was this article helpful?
4.5 out of 5 stars

1 rating

5 Stars 0%
4 Stars 100%
3 Stars 0%
2 Stars 0%
1 Stars 0%
5
How can we improve this article?
Please submit the reason for your vote so that we can improve the article.