CRM

---

1. Overview

The CRM module manages sales opportunities from first contact through won business. It tracks leads as they move through a configurable pipeline of stages, enables structured proposals to be built from reusable templates, and maintains a complete communication log for every customer interaction. The module connects directly to the rest of the system — won leads and approved proposals can be converted into work orders without re-entering data.

Key capabilities:

• Track sales leads with pipeline stages, quality grades, and monetary values
• Link leads to salesmen, work orders, invoices, and job contracts
• Build professional proposals from reusable templates with multiple selectable options and detailed line items
• Log every customer communication (calls, emails, texts, meetings) with follow-up tracking
• Monitor sales performance with a real-time dashboard showing pipeline health and team activity

---

2. Key Concepts

• Lead — A sales opportunity tracked through a pipeline. Each lead is tied to a customer and site, has a potential dollar value, a quality grade (A–F), and a current pipeline stage. Leads are assigned to salesmen and accumulate communication history. Example: Riverside Medical Center — potential HVAC replacement, $52,000.

• Pipeline Stage — A step in the sales process that every lead moves through. Stages are configured in CRM Settings and displayed as a visual progress bar on the lead form. Typical stages: Prospect → Contacted → Qualified → Proposal Sent → Negotiation → Won. The stage funnel on the CRM Dashboard shows where leads drop off.

• Proposal — A formal quote or scope of work presented to a customer. Proposals contain one or more selectable options (e.g., “Basic”, “Standard”, “Premium”), each with detailed line items for labor, materials, flat rates, and other charges. Proposals have a status lifecycle: Draft → Submitted → Pending → Approved/Rejected/Withdrawn.

• Proposal Revision — When a proposal template has revision-on-edit enabled, editing financial fields creates a new revision rather than overwriting the original. This preserves a complete history of what was offered and when. The “Latest Revisions Only” toggle on the search screen filters out older versions for day-to-day work.

• Conversion — The process of turning an approved proposal into an actionable record. Depending on the Conversion Type, the proposal becomes a Work Order (Service module), carrying over the customer, site, and line item details without re-entry.

• Communication Log — A record of every interaction with a customer: phone calls, emails, texts, and meetings. Communications are logged with type, status, sentiment, direction (inbound/outbound), and follow-up tracking. They appear on leads, work orders, customers, jobs, service contracts, and vendors, providing a complete customer interaction history. An appointment can be referenced on a communication, but communications are not shown on the appointment screen itself — they surface through the customer or work order the communication is tied to.

---

3. How It Connects

Upstream — Where CRM gets its data:

• Accounts Receivable (Customer Database) → Leads reference existing customers from the AR customer master. New customers can be created inline from the lead form.
• Service (Work Orders) → Work orders can be linked to leads to track actual revenue generated from the opportunity. Any of the customer’s work orders for the lead’s selected site can be linked (the link list is filtered only by site, not by status). When computing the lead’s Actual Value, cancelled work orders are excluded; non-cancelled linked work orders contribute their total sale amount.
• Accounts Receivable (Invoices) → Invoices linked to a lead contribute to the lead’s Actual Value, showing the real revenue generated.

Downstream — Where CRM sends its data:

• Service (Work Orders) → Approved proposals with Conversion Type = Work Order create new WOs with customer, site, and line items pre-populated. The WO links back to the lead and proposal.
• CRM Dashboard → All lead and proposal data feeds the dashboard charts: pipeline funnel, leads by user/campaign, proposal dollar values, and conversion rates.

Key Integration Point — Proposal-to-Conversion Pipeline: When Jeff Allen’s proposal for Riverside Medical Center is approved, clicking Convert creates a work order that inherits the customer, site address, line items, and pricing from the proposal. The lead’s Actual Value then updates automatically as invoices are generated from the converted WO, closing the loop from opportunity to revenue.

---

4. CRM Dashboard

Navigation: CRM → Dashboard

The CRM Dashboard provides visual analytics for sales pipeline health and team performance. All charts use a date range selector (start date and end date) to filter the data shown.

Charts

Proposal $ (All) A pie chart showing the total dollar value of proposals grouped by status (Draft, Submitted, Pending, Approved, Rejected, Withdrawn). Includes all proposal revisions. Hover over a slice to see the exact dollar amount and the number of proposals for that status.

Proposal $ (Latest Revisions) The same pie chart as above, but counting only the most recent revision of each proposal. This gives a cleaner view of the current state of active proposals without double-counting revised proposals.

Proposal Conversion A pie chart showing how many proposals have been converted to work orders versus how many remain un-converted. Useful for measuring close rates on submitted proposals.

Leads by User A stacked bar chart showing leads grouped by the user who created them. Each bar is divided into three segments:

• Won (green) — leads marked as won (the Won / isConverted flag is set)
• In-Progress (amber) — leads still active in the pipeline (not won and not yet at the final stage)
• Lost (red) — leads that have reached the final pipeline stage (the stage with the highest sequence number)

Each segment shows dollar value. Hover over a segment to see the count and monetary value.

Leads by Campaign The same stacked bar chart structure as Leads by User, but grouped by the lead source (campaign or channel). Use this to evaluate which marketing sources produce the most and highest-quality leads.

Unqualified Leads by Reason A pie chart showing the distribution of unqualified leads across each configured unqualified reason. Helps identify the most common reasons opportunities are lost.

Lead Stage Drop-Off (Funnel) A funnel chart showing the number of leads at each pipeline stage, ordered by stage sequence. The width of each stage represents the count of leads currently at or past that stage, making drop-off between stages visually apparent.

---

5. Leads

Navigation: CRM → Manage Leads

A lead represents a sales opportunity — a potential customer or a potential job at an existing customer site. Leads move through a configurable pipeline of stages, from first contact through won or lost.

Searching for Leads

The Search Leads screen displays all leads in a searchable data grid. Type in the search box to filter by any lead field. The system supports advanced search for filtering by specific attributes.

Result columns:

• Lead ID
• Customer ID
• Customer Name
• Customer Address (billing)
• Site Name
• Site Address
• Lead Stage
• Won (yes/no)
• Department

Click the edit icon to open a lead in edit mode, or click a row to open the view screen. Use the delete icon to remove a lead (confirmation required). Use the + icon to create a new lead.

Creating a Lead

Navigate to Manage Leads → Create or click + on the search screen.

Stage Progress Bar At the top of the form is a visual progress bar showing all configured lead stages in sequence. The current stage is highlighted in blue with a spinning icon, past/completed stages show a green check, and future stages display a gray clock icon. Click any stage on the bar to jump to that stage.

Customer & Site

Field	Description	Required
Customer	The customer associated with this lead. Type to search existing customers, or use the option to create a new customer directly from this field.	Yes
Site Address	The specific site (delivery or service location) for this lead. Options are filtered to the selected customer’s configured site addresses.	Yes

Once a customer and site are selected, the customer’s name, secondary name, billing address, site name, and site address are displayed as read-only reference information below. A View Notes button is available for both the customer and the site to review any notes on file.

Lead Classification

Field	Description	Required
Potential Value	Your estimated dollar value of this opportunity	No
Quality Grade	A letter grade (A, B, C, D, F) indicating the quality or likelihood of conversion	No
Stage	The current pipeline stage for this lead	Yes
Department	Internal department responsible for this lead	No
Source	How this lead was acquired (configured in CRM Settings)	No
Unqualified Reason	If the lead is unqualified, the reason why	No
Email	A Customer Contact autocomplete that displays the contact’s email address	No
Do Not Disturb	Check to flag that this customer should not be contacted	No
Won	Check to mark this lead as won (converted to active business). Displays as “Won” but the underlying field is isConverted.	No

Value Tracking (Read-Only)

These two fields are automatically calculated from linked records and cannot be edited directly:

• Proposal Value — Automatically calculated from the amounts of the latest-revision proposals linked to this lead. The method depends on the Proposal Lead Value CRM setting — the Average, Minimum, or Maximum of the linked proposal totals (it is not a simple sum).
• Actual Value — The sum of revenue from linked work orders, invoices, and job contract amounts. Cancelled work orders and voided invoices are excluded.

Linked Records

All linked record selectors are filtered to the selected customer and site address.

Field	Description
Linked Work Orders	Select one or more work orders to associate with this lead
Linked Invoices	Select one or more invoices to associate with this lead
Linked Job Contracts	Select one or more job contracts to associate with this lead
Salesmen	Assign one or more salesmen responsible for this lead

Notes A multi-line text field for any additional notes about the lead.

Click Save (or Create on a new lead) to save the record.

Editing a Lead

From the search screen, click the edit icon, or from the view screen click Edit. All fields are editable. The stage progress bar at the top allows you to change the stage directly by clicking on it. Click Save to apply changes.

Viewing a Lead

Click any lead row in the search results to open the view screen. The view screen is organized into tabs:

Linked Records Tables showing the linked work orders, invoices, and job contracts, with clickable links to open each record.

Stage Changes A history of all stage transitions for this lead, showing when the lead moved between pipeline stages.

Attachments Files and documents attached to this lead record.

Communications The full communication log for this lead — every phone call, email, text, and other interaction that has been logged. See the Communications section for details on logging and viewing communications.

Salesmen The salesmen assigned to this lead.

Actions available from the lead view screen:

• Edit — Opens the edit form
• Delete — Deletes the lead (confirmation required)
• Audit Lead — Opens the audit trail for this lead

---

Managing Salesmen on a Lead

Navigation: CRM → Manage Leads → open a lead → Salesmen tab

The Salesmen tab on the lead view screen lists every salesman assigned to the lead and lets you add or remove assignments directly, without opening the lead in edit mode. Each assignment is a link between the lead and a salesman from your salesman list.

The table shows one row per assigned salesman, sorted by name:

Column	Description
Name	The salesman’s primary name
Name 2	The salesman’s secondary name
Address	The salesman’s street address
Address 2	The salesman’s secondary address line
City	The salesman’s city
State	The salesman’s state
Zip	The salesman’s ZIP code

Adding a salesman

1. On the Salesmen tab, click the + (Link Salesman) button in the table header.
2. In the Link Salesman dialog, open the Salesman field and select a salesman. The list shows only salesmen who are not already assigned to this lead.
3. Click Link to create the assignment, or Cancel to close without saving. The new salesman appears in the table.

Removing a salesman

1. On the salesman’s row, click the Unlink Salesman icon.
2. A confirmation prompt asks whether you want to unlink this salesman from this lead.
3. Click Unlink to confirm. The salesman is removed from the table.

Note

Both the Link Salesman and Unlink Salesman actions require the Lead – Update permission. If you do not have it, both buttons are disabled.

Lead Status

The lead view screen header shows a row of status chips that summarize the lead at a glance. One of these — the Lead Status chip — is calculated automatically from the lead’s pipeline stage and its Won flag, rather than being a field you set directly.

The header can display the following chips, from left to right:

Chip	When it appears
Grade: X	When a Quality Grade has been assigned. Shows the grade letter (for example, “Grade: A”).
Do Not Disturb	When the lead’s Do Not Disturb flag is set.
Won	When the lead is marked Won (the Won / isConverted flag is set).
Lead Status	Always shown. Calculated automatically — see below.

The automatic Lead Status chip is derived as follows:

Status	Meaning
Closed	The lead is marked Won and is on the last pipeline stage (the stage with the highest sequence number).
Lost	The lead is on the last pipeline stage but is not marked Won.
In Progress	The lead is on any earlier stage.

Note

The Won chip and the Lead Status chip are independent. The Won chip reflects only the Won flag, while the Lead Status chip combines the Won flag with the lead’s stage. A lead that is marked Won but has not yet been advanced to the final stage will show the Won chip but its Lead Status will still read In Progress until it reaches the last stage.

Managing Linked Records

Navigation: CRM → Manage Leads → open a lead → Linked Records tab

The Linked Records tab lists the work orders, sales invoices, and job contracts currently associated with the lead. Each row shows the record’s type, ID (a clickable link that opens the record in a new tab), and a short description. You can link and unlink records directly from this tab without editing the lead.

Column	Description
Type	Whether the record is a Work Order, Sales Invoice, or Job Contract
ID	The record’s human-readable ID; click to open the record in a new browser tab
Description	A summary of the record (for example, the service type and amount for a work order, or the contract amount for a job contract)

Linking records

Click the + (Link Records) button in the table’s header to open the Link Lead Record dialog. The dialog offers three multi-select fields — Work Orders, Invoices, and Job Contracts — each listing only records that belong to the lead’s customer and that share the lead’s site, and that are not already linked to this lead.

1. On the Linked Records tab, click the + button in the table header.

2. In the Link Lead Record dialog, use the Work Orders, Invoices, and Job Contracts fields to select one or more records to associate with the lead.

3. Click Link to save. The newly linked records appear in the table. To close without linking, click Cancel.

Caution

If you select a record that is already linked to a different lead, a warning is shown (for example, “Work Order already linked to a lead.”). You can still link it, but doing so moves the record’s association to the current lead. Selecting Link with no records chosen returns a “No records selected.” message.

Unlinking a record

Each row in the Linked Records table has an Unlink Record button. Click it and confirm to remove that record’s association with the lead. The record itself is not deleted — only the link is removed.

Tip

Linking or unlinking records updates the lead’s Actual Value, which is calculated from the work orders, invoices, and job contracts linked to the lead. Both the link and unlink actions require the lead update permission; without it, the + and Unlink buttons are disabled.

6. Proposals

Navigation: CRM → Manage Proposals

A proposal is a formal quote or scope of work presented to a customer. Proposals are built from templates and can contain multiple options for the customer to choose from. Each option has detailed line items for labor, materials, flat rates, and other charges. When a proposal is approved, it can be converted directly into a work order.

Searching for Proposals

The Search Proposals screen lists all proposals. A Latest Revisions Only toggle switch filters the list to show only the most recent revision of each proposal, which is useful for day-to-day work. Turn it off to see all revisions.

Result columns:

• Proposal ID
• Customer ID
• Billing Name (Customer Name)
• Billing Address
• Site Name
• Site Address
• Status
• Revision

Click any row to open the proposal view. Use the edit icon to revise the proposal, or the delete icon to remove it (not available if the proposal has been converted to a work order). Use the + icon to create a new proposal.

Proposal Status Values

Status	Meaning
Draft	Created but not yet sent to the customer
Submitted	Sent to the customer for review
Pending	Awaiting customer decision
Approved	Customer has agreed to the proposal
Rejected	Customer declined the proposal
Withdrawn	Proposal was recalled before a decision

Creating a Proposal

Navigate to Manage Proposals → Create or click + on the search screen.

Header Fields

Field	Description	Required
Customer	The customer this proposal is for	Yes
Site	The site address the proposal covers	Yes
Source Appointment	An optional appointment record that sourced this proposal	No
Service Contract	An optional existing service contract at the selected site to associate with this proposal. The dropdown lists the service contracts on file for the chosen Site	No
Proposal Template	The template to base this proposal on; selecting a template automatically populates the options and line items	Yes
Conversion Type	Inherited from the selected Proposal Template; determines whether this proposal, if approved, will convert to a Work Order	Read-only
Revise on Edit	Controls whether later edits to this proposal create a new revision instead of overwriting it. Defaults to the Revise on Edit setting of the selected template, but you can override it here. Only editable while creating the proposal — once saved it becomes read-only	No
Static Pricing	Freezes the proposal’s prices so they are not re-quoted while the freeze is active. When checked, a Static Until Date is required	No
Static Until Date	The date through which prices are frozen. Required when Static Pricing is checked; clearing the Static Pricing checkbox clears this date	Conditional

The Revise on Edit setting is captured on the proposal itself when it is created, and it is what governs the revision behavior described under Editing a Proposal below — not the template’s current setting. The template only supplies the default at create time, so changing the template’s Revise on Edit setting afterward does not change how an already-created proposal behaves. Because the checkbox is disabled after the proposal is saved, this choice is fixed for the life of the proposal at the moment you create it.

Service Contract Use the Service Contract field on the General tab to link the proposal to a service contract already on file for the selected site. The list is loaded from the chosen Site, so you must select the Customer and Site first; changing the site clears and reloads the available contracts. Each contract is shown as its contract number, contract type, and effective-through-expiration date range. The field is optional and may be left blank. On the View Proposal screen the linked Service Contract is displayed and acts as a link that opens that service contract (in a new tab) for quick reference.

Proposal Options

After selecting a template, the proposal displays one or more options — different scopes of work or price tiers that the customer can choose from. Each option shows:

• Name and color-coded indicator
• Description
• Breakdown of Labor, Material, Other, and Additional charges
• Total sale amount
• Number of workers required

Options can be marked as Approved to indicate the customer’s selection.

Line Items (per Option)

Each option contains a grid of line items. A new blank row is added automatically as you fill in the last row; click the trash icon on a row to remove it.

Column	Description
Line Item Type	The type of charge: Labor Sell, Material, Flat Rate, Dynamic Charge, Contract Sale, Flat Rate Labor Sell, Flat Rate Material Sell, Quote, Labor Cost, or Subs
Description	Description of the line item
Quantity	Number of units
Unit of Measure	The unit (each, hour, linear foot, etc.)
Unit Sell	Selling price per unit
Extended Sell	Quantity × Unit Sell (calculated)
Unit Cost	Cost per unit
Extended Cost	Quantity × Unit Cost (calculated)
Discount Amount	Discount applied to this line
Total Sell	Extended Sell minus Discount
Cost Center	Internal cost center for this line
Taxable	Check if this line item is subject to sales tax
Show on Proposal	Check if this line should appear on the customer-facing proposal document
Only Estimate	Check if this line is an estimate and not a firm price

Financial Summary (per Option)

Automatically calculated totals displayed below each option’s line items:

• Labor
• Material
• Other
• Subtotal
• Addtl Charges
• Total
• Workers

The proposal-level totals (below all options) show Labor Sale Total, Material Sale Total, Other Sale Total, Subtotal, Discount / Discount %, Tax Total, Additional Charges, and Sale Total.

Notes Free-text notes to include on the proposal.

Attachments Files to attach to the proposal record.

Static Pricing

Use Static Pricing to lock in a proposal’s pricing for a period of time. Check the Static Pricing box and enter a Static Until Date; the date is required whenever Static Pricing is checked, and unchecking the box clears the date. While the Static Until Date is still in the future, the Update Prices action is disabled, so the proposal’s line items will not be re-priced even if underlying rates change. Once the Static Until Date has passed, prices are no longer frozen and Update Prices becomes available again.

Click Save (or Create on a new proposal) to save the proposal. It is saved with whatever Status is currently selected (for example, Draft or Submitted) — saving does not force the status to Draft.

Editing a Proposal

When the proposal template has revision-on-edit enabled, changing key financial fields (the template, approved option, discount code, sales-tax jurisdiction, or total sale amount) creates a new revision rather than overwriting the previous version. This preserves a complete history of changes, and the revision number increments automatically. Click Save — the new revision is created server-side; there is no separate Save Revision button.

From an existing proposal you can also:

• Change Status — Edit the proposal and select a new value in the Status dropdown (Approved, Draft, Pending, Rejected, Submitted, or Withdrawn). There is no dedicated Change Status action, and any status may be selected — transitions are not enforced.
• Convert to Work Order — Converts the proposal into a work order. Enabled when the proposal has not already been converted, its conversion type is Work Order (inherited from the proposal template), and you have permission to create work orders. The approved option’s line items are carried into the work order.
• Update Prices — Recomputes the proposal’s line-item pricing from current rates. Available only when editing an existing proposal. It is disabled while Static Pricing is in effect — that is, when Static Pricing is checked and the Static Until Date is still in the future — so a frozen proposal keeps its locked prices until that date passes.

Updating Prices on a Proposal

Navigation: CRM → Manage Proposals → open an existing proposal → Update Prices

The proposal editor includes an Update Prices button (next to Save) that re-prices every line item on the proposal against current pricing. Use it after pricing-relevant data has changed — for example when underlying rates, materials, or special pricing have been updated — to refresh the calculated amounts without re-entering each line by hand.

When you click Update Prices, the proposal recalculates each line item according to its type:

Line item type	What is recalculated
Flat Rate	Flat-rate sell and cost amounts
Labor Cost	Extended cost from quantity × the employee’s hourly pay rate
Labor Sell	Sell price, applying any effective (discounted) rate, plus extended and total sell
Material	Material sell and cost amounts
Misc / Quote	Extended sell from quantity × unit sell, less the line discount
Subs	Extended cost from quantity × unit cost

Child line items also have their Show on Proposal and Only Estimate settings re-synced from their parent (material lines follow the parent’s Show-on-Proposal setting; other child types are hidden from the customer-facing proposal). After recalculation, the option and proposal totals are refreshed automatically.

Recalculation also runs on its own whenever you change a pricing-relevant field on a line item, so Update Prices is mainly useful for forcing a full refresh of an already-saved proposal.

The recalculated values are not stored until you click Save.

Caution

Update Prices is unavailable in the following situations:

• While the proposal is being saved.
• On a brand-new proposal that has not yet been created (create the proposal first, then reopen it to update prices).
• When Static Pricing is on and the Static Until Date is still in the future. Static pricing locks the proposal’s prices until that date passes; to re-price sooner, clear Static Pricing (which also clears the Static Until Date) or wait until the date has passed.

Viewing a Proposal

The view screen displays the proposal in read-only format with the following tabs:

• Options — All options with their line items and financial totals
• Revisions — Full audit trail of all revisions
• Attachments — Files and documents attached to this proposal

The header shows ID, status, revision number, customer, site, conversion status with links to the converted work order (if applicable), and the Static Pricing flag with its Static Until date.

---

Proposal-Level Discounts

A discount can be applied to the proposal as a whole from the proposal-level financial summary (below all options). There are two ways to enter the discount, and they are mutually exclusive: you either select a predefined Discount Code, or you enter a manual Discount amount or Discount % by hand.

Navigation: CRM → Manage Proposals → (create or edit a proposal) → proposal-level totals

Field	Description
Discount Code	Autocomplete that selects a predefined discount code. Options are labeled as code - description. A code carries a fixed value that is applied either as a percentage or as a dollar amount.
Discount	A manually entered flat dollar discount applied to the proposal.
Discount %	A manually entered percentage discount, displayed with a trailing % and two decimal places.

How the three fields interact

1. Selecting a Discount Code fills in the discount for you. If the code is a percentage code, its value is placed in Discount % and the Discount amount is set to 0. If the code is a flat-amount code, its value is placed in Discount and Discount % is set to 0.

2. While a Discount Code is selected, the Discount and Discount % fields are disabled, so they cannot be edited by hand. Clear the Discount Code first if you want to enter a discount manually.

3. Entering a manual Discount amount clears Discount % back to 0, and entering a manual Discount % clears the Discount amount back to 0 — only one of the two can hold a value at a time.

4. Clearing the Discount Code resets both Discount and Discount % to 0.

After a discount entry is changed, the proposal totals recalculate automatically.

On the View Proposal screen, the applied discount is shown read-only as Discount Code, Discount %, and Discount Amount.

Sales Tax Jurisdiction and Tax Total

The Tax Total shown in the proposal-level financial summary is driven by the Sales Tax Jurisdiction selector. Selecting a jurisdiction applies that jurisdiction’s tax rate to the taxable portion of the proposal and recalculates the tax automatically.

Sales Tax Jurisdiction is a searchable dropdown. Each jurisdiction is listed by its description followed by its tax rate (for example, City of Austin - 8.25000%), and the list is sorted alphabetically by description. The field is optional; if no jurisdiction is selected, the tax rate is treated as 0% and the Tax Total is $0.00.

Tax Total is a read-only field. You cannot type into it — its value is always recalculated from the selected jurisdiction and the proposal’s taxable line items.

1. In the proposal’s financial summary, open the Sales Tax Jurisdiction dropdown and select a jurisdiction (or clear it to remove tax).

2. The Tax Total field recalculates as soon as you leave the Sales Tax Jurisdiction field. It equals the taxable subtotal multiplied by the jurisdiction’s tax rate, rounded to the cent.

3. The recalculated tax flows into the Sale Total (Subtotal + Tax Total − Discount).

4. Click Save (or Create) to store the selected jurisdiction and the calculated Tax Total on the proposal.

Only line items marked Taxable contribute to the taxable subtotal. Any discount is allocated across the line items first, and tax is then applied to the discounted, taxable amounts — so changing the discount or a line item’s Taxable checkbox also changes the Tax Total.

When you view a saved proposal, this information is shown read-only as Sales Tax Juris (the jurisdiction and its rate) and Total Tax Amount (the calculated tax).

Note

Changing the Sales Tax Jurisdiction on a proposal whose template has revision-on-edit enabled is one of the financial changes that creates a new revision rather than overwriting the current one.

Line Item Detail

When you choose a Line Item Type, the row expands to reveal a configuration panel specific to that type. The panel lets you tie the line item to the underlying record (a flat rate, charge, labor rate, product, or contract type) that drives its pricing. The panel appears for the Flat Rate, Dynamic Charge, Labor Sell, Material, and Contract Sale types. The Quote, Flat Rate Labor Sell, Flat Rate Material Sell, and Misc types have no detail panel.

Flat Rate

Search for and select a flat rate, then set the pricing flags that apply.

Field	Description
Flat Rate	Search for a flat rate to attach to this line. Selecting one populates the line’s pricing.
Primary	Marks this as the primary flat rate.
Preferred	Uses the flat rate’s preferred pricing.
After Hours	Uses the flat rate’s after-hours pricing.
Warranty	Marks the flat rate as warranty work.

Changing the flat rate or any of these flags re-prices the line.

Dynamic Charge

Field	Description
Dynamic Charge	Select an active dynamic charge to apply to this line.
Formula	Read-only. Displays the formula defined on the selected dynamic charge.

Labor Sell

Field	Description
Labor Rate	Select the labor rate that prices this line.
Hourly Rate	Read-only. The hourly rate of the selected labor rate.
Default	Read-only. Indicates whether the selected labor rate is the default rate.

Material

Field	Description
Product	Search for and select a product. Selecting one sets the line’s description and pricing.

Contract Sale

A Contract Sale line item carries a contract type, an amount, and an optional sub-grid of contract options.

Field	Description
Contract Type	Select the service contract type. Selecting one sets the amount to the contract type’s default price and updates the line description.
Amount	The sale amount for the contract. Editable until you add one or more contract options, after which it is driven by the options sub-grid.

The Contract Options sub-grid lets you break the contract into individual options:

Column	Description
Contract Option	Select a contract option.
Quantity	Whole-number quantity for the option.
Amount	Read-only. The calculated amount for the option.
Is Percent	Read-only. Indicates whether the selected contract option is a percentage.

Use the + button in the sub-grid header to add a contract option row, and the trash icon on a row to remove it.

Note

On the Contract Sale panel, the Amount field is locked once one or more contract options are present — the contract total is then calculated from the options sub-grid rather than entered directly.

View Proposal Actions menu

Navigation: CRM → Manage Proposals → click a proposal row to open View Proposal → Actions button (top right of the proposal header).

The conversion and maintenance actions for a proposal live on the Actions menu of the View Proposal screen — there is no separate inline “Convert” button. The menu offers:

Action	What it does	When it is available
Convert to Work Order	Opens the Work Order create screen with a new work order seeded from this proposal (customer, site, and the proposal’s line items are carried in).	The proposal’s Conversion Type is Work Order, the proposal has not already been converted, and you have Work Order create permission.
Edit Proposal	Opens the proposal in edit mode.	You have Proposal update permission and the proposal has not already been converted.
Delete Proposal	Prompts to delete the proposal.	You have Proposal delete permission and the proposal has not already been converted.
Audit Proposal	Opens the change-history (audit) screen for this proposal.	Always available.

Note

Convert to Work Order is gated only on Conversion Type, whether the proposal has already been converted, and Work Order create permission. It is not gated on the proposal’s status — a proposal does not have to be in the Approved status for the action to be enabled.

Audit Proposal

Navigation: CRM → Manage Proposals → open a proposal → Actions → Audit Proposal.

The audit screen lists every recorded change to the proposal over a date range. By default it shows changes from the past month up to now; adjust the Start Date/Time and End Date/Time fields and click Search to widen or narrow the window.

Each row in the audit table shows:

Column	Description
Timestamp	Date and time the change was recorded.
User	The user who made the change.
Description	A summary of the change.

Expand a row to see the individual fields that changed, each with its Old Value and New Value (old values are shown in red, new values in green, and empty values appear as (empty)).

7. Proposal Templates

Navigation: CRM → Manage Proposal Templates

Proposal templates define the reusable structure for proposals — the options available and the standard line items within each option. When a user creates a proposal and selects a template, the template’s options and line items are copied into the new proposal, which can then be customized.

Searching for Templates

The Search Proposal Templates screen lists all templates with their name, conversion type (Work Order; Job is planned but not yet available), and proposal type. Click the edit icon to edit, the delete icon to remove, or the + icon to create a new template.

Creating a Template

Navigate to Manage Proposal Templates → Create or click + on the search screen.

Template Header

Field	Description	Required
Name	A descriptive name for the template (displayed when selecting a template on proposals)	Yes
Conversion Type	Whether proposals using this template will convert to a Work Order. (Job conversion is planned but not yet available.)	Yes
Proposal Type	Either Additive or Progressive — controls how the template’s options are presented and approved	Yes
Should Revise on Edit	If checked, editing a proposal that uses this template will automatically create a new revision	No

Template Options

Add one or more options to the template. Each option represents a different scope or price level a customer can choose.

Field	Description	Required
Name	Option name (e.g., “Basic”, “Standard”, “Premium”)	Yes
Description	Brief description of what this option includes	Yes
Color	A color indicator for visual differentiation in the UI	No
Default Workers Required	The default number of workers needed to fulfill this option	Yes
Sort Order	Controls the display order of options	Yes

Template Line Items

Each option can have its own default line items. The fields mirror those in the proposal line items grid:

• Line Item Type (Labor Sell, Material, Flat Rate, Dynamic Charge, Contract Sale, Flat Rate Labor Sell, Flat Rate Material Sell, Misc)
• Description
• Quantity
• UOM
• Unit Sell, Unit Cost
• Show On Proposal, Only Estimate

These line items are copied into any proposal created from this template, and can be modified on a per-proposal basis.

Click Create to save a new template (the button reads Save when you are editing an existing template).

Editing a Template

Click the edit icon on the search screen or the Edit button on the view screen. All template fields, options, and line items are editable. Changes to a template do not retroactively affect existing proposals that were created from it — only new proposals will receive the updated defaults.

---

Additive vs. Progressive Proposal Types

The Proposal Type set on a template (Additive or Progressive) controls how a customer’s option selections are recorded when the proposal is later worked, specifically what happens when you mark an option as Approved.

Proposal Type	Approval behavior
Additive	Marking an option as Approved does not affect the other options. You can mark more than one option as Approved at the same time.
Progressive	Approval is limited to a single option. Marking one option as Approved automatically sets it as the proposal’s approved option and clears the approved flag from every other option; the remaining option checkboxes are then disabled so only the chosen option stays approved.

With a Progressive template, the moment you check an option’s Approved box that option becomes the sole approved option and the other options’ Approved checkboxes are greyed out. To switch to a different option, uncheck the currently approved one first.

With an Additive template, the Approved checkboxes act independently — checking one never disables or unchecks the others.

Note

This behavior is determined entirely by the template’s Proposal Type. It does not change which line items are carried into a Work Order on conversion — only the approved option’s line items are carried over regardless of Proposal Type.

8. Communications

The communications table appears embedded within lead, work order, appointment, vendor, and other screens throughout the system. It provides a centralized log of every interaction with a customer or vendor.

Logging a Communication

Click the + button in the communications table to open the Create Communication dialog.

Fields

Field	Description	Required
Occurred At	The date and time the communication took place	Yes
Communication Type	The type of interaction (e.g., Phone Call, Email, Text)	No
Communication Status	The outcome or status of the communication (e.g., Reached, Left Voicemail)	No
Priority	Importance level: Lowest, Low, Medium, High, Highest	No
Direction	Whether the communication was Inbound (customer contacted you) or Outbound (you contacted customer)	No
Resulting Sentiment	The tone of the interaction: Negative, Neutral, or Positive	No
Requested Documentation	Check if the customer requested documents during this communication	No
Followup Required	Check if a follow-up action is needed	No
Followup Date/Time	When the follow-up should happen (required if Followup Required is checked)	If Followup
Followup User	The user responsible for the follow-up	If Followup
Notes	Detailed notes about the conversation	No

The communication is automatically linked to context it was opened from (e.g., if opened from a lead, it is linked to that lead). You can also manually link to related records:

Field	Description
Work Order	Link to a specific work order
Job	Link to a specific job
Appointment	Link to a specific appointment
Appointment Confirmation	Link to a specific confirmation (when selected, auto-fills Occurred At and Communication Type)
Lead	Link to a specific lead

Tip

When logging a communication from an appointment confirmation, the Occurred At date/time and Communication Type are automatically filled in based on the confirmation type (phone, text, or email).

Communications Table

The table shows all communications in reverse chronological order. Expand any row to see the full notes. Columns include:

• Occurred At
• User (who logged it)
• Type, Direction, Status, Priority, Resulting Sentiment
• Requested Documentation, Followup Required, Followup Time, Followup User
• Linked Service Contract, Work Order, Job, Appointment, Apt Confirmation, Lead
• Edit and Delete action buttons (subject to permissions)

---

9. CRM Settings

Navigation: CRM → CRM Settings

CRM Settings is the administrative configuration screen. Only users with the CRM settings update permission can change the global settings. Reference data (statuses, types, stages, etc.) can be managed by any user with the appropriate create/update/delete permissions for those specific items.

Global Settings

These settings save automatically when you leave a field.

Field	Description	Required
Default Phone Call Communication Type	The communication type automatically selected when logging a communication linked to a phone call appointment confirmation	Yes
Default Text Communication Type	Automatically selected when logging a communication linked to a text appointment confirmation	Yes
Default Email Communication Type	Automatically selected when logging a communication linked to an email appointment confirmation	Yes
Proposal Lead Value	Determines how the Proposal Value on a lead is calculated from linked proposals: Avg (average), Max (highest), or Min (lowest)	Yes

---

Reference Data Tabs

The lower section contains tabs for managing all lookup tables used in the CRM module.

Communication Statuses

Statuses represent the outcome or current state of a communication (e.g., Reached, Left Voicemail, No Answer, Completed).

Field	Description	Required
Name	Status name displayed in the communication form	Yes

Communication Types

Types classify the channel or method of communication (e.g., Phone Call, Email, Text, In-Person Meeting, Video Call).

Field	Description	Required
Name	Type name displayed in the communication form	Yes

Lead Departments

Departments allow leads to be categorized by the internal department or business line responsible for them.

Field	Description	Required
Name	Department name	Yes

Departments have no ordering control; they are listed alphabetically by name.

Lead Stages

Stages define the steps in your sales pipeline. Every lead progresses (or regresses) through these stages, and the pipeline funnel chart on the dashboard visualizes the count of leads at each stage.

Field	Description	Required
Name	Stage name (e.g., “Prospect”, “Contacted”, “Qualified”, “Proposal Sent”, “Won”)	Yes
Sequence Number	The order of the stage in the pipeline	Auto-calculated

Stages can be reordered by dragging and dropping rows in the table. The sequence number updates automatically.

Caution

Stage sequence determines the order displayed on the lead form’s progress bar and on the dashboard funnel chart. Think carefully before reordering stages, as this affects all existing leads.

Lead Sources

Sources identify how a lead was acquired (e.g., Website, Referral, Trade Show, Cold Call, Google Ad).

Field	Description	Required
Name	Source name displayed in the lead form	Yes

Lead Unqualified Reasons

When a lead is marked as unqualified or lost, the user selects a reason. These reasons are tracked in the dashboard’s Unqualified Leads pie chart to identify patterns.

Field	Description	Required
Reason	The reason text (e.g., “Budget too low”, “Wrong timing”, “Went with competitor”)	Yes

---

10. Permissions

Access to each screen and action is controlled by role-based permissions. If a button is grayed out or unavailable, your user account may not have the required permission.

Action	Permission Required
View leads	Lead – Read
Create leads	Lead – Create
Edit leads / link records	Lead – Update
Delete leads	Lead – Delete
View proposals	Proposal – Read
Create proposals	Proposal – Create
Edit / revise proposals	Proposal – Update
Delete proposals	Proposal – Delete
View proposal templates	Proposal Template – Read
Create / edit templates	Proposal Template – Create / Update
Delete templates	Proposal Template – Delete
Log communications	Communication – Create
Edit communications	Communication – Update
Delete communications	Communication – Delete
Edit global CRM settings	CRM Settings – Update
Manage communication statuses/types	Communication Status/Type – Create/Update/Delete
Manage lead stages/sources/departments	Lead Stage/Source/Department – Create/Update/Delete

---

11. Worked Examples

Example 1: Lead Through Proposal to Work Order Conversion

Scenario: Riverside Medical Center contacts Precision Mechanical about replacing their rooftop HVAC units. Jeff Allen (Salesman) manages the opportunity from first contact through work order creation.

Step 1 — Create the lead:

1. Jeff navigates to CRM → Manage Leads and clicks +.
2. Customer = Riverside Medical Center, Site = 200 Health Center Blvd.
3. Stage = Prospect, Quality Grade = A, Potential Value = $52,000.
4. Source = Referral, Department = HVAC.
5. Salesmen = Jeff Allen.
6. Notes = “Facility manager Dr. Patel requested evaluation of 4 aging RTUs on the main building.”
7. Click Create. Lead L-820 is created.

Step 2 — Log communications and advance the stage:

1. Jeff calls Dr. Patel. On the Communications tab, he clicks +:
   • Occurred At = 02/03/2026, 2:15 PM, Type = Phone Call, Status = Reached, Direction = Outbound
   • Sentiment = Positive, Notes = “Dr. Patel confirmed budget approval for Q2. Wants proposal by Feb 15.”
   • Followup Required = ✓, Followup Date = 02/10/2026, Followup User = Jeff Allen
2. Jeff clicks the Contacted stage on the progress bar → status advances from Prospect to Contacted.
3. After site visit: clicks Qualified on the progress bar.

Step 3 — Create a proposal:

1. Navigate to CRM → Manage Proposals and click +.
2. Customer = Riverside Medical Center, Site = 200 Health Center Blvd.
3. Template = HVAC Replacement, Conversion Type = Work Order.
4. The template populates two options:

Option A — Standard Replacement ($48,000):

Line Item Type	Description	Qty	Unit Sell	Extended Sell
Material	Carrier 48TC 5-ton RTU	4	$6,200	$24,800
Labor Sell	Installation Labor	120 hrs	$108/hr	$12,960
Material	Ductwork Modifications	1	$5,240	$5,240
Dynamic Charge	Crane Rental	1	$5,000	$5,000
Total				$48,000

Option B — Premium Replacement ($52,000): Same as Option A but with higher-efficiency units at $7,200 each and extended warranty.

5. Click Save as Draft.

Step 4 — Submit and convert:

1. Jeff reviews with Tom (Service Manager), then changes the status to Submitted.
2. Advances lead stage to Proposal Sent.
3. Dr. Patel accepts Option B. Jeff changes the proposal status to Approved, marks Option B as Approved.
4. Advances lead stage to Won and checks Won on the lead.
5. Clicks Convert. A new work order WO-2250 is created with all Option B line items.

Result: Lead L-820 shows: Proposal Value = $52,000 (auto-calculated from the linked proposal) and Status = Won (because Jeff manually checked Won in Step 4). Converting a proposal links the new work order and refreshes the lead’s Actual Value, but it does not automatically mark the lead Won — that remains a separate manual step. WO-2250 is ready for scheduling.

---

Example 2: Pipeline Management and Lost Leads

Scenario: Jeff Allen reviews his pipeline during the weekly sales meeting, analyzing the funnel and addressing stalled leads.

Step 1 — Review the CRM Dashboard:

1. Navigate to CRM → Dashboard, set date range to last 90 days.

2. Lead Stage Drop-Off Funnel shows:

   • Prospect: 45 leads
   • Contacted: 38 leads (16% drop-off)
   • Qualified: 22 leads (42% drop-off — significant)
   • Proposal Sent: 18 leads
   • Negotiation: 10 leads
   • Won: 7 leads

3. Key insight: The biggest drop-off is Contacted → Qualified (42%). Jeff investigates.

4. Leads by Campaign shows:

   • Website: 18 leads, 3 won ($45,000)
   • Referral: 12 leads, 3 won ($89,000) — highest value per lead
   • Trade Show: 15 leads, 1 won ($12,000) — lowest conversion

5. Unqualified Leads by Reason:

   • “Budget too low”: 8 leads (35%)
   • “Went with competitor”: 6 leads (26%)
   • “Wrong timing”: 5 leads (22%)
   • “No response”: 4 leads (17%)

Step 2 — Address stalled leads:

1. Jeff filters the lead list by Stage = Contacted to find the 16 leads that haven’t moved.
2. Opens Lead L-795 (Metro Restaurant Group) — last communication was 3 weeks ago.
3. Logs a new follow-up call. Status = Left Voicemail. Sets Followup Date = next Tuesday.
4. Opens Lead L-801 (Bayview Hotel) — notes say “budget not approved until July.”
5. Updates stage to Qualified with Quality Grade = C, adds note: “Follow up in July.”

---

Example 3: Multi-Revision Proposal with Template

Scenario: Davis Property Management wants HVAC maintenance for 3 buildings. Jeff creates a proposal, Davis requests changes, and Jeff submits a revised version.

Step 1 — Create initial proposal (Revision 1):

1. Navigate to Manage Proposals → Create.
2. Customer = Davis Property Management, Site = Davis Office Complex — 500 Commerce Dr.
3. Template = Multi-Building Maintenance, Conversion Type = Work Order.
4. Template populates with a single option. Jeff adjusts:
   • 3 buildings × quarterly checkups = 12 visits/year
   • Labor: 12 visits × 3 hrs × $95/hr = $3,420
   • Materials: $1,200 estimated (filters/belts)
   • Total: $4,620/year
5. Click Save (Draft). Proposal P-310, Revision 1.

Step 2 — Submit and get feedback:

1. Jeff changes the status to Submitted.
2. Davis replies: “Can you add after-hours emergency coverage and reduce to semi-annual visits?”

Step 3 — Create Revision 2:

1. Jeff opens P-310 and clicks Edit. (Because this template has Revise on Edit enabled and Jeff changes financial fields, the system will create Revision 2 when he saves — not on opening the editor.)
2. Changes:
   • Reduce visits from 12 to 6 (semi-annual)
   • Add a new line: “After-Hours Emergency Coverage — $1,800/year” (Dynamic Charge)
   • Revised labor: 6 visits × 3 hrs × $95/hr = $1,710
   • Materials: $600 (reduced visits)
   • New Total: $4,110/year
3. Click Save Revision.

Step 4 — Davis accepts Revision 2:

1. Jeff changes Revision 2 status to Submitted.
2. Davis accepts. Jeff changes the status to Approved, then clicks Convert to create the work order.

Proposal history preserved:

Revision	Status	Total	Key Differences
Rev 1	Withdrawn	$4,620	12 quarterly visits, no emergency
Rev 2	Approved	$4,110	6 semi-annual visits + emergency coverage

---

12. Business Rules

Rules are grouped by category. Each rule has an ID for cross-referencing.

Constraints

• BR-CRM-C1: Approved Option Before Conversion — A proposal can be converted to a Work Order once its Conversion Type is Work Order, it has not already been converted, has at least one option marked Approved, and you have Work Order create permission. The approved option’s line items are carried into the Work Order. There is no check on a proposal-level “status” field before conversion.
• BR-CRM-C2: Conversion Type Required — Every proposal must have a Conversion Type, inherited from the selected Proposal Template.
• BR-CRM-C3: Customer and Site Required — Leads and proposals require a customer and site before creation.

Automations

• BR-CRM-A1: Proposal Value Calculation — Proposal Value auto-calculates from linked proposals using the configured method (Avg/Max/Min).
• BR-CRM-A2: Actual Value from Linked Records — Actual Value auto-calculates from work orders, invoices, and job contract amounts linked to the lead. Cancelled work orders and voided invoices are excluded.
• BR-CRM-A3: Revision on Edit — When a proposal template has revision-on-edit enabled, editing financial fields creates a new revision automatically; the original is preserved.
• BR-CRM-A4: Template Population — Selecting a proposal template auto-populates options and line items into the new proposal.

Workflows

• BR-CRM-W1: Lead Pipeline — Lead progresses through configured stages: Prospect → Contacted → Qualified → Proposal Sent → Negotiation → Won/Lost.
• BR-CRM-W2: Proposal Lifecycle — Draft → Submitted → Pending → Approved/Rejected/Withdrawn.

Cross-Module Effects

• BR-CRM-X1: Proposal to Work Order — Approved proposals with Conversion Type = Work Order create WOs in Service with copied customer, site, and line items.
• BR-CRM-X3: Actual Value Feedback — Invoices, WO revenue, and job contract amounts linked to a lead update the lead’s Actual Value, closing the opportunity-to-revenue loop. Cancelled WOs and voided invoices are excluded.

---

13. Troubleshooting / FAQ

Q: I can’t convert a proposal — the Convert button is disabled. The Convert to Work Order action is enabled only when the proposal’s Conversion Type is Work Order, it has not already been converted, and you have Work Order create permission (BR-CRM-C1). Check the proposal’s Conversion Type and that it hasn’t already been converted. (Only the option marked Approved has its line items carried into the Work Order, so make sure an option is approved to bring line items across.)

Q: The system requires a Conversion Type but I haven’t set one. Every proposal must have a Conversion Type, which is inherited from the selected Proposal Template (BR-CRM-C2). Select a template with the appropriate conversion type.

Q: I can’t create a lead — “Customer and Site required.” Both customer and site are required fields on leads and proposals (BR-CRM-C3). Search for the customer first (or use inline create for new customers), then select a site address.

Q: I edited a proposal but my changes created a new revision instead of updating the original. This is by design (BR-CRM-A3). When the proposal template has revision-on-edit enabled, editing financial fields creates a new revision to preserve a complete history. The original revision is still accessible. Use the Latest Revisions Only toggle on the search screen to filter out older versions.

Q: The lead’s Proposal Value doesn’t match what I entered on the proposal. Proposal Value auto-calculates from linked proposals using the configured method — Average, Max, or Min (BR-CRM-A1). If multiple proposals are linked to the lead, the value reflects the calculation method, not a single proposal’s total.

Q: A converted work order is missing line items from the proposal. Only the Approved option’s line items are carried over during conversion. Verify that the correct option was marked as approved before converting. If line items are still missing, check whether the option had its line items fully populated.

Q: My pipeline shows a big drop-off at a specific stage. Review the Unqualified Leads by Reason chart on the CRM Dashboard to understand why leads are falling out. Common causes: budget too low, wrong timing, or competitor wins. Use this data to adjust qualification criteria or sales approach.

---

14. Tips & Notes

Creating and progressing a lead

1. Navigate to Manage Leads → Create.
2. Search for and select the customer (or use the inline create option if it’s a new customer).
3. Select the customer’s site address.
4. Set the Stage to the appropriate starting point in your pipeline, assign a Quality Grade and Potential Value, and select the Source.
5. Assign one or more Salesmen.
6. Click Create to save.
7. As the opportunity progresses, open the lead in edit mode and click the appropriate stage on the progress bar to advance it, or check Won when the business is confirmed.

Building a proposal from a template

1. Navigate to Manage Proposals → Create.
2. Select the customer and site address.
3. Choose a Proposal Template — the options and line items populate automatically.
4. Review each option’s line items and adjust quantities, prices, and descriptions as needed.
5. Click Save to save as a Draft.
6. When ready to send, click Submit to change the status to Submitted.
7. When the customer responds, update the status to Approved, Rejected, or Withdrawn.
8. If Approved, click Convert to create the linked work order.

Logging a follow-up communication

1. Open the lead, work order, or appointment record.
2. In the Communications tab, click +.
3. Set Occurred At to when the call/email/text happened.
4. Select the Type and Status, and add your Notes.
5. Check Followup Required, then set the Followup Date/Time and Followup User.
6. Save the communication.
7. The follow-up details (Followup Required, Date/Time, User) are stored and displayed on the communication record itself. There is no dashboard, schedule, or notification that surfaces the follow-up to the assigned user — review the communication record directly to act on follow-ups.

Managing your pipeline health

Use the CRM Dashboard to monitor pipeline health regularly:

• The Lead Stage Drop-Off funnel shows where prospects are stalling — if a large number of leads are stuck at a particular stage, investigate and address the bottleneck.
• Leads by User and Leads by Campaign show which salesmen and channels are producing results.
• The Proposal $ charts show the dollar value sitting in each proposal status — watch the Submitted and Approved slices for opportunities ready to close.
• Unqualified Leads by Reason reveals systemic issues (e.g., consistently losing on price).