FHIR IG analytics

Resources that use this resource

No resources found

Resources that this resource uses

No resources found

Narrative

Note: links and images are rebased to the (stated) source

Source1

{
  "resourceType": "ConceptMap",
  "id": "R3-AllergyIntolerance-element-map-to-R4",
  "text": {
    "status": "generated",
    "div": "<!-- snip (see above) -->"
  },
  "extension": [
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
      "valueCode": "fhir"
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
      "valueInteger": 0,
      "_valueInteger": {
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
            "valueCanonical": "http://hl7.org/fhir/uv/xver/ImplementationGuide/hl7.fhir.uv.xver-r3.r4"
          }
        ]
      }
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
      "valueCode": "trial-use",
      "_valueCode": {
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
            "valueCanonical": "http://hl7.org/fhir/uv/xver/ImplementationGuide/hl7.fhir.uv.xver-r3.r4"
          }
        ]
      }
    }
  ],
  "url": "http://hl7.org/fhir/uv/xver/ConceptMap/R3-AllergyIntolerance-element-map-to-R4",
  "version": "0.1.0",
  "name": "R3AllergyIntoleranceElementMapToR4",
  "title": "Cross-version mapping for FHIR STU3 AllergyIntolerance to FHIR R4 AllergyIntolerance",
  "status": "active",
  "experimental": false,
  "date": "2026-03-17T16:03:23.1508829-05:00",
  "contact": [
    {
      "name": "FHIR Infrastructure",
      "telecom": [
        {
          "system": "url",
          "value": "http://www.hl7.org/Special/committees/fiwg"
        }
      ]
    }
  ],
  "description": "This ConceptMap represents cross-version mappings for elements from a FHIR STU3 AllergyIntolerance to FHIR R4.",
  "jurisdiction": [
    {
      "coding": [
        {
          "system": "http://unstats.un.org/unsd/methods/m49/m49.htm",
          "code": "001",
          "display": "World"
        }
      ]
    }
  ],
  "sourceCanonical": "http://hl7.org/fhir/3.0",
  "targetUri": "http://hl7.org/fhir/4.0",
  "group": [
    {
      "source": "http://hl7.org/fhir/StructureDefinition/AllergyIntolerance",
      "sourceVersion": "3.0.2",
      "target": "http://hl7.org/fhir/StructureDefinition/AllergyIntolerance",
      "targetVersion": "4.0.1",
      "element": [
        {
          "code": "AllergyIntolerance.meta",
          "display": "meta",
          "target": [
            {
              "code": "AllergyIntolerance.meta",
              "display": "AllergyIntolerance.meta",
              "equivalence": "equivalent",
              "comment": "Element `AllergyIntolerance.meta` is mapped to FHIR R4 element `AllergyIntolerance.meta` as `Equivalent`."
            }
          ]
        },
        {
          "code": "AllergyIntolerance.implicitRules",
          "display": "implicitRules",
          "target": [
            {
              "code": "AllergyIntolerance.implicitRules",
              "display": "AllergyIntolerance.implicitRules",
              "equivalence": "equivalent",
              "comment": "Element `AllergyIntolerance.implicitRules` is mapped to FHIR R4 element `AllergyIntolerance.implicitRules` as `Equivalent`.\nAsserting 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. \n\nThis element is labelled as a modifier because the implicit rules may provide additional knowledge about the resource that modifies it's meaning or interpretation."
            }
          ]
        },
        {
          "code": "AllergyIntolerance.language",
          "display": "language",
          "target": [
            {
              "code": "AllergyIntolerance.language",
              "display": "AllergyIntolerance.language",
              "equivalence": "equivalent",
              "comment": "Element `AllergyIntolerance.language` is mapped to FHIR R4 element `AllergyIntolerance.language` as `Equivalent`.\nLanguage 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)."
            }
          ]
        },
        {
          "code": "AllergyIntolerance.text",
          "display": "text",
          "target": [
            {
              "code": "AllergyIntolerance.text",
              "display": "AllergyIntolerance.text",
              "equivalence": "equivalent",
              "comment": "Element `AllergyIntolerance.text` is mapped to FHIR R4 element `AllergyIntolerance.text` as `Equivalent`.\nContained 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."
            }
          ]
        },
        {
          "code": "AllergyIntolerance.contained",
          "display": "contained",
          "target": [
            {
              "code": "AllergyIntolerance.contained",
              "display": "AllergyIntolerance.contained",
              "equivalence": "equivalent",
              "comment": "Element `AllergyIntolerance.contained` is mapped to FHIR R4 element `AllergyIntolerance.contained` as `Equivalent`.\nThis 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."
            }
          ]
        },
        {
          "code": "AllergyIntolerance.identifier",
          "display": "identifier",
          "target": [
            {
              "code": "AllergyIntolerance.identifier",
              "display": "AllergyIntolerance.identifier",
              "equivalence": "equivalent",
              "comment": "Element `AllergyIntolerance.identifier` is mapped to FHIR R4 element `AllergyIntolerance.identifier` as `Equivalent`."
            }
          ]
        },
        {
          "code": "AllergyIntolerance.clinicalStatus",
          "display": "clinicalStatus",
          "target": [
            {
              "code": "AllergyIntolerance.clinicalStatus",
              "display": "AllergyIntolerance.clinicalStatus",
              "equivalence": "equivalent",
              "comment": "Element `AllergyIntolerance.clinicalStatus` is mapped to FHIR R4 element `AllergyIntolerance.clinicalStatus` as `SourceIsNarrowerThanTarget`.\nThis element is labeled as a modifier because the status contains the codes inactive and resolved that mark the AllergyIntolerance as not currently valid."
            }
          ]
        },
        {
          "code": "AllergyIntolerance.verificationStatus",
          "display": "verificationStatus",
          "target": [
            {
              "code": "AllergyIntolerance.verificationStatus",
              "display": "AllergyIntolerance.verificationStatus",
              "equivalence": "equivalent",
              "comment": "Element `AllergyIntolerance.verificationStatus` is mapped to FHIR R4 element `AllergyIntolerance.verificationStatus` as `SourceIsNarrowerThanTarget`.\nThis element is labeled as a modifier because the status contains the codes refuted and entered-in-error that mark the AllergyIntolerance as not currently valid."
            }
          ]
        },
        {
          "code": "AllergyIntolerance.type",
          "display": "type",
          "target": [
            {
              "code": "AllergyIntolerance.type",
              "display": "AllergyIntolerance.type",
              "equivalence": "equivalent",
              "comment": "Element `AllergyIntolerance.type` is mapped to FHIR R4 element `AllergyIntolerance.type` as `Equivalent`.\nAllergic (typically immune-mediated) reactions have been traditionally regarded as an indicator for potential escalation to significant future risk. Contemporary knowledge suggests that some reactions previously thought to be immune-mediated are, in fact, non-immune, but in some cases can still pose a life threatening risk. It is acknowledged that many clinicians may not be in a position to distinguish the mechanism of a particular reaction. Often the term \"allergy\" is used rather generically and may overlap with the use of \"intolerance\" - in practice the boundaries between these two concepts may not be well-defined or understood. This data element is included nevertheless, because many legacy systems have captured this attribute. Immunologic testing may provide supporting evidence for the basis of the reaction and the causative substance, but no tests are 100% sensitive or specific for sensitivity to a particular substance. If, as is commonly the case, it is unclear whether the reaction is due to an allergy or an intolerance, then the type element should be omitted from the resource."
            }
          ]
        },
        {
          "code": "AllergyIntolerance.category",
          "display": "category",
          "target": [
            {
              "code": "AllergyIntolerance.category",
              "display": "AllergyIntolerance.category",
              "equivalence": "equivalent",
              "comment": "Element `AllergyIntolerance.category` is mapped to FHIR R4 element `AllergyIntolerance.category` as `Equivalent`.\nThis data element has been included because it is currently being captured in some clinical systems. This data can be derived from the substance where coding systems are used, and is effectively redundant in that situation.  When searching on category, consider the implications of AllergyIntolerance resources without a category.  For example, when searching on category = medication, medication allergies that don't have a category valued will not be returned.  Refer to [search](https://hl7.org/fhir/search.html) for more information on how to search category with a :missing modifier to get allergies that don't have a category.  Additionally, category should be used with caution because category can be subjective based on the sender."
            }
          ]
        },
        {
          "code": "AllergyIntolerance.criticality",
          "display": "criticality",
          "target": [
            {
              "code": "AllergyIntolerance.criticality",
              "display": "AllergyIntolerance.criticality",
              "equivalence": "equivalent",
              "comment": "Element `AllergyIntolerance.criticality` is mapped to FHIR R4 element `AllergyIntolerance.criticality` as `Equivalent`.\nThe default criticality value for any propensity to an adverse reaction should be 'Low Risk', indicating at the very least a relative contraindication to deliberate or voluntary exposure to the substance. 'High Risk' is flagged if the clinician has identified a propensity for a more serious or potentially life-threatening reaction, such as anaphylaxis, and implies an absolute contraindication to deliberate or voluntary exposure to the substance. If this element is missing, the criticality is unknown (though it may be known elsewhere).\n\nSystems that capture a severity at the condition level are actually representing the concept of criticality whereas the severity documented at the reaction level is representing the true reaction severity.  Existing systems that are capturing both condition criticality and reaction severity may use the term \"severity\" to represent both.  Criticality is the worst it could be in the future (i.e. situation-agnostic) whereas severity is situation-dependent."
            }
          ]
        },
        {
          "code": "AllergyIntolerance.code",
          "display": "code",
          "target": [
            {
              "code": "AllergyIntolerance.code",
              "display": "AllergyIntolerance.code",
              "equivalence": "equivalent",
              "comment": "Element `AllergyIntolerance.code` is mapped to FHIR R4 element `AllergyIntolerance.code` as `Equivalent`.\nIt is strongly recommended that this element be populated using a terminology, where possible. For example, some terminologies used include RxNorm, SNOMED CT, DM+D, NDFRT, ICD-9, IDC-10, UNI, ATC and CPT. Plain text should only be used if there is no appropriate terminology available. Additional details can be specified in the text.\r\rWhen a substance or product code is specified for the 'code' element, the \"default\" semantic context is that this is a positive statement of an allergy or intolerance (depending on the value of the 'type' element, if present) condition to the specified substance/product.  In the corresponding SNOMED CT allergy model, the specified substance/product is the target (destination) of the \"Causative agent\" relationship.\r\rThe 'substanceExposureRisk' extension is available as a structured and more flexible alternative to the 'code' element for making positive or negative allergy or intolerance statements.  This extension provides the capability to make \"no known allergy\" (or \"no risk of adverse reaction\") statements regarding any coded substance/product (including cases when a pre-coordinated \"no allergy to x\" concept for that substance/product does not exist).  If the 'substanceExposureRisk' extension is present, the AllergyIntolerance.code element SHALL be omitted."
            }
          ]
        },
        {
          "code": "AllergyIntolerance.patient",
          "display": "patient",
          "target": [
            {
              "code": "AllergyIntolerance.patient",
              "display": "AllergyIntolerance.patient",
              "equivalence": "equivalent",
              "comment": "Element `AllergyIntolerance.patient` is mapped to FHIR R4 element `AllergyIntolerance.patient` as `Equivalent`."
            }
          ]
        },
        {
          "code": "AllergyIntolerance.onset[x]",
          "display": "onset[x]",
          "target": [
            {
              "code": "AllergyIntolerance.onset[x]",
              "display": "AllergyIntolerance.onset[x]",
              "equivalence": "equivalent",
              "comment": "Element `AllergyIntolerance.onset[x]` is mapped to FHIR R4 element `AllergyIntolerance.onset[x]` as `Equivalent`.\nThe target context `AllergyIntolerance.onset[x]` is a choice-type element and cannot directly hold extensions. The context is moved up to parent element `AllergyIntolerance`."
            }
          ]
        },
        {
          "code": "AllergyIntolerance.assertedDate",
          "display": "assertedDate",
          "target": [
            {
              "code": "AllergyIntolerance.recordedDate",
              "display": "AllergyIntolerance.recordedDate",
              "equivalence": "equivalent",
              "comment": "Element `AllergyIntolerance.assertedDate` is mapped to FHIR R4 element `AllergyIntolerance.recordedDate` as `Equivalent`."
            }
          ]
        },
        {
          "code": "AllergyIntolerance.recorder",
          "display": "recorder",
          "target": [
            {
              "code": "AllergyIntolerance.recorder",
              "display": "AllergyIntolerance.recorder",
              "equivalence": "equivalent",
              "comment": "Element `AllergyIntolerance.recorder` is mapped to FHIR R4 element `AllergyIntolerance.recorder` as `Equivalent`."
            }
          ]
        },
        {
          "code": "AllergyIntolerance.asserter",
          "display": "asserter",
          "target": [
            {
              "code": "AllergyIntolerance.asserter",
              "display": "AllergyIntolerance.asserter",
              "equivalence": "equivalent",
              "comment": "Element `AllergyIntolerance.asserter` is mapped to FHIR R4 element `AllergyIntolerance.asserter` as `Equivalent`.\nThe recorder takes repsonsibility for the content, but can reference the source from where they got it."
            }
          ]
        },
        {
          "code": "AllergyIntolerance.lastOccurrence",
          "display": "lastOccurrence",
          "target": [
            {
              "code": "AllergyIntolerance.lastOccurrence",
              "display": "AllergyIntolerance.lastOccurrence",
              "equivalence": "equivalent",
              "comment": "Element `AllergyIntolerance.lastOccurrence` is mapped to FHIR R4 element `AllergyIntolerance.lastOccurrence` as `Equivalent`.\nThis date may be replicated by one of the Onset of Reaction dates. Where a textual representation of the date of last occurrence is required e.g. 'In Childhood, '10 years ago' the Comment element should be used."
            }
          ]
        },
        {
          "code": "AllergyIntolerance.note",
          "display": "note",
          "target": [
            {
              "code": "AllergyIntolerance.note",
              "display": "AllergyIntolerance.note",
              "equivalence": "equivalent",
              "comment": "Element `AllergyIntolerance.note` is mapped to FHIR R4 element `AllergyIntolerance.note` as `Equivalent`.\nFor example: including reason for flagging a seriousness of 'High Risk'; and instructions related to future exposure or administration of the substance, such as administration within an Intensive Care Unit or under corticosteroid cover. The notes should be related to an allergy or intolerance as a condition in general and not related to any particular episode of it. For episode notes and descriptions, use AllergyIntolerance.event.description and  AllergyIntolerance.event.notes."
            }
          ]
        },
        {
          "code": "AllergyIntolerance.reaction",
          "display": "reaction",
          "target": [
            {
              "code": "AllergyIntolerance.reaction",
              "display": "AllergyIntolerance.reaction",
              "equivalence": "wider",
              "comment": "Element `AllergyIntolerance.reaction` is mapped to FHIR R4 element `AllergyIntolerance.reaction` as `Equivalent`."
            }
          ]
        },
        {
          "code": "AllergyIntolerance.reaction.substance",
          "display": "substance",
          "target": [
            {
              "code": "AllergyIntolerance.reaction.substance",
              "display": "AllergyIntolerance.reaction.substance",
              "equivalence": "equivalent",
              "comment": "Element `AllergyIntolerance.reaction.substance` is mapped to FHIR R4 element `AllergyIntolerance.reaction.substance` as `Equivalent`.\nCoding of the specific substance (or pharmaceutical product) with a terminology capable of triggering decision support should be used wherever possible.  The 'code' element allows for the use of a specific substance or pharmaceutical product, or a group or class of substances. In the case of an allergy or intolerance to a class of substances, (for example, \"penicillins\"), the 'reaction.substance' element could be used to code the specific substance that was identifed as having caused the reaction (for example, \"amoxycillin\"). Duplication of the value in the 'code' and 'reaction.substance' elements is acceptable when a specific substance has been recorded in 'code'."
            }
          ]
        },
        {
          "code": "AllergyIntolerance.reaction.manifestation",
          "display": "manifestation",
          "target": [
            {
              "code": "AllergyIntolerance.reaction.manifestation",
              "display": "AllergyIntolerance.reaction.manifestation",
              "equivalence": "equivalent",
              "comment": "Element `AllergyIntolerance.reaction.manifestation` is mapped to FHIR R4 element `AllergyIntolerance.reaction.manifestation` as `Equivalent`.\nManifestation can be expressed as a single word, phrase or brief description. For example: nausea, rash or no reaction. It is preferable that manifestation should be coded with a terminology, where possible. The values entered here may be used to display on an application screen as part of a list of adverse reactions, as recommended in the UK NHS CUI guidelines.  Terminologies commonly used include, but are not limited to, SNOMED CT or ICD10."
            }
          ]
        },
        {
          "code": "AllergyIntolerance.reaction.description",
          "display": "description",
          "target": [
            {
              "code": "AllergyIntolerance.reaction.description",
              "display": "AllergyIntolerance.reaction.description",
              "equivalence": "equivalent",
              "comment": "Element `AllergyIntolerance.reaction.description` is mapped to FHIR R4 element `AllergyIntolerance.reaction.description` as `Equivalent`.\nUse the description to provide any details of a particular event of the occurred reaction such as circumstances, reaction specifics, what happened before/after. Information, related to the event, but not describing a particular care should be captured in the comment field. For example: at the age of four, the patient was given penicillin for strep throat and subsequently developed severe hives."
            }
          ]
        },
        {
          "code": "AllergyIntolerance.reaction.onset",
          "display": "onset",
          "target": [
            {
              "code": "AllergyIntolerance.reaction.onset",
              "display": "AllergyIntolerance.reaction.onset",
              "equivalence": "equivalent",
              "comment": "Element `AllergyIntolerance.reaction.onset` is mapped to FHIR R4 element `AllergyIntolerance.reaction.onset` as `Equivalent`."
            }
          ]
        },
        {
          "code": "AllergyIntolerance.reaction.severity",
          "display": "severity",
          "target": [
            {
              "code": "AllergyIntolerance.reaction.severity",
              "display": "AllergyIntolerance.reaction.severity",
              "equivalence": "equivalent",
              "comment": "Element `AllergyIntolerance.reaction.severity` is mapped to FHIR R4 element `AllergyIntolerance.reaction.severity` as `Equivalent`.\nIt is acknowledged that this assessment is very subjective. There may be some some specific practice domains where objective scales have been applied. Objective scales can be included in this model as extensions."
            }
          ]
        },
        {
          "code": "AllergyIntolerance.reaction.exposureRoute",
          "display": "exposureRoute",
          "target": [
            {
              "code": "AllergyIntolerance.reaction.exposureRoute",
              "display": "AllergyIntolerance.reaction.exposureRoute",
              "equivalence": "equivalent",
              "comment": "Element `AllergyIntolerance.reaction.exposureRoute` is mapped to FHIR R4 element `AllergyIntolerance.reaction.exposureRoute` as `Equivalent`.\nCoding of the route of exposure with a terminology should be used wherever possible."
            }
          ]
        },
        {
          "code": "AllergyIntolerance.reaction.note",
          "display": "note",
          "target": [
            {
              "code": "AllergyIntolerance.reaction.note",
              "display": "AllergyIntolerance.reaction.note",
              "equivalence": "equivalent",
              "comment": "Element `AllergyIntolerance.reaction.note` is mapped to FHIR R4 element `AllergyIntolerance.reaction.note` as `Equivalent`.\nUse this field to record information indirectly related to a particular event and not captured in the description. For example: Clinical records are no longer available, recorded based on information provided to the patient by her mother and her mother is deceased."
            }
          ]
        }
      ]
    }
  ]
}