Repair Jobs ​
Repair jobs are diagnostic and fix visits for existing boiler installations. Unlike installations which are single continuous jobs, repairs follow a multi-visit workflow where engineers diagnose issues, order parts if needed, and return to complete the repair.
Visit Types ​
| Visit Type | Description | Documentation |
|---|---|---|
inspection | Initial diagnostic visit | Inspection |
follow_up | Return visit after parts ordered | Follow Up |
remedial | Additional work after repair | Remedial |
Repair Job Types ​
job.jobType | Description | Documentation |
|---|---|---|
boiler_repair | Standard boiler repair | This section |
google_heat_link | Google Heat Link device repair | Heat Link |
Common Properties ​
| Property | Description |
|---|---|
jobType | Always 'Repair' |
visitType | 'inspection' | 'follow_up' | 'remedial' |
job.visits | Array of previous visit reports and photos |
partsStatus | Tracks parts ordering status across visits |
screeningHistory | Customer answers from booking (fault codes, symptoms) |
Typical Workflow ​
- Inspection - Engineer diagnoses the issue and determines outcome
- Parts ordered - If repair needed, parts are ordered via supplier or engineer stock
- Follow-up scheduled - Return date set based on parts availability
- Follow-up visit - Same engineer returns to complete the repair
- Remedial (if needed) - Additional visit for further work
Submission ​
All repair visit types submit via the same endpoint:
PUT /engineers/repair/boiler/{jobId}/event
Body: {event: 'done'}Job transitions to ready_for_audit state on success.