> For the complete documentation index, see [llms.txt](https://learn.withessential.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.withessential.com/field-operations/deficiencies/working-a-deficiency-task.md).

# Working a deficiency task

A Deficiencies task is where your office acts on the problems a technician flagged. Open the task to see each deficiency's customer-facing **Report Description**, **Internal Description**, additional deficiency-field answers, and attached photos or files. The original Pass, Fail, Yes, or No compliance answer is not repeated. Deficiencies created from report items with advanced tracking carry an Open or Resolved pill; resolved ones show the resolution date and how they resolved—**(report resubmitted)**, **(passed retest)**, or **(marked manually)**—plus the last retest date when there is one. Resolved tracked items collect in their own Resolved section. Standard findings remain in the main list without a status pill.

The Overview block ties the task to the property, visit, technician, visit type, and invoice items. From the source inspection report shown on the task, use **View Report** or, with the right permission, **Edit Report**. Use **Download All Reports** to download all report files at once. To email the report PDF directly, open the submitted report and use **Send Report**, or use **Send Report** in its Job task's Inspection Reports section. To share a broader recap link instead, use **Send Job Summary** from the report or the Job task's Quick Actions. These sharing methods are enabled separately; see [Download or email an inspection report](/field-operations/inspection-reports/download-or-email-an-inspection-report.md).

If Edit Report or a follow-up Quick Action is missing but you need it for your work, contact your business's administrator to review your role.

Quick Actions give you the two most common follow-ups. Create Quote starts a new quote pre-linked to this deficiency task, so you can turn the findings into a priced proposal to fix them. Create Job / Visit schedules the repair work.

When the property has other deficiency tasks still open—or this task's findings are all resolved—Create Quote first shows a picker so you can choose which tasks to include. A resolved source task is marked **Not Included**.

Creating the quote uses the selected tasks as source context, links their jobs, and can attach their inspection-report PDFs when report auto-attach is on for your business. It does not prefill line items. **Generate draft** creates the proposed line items afterward. Asset-backed findings are grouped by the report's asset-group type, with reports of the same type sharing a group; report-level findings without an asset may remain ungrouped. A configured task automation can update the selected tasks after quote creation.

Use **Mark Resolved** on a tracked deficiency when the fix happened outside a report, and **Reopen** to undo that manual resolution. These controls live on the task and do not require inspection-report edit access. Standard findings do not show resolution controls; correct the source report and resubmit it to remove the finding. You can also set the task's status and keep an internal notes field on the task itself (separate from the per-deficiency notes), then Save. If the report is later resubmitted with the issues fixed, or a later inspection passes the same tracked item, tracked deficiencies resolve on their own, so you're not chasing problems that are already fixed.

> **Where to find it:** Open a Deficiencies task from Tasks. The detail view shows each deficiency, the source inspection report, and Quick Actions including Create Quote.

## Related guides

* [How tracked deficiencies resolve](/field-operations/deficiencies/deficiencies-clear-when-the-inspection-report-is-resubmitted-without-them.md)
* [What is a deficiency?](/field-operations/deficiencies/what-is-a-deficiency.md)
* [Download or email an inspection report](/field-operations/inspection-reports/download-or-email-an-inspection-report.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://learn.withessential.com/field-operations/deficiencies/working-a-deficiency-task.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
