Immunization (CA-Core)

Additional information on this profile (including the JSON & XML structure and detailed element descriptions) can be found at package/structuredefinition-immunization-ca-core.json

This profile imposes the CA Baseline (v1.1.7) Immunization Profile.

Profile

idΣ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
supportingInformationI0..*Extension
modifierExtension?! I0..*Extension
identifier0..*Identifier
statusΣ ?!1..1codeBinding
statusReason0..1CodeableConceptBinding
vaccineCodeΣ1..1CodeableConceptBinding
patientΣ I1..1Reference(package/structuredefinition-patient-ca-core.json)
encounterI0..1Reference(Encounter)
occurrenceDateTimeΣ0..1dateTime
occurrenceStringΣ0..1string
recorded0..1dateTime
primarySourceΣ0..1boolean
reportOrigin0..1CodeableConcept
locationI0..1Reference(Location)
manufacturerI0..1Reference(package/structuredefinition-organization-ca-core.json | Organization)
lotNumber0..1string
expirationDate0..1date
site0..1CodeableConcept
route0..1CodeableConcept
doseQuantityI0..1SimpleQuantity
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
functionΣ0..1CodeableConceptBinding
actorΣ I1..1Reference(package/structuredefinition-practitioner-ca-core.json | package/structuredefinition-practitionerrole-ca-core.json | package/structuredefinition-organization-ca-core.json | Practitioner | PractitionerRole | Organization)
noteΣ0..*Annotation
reasonCode0..*CodeableConceptBinding
reasonReferenceI0..*Reference(Condition | Observation | DiagnosticReport)
isSubpotentΣ ?!0..1boolean
subpotentReason0..*CodeableConcept
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
documentType0..1string
reference0..1uri
publicationDate0..1dateTime
presentationDate0..1dateTime
programEligibility0..*CodeableConcept
fundingSource0..1CodeableConcept
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
date0..1dateTime
detailI0..1Reference(Observation)
reported0..1boolean
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
series0..1string
authorityI0..1Reference(package/structuredefinition-organization-ca-core.json | Organization)
targetDisease0..*CodeableConceptBinding
doseNumberPositiveInt0..1positiveInt
doseNumberString0..1string
seriesDosesPositiveInt0..1positiveInt
seriesDosesString0..1string

Obligations

Obligations are a new (and evolving) mechanism in FHIR to provide a consistent and machine processable way for profiles to define their expectations for system behaviors.

This profile utilizes the Obligation Extension to convey these expectations.

Note: Simplifier is working on rendering of Obligations. In the meantime the Obligations applied on the profile (see JSON & XML structure) have been rendered as a table below for easier viewing.

Obligation Code Actor Elements
SHALL:able-to-populate Server Actor (CA Core) extension:supportingInformation, status, statusReason, vaccineCode, patient, occurrence[x]:occurrenceDateTime, manufacturer, lotNumber, expirationDate, site, route, doseQuantity, performer, performer.function, performer.actor, reasonCode, subpotentReason, reaction. reaction.date, reaction.detail, protocolApplied, protocolApplied.series, protocolApplied.authority, protocolApplied.targetDisease, protocolApplied.seriesDoses[x]:seriesDosesString, protocolApplied.doseNumber[x]:doseNumberString
SHALL:no-error Client Actor (CA Core) extension:supportingInformation, status, statusReason, vaccineCode, patient, occurrence[x]:occurrenceDateTime, occurrence[x]:occurrenceString, manufacturer, lotNumber, expirationDate, site, route, doseQuantity, performer, performer.function, performer.actor, reasonCode, subpotentReason, reaction. reaction.date, reaction.detail, protocolApplied, protocolApplied.series, protocolApplied.authority, protocolApplied.targetDisease, protocolApplied.seriesDoses[x]:seriesDosesPositiveInt, protocolApplied.seriesDoses[x]:seriesDosesString, protocolApplied.doseNumber[x]:doseNumberPositiveInt, protocolApplied.doseNumber[x]:doseNumberString

Terminology

This version of the guide is based on the early content development of the pan-Canadian Health Data Content Framework (pCHDCF). The pCHDCF is beginning to introduce recommended terminology for select concepts. Implementers should be aware that the identification of preferred terminology continues to progress and that some coded elements may have terminology recommendations added in future releases.

Note: Implementers should be aware of the limitations in some terminology referenced in this guide that is not fully expressed as an enumerated FHIR ValueSet or resolvable FHIR CodeSystems. Readers should refer to the Known Issues & Future Development page.

Bindings

Primary bindings are expressed in the rendering of the profile above (as well as can be found in the JSON/XML file).

Additional terminology bindings are also expressed in this profile to surface Alternate Value Sets expressed in the pCHDCF Data Content Standard. Currently, Simplifier does not render the additionalBinding extension that is applied within the profile to express these Alternate Value Sets. See Known Issues & Future Development page.

In the interim, the terminology that has been expressed as additionalBindings is rendered below for ease of use:

Mappings to pCHDCF

Draft Data Content Standard Element (As of 2024-02-15) Draft Data Content Standard Element Definition (As of 2024-02-15) FHIR Profile Element Additional Notes
Immunization Status The indication of the current status of the immunization event (e.g., completed, enter in error, not done). Immunization.status
Immunization Reason Not Performed The reason the immunization event was not performed. Immunization.statusReason
Immunization Name The trade name and its associated DIN, or generic name of the immunization product. Immunization.vaccineCode
Immunization Date The date the immunization was administered. Immunization.occurrence[x]:occurrenceDateTime Mapping of this concept could apply to both the dateTime and string data types, however dateTime is the primary mapping and preferred dataType to support to promote the capabilities to capture structured data.
Immunization Reason Not Performed Date The date of an immunization refusal or deferral. Immunization.occurrence[x]:occurrenceDateTime Mapping applies when the status is 'not-done'. Mapping of this concept could apply to both the dateTime and string data types, however dateTime is the primary mapping and preferred dataType to support to promote the capabilities to capture structured data.
Immunization Manufacturer The name of the immunization manufacturer. Immunization.manufacturer
Immunization Lot Number The lot number (identification number) of the immunization product. Immunization.lotNumber
Immunization Expiration Date The date of expiration of the immunization product. Immunization.expirationDate
Immunization Site The anatomical site where the immunization product was administered (e.g., right deltoid). Immunization.site
Immunization Route of Administration The path by which the immunization product is taken into or makes contact with the body (e.g., oral, intramuscular). Immunization.route
Immunization Dose Volume The volume of immunization product being administered. Immunization.doseQuantity Use of volume in concept may imply that further dataType sub-elements may be required (e.g., coded units to express volume). Further mapping may be applied as this concept is refined in the pCHDCF.
Immunization Reaction Reporter The individual who reported a reaction to an immunization (example: provider, person). Immunization.performer.function + Immunization.performer.actor The current definition for this concept implies that the performer is understood with a given function (reporter). The mapping is also based on the assumption that the reaction is captured within the record of the immunization event (instead of as an AdverseEvent or AllergyIntolerance). To fully provide meaning to performer under this definition, the Immunization.performer.function element must also be used. The mapping proposed is based on similar structures in national base implementation guides for other roles (e.g., approvers). Reviewers are encouraged to provide feedback on the mapping for this element compared to other alternatives (e.g. extensions, representation in AdverseEvent).
Immunization Reason The reason why the immunization product was administered, for example, routine immunization or travel. Immunization.reasonCode
Immunization Subpotent Reason The reason why the dose is considered to be subpotent. Immunization.subpotentReason
Immunization Education Note The documentation of education and/or resources provided to the person or guardian at the time of immunization administration. N/A Expected to be housed outside of Immunization Resource. While the FHIR R4 Immunization resource has the education element, it was removed in later releases of FHIR and replaced with guidance to convey details on the education provided to the person using the Communication resource. To maximize compatibility with future versions of FHIR, Communication is recommended over Immunization.education.
Immunization Reaction The type of immunization reaction, for example, rash, fever, anaphylaxis, etc. Immunization.reaction.detail* This mapping is inexact and the pCHDCF concept definition may need to be further refined to determine if the details are more appropriately housed in the AllergyIntolerance or AdverseEvent resources. Reviewers are encouraged to provide feedback on how this concept is currently captured in their systems today.
Immunization Reaction Date The date of the reaction to the immunization. Immunization.reaction.date
Immunization Reaction Time The time of the reaction to the immunization. Immunization.reaction.date
Immunization Protocol The immunization protocol that is being followed. Immunization.protocolApplied This concept currently maps to the backbone element which isn't directly populated in instances.
Immunization Protocol Series The name of vaccine series. Immunization.protocolApplied.series
Immunization Protocol Authority The authority responsible for publishing the recommendations. Immunization.protocolApplied.authority
Immunization Protocol Target disease The immunization preventable disease being targeted. Immunization.protocolApplied.targetDisease
Immunization Series Doses The recommended number of doses for immunity. Immunization.protocolApplied.seriesDoses[x]:seriesDosesString Mapping of this concept could apply to both the positiveInt and string data types, however string is the primary mapping and preferred dataType to support in order to maximize compatibility with future versions of FHIR (later versions of FHIR removing the positiveInt dataType from this element).
Immunization Dose Number Dose number within a series (e.g. dose 1 of 2 for Shingles immunization). Immunization.protocolApplied.doseNumber[x]:doseNumberString Mapping of this concept could apply to both the positiveInt and string data types, however string is the primary mapping and preferred dataType to support in order to maximize compatibility with future versions of FHIR (later versions of FHIR removing the positiveInt dataType from this element).
Immunization Supporting Documents Additional documents that provide further information about a person's immunization record (e.g., a record from a previous provider, public health unit). Immunization.extension:supportingInformation This extension is used to pre-adopt an element from FHIR R5 Immunization to support this mapping