Excavation Software — Data Model | FieldCamp
How an excavation business runs in FieldCamp — site projects, heavy machinery with hours, 811 locate tickets, materials hauled, and permits on the core records.
An excavation contractor does not run a service call.
A dig is a site project — it gets located before anyone breaks ground, it runs on machines billed by the hour, it moves dirt by the load, and it is gated by permits and a one-call ticket from the day it starts.
FieldCamp models that. Your Customers, Requests, Estimates & Invoices, Jobs, and Visits already carry the client, the bid, the field schedule, and the billing.
On top of that, an excavation setup adds the records a dig needs and core has no home for: a Site project that runs the whole job, a Machinery asset with its own hours, a Locate Ticket for the 811 call, materials hauled, and permits.
What the core already gives you
Most of an excavation workflow is already wired into the core records. Keep them as-is and add the site-work layer on top.
- The client book — a Customer carries a separate property address and billing address, the lead source, and the account history, so homeowners, builders, and repeat GCs live in one place.
- The bid front end — a Request captures the inquiry and the site walk, then converts into an Estimate. An excavation bid is often a multi-option proposal: the Good / Better / Best scope is one estimate with selectable options, plus a deposit and an approval step.
- Billing — an Invoice handles deposits, payment terms, purchase-order numbers, overdue reminders, and card or online payment.
- The field schedule — a Job is the scheduled work, carried out as one or more Visits. A multi-day dig is one visit per day, each with crew assignment, on-site check-in and check-out, and a signature-gated finish step.
- On-site data capture — a pre-dig safety walk, a daily dig log, an as-built photo set, and a backfill compaction sign-off are captured as job forms, not loose fields.
- The price book — machine rates, material rates, and trucking are line items in the price book with vendors and cost ladders, and feed every estimate and invoice.
So the site-work layer is additive. Core handles the client, the bid, the billing, the field schedule, and the forms; the specialized objects handle the site project, the machinery, the locate ticket, the materials, and the permits.
What excavation adds
Each item below is a custom object built on FieldCamp's customization engine — its own fields, its own links to the core records, its own stages where it needs them, and its own record page assembled from building blocks.
Together they capture the five things that define the excavation business: a site-project spine, the machines that do the digging, the one-call ticket that keeps it legal, the dirt that moves, and the permits that gate it.
Site Project — the dig spine
The Site Project is the record that runs a dig from a signed contract through final grade.
It exists because a core Job models one scheduled work order, while a site job is a multi-phase project with its own contract value, its own machines and hauls, and its own long lifecycle.
It carries the project name, the project type (residential or commercial / site-work), the work type (foundation dig, grading, trenching, demolition, septic, pond, or utility install), the site address, the contract value and signed date, the start and target-complete dates, the cubic-yards of cut and fill, a permit-required flag, project photos and documents, and notes.
It links to the rest of the model: to the Customer it belongs to, to the Estimate and Invoice that handle the bid and billing, to the Jobs that produce the visits and crews, to its Locate Tickets, its Material Hauls, its Permits, the Machinery on site, and the team member running as foreman.
A net-yardage field can be a formula — cubic yards of cut minus cubic yards of fill — so the import or export figure updates itself rather than being retyped.
The project board is a drag-across-stages view of every active site project — the same idea as a construction PM board, rebuilt natively.
Its page also shows key numbers like contract value, machine hours to date, and yardage moved, and a cost view comparing estimated against actual.
Machinery — the asset with hours
A Machinery record is one piece of heavy equipment — an excavator, a dozer, a skid steer, a loader, a backhoe, a compactor, or a haul truck.
It is a standalone asset so a machine's make, model, serial, and running hours follow it across every project, not retyped per job.
| Field | Field type | What it holds |
|---|---|---|
| Name | Text | A plain label for the machine, such as "CAT 320 Excavator." Required. |
| Machine type | Single choice | Excavator, Dozer, Loader, Backhoe, Skid Steer, Compactor, or Haul Truck. |
| Make · Model | Text · Text | The manufacturer and model. |
| Serial / VIN | Text | The unit's serial or vehicle identification number, for service and rental records. |
| Current hours | Number | The reading off the hour meter, the basis for service intervals and machine billing. |
| Next service hours | Number | The hour reading the next preventive service is due at. |
| Ownership | Single choice | Owned, Leased, or Rented — so rented machines surface against their return date. |
| Status | Pipeline stage | Whether the machine is in service, down for maintenance, or retired. |
A Machinery record uses an assets block for its specs and a service-history block built from the visits performed against it, and a compliance block can count down hours to the next service so a machine due for a PM surfaces before it goes down.
Machine hours are captured, not auto-imported. FieldCamp stores the hour-meter reading you record and uses it for service intervals and hour-based billing. It does not pull engine hours, idle time, fuel, or fault codes live from a telematics feed — CAT Product Link, Komatsu KOMTRAX, John Deere JDLink, or a third-party GPS box. Record the hours off the meter or from a daily log; the live telematics connection is not built here.
Locate Ticket — the 811 call
A Locate Ticket is the one-call notification an excavator is legally required to file before digging.
Anyone breaking ground requests that the approximate location of underground utilities — gas, electric, water, sewer, telecom — be marked, and the call comes back with a ticket number and a clock.
It earns its own record because that clock is not yours.
A ticket has a legal wait before you can dig — two or three business days in most states — and an expiry date after which it has to be refreshed, so it runs on the one-call center's timing, separate from the project's.
| Field | Field type | What it holds |
|---|---|---|
| Ticket number | Text | The reference number returned by the one-call center, kept for the life of the dig. Required. |
| One-call center | Text | The state 811 / one-call center the ticket was filed with. |
| Date filed | Date | When the locate request was submitted. |
| Dig-by / legal start | Date | The date the legal wait clears and digging may begin. |
| Expiration date | Date | When the ticket lapses and must be renewed before work continues. |
| Utilities marked | Multi-choice | Which facilities have been located — gas, electric, water, sewer, telecom, other. |
| All clear | Checkbox | Whether every facility owner has responded and the site is positive-response clear. |
| Status | Pipeline stage | Its stage from filed through cleared to expired. |
A Locate Ticket belongs to its Site Project, and through the project it inherits the Customer and site address. One project can carry several over its life, because a long dig outlasts a single ticket and the call has to be refreshed.
Mark Ticket number and Dig-by date as required before a project can move into digging, and put a confirmation on that move.
The crew cannot break ground without a live ticket and the date the wait clears, so the guardrail lands exactly where the regulation does.
Material Haul — the dirt that moves
A Material Haul is one record of material brought to or taken from the site — the import and export that site-work bills and reports on.
Trucking sand, gravel, dirt, and spoil is much of the day, so the loads are a record, not a note buried on the job.
| Field | Field type | What it holds |
|---|---|---|
| Material | Single choice | Topsoil, Fill, Gravel, Sand, Rock, Spoil, or Debris. |
| Direction | Single choice | Import to site or Export from site. |
| Quantity · Unit | Number · Single choice | The amount moved, in cubic yards, tons, or loads. |
| Truck count | Number | How many truck loads the haul took. |
| Hauler / vendor | Text | The trucking company or pit the material came from or went to. |
| Disposal / source site | Text | The pit, quarry, or dump the material was sourced from or hauled to. |
| Ticket / weigh slip | File | The scale ticket or load slip backing the quantity. |
Each Material Haul belongs to its Site Project, and a loadout sheet on the project compares projected, hauled, and actual material, so the dirt budget stays honest across a long dig.
Permit — the authorization with its own clock
A Permit is the city or county authorization a dig depends on — a grading permit, a land-disturbance permit, a right-of-way or street-cut permit, or a demolition permit, pulled before some work can legally start and closed out before the work is done.
Permits are a full example in their own right. The Permits data model covers the permit number, issuing authority, fees, dates, and the applied-to-closed lifecycle in detail.
On an excavation project, a Permit parents to the Job or the Site Project the way Equipment parents to a customer, and one dig can carry several at once — grading, right-of-way, and demolition.
How the excavation objects link to the core
A Customer owns Site Projects. Each Site Project pulls in the core bid and billing records, the Jobs that produce its visits and crews, its locate tickets, its material hauls, its permits, and the machinery working the dig — with a team member as foreman.
The site-work lifecycle
A site project moves through a named dig lifecycle — and it has one gate a service call never does: nobody breaks ground until the locate ticket clears. The diagram shows the path from the bid through locate, dig, backfill, and restore.
A few of these stages carry requirements before a project can move on. Marking a project Contract Signed asks for the contract value and signed date and shows a confirmation.
The move into Digging asks for a cleared Locate Ticket, and Closeout can ask for the final-grade photo set and, on residential work, an owner signature.
Along the way, the project keeps itself in sync. Marking it Contract Signed spins up the first dig Job.
Reaching Locate Cleared, Backfill, or Closeout sends a notification to the office, the foreman, or the client. And because a long dig can outlast its ticket, the loop back from Digging to Locate Requested is built in for a refresh.
The phase names are yours to rename. A trenching outfit might run Locate, Trench, Lay, Backfill; a grading contractor might run Strip, Cut, Fill, Compact, Finish — the same pipeline, relabeled to the way the shop talks about its work.
Residential vs commercial site work
One model serves both. The differences are a handful of fields and stages that turn on or off per segment — not a separate build.
Residential
A foundation dig, a septic, or a backyard pond is one homeowner, one lot, one Site Project. The job is shorter, runs a machine or two, and often pulls a single grading or land-disturbance permit. Billing is a deposit plus a final, and the homeowner signs off at closeout. The locate ticket is still mandatory — the same 811 call, on the same legal clock.
Commercial / site-work
A subdivision, a pad, or a road job is longer, runs a deeper machine fleet, and moves far more dirt — so material hauls and machine hours carry the cost. It pulls more permits — grading, right-of-way, demolition — and bills on monthly progress draws. The schedule is contract-driven, with a foreman and superintendent on the team.
The Site Project, Machinery, Locate Ticket, and Material Haul records serve both — fill the fields each segment needs. The permit-heavy, haul-heavy commercial path and the single-lot residential path are the same objects, configured differently.
Built for any size. A two-machine residential dirt outfit and a multi-crew site-work contractor run on the same records. The Site Project, Machinery, Locate Ticket, Material Haul, and Permit layer is there whether you run one dig or twenty — and it sits on the same transaction spine the smallest service shop uses.
Built on the customization engine
None of these records are a separate product bolted on.
The Site Project, Machinery, Locate Ticket, and Material Haul are custom objects with their own fields; the dig lifecycle, the locate-clear gate, and the machine-status steps are stages and workflows with their own requirements and automations; and each record page is arranged from building blocks like the project board, the loadout sheet, the cost view, and the service-hours countdown.
Machines lean on the Equipment asset pattern, and permits are the Permits custom object parented to the dig.
Rename a stage, add a field, or rearrange a page, and the model bends to how your shop actually runs — without touching the transaction spine underneath.
Related records
The homeowner, builder, or GC a site project, its hauls, and its billing all hang off.
The scheduled dig a site project produces — line items, crews, machines, and status.
The asset pattern the Machinery record is built on — specs, hours, and service history.
The grading and right-of-way authorizations a dig is gated by, on their own clock.
The Good / Better / Best bid and the deposits and progress invoices that follow.
How the site project, machinery, locate ticket, and haul records are built.
Coming from HCSS
Most earthwork and excavation contractors run on HCSS — HeavyBid for the bid, HeavyJob for the field, and Equipment360 for the fleet.
The shapes line up well: a job is the dig, cost codes price the work, foremen log crews and quantities from the field, and equipment carries its hours.
The difference is that in FieldCamp you own and shape the model, rather than fitting your shop to a fixed one. Most of what HCSS holds has a home here.
| In HCSS | In FieldCamp | Notes |
|---|---|---|
| Owner / Customer | Customers | The homeowner, builder, or GC responsible for the bid and billing. One record holds property and billing addresses. |
| Job (HeavyJob) | A Site Project — a custom object — that produces the Jobs | HCSS's job is a multi-phase project; model it as the Site Project spine, with each scheduled dig as a Job. |
| Bid / Estimate (HeavyBid) | Estimates & Invoices | The bid carries Good / Better / Best options, deposits, and progress invoices. |
| Bid items / activities / cost codes | Price Book line items | Machine rates, material rates, and trucking, with vendor pricing and cost ladders, feeding every estimate. |
| Equipment (Equipment360) | A Machinery asset on the Equipment pattern | The excavator, dozer, or haul truck, tracked with make, model, serial, and running hours across every project. |
| Meter readings | Current hours on the Machinery record | The hour-meter reading you record, the basis for service intervals and hour-based billing. |
| Time card (foreman crew entry) | Visits staffed by Team Members | Each scheduled trip, with crew assignment, on-site check-in and check-out, and a signature-gated finish. |
| Crew / labor class | Team Members | Carry certifications as skills and territory as service areas. |
| Daily diary | A daily dig log job form on the visit | Weather, deliveries, delays, and field notes captured as a structured form, not loose fields. |
| Quantities (yardage, material) | A Material Haul custom object and yardage fields on the Site Project | Import and export by the load, with a loadout sheet comparing projected against actual. |
| 811 / one-call ticket | A Locate Ticket custom object | The one-call notification on its own legal clock, with a dig-by date and an expiry to refresh. |
| Permit | Permits | Grading, right-of-way, and demolition authorizations, each on their own clock, attached to the Job or Site Project. |
What you gain. In HCSS the structure is fixed — the objects, their fields, and how they relate are set for you.
In FieldCamp every one of those records is yours to rename, extend, restage, and relayout with custom objects and fields and your own stages and workflows, so you can match your old setup first and then bend it to the way your shop talks about a dig.
One honest difference. HCSS is a heavy-civil platform with depth FieldCamp does not replicate.
It pulls live engine hours, idle, fuel, and fault codes from HCSS Telematics; it runs mass-haul and earthwork takeoff against a model; it carries certified payroll and union-rate compliance; and HeavyJob runs a real-time job-costing engine that books labor and equipment against cost codes as the field reports it.
FieldCamp captures hours off the meter, logs quantities and crews from the field, and compares estimated against actual on the project — but the live telematics feed, the takeoff model, certified payroll, and the standalone cost-accounting engine are not built here.
If those are central to how you bid and bill, plan that part of the move deliberately.
See also
More in the FieldCamp data model.
Define the phases each dig moves through, and the locate gate before ground breaks.
Arrange the project board, loadout sheet, and service-hours blocks on each record page.
See another project-driven trade built on the same core records.
How the core records connect, and how to make them your own.
Electrical Data Model — Permits & Assets | FieldCamp
How an electrical business runs in FieldCamp: core records for service work, plus specialized objects for serviced assets, permits, inspections, and projects.
Fencing Data Model — Permits & Takeoff | FieldCamp
How a fencing business runs in FieldCamp: Request, Estimate, Job, Visit, Invoice, plus a permit and utility-locate gate and fence-segment takeoff records.