When a job cannot be completed as planned, you can cancel it with a documented reason. This ensures proper record-keeping and helps identify patterns in job cancellations.
When to Cancel a Job
Common scenarios for cancellation:
Customer requests cancellationWeather conditions prevent serviceAccess issues at the job siteEquipment problemsEmergency prioritization of other workSite not ready for serviceHow to Cancel a Job
Step 1: Open the Job
Navigate to the job you want to cancel and open the Job Detail Modal.
Step 2: Click Cancel Job
Locate the "Cancel Job" button (red outline with ban icon)Click to open the Cancel Job ModalStep 3: Select Cancellation Reason
The modal requires you to specify why the job is being cancelled:
Preset Reasons:
Customer RequestWeather ConditionsAccess IssuesEquipment ProblemsEmergency PrioritizationSite Not ReadyOtherStep 4: Provide Custom Reason (if "Other")
If you select "Other":
A text input field appearsEnter a specific reason (max 255 characters)This becomes the recorded cancellation reasonStep 5: Confirm Cancellation
Review the job number and customer name displayedClick "Cancel Job" to confirmOr click "Keep Job" to abort the cancellationWhat Happens When You Cancel
| Action | Result |
|--------|--------|
| Status Update | Changes to "cancelled" |
| Reason Storage | `cancellation_reason` field populated |
| Timestamp | `cancelled_at` recorded |
| Visual Indicator | Job displays with red cancelled badge |
| Equipment | Assignments may need manual handling |
Viewing Cancelled Jobs
By default, cancelled jobs are hidden from the Calendar and Dispatch views. To see them:
Toggle "Show Cancelled Jobs" in the filter barCancelled jobs appear with red stylingCancellation Details Display
For cancelled jobs, a special "Cancellation Details" card appears in the Job Detail Modal showing:
The recorded reasonThe date and time of cancellationImportant Notes
Cancellation is permanent - you cannot un-cancel a jobCreate a new job if the work should still be completedEquipment assignments may still show on the cancelled job for referenceReports and analytics can filter or include cancelled jobs for pattern analysisTips
Always document the reason clearly for future referenceConsider calling the customer before cancelling to explore alternativesIf weather causes multiple cancellations, use the "Weather Conditions" reason for accurate reporting