HL7 FHIR® US Core Implementation Guide STU3 Release 3.1.0

This page is part of the US Core (v3.1.0: STU3) based on FHIR R4. The current version which supercedes this version is 5.0.1. For a full list of available versions, see the Directory of published versions

StructureDefinition-us-core-allergyintolerance

This profile sets minimum expectations for the AllergyIntolerance resource to record, search, and fetch allergies/adverse reactions associated with a patient. It identifies the mandatory core elements, extensions, vocabularies and value sets which SHALL be present in the AllergyIntolerance resource when using this profile.

Example Usage Scenarios:

The following are example usage scenarios for the US Core AllergyIntolerance profile:

Mandatory and Must Support Data Elements

The following data-elements are mandatory (i.e data MUST be present) or must be supported if the data is present in the sending system (Must Support definition). They are presented below in a simple human-readable explanation. Profile specific guidance and examples are provided as well. The Formal Profile Definition below provides the formal summary, definitions, and terminology requirements.

Each AllergyIntolerance must have:

  1. a status of the allergy*
  2. a code which tells you what the patient is allergic to
  3. a patient

*The status element has the following constraints: SHALL be present if verification status is not entered-in-error and SHALL NOT be present if verification Status is entered-in-error.

Each AllergyIntolerance must support:

  1. a verification status

Profile specific implementation guidance:

  • No Known Allergies may be represented using the US Core-AllergyIntolerance profile with appropriate negation code in AllergyIntolerence.code and the appropriate verification status in AllergyIntolerance.verificationStatus.

    If a patient has not been asked about their allergies, this would be represented as:

    • AllergyIntolerance.code = “716186003” (No known allergy (situation))

    • AllergyIntolerance.verificationStatus = “unconfirmed”

    If a patient has been asked, but has indicated they have no known allergies, this would be represented as:

    • AllergyIntolerance.code = “716186003” (No known allergy (situation))

    • AllergyIntolerance.verificationStatus = “verified”

Examples

Formal Views of Profile Content

Description of Profiles, Differentials, and Snapshots.

The official URL for this profile is: http://hl7.org/fhir/us/core/StructureDefinition/us-core-allergyintolerance

Published on Tue May 21 00:00:00 AEST 2019 as active by the HL7 US Realm Steering Committee.

This profile builds on AllergyIntolerance

AllergyIntolerance

Summary of the Mandatory Requirements

  1. A CodeableConcept in AllergyIntolerance.code with an extensible binding to US Core Common substances for allergy and intolerance documentation including refutations
  2. A Patient Reference in AllergyIntolerance.patient

Summary of the Must Support Requirements

  1. A CodeableConcept in AllergyIntolerance.clinicalStatus with a required binding to AllergyIntolerance Clinical Status Codes
  2. A CodeableConcept in AllergyIntolerance.verificationStatus with a required binding to AllergyIntolerance Verification Status Codes

Summary of Constraints

  1. AllergyIntolerance.clinicalStatus SHALL be present if verificationStatus is not entered-in-error.
  2. AllergyIntolerance.clinicalStatus SHALL NOT be present if verification Status is entered-in-error
NameFlagsCard.TypeDescription & Constraintsdoco
.. AllergyIntolerance I0..*Allergy or Intolerance (generally: Risk of adverse reaction to a substance)
... id Σ0..1stringLogical id of this artifact
... meta ΣI0..1MetaMetadata about the resource
... implicitRules ?!ΣI0..1uriA set of rules under which this content was created
... language I0..1codeLanguage of the resource content
Binding: CommonLanguages (preferred)
Max Binding: AllLanguages
... text I0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension I0..*ExtensionAdditional content defined by implementations
... modifierExtension ?!I0..*ExtensionExtensions that cannot be ignored
... identifier ΣI0..*IdentifierExternal ids for this item
... clinicalStatus ?!SΣI0..1CodeableConceptactive | inactive | resolved
Binding: AllergyIntoleranceClinicalStatusCodes (required)
... verificationStatus ?!SΣI0..1CodeableConceptunconfirmed | confirmed | refuted | entered-in-error
Binding: AllergyIntoleranceVerificationStatusCodes (required)
... type ΣI0..1codeallergy | intolerance - Underlying mechanism (if known)
Binding: AllergyIntoleranceType (required)
... category ΣI0..*codefood | medication | environment | biologic
Binding: AllergyIntoleranceCategory (required)
... criticality ΣI0..1codelow | high | unable-to-assess
Binding: AllergyIntoleranceCriticality (required)
... code SΣI1..1CodeableConceptCode that identifies the allergy or intolerance
Binding: US Core Common substances for allergy and intolerance documentation including refutations (extensible)
... patient SΣI1..1Reference(US Core Patient Profile)Who the sensitivity is for
... encounter I0..1Reference(Encounter)Encounter when the allergy or intolerance was asserted
... onset[x] I0..1When allergy or intolerance was identified
.... onsetDateTimedateTime
.... onsetAgeAge
.... onsetPeriodPeriod
.... onsetRangeRange
.... onsetStringstring
... recordedDate I0..1dateTimeDate first version of the resource instance was recorded
... recorder I0..1Reference(Practitioner | PractitionerRole | Patient | RelatedPerson)Who recorded the sensitivity
... asserter ΣI0..1Reference(Patient | RelatedPerson | Practitioner | PractitionerRole)Source of the information about the allergy
... lastOccurrence I0..1dateTimeDate(/time) of last known occurrence of a reaction
... note I0..*AnnotationAdditional text not captured in other fields
... reaction I0..*BackboneElementAdverse Reaction Events linked to exposure to substance
.... id 0..1stringUnique id for inter-element referencing
.... extension I0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!ΣI0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... substance I0..1CodeableConceptSpecific substance or pharmaceutical product considered to be responsible for event
Binding: SubstanceCode (example)
.... manifestation I1..*CodeableConceptClinical symptoms/signs associated with the Event
Binding: SNOMEDCTClinicalFindings (example)
.... description I0..1stringDescription of the event as a whole
.... onset I0..1dateTimeDate(/time) when manifestations showed
.... severity I0..1codemild | moderate | severe (of event as a whole)
Binding: AllergyIntoleranceSeverity (required)
.... exposureRoute I0..1CodeableConceptHow the subject was exposed to the substance
Binding: SNOMEDCTRouteCodes (example)
.... note I0..*AnnotationText about event not captured in other fields

doco Documentation for this format

AllergyIntolerance

Summary of the Mandatory Requirements

  1. A CodeableConcept in AllergyIntolerance.code with an extensible binding to US Core Common substances for allergy and intolerance documentation including refutations
  2. A Patient Reference in AllergyIntolerance.patient

Summary of the Must Support Requirements

  1. A CodeableConcept in AllergyIntolerance.clinicalStatus with a required binding to AllergyIntolerance Clinical Status Codes
  2. A CodeableConcept in AllergyIntolerance.verificationStatus with a required binding to AllergyIntolerance Verification Status Codes

Summary of Constraints

  1. AllergyIntolerance.clinicalStatus SHALL be present if verificationStatus is not entered-in-error.
  2. AllergyIntolerance.clinicalStatus SHALL NOT be present if verification Status is entered-in-error

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. AllergyIntolerance I0..*Allergy or Intolerance (generally: Risk of adverse reaction to a substance)
... id Σ0..1stringLogical id of this artifact
... meta ΣI0..1MetaMetadata about the resource
... implicitRules ?!ΣI0..1uriA set of rules under which this content was created
... language I0..1codeLanguage of the resource content
Binding: CommonLanguages (preferred)
Max Binding: AllLanguages
... text I0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension I0..*ExtensionAdditional content defined by implementations
... modifierExtension ?!I0..*ExtensionExtensions that cannot be ignored
... identifier ΣI0..*IdentifierExternal ids for this item
... clinicalStatus ?!SΣI0..1CodeableConceptactive | inactive | resolved
Binding: AllergyIntoleranceClinicalStatusCodes (required)
... verificationStatus ?!SΣI0..1CodeableConceptunconfirmed | confirmed | refuted | entered-in-error
Binding: AllergyIntoleranceVerificationStatusCodes (required)
... type ΣI0..1codeallergy | intolerance - Underlying mechanism (if known)
Binding: AllergyIntoleranceType (required)
... category ΣI0..*codefood | medication | environment | biologic
Binding: AllergyIntoleranceCategory (required)
... criticality ΣI0..1codelow | high | unable-to-assess
Binding: AllergyIntoleranceCriticality (required)
... code SΣI1..1CodeableConceptCode that identifies the allergy or intolerance
Binding: US Core Common substances for allergy and intolerance documentation including refutations (extensible)
... patient SΣI1..1Reference(US Core Patient Profile)Who the sensitivity is for
... encounter I0..1Reference(Encounter)Encounter when the allergy or intolerance was asserted
... onset[x] I0..1When allergy or intolerance was identified
.... onsetDateTimedateTime
.... onsetAgeAge
.... onsetPeriodPeriod
.... onsetRangeRange
.... onsetStringstring
... recordedDate I0..1dateTimeDate first version of the resource instance was recorded
... recorder I0..1Reference(Practitioner | PractitionerRole | Patient | RelatedPerson)Who recorded the sensitivity
... asserter ΣI0..1Reference(Patient | RelatedPerson | Practitioner | PractitionerRole)Source of the information about the allergy
... lastOccurrence I0..1dateTimeDate(/time) of last known occurrence of a reaction
... note I0..*AnnotationAdditional text not captured in other fields
... reaction I0..*BackboneElementAdverse Reaction Events linked to exposure to substance
.... id 0..1stringUnique id for inter-element referencing
.... extension I0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!ΣI0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... substance I0..1CodeableConceptSpecific substance or pharmaceutical product considered to be responsible for event
Binding: SubstanceCode (example)
.... manifestation I1..*CodeableConceptClinical symptoms/signs associated with the Event
Binding: SNOMEDCTClinicalFindings (example)
.... description I0..1stringDescription of the event as a whole
.... onset I0..1dateTimeDate(/time) when manifestations showed
.... severity I0..1codemild | moderate | severe (of event as a whole)
Binding: AllergyIntoleranceSeverity (required)
.... exposureRoute I0..1CodeableConceptHow the subject was exposed to the substance
Binding: SNOMEDCTRouteCodes (example)
.... note I0..*AnnotationText about event not captured in other fields

doco Documentation for this format

Downloads: StructureDefinition: (XML, JSON), Schema: XML Schematron


Quick Start

Below is an overview of the required set of RESTful FHIR interactions - for example, search and read operations - for this profile. See the Conformance requirements for a complete list of supported RESTful interactions for this IG.

  • See the General Guidance section for additional rules and expectations when a server requires status parameters.
  • See the General Guidance section for additional guidance on searching for multiple patients.

Mandatory Search Parameters:

The following search parameters and search parameter combinations SHALL be supported.:

  1. SHALL support searching for all allergies for a patient using the patient search parameter:

    GET [base]/AllergyIntolerance?patient=[reference]

    Example:

    1. GET [base]/AllergyIntolerance?patient=1137192

    Implementation Notes: Fetches a bundle of all AllergyIntolerance resources for the specified patient (how to search by reference)

Optional Search Parameters:

The following search parameter combinations SHOULD be supported.:

  1. SHOULD support searching using the combination of the patient and clinical-status search parameters:

    GET [base]/AllergyIntolerance?patient=[reference]&clinical-status={[system]}|[code]

    Example:

    1. GET [base]/AllergyIntolerance?patient=[id]&clinical-status=http://terminology.hl7.org/CodeSystem/allergyintolerance-clinical|active

    Implementation Notes: Fetches a bundle of all AllergyIntolerance resources for the specified patient and status code. This will not return any "entered in error" resources because of the conditional presence of the clinicalStatus element. (how to search by reference and how to search by token)