> ## Documentation Index
> Fetch the complete documentation index at: https://docs.connectivehealth.io/llms.txt
> Use this file to discover all available pages before exploring further.

# CarePlan

> The FHIR CarePlan resource as produced by Connective Health

[FHIR R4 CarePlan](https://www.hl7.org/fhir/R4/careplan.html) ·
[US Core CarePlan](https://hl7.org/fhir/us/core/STU9/StructureDefinition-us-core-careplan.html)

<Info>
  This resource carries the **assessment and plan of treatment** narrative in the
  [Patient Everything](/fhir/patient-everything-bundle) and [Patient Summary](/fhir/patient-summary-bundle) bundles.
  It is not produced for [Bulk Medication History](/fhir/bulk-medication-history-bundle).
</Info>

# Stable ID

The `id` is derived from the patient, the plan date, and the plan narrative text. Because the narrative is part of the
`id`, any edit to the plan text produces a new `CarePlan` rather than updating the existing one.

<Note>
  The encounter link described below is **not** part of the `id`, so the same plan carries the same `id` in both
  bundles.
</Note>

# Fields

| Field          | Cardinality | Notes                                                                                                                                                                                    |
| -------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `meta.profile` | 1..1        | Always set to the US Core CarePlan profile URL.                                                                                                                                          |
| `status`       | 1..1        | Currently, always `unknown`.                                                                                                                                                             |
| `intent`       | 1..1        | Always `plan`.                                                                                                                                                                           |
| `subject`      | 1..1        | Reference to the [Patient](/fhir/resources/patient).                                                                                                                                     |
| `category`     | 1..1        | Always `assess-plan` ("Assessment and Plan of Treatment") from the [US Core CarePlan Category](http://hl7.org/fhir/us/core/CodeSystem/careplan-category) system, as required by US Core. |
| `text.div`     | 1..1        | The plan narrative, HTML-escaped so the source text is rendered as literal text rather than interpreted as markup.                                                                       |
| `text.status`  | 1..1        | Always `additional` -- the narrative carries information beyond the structured fields, which is the whole point of this resource.                                                        |
| `author`       | 0..1        | Contained [PractitionerRole](/fhir/resources/practitioner-role) for the provider who recorded the plan. Omitted when no provider is known.                                               |
| `encounter`    | 0..1        | **Patient Summary only.** References the [Encounter](/fhir/resources/encounter) for the visit the plan was recorded at. Never set in the Patient Everything bundle.                      |

<Warning>
  `CarePlan` is a **narrative-only** resource here. `activity`, `goal`, `addresses`, `period`, and `careTeam` are not
  populated -- the entire clinical content is the `text.div` narrative. Consumers should not expect structured
  activities or goals.
</Warning>

# Care plan sourcing

| Bundle                                                | Where care plans come from                                                                                                                            |
| ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Patient Everything](/fhir/patient-everything-bundle) | All plans of care on the patient's record, independent of any visit.                                                                                  |
| [Patient Summary](/fhir/patient-summary-bundle)       | Only plans attached to a visit that was selected for the summary -- including plans on follow-up visits. Each is linked to its visit via `encounter`. |