Callout Follow Up Visit
A follow-up visit is the return visit to complete a repair after parts have been ordered or when additional work was scheduled during the inspection. The engineer has access to the previous inspection report and photos.
Definition
| Property | Description |
|---|---|
jobType | 'Callout' |
visitType | 'follow_up' |
Job Properties
| Property | Description |
|---|---|
partsStatus | 'ordered' | 'ordered_manually' | 'engineer_supplied' - set during inspection |
repairOutcome | Outcome from inspection visit (typically 'repair_required') |
job.visits | Array containing the previous inspection visit report and photos |
Checklist Steps
1. Repair Report
| Outcome | Description |
|---|---|
issue_fixed | Repair completed successfully |
cannot_fix | Unable to complete the repair |
2. Parts & Materials (issue_fixed only)
| Parts Source | Description |
|---|---|
supplier | Parts came from supplier order |
engineer | Engineer-supplied parts |
not_applicable | No parts were required |
3. CP1 Form (Conditional)
Required if boiler/gas work was performed. See CP1 Documentation.
4. Repair Photos
| Outcome | Parts Source | Has Receipt | Required Photos |
|---|---|---|---|
issue_fixed | supplier | - | Boiler, Data plate, Repair work or parts fitted |
issue_fixed | engineer | Yes | Boiler, Data plate, Repair work or parts fitted, Receipt |
issue_fixed | engineer | No | Boiler, Data plate, Parts before fitted, Repair work |
issue_fixed | not_applicable | - | Boiler, Data plate, Repair work or parts fitted |
cannot_fix | - | - | All optional: Boiler, Data plate, Defect or defective part |
Parts Reimbursement
When partsSource === 'engineer':
| Has Receipt | Reimbursement |
|---|---|
| Yes | Full cost reimbursed (receipt photo required) |
| No | Percentage of parts cost (parts photo required) |
Submission
| Endpoint | Method | Body |
|---|---|---|
/engineers/callouts/visits/{visitId}/report | POST | CalloutVisitOutcome |
/engineers/callouts/visits/{webApiId}/event | PUT | {event: 'done'} |
The report is sent when the engineer completes the repair report; the done event is what transitions the job to ready_for_audit. Both path params carry the same value — mapCalloutJob sets id and webApiId from the API visit id.
Related
| Visit Type | Description | Documentation |
|---|---|---|
inspection | Initial diagnostic visit | Inspection |
remedial | Additional work after follow-up | Remedial |