# 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](https://www.syntaqx.com/books/field-operations/field-operations-business#branches-regions-and-the-org-chart); the general shape is in [Tenant Hierarchies](https://www.syntaqx.com/docs/architecture/multi-tenancy#tenant-hierarchies)).
- **Dead time:** paid time that is neither driving to work nor doing it: loading, waiting, paperwork ([The Field Operations Business](https://www.syntaqx.com/books/field-operations/field-operations-business#route-density-and-unit-economics)).
- **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](https://www.syntaqx.com/books/field-operations/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](https://www.syntaqx.com/books/field-operations/field-operations-business#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](https://www.syntaqx.com/books/field-operations/software-landscape)).
- **Horizontal SMB platform:** a field service product for small businesses across many trades, such as Jobber or Housecall Pro ([The Software Landscape](https://www.syntaqx.com/books/field-operations/software-landscape#systems-of-record-by-class)).
- **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](https://www.syntaqx.com/books/field-operations/field-operations-business#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](https://www.syntaqx.com/books/field-operations/field-operations-business#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](https://www.syntaqx.com/books/field-operations/field-operations-business#route-density-and-unit-economics)).
- **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](https://www.syntaqx.com/books/field-operations/field-operations-business#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 a `people` row ([The Core Data Model](https://www.syntaqx.com/books/field-operations/field-operations-business#the-core-data-model)).
- **System of record:** the one system whose copy of a record wins when systems disagree ([The Software Landscape](https://www.syntaqx.com/books/field-operations/software-landscape#systems-of-record-by-class)).
- **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](https://www.syntaqx.com/books/field-operations/software-landscape#systems-of-record-by-class)).

### Customers, Properties and Agreements

- **Account, customer:** the party that pays (`accounts`), kept separate from the place served and the people involved ([Customers, Accounts & Properties](https://www.syntaqx.com/books/field-operations/customers-and-properties#payer-site-and-people)).
- **Add-on:** a product sold alongside a plan and priced on its own ([Service Agreements & Plans](https://www.syntaqx.com/books/field-operations/service-agreements#what-an-agreement-is-made-of)).
- **Agreement:** the contract for a plan version at a property (`agreements`); vendors say membership, maintenance plan, subscription or service agreement ([Service Agreements & Plans](https://www.syntaqx.com/books/field-operations/service-agreements)).
- **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](https://www.syntaqx.com/books/field-operations/service-agreements)).
- **Allowance:** a number of included visits an agreement grants, used on request rather than on a schedule ([Recurring Schedules](https://www.syntaqx.com/books/field-operations/recurring-schedules#how-the-platforms-generate-recurring-work)).
- **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](https://www.syntaqx.com/books/field-operations/one-time-services-and-upsells#adding-an-add-on-to-a-live-agreement)).
- **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](https://www.syntaqx.com/books/field-operations/repair-and-installation#equipment-is-an-asset)).
- **Cancelled versus terminated:** an agreement that ends before it ever became `active` (including in the cooling-off window) is `cancelled` and emits `agreement.cancelled`; ending an `active` agreement is `terminated`, with a churn type and a reason, and emits `agreement.terminated` ([Service Agreements & Plans](https://www.syntaqx.com/books/field-operations/service-agreements#term-renewal-and-cancellation)).
- **CASS:** the USPS certification for address-matching software ([Addresses & Geocoding](https://www.syntaqx.com/docs/fundamentals/addresses#standardize)).
- **Contact role:** what a person may do for an account or property: pay, approve work, receive reports, grant site access ([Customers, Accounts & Properties](https://www.syntaqx.com/books/field-operations/customers-and-properties#people-roles-and-preferences)).
- **Geocode:** coordinates for an address, with a precision that matters (rooftop, parcel, street, postal code) ([Addresses & Geocoding](https://www.syntaqx.com/docs/fundamentals/addresses#geocode-and-precision)).
- **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 to `terminated`. Not the same as a held visit or a work order's hold reason ([Service Agreements & Plans](https://www.syntaqx.com/books/field-operations/service-agreements#pausing-and-holding)).
- **Initial service:** the first visit, usually longer and priced separately from recurring ones ([Service Agreements & Plans](https://www.syntaqx.com/books/field-operations/service-agreements#what-an-agreement-is-made-of)).
- **Membership:** the trade suites' name for an agreement, usually a maintenance plan with tune-ups and member pricing ([Repair, Install & Commercial Work](https://www.syntaqx.com/books/field-operations/repair-and-installation#maintenance-agreements-in-the-repair-trades)).
- **One-time agreement:** an agreement of kind `one_time` for one-time work that needs signed terms (authorizations, a cancellation window, a guarantee, a contract with deposits or permits); it never owns recurrences and ends `fulfilled` ([One-Time Services & Upsells](https://www.syntaqx.com/books/field-operations/one-time-services-and-upsells#when-one-time-work-needs-an-agreement)).
- **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 stays `active`, recorded as a dated suspension interval so a future pause is honored ([Service Agreements & Plans](https://www.syntaqx.com/books/field-operations/service-agreements#pausing-and-holding)).
- **Person:** a customer-side human (`people`), a contact linked to accounts and properties through contact roles; staff are staff members ([Customers, Accounts & Properties](https://www.syntaqx.com/books/field-operations/customers-and-properties#people-roles-and-preferences)).
- **Plan, plan version:** the product sold, versioned so each agreement keeps the terms it was signed under ([Service Agreements & Plans](https://www.syntaqx.com/books/field-operations/service-agreements#how-to-build-it); the pattern is in [Effective Dating & History](https://www.syntaqx.com/docs/database/temporal-data#versioned-entities)).
- **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](https://www.syntaqx.com/books/field-operations/customers-and-properties#what-lives-on-the-property)).
- **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](https://www.syntaqx.com/books/field-operations/customers-and-properties#property-keys-and-enrichment)).
- **Renewal:** extending an agreement's term, automatically or as a new sale; regulated where it's automatic ([Service Agreements & Plans](https://www.syntaqx.com/books/field-operations/service-agreements#term-renewal-and-cancellation)).
- **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](https://www.syntaqx.com/books/field-operations/customers-and-properties#addresses-for-service-work)).
- **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](https://www.syntaqx.com/books/field-operations/service-agreements#upgrades-downgrades-and-changes)).
- **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](https://www.syntaqx.com/books/field-operations/service-agreements#warranties-and-guarantees)).

### 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](https://www.syntaqx.com/books/field-operations/repair-and-installation#insurance-claims-work-restoration-and-roofing)).
- **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](https://www.syntaqx.com/books/field-operations/consumer-protection#the-exclusions-read-narrowly)).
- **Callback, recall, re-service:** a return to fix work that didn't hold, modeled as a new work order with `source = 'callback'` and `callback_of_work_order_id` set 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](https://www.syntaqx.com/books/field-operations/repair-and-installation#first-time-fix-and-callbacks)).
- **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](https://www.syntaqx.com/books/field-operations/repair-and-installation#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](https://www.syntaqx.com/books/field-operations/repair-and-installation#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](https://www.syntaqx.com/books/field-operations/repair-and-installation#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](https://www.syntaqx.com/books/field-operations/repair-and-installation#commercial-work-contracts-clocks-and-caps)).
- **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](https://www.syntaqx.com/books/field-operations/repair-and-installation#diagnostic-fees-and-trip-charges)).
- **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](https://www.syntaqx.com/books/field-operations/field-operations-business#the-core-data-model); options and approvals are in [Pricing & Sales Rules](https://www.syntaqx.com/books/field-operations/pricing-and-sales-rules#good-better-best-and-proposals)).
- **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](https://www.syntaqx.com/books/field-operations/repair-and-installation#flat-rate-or-time-and-materials)).
- **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 is `completed` ([The Core Data Model](https://www.syntaqx.com/books/field-operations/field-operations-business#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](https://www.syntaqx.com/books/field-operations/repair-and-installation#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](https://www.syntaqx.com/books/field-operations/repair-and-installation#commercial-work-contracts-clocks-and-caps)).
- **On call:** availability outside regular hours; it lets a technician be sent without counting as bookable capacity ([Repair, Install & Commercial Work](https://www.syntaqx.com/books/field-operations/repair-and-installation#emergencies-after-hours-and-on-call)).
- **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](https://www.syntaqx.com/books/field-operations/consumer-protection#the-exclusions-read-narrowly)).
- **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](https://www.syntaqx.com/books/field-operations/repair-and-installation#commercial-work-contracts-clocks-and-caps)).
- **Progress billing:** deposits, progress payments and a final invoice against one project, often from a schedule of values with retainage ([Repair, Install & Commercial Work](https://www.syntaqx.com/books/field-operations/repair-and-installation#installs-and-projects)).
- **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](https://www.syntaqx.com/books/field-operations/repair-and-installation#commercial-work-contracts-clocks-and-caps)).
- **Recoverable depreciation:** the part of a replacement-cost insurance payment the carrier withholds until the repair is finished and invoiced ([Insurance Claims Work](https://www.syntaqx.com/books/field-operations/repair-and-installation#insurance-claims-work-restoration-and-roofing)).
- **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](https://www.syntaqx.com/books/field-operations/field-operations-business#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](https://www.syntaqx.com/books/field-operations/repair-and-installation#commercial-work-contracts-clocks-and-caps)).
- **Subcontractor:** another company that performs work for this one, booked as a `contractor` resource, paid per job and gated on its own license, insurance and bond ([Subcontractors and Inbound Work Orders](https://www.syntaqx.com/books/field-operations/repair-and-installation#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](https://www.syntaqx.com/books/field-operations/repair-and-installation#insurance-claims-work-restoration-and-roofing)).
- **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](https://www.syntaqx.com/books/field-operations/repair-and-installation#how-to-build-it)).
- **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](https://www.syntaqx.com/books/field-operations/repair-and-installation#flat-rate-or-time-and-materials)).
- **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](https://www.syntaqx.com/books/field-operations/repair-and-installation#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](https://www.syntaqx.com/books/field-operations/repair-and-installation#warranty-claims-getting-paid-by-someone-else)).
- **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](https://www.syntaqx.com/books/field-operations/repair-and-installation#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](https://www.syntaqx.com/books/field-operations/field-operations-business#the-core-data-model)).
- **Xactimate:** Verisk's estimating software, in whose line items most US property insurance claims are priced and supplemented ([Insurance Claims Work](https://www.syntaqx.com/books/field-operations/repair-and-installation#insurance-claims-work-restoration-and-roofing)).

### Last-Mile Delivery

- **Attendance:** whether someone must be present for the work: `required`, `preferred` or `not_required`. Unattended work can drop its arrival window, which is the largest density lever in routing ([Last-Mile Delivery & Distribution](https://www.syntaqx.com/books/field-operations/last-mile-delivery#attended-and-unattended-service)).
- **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](https://www.syntaqx.com/books/field-operations/last-mile-delivery#why-the-last-mile-costs-the-most)).
- **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](https://www.syntaqx.com/books/field-operations/last-mile-delivery#preferences-and-instructions)).
- **First, middle and last mile:** shipper to warehouse, warehouse to hub or depot, and depot to door ([Last-Mile Delivery & Distribution](https://www.syntaqx.com/books/field-operations/last-mile-delivery#from-dock-to-door)).
- **First-attempt delivery rate:** the share of deliveries completed on the first attempt ([Operating Metrics](https://www.syntaqx.com/books/field-operations/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](https://www.syntaqx.com/books/field-operations/last-mile-delivery#proof-when-nobody-signs)).
- **Pickup-and-delivery pair:** two linked stops where the delivery can't happen before its pickup ([Last-Mile Delivery & Distribution](https://www.syntaqx.com/books/field-operations/last-mile-delivery#waves-depots-and-pickup-and-delivery-pairs)).
- **Shipper, consignee:** who pays for the delivery, and who receives it at the site ([Last-Mile Delivery & Distribution](https://www.syntaqx.com/books/field-operations/last-mile-delivery#who-pays-shipper-and-consignee)).
- **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](https://www.syntaqx.com/books/field-operations/last-mile-delivery#failed-attempts-redelivery-and-returns)).

---

Canonical URL: https://www.syntaqx.com/books/field-operations/glossary/how-the-work-flows
