Field OperationsField Operations GlossaryPart 1 of 7
How the Work Flows Glossary
76 terms from the Field Operations book's How the Work Flows part, each defined in a line and linked to the chapter that explains it.
The Business and the Market
- Branch, region, brand: the layers of an org tree; a branch owns a territory, its technicians and routes, and is the unit most work is run and reported by (The Field Operations Business; the general shape is in Tenant Hierarchies).
- Dead time: paid time that is neither driving to work nor doing it: loading, waiting, paperwork (The Field Operations Business).
- Enterprise field service: field service built on a general business platform (Salesforce, Dynamics 365, ServiceNow, Oracle, SAP, IFS) and extended per customer (The Software Landscape).
- Franchisor, franchisee: the brand owner and the separate business that operates under its brand, prices and software; who may see and keep whose data is set by the franchise agreement and disclosed in Item 11 of the disclosure document (Branches, Regions and the Org Chart).
- FSM (field service management): software that runs the customer, scheduling, technician and billing side of a field business (The Software Landscape).
- Horizontal SMB platform: a field service product for small businesses across many trades, such as Jobber or Housecall Pro (The Software Landscape).
- Multi-location roll-up: reporting summed from branches or franchisees up the org tree, each number kept under the org unit and business date it was recorded with (Branches, Regions and the Org Chart).
- Org unit: one node of the org tree (
org_units: a brand, region or branch), carrying the time zone that sets the branch's business date for billing and generation runs (The Core Data Model). - Route density: how many customers sit close together on a route; the economics of recurring service are mostly density (The Field Operations Business).
- Royalty report: the franchisor's periodic fee computed as a percentage of each franchisee's gross or net sales as its agreement defines them, closed and stamped like a commission run (Branches, Regions and the Org Chart).
- Staff member: an employee or contractor who logs in or does the work (
staff_members); a worker is always a staff member, never apeoplerow (The Core Data Model). - System of record: the one system whose copy of a record wins when systems disagree (The Software Landscape).
- Vertical platform: a product built for one trade's rules, such as FieldRoutes or PestPac for pest control, or Skimmer for pools (The Software Landscape).
Customers, Properties and Agreements
- Account, customer: the party that pays (
accounts), kept separate from the place served and the people involved (Customers, Accounts & Properties). - Add-on: a product sold alongside a plan and priced on its own (Service Agreements & Plans).
- Agreement: the contract for a plan version at a property (
agreements); vendors say membership, maintenance plan, subscription or service agreement (Service Agreements & Plans). - Agreement states: draft, out for signature, signed (cancellation window open, not billable), active, paused, on hold, terminated, fulfilled (a one-time agreement whose work and term are done); or void (never signed) and cancelled (ended before it became active) (Service Agreements & Plans).
- Allowance: a number of included visits an agreement grants, used on request rather than on a schedule (Recurring Schedules).
- Amendment: a change to a live agreement recorded as a new terms version, such as an add-on joining mid-term, effective on its first added visit and prorated by day (One-Time Services & Upsells).
- Asset, equipment: a serviced thing at a property (a furnace, a backflow assembly, a pool pump, bait stations) with its own history, serial number and warranty terms (Repair, Install & Commercial Work).
- Cancelled versus terminated: an agreement that ends before it ever became
active(including in the cooling-off window) iscancelledand emitsagreement.cancelled; ending anactiveagreement isterminated, with a churn type and a reason, and emitsagreement.terminated(Service Agreements & Plans). - CASS: the USPS certification for address-matching software (Addresses & Geocoding).
- Contact role: what a person may do for an account or property: pay, approve work, receive reports, grant site access (Customers, Accounts & Properties).
- Geocode: coordinates for an address, with a precision that matters (rooftop, parcel, street, postal code) (Addresses & Geocoding).
- Hold (agreement): the company stopping service on an agreement (
on_hold) for non-payment or a dispute; no new visits or charges while collection continues. The status is the current state, driven by dated suspension intervals the generator reads. FieldRoutes separates its hold from a freeze, which ends the subscription and maps toterminated. Not the same as a held visit or a work order's hold reason (Service Agreements & Plans). - Initial service: the first visit, usually longer and priced separately from recurring ones (Service Agreements & Plans).
- Membership: the trade suites' name for an agreement, usually a maintenance plan with tune-ups and member pricing (Repair, Install & Commercial Work).
- One-time agreement: an agreement of kind
one_timefor one-time work that needs signed terms (authorizations, a cancellation window, a guarantee, a contract with deposits or permits); it never owns recurrences and endsfulfilled(One-Time Services & Upsells). - Pause: the customer asking to stop service for a while (travel, a pool drained for repairs) without ending the agreement (
paused); a seasonal plan's planned off-season is the recurrence's season, not a pause, and the agreement staysactive, recorded as a dated suspension interval so a future pause is honored (Service Agreements & Plans). - Person: a customer-side human (
people), a contact linked to accounts and properties through contact roles; staff are staff members (Customers, Accounts & Properties). - Plan, plan version: the product sold, versioned so each agreement keeps the terms it was signed under (Service Agreements & Plans; the pattern is in Effective Dating & History).
- Property, location, site: the place where the work happens (
properties), with its own service point, time zone, access notes, hazards and assets (Customers, Accounts & Properties). - Property key: a data vendor's stable identifier for a parcel or address, stored beside your own ID to join enrichment data (Customers, Accounts & Properties).
- Renewal: extending an agreement's term, automatically or as a new sale; regulated where it's automatic (Service Agreements & Plans).
- Service point: the spot a technician drives to, stored as the property's location; a technician's pin outranks any vendor rooftop (Customers, Accounts & Properties).
- Versioned terms: an agreement as a stable identity whose terms (lines, prices, frequency) change as immutable versions, so history shows what applied when (Service Agreements & Plans).
- Warranty, guarantee: a promise about future outcomes: a company's (a renewable termite warranty, a re-service guarantee) lives on the agreement; a manufacturer's lives on the asset (Service Agreements & Plans).
Repair, Install and Commercial Work
- Assignment of benefits (AOB): a homeowner signing insurance proceeds over to a contractor; Florida voided it for residential policies issued on or after January 1, 2023 (Insurance Claims Work).
- Bona fide emergency: a buyer-initiated "bona fide immediate personal emergency," where the buyer waives the cooling-off right in a dated, signed statement in their own handwriting; a technician's checkbox never qualifies (Consumer Protection).
- Callback, recall, re-service: a return to fix work that didn't hold, modeled as a new work order with
source = 'callback'andcallback_of_work_order_idset when it's booked, usually at no charge. A part that wasn't on the truck is a hold, not a callback; repair trades say callback or recall, recurring trades say re-service (Repair, Install & Commercial Work). - Change order: a signed amendment to a sold estimate that changes price, scope or schedule, and moves the job's budget and contract value when approved (Installs and Projects).
- Connected device, device alert: a sensor or controller on an asset (a thermostat, a pump, a rodent trap) whose alerts are deduplicated and triaged into work orders, CSR tasks or remote fixes, under access the owner granted (Connected Equipment and Remote Monitoring).
- Debounce window: the period in which repeated alerts from one device are parented under the first instead of opening new work (Connected Equipment and Remote Monitoring).
- Deficiency: a problem found on a planned or inspection visit, recorded per asset with a severity, and often turned into a quote (Repair, Install & Commercial Work).
- Diagnostic fee, trip charge: what the customer pays for the visit and the diagnosis, whether or not they buy the repair; waived, credited or charged by rule (Repair, Install & Commercial Work).
- Estimate, quote: a priced proposal (
estimates) linked to the work order it would fill, with options and snapshotted lines; approving an option copies its lines onto the work order (The Core Data Model; options and approvals are in Pricing & Sales Rules). - Flat rate: one price per task (labor, typical parts and markup), approved before work starts; the usual pricing for residential repair (Repair, Install & Commercial Work).
- Hold reason (work order): why an open work order is waiting (
part_needed,approval_needed,permit_needed) after a visit did what it could; the visit itself iscompleted(The Core Data Model). - Home warranty, residential service company: a contract company that both dispatches a covered repair to a contractor and pays for it after authorization, while the homeowner pays a service call fee (Home Warranty Companies).
- Not-to-exceed (NTE): a commercial client's spending cap on a work order; crossing it needs a recorded approval (Repair, Install & Commercial Work).
- On call: availability outside regular hours; it lets a technician be sent without counting as bookable capacity (Repair, Install & Commercial Work).
- Personal property: movable goods, as opposed to the home itself; the Cooling-Off Rule's repair exclusion covers only buyer-initiated repair of the buyer's personal property (Consumer Protection).
- Preventive maintenance, planned maintenance: scheduled work per asset (tune-ups, inspections, filter changes), driven by a calendar, a condition or usage (Repair, Install & Commercial Work).
- Progress billing: deposits, progress payments and a final invoice against one project, often from a schedule of values with retainage (Repair, Install & Commercial Work).
- Purchase order (PO): a commercial client's authorization number, carried on the work order, without which the invoice won't be paid; also the order to a supplier for a special-order part (Repair, Install & Commercial Work).
- Recoverable depreciation: the part of a replacement-cost insurance payment the carrier withholds until the repair is finished and invoiced (Insurance Claims Work).
- Service type: the catalog of what work orders perform (
service_types): a quarterly pest service, a drain clearing, a furnace install. Vendors' work types add a default duration and required skills (The Core Data Model). - SLA clock: a response or resolution target on a work order (the response clock and the resolution clock), counted on a calendar in the property's zone and rebuilt from start, pause, resume and breach events (Repair, Install & Commercial Work).
- Subcontractor: another company that performs work for this one, booked as a
contractorresource, paid per job and gated on its own license, insurance and bond (Subcontractors and Inbound Work Orders). - Supplement: a request to the insurance carrier to add items the adjuster's estimate missed, approved before the work is done (Insurance Claims Work).
- Third-party payer: an account other than the customer that pays some of a work order (a home warranty company, an insurer, a facilities client, a lender), with its own reference and authorization (Repair, Install & Commercial Work).
- Time and materials (T&M): labor by the hour at a rate set by when it happens, plus parts at cost plus markup (Repair, Install & Commercial Work).
- Trade service call fee: the homeowner's share of a home warranty job, owed per service request, with the rest of the invoice going to the warranty company; not the same as a diagnostic fee, which the customer pays the contractor directly (Home Warranty Companies).
- Warranty claim: a request to a manufacturer, distributor or claim processor to pay for a covered part or labor, tracked as a receivable with a submit-by date, evidence and states (Repair, Install & Commercial Work).
- Work order network: a facilities client's system for dispatching contractors, such as ServiceChannel or CorrigoPro, with check-in, NTE and invoicing on the client's side (Subcontractors and Inbound Work Orders).
- Work order: the work to be done (
work_orders), from an occurrence, a request, a sale or a callback; vendors also call it a job or ticket. One work order can take several visits (The Field Operations Business). - Xactimate: Verisk's estimating software, in whose line items most US property insurance claims are priced and supplemented (Insurance Claims Work).
Last-Mile Delivery
- Attendance: whether someone must be present for the work:
required,preferredornot_required. Unattended work can drop its arrival window, which is the largest density lever in routing (Last-Mile Delivery & Distribution). - Cost per stop, cost per delivery: route cost divided by stops attempted, versus by deliveries completed; the gap is what failed attempts cost (Last-Mile Delivery & Distribution).
- Delivery instruction: a standing instruction on the property (safe place, gate code) or a one-off on the order, applied in a fixed precedence; access codes are secrets (Last-Mile Delivery & Distribution).
- First, middle and last mile: shipper to warehouse, warehouse to hub or depot, and depot to door (Last-Mile Delivery & Distribution).
- First-attempt delivery rate: the share of deliveries completed on the first attempt (Operating Metrics).
- Handoff: how a delivery left the driver: to the recipient, to a third party, a safe place, a mailbox, a locker or a garage (Last-Mile Delivery & Distribution).
- Pickup-and-delivery pair: two linked stops where the delivery can't happen before its pickup (Last-Mile Delivery & Distribution).
- Shipper, consignee: who pays for the delivery, and who receives it at the site (Last-Mile Delivery & Distribution).
- Undeliverable action: what happens after the last failed attempt (return to sender, hold at a pickup point, dispose), decided when the order is created (Last-Mile Delivery & Distribution).