Jobs & Scheduling
Jobs List & Detail
Create jobs, track status, assign technicians, and view job history.
6 min readJobs List & Detail
Create and track field jobs, assign technicians, and drill into job history from the list or a customer record.
Overview
Jobs (
/jobs) is the operational center for scheduled work. Create jobs from the list, customer detail, estimates, or /jobs/new. Each job has a detail page at /jobs/:id with status, scheduling, notes, and related billing.How to access
| Area | Menu path | Route |
|---|---|---|
| Job list | Jobs | /jobs |
| New job (full page) | New Job on list | /jobs/new |
| Job detail | Click a row | /jobs/:id |
| Board view | List view toggle | /jobs/board |
| Calendar | Jobs calendar | /jobs/calendar |
Requires
jobs:view (and create/update/delete for mutating actions).What you can do today
- Search, filter, and sort the job list; switch to Board or Calendar views.
- Open New Job — renders the new job modal as a full page at
/jobs/new. - Prefill new jobs via query params (
customerId,estimateId,scheduledDate,assignedTechnicianId, etc.). - Assign primary and additional technicians, vehicles, and schedule date/time.
- Set job type, priority, source, recurring options, and on-site notes.
- View and update job status on the detail page.
- Link jobs to customers, estimates, and invoices.
Prerequisites
- Active customers for customer-linked jobs.
- Technicians configured under team/users settings for assignment.
- Optional: approved estimate to prefill job context via
estimateIdon/jobs/new.
Step-by-step
Create a job from the list
- Go to Jobs → click New Job (
/jobs/new). - Search and select a customer (or arrive with
?customerId=prefilled). - Choose job type, priority, and service address.
- Use Schedule to pick date, time, and primary technician.
- Enter description and optional quoted price.
- Expand More for on-site notes, access instructions, and special requirements.
- Submit — you land on
/jobs/:id(or yourreturnUrlif provided).
Create a job from a customer
- Open
/customers/:id. - Click New Job.
- Complete the same modal flow with the customer locked in.
Work a job to completion
- Open
/jobs/:id. - Update status as work progresses (Draft → Scheduled → In Progress → Completed).
- Add notes, photos, and related invoices/estimates from the detail page actions.
Current limitations
New job modal — partial / preview areas
- Quoted price shows an AI · from price book · soon hint; manual entry works, but AI price-book suggestion is not live.
- Change customer button in the locked-customer header is disabled when opened from a customer context.
- List-level AI Insights preview on Jobs requires OpenAI configuration (same pattern as Customers).
Other list actions labeled COMING SOON in related modules do not block core job create/edit.
Roadmap
- AI-assisted quoted price from price book on new job.
- Deeper job list AI suggestions when OpenAI is connected.
Related features
- Job Pipeline Board — Kanban by status
- Customer Detail & Workspace — start jobs from a customer
- Estimates Overview — convert approved estimates to jobs
- Scheduler & Dispatch — day-view dispatch (separate guide)