R4 Draft for Comment
MedicationsThis page is part of the FHIR Specification (v3.2.0: R4 Ballot 1). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions 
. Page versions: R5 R4B R4
| Public Health and Emergency Response Work Group | Maturity Level: 0 | Trial Use | Compartments: Patient |
Describes a comparison of an immunization event against published recommendations to determine if the administration is "valid" in relation to those recommendations.
The ImmunizationEvaluation resource is intended to cover communicating the results of an evaluation of a vaccine administration event (documented using the Immunization resource) against a set of published recommendations (protocols). Evaluating administered doses in a patient's immunization history is central to ensuring that the patient if fully protected against vaccine-preventable diseases. It is also a necessary prerequisite to generating a customized set of immunization recommendations for the patient.
The ImmunizationEvaluation resource communicates the results of an evaluation of an instance of the Immunization resource relative to a set of published recommendations. It is intended to communicate if the vaccine administration event was "valid" or "not valid" relative to the recommendations. Once all vaccine administration events in a patient's record have been evaluated, it is then possible to generate a set of vaccination related recommendations, unique for the patient. These recommendations are communicated using the ImmunizationRecommedation resource.
Through FHIR Release 3, the Immunization resource contained a "protocol" backbone element which functioned as an evaluation of the vaccine administration event. Begining in Release 4, this new resource replaces the Immunization.protocal element.
This resource is referenced by immunizationrecommendation
Structure
UML Diagram (Legend)
XML Template
<ImmunizationEvaluation xmlns="http://hl7.org/fhir"><!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..* Identifier Business identifier --></identifier> <status value="[code]"/><!-- 1..1 completed | entered-in-error --> <patient><!-- 1..1 Reference(Patient) Who this evaluation is for --></patient> <date value="[dateTime]"/><!-- 0..1 Date evaluation was performed --> <authority><!-- 0..1 Reference(Organization) Who is responsible for publishing the recommendations --></authority> <targetDisease><!-- 1..* CodeableConcept Evaluation target disease --></targetDisease> <immunizationEvent><!-- 1..1 Reference(Immunization) Immunization being evaluated --></immunizationEvent> <doseStatus><!-- 1..1 CodeableConcept Status of the dose relative to published recommendations --></doseStatus> <doseStatusReason><!-- 0..* CodeableConcept Reason for the dose status --></doseStatusReason> <description value="[string]"/><!-- 0..1 Evaluation notes --> <series value="[string]"/><!-- 0..1 Name of vaccine series --> <doseNumber value="[positiveInt]"/><!-- 0..1 Dose number within series --> <seriesDoses value="[positiveInt]"/><!-- 0..1 Recommended number of doses for immunity --> </ImmunizationEvaluation>
JSON Template
{
"resourceType" : "ImmunizationEvaluation",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"identifier" : [{ Identifier }], // Business identifier
"status" : "<code>", // R! completed | entered-in-error
"patient" : { Reference(Patient) }, // R! Who this evaluation is for
"date" : "<dateTime>", // Date evaluation was performed
"authority" : { Reference(Organization) }, // Who is responsible for publishing the recommendations
"targetDisease" : [{ CodeableConcept }], // R! Evaluation target disease
"immunizationEvent" : { Reference(Immunization) }, // R! Immunization being evaluated
"doseStatus" : { CodeableConcept }, // R! Status of the dose relative to published recommendations
"doseStatusReason" : [{ CodeableConcept }], // Reason for the dose status
"description" : "<string>", // Evaluation notes
"series" : "<string>", // Name of vaccine series
"doseNumber" : "<positiveInt>", // Dose number within series
"seriesDoses" : "<positiveInt>" // Recommended number of doses for immunity
}
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> .
Structure
XML Template
<ImmunizationEvaluation xmlns="http://hl7.org/fhir">
JSON Template
{
"resourceType" : "ImmunizationEvaluation",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"identifier" : [{ Identifier }], // Business identifier
"status" : "<code>", // R! completed | entered-in-error
"patient" : { Reference(Patient) }, // R! Who this evaluation is for
"date" : "<dateTime>", // Date evaluation was performed
"authority" : { Reference(Organization) }, // Who is responsible for publishing the recommendations
"targetDisease" : [{ CodeableConcept }], // R! Evaluation target disease
"immunizationEvent" : { Reference(Immunization) }, // R! Immunization being evaluated
"doseStatus" : { CodeableConcept }, // R! Status of the dose relative to published recommendations
"doseStatusReason" : [{ CodeableConcept }], // Reason for the dose status
"description" : "<string>", // Evaluation notes
"series" : "<string>", // Name of vaccine series
"doseNumber" : "<positiveInt>", // Dose number within series
"seriesDoses" : "<positiveInt>" // Recommended number of doses for immunity
}
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> .
Alternate definitions: Master Definition (XML, JSON), XML Schema/Schematron + JSON Schema, ShEx (for Turtle) + see the extensions & the dependency analysis
| Path | Definition | Type | Reference |
|---|---|---|---|
| ImmunizationEvaluation.status | The status of the evaluation being done | Required | Immunization Evaluation Status Codes |
| ImmunizationEvaluation.targetDisease | The vaccine preventable disease the dose is being evaluated against | Example | Immunization Evaluation Target Disease Codes |
| ImmunizationEvaluation.doseStatus | The status of the administered dose relative to the published recommendations for the target disease. | Example | Immunization Evaluation Dose Status codes |
| ImmunizationEvaluation.doseStatusReason | The reason the dose status was assigned | Example | Immunization Evaluation Dose Status Reason codes |
A single vaccine administration event (as communicated via the Immunization resource) may be evaluated against multiple published recommendations, against the same set of published recommendations at different points in time or against published recommendations for different vaccine-preventable diseases. That is a single Immunization record may be linked to multiple ImmunizationEvaluation records.
For example a dose of Twinrix contains antigen against both Hepatitis A and Hepatitis B. The evaluation of such a dose should happen against recommendations for both types of Hepatitis. Furthermore, the dose may be evaluated against both national and local recommendation or may be evaluated against either set of recommendations at multiple points in time (yearly as the patient comes in for standard "well person" appointment with their care provider).
Typically a single "recommendation" is prepare for the patient based on the evaluation of all of the vaccine administration events in the patient's history. This "recommendation" may include individual recommendations for multiple vaccines/vaccine groups. For example, a recommendation may be generate that includes recommendations for both an influenza and a diphtheria/tetanus vaccination. Such recommendations use the ImmunizationRecommedation resource.
Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.
| Name | Type | Description | Expression | In Common |
| date | date | Date the evaluation was generated | ImmunizationEvaluation.date | |
| dose-status | token | The status of the dose relative to published recommendations | ImmunizationEvaluation.doseStatus | |
| identifier | token | ID of the evaluation | ImmunizationEvaluation.identifier | |
| immunization-event | reference | The vaccine administration event being evaluated | ImmunizationEvaluation.immunizationEvent (Immunization) | |
| patient | reference | The patient being evaluated | ImmunizationEvaluation.patient (Patient) | |
| target-disease | token | The vaccine preventable disease being evaluated against | ImmunizationEvaluation.targetDisease |
®© HL7.org 2011+. FHIR Release 4 Draft for Comment (Jan-2018 v3.2.0-12885) generated on Wed, Dec 20, 2017 15:57+1100. QA Page
Links: Search |
Version History |
Table of Contents |
Credits |
Compare to DSTU3 |
|
Propose a change