Callout Inspection Visit ​
A callout inspection visit is the first visit in a callout job workflow. Engineers diagnose issues, determine the outcome, and either fix on-site or schedule follow-up work.
Definition ​
| Property | Description |
|---|---|
jobType | 'Callout' |
visitType | 'inspection' |
Job Properties ​
| Property | Description |
|---|---|
partsStatus | 'engineer_supplied' | 'order_required' | 'ordered' | 'ordered_manually' | 'not_required' |
calloutType | 'SubscriptionVisit' | 'InstallationVisit' |
visits | Array of previous visit reports with photos and outcomes |
Checklist Steps ​
1. Inspection Report ​
Select an outcome and complete the relevant screens per the flow above.
| Outcome | Description |
|---|---|
issue_fixed | Problem resolved during inspection visit |
repair_required | Further repair work needed, schedule follow-up |
replacement_required | Component beyond economical repair (BER) |
cannot_diagnose | Unable to determine the fault |
2. Defect Type (repair_required only) ​
| Defect Type | Description |
|---|---|
boiler_issue | Problem with the boiler itself |
controls_issue | Problem with controls/thermostat |
wider_system_issue | Problem with the wider heating system |
3. Repair Category (repair_required only) ​
Fetched from API based on defect type. Used to categorize the repair work needed.
4. Parts & Materials ​
| Parts Source | Description |
|---|---|
supplier | Parts ordered from supplier |
engineer | Engineer-supplied parts |
not_applicable | No parts required |
5. CP1 Form (Conditional) ​
Required if boiler/gas work was performed. See CP1 Documentation.
6. Inspection Photos ​
| Outcome | Required Photos |
|---|---|
issue_fixed | Boiler, Data plate, Repair work, Parts used (optional) |
repair_required | Boiler, Data plate, Defect, Parts order confirmation* |
replacement_required | Boiler, Data plate, Defect |
cannot_diagnose | All optional: Boiler, Data plate, Defect |
* Parts order confirmation only required if partsSource === 'supplier'.
Submission ​
| Endpoint | Method | Body |
|---|---|---|
/engineers/callouts/visits/{visitId}/report | POST | CalloutVisitOutcome |
Job transitions to ready_for_audit state on success.
Related ​
| Visit Type | Description | Documentation |
|---|---|---|
follow_up | Return visit to complete repair after parts ordered | Follow Up |
remedial | Additional work required after initial repair | Remedial |