Extensions for Using Data Elements from FHIR STU3 in FHIR R4
0.1.0 - STU
Extensions for Using Data Elements from FHIR STU3 in FHIR R4
0.1.0 - STU
Extensions for Using Data Elements from FHIR STU3 in FHIR R4 - Downloaded Version null See the Directory of published versions
| Official URL: http://hl7.org/fhir/uv/xver/ConceptMap/R3-CarePlan-element-map-to-R4 | Version: 0.1.0 | |||
| Standards status: Trial-use | Maturity Level: 0 | Computable Name: R3CarePlanElementMapToR4 | ||
This ConceptMap represents cross-version mappings for elements from a FHIR STU3 CarePlan to FHIR R4.
Mapping from http://hl7.org/fhir/3.0 to http://hl7.org/fhir/4.0
Group 1 Mapping from http://hl7.org/fhir/StructureDefinition/CarePlan|3.0.2 to CarePlanversion: 4.0.1)
| Source Concept Details | Relationship | Target Concept Details | Comment | ||
| Codes from http://hl7.org/fhir/StructureDefinition/CarePlan|3.0.2 | Codes from CarePlan | ||||
| CarePlan.meta | meta | is equivalent to | CarePlan.meta | CarePlan.meta | Element `CarePlan.meta` is mapped to FHIR R4 element `CarePlan.meta` as `Equivalent`. |
| CarePlan.implicitRules | implicitRules | is equivalent to | CarePlan.implicitRules | CarePlan.implicitRules | Element `CarePlan.implicitRules` is mapped to FHIR R4 element `CarePlan.implicitRules` as `Equivalent`. Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element. This element is labelled as a modifier because the implicit rules may provide additional knowledge about the resource that modifies it's meaning or interpretation. |
| CarePlan.language | language | is equivalent to | CarePlan.language | CarePlan.language | Element `CarePlan.language` is mapped to FHIR R4 element `CarePlan.language` as `Equivalent`. Language is provided to support indexing and accessibility (typically, services such as text to speech use the language tag). The html language tag in the narrative applies to the narrative. The language tag on the resource may be used to specify the language of other presentations generated from the data in the resource Not all the content has to be in the base language. The Resource.language should not be assumed to apply to the narrative automatically. If a language is specified, it should it also be specified on the div element in the html (see rules in HTML5 for information about the relationship between xml:lang and the html lang attribute). |
| CarePlan.text | text | is equivalent to | CarePlan.text | CarePlan.text | Element `CarePlan.text` is mapped to FHIR R4 element `CarePlan.text` as `Equivalent`. Contained resources do not have narrative. Resources that are not contained SHOULD have a narrative. In some cases, a resource may only have text with little or no additional discrete data (as long as all minOccurs=1 elements are satisfied). This may be necessary for data from legacy systems where information is captured as a "text blob" or where text is additionally entered raw or narrated and encoded in formation is added later. |
| CarePlan.contained | contained | is equivalent to | CarePlan.contained | CarePlan.contained | Element `CarePlan.contained` is mapped to FHIR R4 element `CarePlan.contained` as `Equivalent`. This should never be done when the content can be identified properly, as once identification is lost, it is extremely difficult (and context dependent) to restore it again. |
| CarePlan.identifier | identifier | is equivalent to | CarePlan.identifier | CarePlan.identifier | Element `CarePlan.identifier` is mapped to FHIR R4 element `CarePlan.identifier` as `Equivalent`. |
| CarePlan.basedOn | basedOn | is equivalent to | CarePlan.basedOn | CarePlan.basedOn | Element `CarePlan.basedOn` is mapped to FHIR R4 element `CarePlan.basedOn` as `Equivalent`. |
| CarePlan.replaces | replaces | is equivalent to | CarePlan.replaces | CarePlan.replaces | Element `CarePlan.replaces` is mapped to FHIR R4 element `CarePlan.replaces` as `Equivalent`. The replacement could be because the initial care plan was immediately rejected (due to an issue) or because the previous care plan was completed, but the need for the action described by the care plan remains ongoing. |
| CarePlan.partOf | partOf | is equivalent to | CarePlan.partOf | CarePlan.partOf | Element `CarePlan.partOf` is mapped to FHIR R4 element `CarePlan.partOf` as `Equivalent`. Each care plan is an independent request, such that having a care plan be part of another care plan can cause issues with cascading statuses. As such, this element is still being discussed. |
| CarePlan.status | status | is equivalent to | CarePlan.status | CarePlan.status | Element `CarePlan.status` is mapped to FHIR R4 element `CarePlan.status` as `Equivalent`. The unknown code is not to be used to convey other statuses. The unknown code should be used when one of the statuses applies, but the authoring system doesn't know the current state of the care plan. This element is labeled as a modifier because the status contains the code entered-in-error] that marks the plan as not currently valid. |
| CarePlan.intent | intent | is equivalent to | CarePlan.intent | CarePlan.intent | Element `CarePlan.intent` is mapped to FHIR R4 element `CarePlan.intent` as `Equivalent`. This element is labeled as a modifier because the intent alters when and how the resource is actually applicable. |
| CarePlan.category | category | is equivalent to | CarePlan.category | CarePlan.category | Element `CarePlan.category` is mapped to FHIR R4 element `CarePlan.category` as `Equivalent`. There may be multiple axis of categorization and one plan may serve multiple purposes. In some cases, this may be redundant with references to CarePlan.concern. |
| CarePlan.title | title | is equivalent to | CarePlan.title | CarePlan.title | Element `CarePlan.title` is mapped to FHIR R4 element `CarePlan.title` as `Equivalent`. |
| CarePlan.description | description | is equivalent to | CarePlan.description | CarePlan.description | Element `CarePlan.description` is mapped to FHIR R4 element `CarePlan.description` as `Equivalent`. |
| CarePlan.subject | subject | is equivalent to | CarePlan.subject | CarePlan.subject | Element `CarePlan.subject` is mapped to FHIR R4 element `CarePlan.subject` as `Equivalent`. |
| CarePlan.context | context | maps to wider concept | CarePlan.encounter | CarePlan.encounter | Element `CarePlan.context` is mapped to FHIR R4 element `CarePlan.encounter` as `SourceIsBroaderThanTarget`. The mappings for `CarePlan.context` do not cover the following types based on type expansion: display, identifier, reference. The standard extension `alternate-reference` has been mapped as the representation of FHIR STU3 element `CarePlan.context` with unmapped reference targets: EpisodeOfCare. Activities conducted as a result of the care plan may well occur as part of other encounters/episodes. |
| CarePlan.period | period | is equivalent to | CarePlan.period | CarePlan.period | Element `CarePlan.period` is mapped to FHIR R4 element `CarePlan.period` as `Equivalent`. Any activities scheduled as part of the plan should be constrained to the specified period regardless of whether the activities are planned within a single encounter/episode or across multiple encounters/episodes (e.g. the longitudinal management of a chronic condition). |
| CarePlan.author | author | is equivalent to | CarePlan.author | CarePlan.author | Element `CarePlan.author` is mapped to FHIR R4 element `CarePlan.author` as `SourceIsBroaderThanTarget`. Collaborative care plans may have multiple authors. |
| CarePlan.careTeam | careTeam | is equivalent to | CarePlan.careTeam | CarePlan.careTeam | Element `CarePlan.careTeam` is mapped to FHIR R4 element `CarePlan.careTeam` as `Equivalent`. |
| CarePlan.addresses | addresses | is equivalent to | CarePlan.addresses | CarePlan.addresses | Element `CarePlan.addresses` is mapped to FHIR R4 element `CarePlan.addresses` as `Equivalent`. |
| CarePlan.supportingInfo | supportingInfo | is equivalent to | CarePlan.supportingInfo | CarePlan.supportingInfo | Element `CarePlan.supportingInfo` is mapped to FHIR R4 element `CarePlan.supportingInfo` as `Equivalent`. Use "concern" to identify specific conditions addressed by the care plan. |
| CarePlan.goal | goal | is equivalent to | CarePlan.goal | CarePlan.goal | Element `CarePlan.goal` is mapped to FHIR R4 element `CarePlan.goal` as `Equivalent`. Goal can be achieving a particular change or merely maintaining a current state or even slowing a decline. |
| CarePlan.activity | activity | maps to wider concept | CarePlan.activity | CarePlan.activity | Element `CarePlan.activity` is mapped to FHIR R4 element `CarePlan.activity` as `Equivalent`. |
| CarePlan.activity.outcomeCodeableConcept | outcomeCodeableConcept | is equivalent to | CarePlan.activity.outcomeCodeableConcept | CarePlan.activity.outcomeCodeableConcept | Element `CarePlan.activity.outcomeCodeableConcept` is mapped to FHIR R4 element `CarePlan.activity.outcomeCodeableConcept` as `Equivalent`. Note that this should not duplicate the activity status (e.g. completed or in progress). |
| CarePlan.activity.outcomeReference | outcomeReference | is equivalent to | CarePlan.activity.outcomeReference | CarePlan.activity.outcomeReference | Element `CarePlan.activity.outcomeReference` is mapped to FHIR R4 element `CarePlan.activity.outcomeReference` as `Equivalent`. The activity outcome is independent of the outcome of the related goal(s). For example, if the goal is to achieve a target body weight of 150 lb and an activity is defined to diet, then the activity outcome could be calories consumed whereas the goal outcome is an observation for the actual body weight measured. |
| CarePlan.activity.progress | progress | is equivalent to | CarePlan.activity.progress | CarePlan.activity.progress | Element `CarePlan.activity.progress` is mapped to FHIR R4 element `CarePlan.activity.progress` as `Equivalent`. This element should NOT be used to describe the activity to be performed - that occurs either within the resource pointed to by activity.detail.reference or in activity.detail.description. |
| CarePlan.activity.reference | reference | is equivalent to | CarePlan.activity.reference | CarePlan.activity.reference | Element `CarePlan.activity.reference` is mapped to FHIR R4 element `CarePlan.activity.reference` as `SourceIsNarrowerThanTarget`. Standard extension exists ([goal-pertainstogoal](https://hl7.org/fhir/extension-goal-pertainstogoal.html)) that allows goals to be referenced from any of the referenced resources in CarePlan.activity.reference. The goal should be visible when the resource referenced by CarePlan.activity.reference is viewed indepedently from the CarePlan. Requests that are pointed to by a CarePlan using this element should *not* point to this CarePlan using the "basedOn" element. i.e. Requests that are part of a CarePlan are not "based on" the CarePlan. |
| CarePlan.activity.detail | detail | maps to wider concept | CarePlan.activity.detail | CarePlan.activity.detail | Element `CarePlan.activity.detail` is mapped to FHIR R4 element `CarePlan.activity.detail` as `Equivalent`. |
| CarePlan.activity.detail.category | category | is equivalent to | CarePlan.activity.detail | CarePlan.activity.detail | Element `CarePlan.activity.detail.category` is mapped to FHIR R4 element `CarePlan.activity.detail` as `Equivalent`. Element `CarePlan.activity.detail.category` is mapped to FHIR R4 element `CarePlan.activity.detail.kind` as `SourceIsBroaderThanTarget`. |
| is related to | CarePlan.activity.detail.kind | CarePlan.activity.detail.kind | Element `CarePlan.activity.detail.category` is mapped to FHIR R4 element `CarePlan.activity.detail` as `Equivalent`. Element `CarePlan.activity.detail.category` is mapped to FHIR R4 element `CarePlan.activity.detail.kind` as `SourceIsBroaderThanTarget`. | ||
| CarePlan.activity.detail.code | code | is equivalent to | CarePlan.activity.detail.code | CarePlan.activity.detail.code | Element `CarePlan.activity.detail.code` is mapped to FHIR R4 element `CarePlan.activity.detail.code` as `Equivalent`. Tends to be less relevant for activities involving particular products. Codes should not convey negation - use "prohibited" instead. |
| CarePlan.activity.detail.reasonCode | reasonCode | is equivalent to | CarePlan.activity.detail.reasonCode | CarePlan.activity.detail.reasonCode | Element `CarePlan.activity.detail.reasonCode` is mapped to FHIR R4 element `CarePlan.activity.detail.reasonCode` as `Equivalent`. This could be a diagnosis code. If a full condition record exists or additional detail is needed, use reasonCondition instead. |
| CarePlan.activity.detail.reasonReference | reasonReference | is equivalent to | CarePlan.activity.detail.reasonReference | CarePlan.activity.detail.reasonReference | Element `CarePlan.activity.detail.reasonReference` is mapped to FHIR R4 element `CarePlan.activity.detail.reasonReference` as `Equivalent`. Conditions can be identified at the activity level that are not identified as reasons for the overall plan. |
| CarePlan.activity.detail.goal | goal | is equivalent to | CarePlan.activity.detail.goal | CarePlan.activity.detail.goal | Element `CarePlan.activity.detail.goal` is mapped to FHIR R4 element `CarePlan.activity.detail.goal` as `Equivalent`. |
| CarePlan.activity.detail.status | status | maps to wider concept | CarePlan.activity.detail.status | CarePlan.activity.detail.status | Element `CarePlan.activity.detail.status` is mapped to FHIR R4 element `CarePlan.activity.detail.status` as `RelatedTo`. The mappings for `CarePlan.activity.detail.status` do not allow expression of the necessary codes, per the bindings on the source and target. The target context `CarePlan.activity.detail.status` is a modifier element, so this extension does not need to be defined as a modifier. Some aspects of status can be inferred based on the resources linked in actionTaken. Note that "status" is only as current as the plan was most recently updated. The unknown code is not to be used to convey other statuses. The unknown code should be used when one of the statuses applies, but the authoring system doesn't know the current state of the activity. |
| CarePlan.activity.detail.statusReason | statusReason | maps to wider concept | CarePlan.activity.detail.statusReason | CarePlan.activity.detail.statusReason | Element `CarePlan.activity.detail.statusReason` is mapped to FHIR R4 element `CarePlan.activity.detail.statusReason` as `SourceIsBroaderThanTarget`. The mappings for `CarePlan.activity.detail.statusReason` do not cover the following types: string. The mappings for `CarePlan.activity.detail.statusReason` do not cover the following types based on type expansion: value. Will generally not be present if status is "complete". Be sure to prompt to update this (or at least remove the existing value) if the status is changed. |
| CarePlan.activity.detail.prohibited | prohibited | is equivalent to | CarePlan.activity.detail.doNotPerform | CarePlan.activity.detail.doNotPerform | Element `CarePlan.activity.detail.prohibited` is mapped to FHIR R4 element `CarePlan.activity.detail.doNotPerform` as `Equivalent`. This element is labeled as a modifier because it marks an activity as an activity that is not to be performed. |
| CarePlan.activity.detail.scheduled[x] | scheduled[x] | is equivalent to | CarePlan.activity.detail.scheduled[x] | CarePlan.activity.detail.scheduled[x] | Element `CarePlan.activity.detail.scheduled[x]` is mapped to FHIR R4 element `CarePlan.activity.detail.scheduled[x]` as `Equivalent`. The target context `CarePlan.activity.detail.scheduled[x]` is a choice-type element and cannot directly hold extensions. The context is moved up to parent element `CarePlan.activity.detail`. |
| CarePlan.activity.detail.location | location | is equivalent to | CarePlan.activity.detail.location | CarePlan.activity.detail.location | Element `CarePlan.activity.detail.location` is mapped to FHIR R4 element `CarePlan.activity.detail.location` as `Equivalent`. May reference a specific clinical location or may identify a type of location. |
| CarePlan.activity.detail.performer | performer | is equivalent to | CarePlan.activity.detail.performer | CarePlan.activity.detail.performer | Element `CarePlan.activity.detail.performer` is mapped to FHIR R4 element `CarePlan.activity.detail.performer` as `Equivalent`. A performer MAY also be a participant in the care plan. |
| CarePlan.activity.detail.product[x] | product[x] | is equivalent to | CarePlan.activity.detail.product[x] | CarePlan.activity.detail.product[x] | Element `CarePlan.activity.detail.product[x]` is mapped to FHIR R4 element `CarePlan.activity.detail.product[x]` as `Equivalent`. The target context `CarePlan.activity.detail.product[x]` is a choice-type element and cannot directly hold extensions. The context is moved up to parent element `CarePlan.activity.detail`. |
| CarePlan.activity.detail.dailyAmount | dailyAmount | is equivalent to | CarePlan.activity.detail.dailyAmount | CarePlan.activity.detail.dailyAmount | Element `CarePlan.activity.detail.dailyAmount` is mapped to FHIR R4 element `CarePlan.activity.detail.dailyAmount` as `Equivalent`. |
| CarePlan.activity.detail.quantity | quantity | is equivalent to | CarePlan.activity.detail.quantity | CarePlan.activity.detail.quantity | Element `CarePlan.activity.detail.quantity` is mapped to FHIR R4 element `CarePlan.activity.detail.quantity` as `Equivalent`. |
| CarePlan.activity.detail.description | description | is equivalent to | CarePlan.activity.detail.description | CarePlan.activity.detail.description | Element `CarePlan.activity.detail.description` is mapped to FHIR R4 element `CarePlan.activity.detail.description` as `Equivalent`. |
| CarePlan.note | note | is equivalent to | CarePlan.note | CarePlan.note | Element `CarePlan.note` is mapped to FHIR R4 element `CarePlan.note` as `Equivalent`. |
Group 2 Mapping from http://hl7.org/fhir/StructureDefinition/CarePlan|3.0.2 to STU3: Protocol or definition (new)version: 0.1.0)
| Source Code | Relationship | Target Code | Comment |
| CarePlan.definition (definition) | is equivalent to | Extension (STU3: Protocol or definition (new)) | Element `CarePlan.definition` has a context of CarePlan based on following the parent source element upwards and mapping to `CarePlan`. Element `CarePlan.definition` has no mapping targets in FHIR R4. Typically, this is because the element has been added (is a new element). |
Group 3 Mapping from http://hl7.org/fhir/StructureDefinition/CarePlan|3.0.2 to STU3: Protocol or definition (new)version: 0.1.0)
| Source Code | Relationship | Target Code | Comment |
| CarePlan.activity.detail.definition (definition) | is equivalent to | Extension (STU3: Protocol or definition (new)) | Element `CarePlan.activity.detail.definition` has a context of CarePlan.activity.detail based on following the parent source element upwards and mapping to `CarePlan`. Element `CarePlan.activity.detail.definition` has no mapping targets in FHIR R4. Typically, this is because the element has been added (is a new element). |
Group 4 Mapping from http://hl7.org/fhir/StructureDefinition/CarePlan|3.0.2 to STU3: not-started | scheduled | in-progress | on-hold | completed | cancelled | unknown additional codesversion: 0.1.0)
| Source Code | Relationship | Target Code | Comment |
| CarePlan.activity.detail.status (status) | is equivalent to | Extension (STU3: not-started | scheduled | in-progress | on-hold | completed | cancelled | unknown additional codes) | Element `CarePlan.activity.detail.status` is mapped to FHIR R4 element `CarePlan.activity.detail.status` as `RelatedTo`. The mappings for `CarePlan.activity.detail.status` do not allow expression of the necessary codes, per the bindings on the source and target. The target context `CarePlan.activity.detail.status` is a modifier element, so this extension does not need to be defined as a modifier. Some aspects of status can be inferred based on the resources linked in actionTaken. Note that "status" is only as current as the plan was most recently updated. The unknown code is not to be used to convey other statuses. The unknown code should be used when one of the statuses applies, but the authoring system doesn't know the current state of the activity. |
Group 5 Mapping from http://hl7.org/fhir/StructureDefinition/CarePlan|3.0.2 to STU3: statusReason additional typesversion: 0.1.0)
| Source Code | Relationship | Target Code | Comment |
| CarePlan.activity.detail.statusReason (statusReason) | is equivalent to | Extension (STU3: statusReason additional types) | Element `CarePlan.activity.detail.statusReason` is mapped to FHIR R4 element `CarePlan.activity.detail.statusReason` as `SourceIsBroaderThanTarget`. The mappings for `CarePlan.activity.detail.statusReason` do not cover the following types: string. The mappings for `CarePlan.activity.detail.statusReason` do not cover the following types based on type expansion: value. Will generally not be present if status is "complete". Be sure to prompt to update this (or at least remove the existing value) if the status is changed. |
IG © 2025+ FHIR Infrastructure. Package hl7.fhir.uv.xver-r3.r4#0.1.0 based on FHIR 4.0.1. Generated 2026-03-20
Links: Table of Contents |
QA Report
| Version History |
|
Propose a change