Virtually Healthcare HL7 FHIR R4 Implementation Guide, published by Virtually Healthcare. This guide is not an authorized publication; it is the continuous build for version 0.1.0-current built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/Virtually-Healthcare/HL7-FHIR-Implementation-Guide/ and changes regularly. See the Directory of published versions

• Content
• Detailed Descriptions
• XML
• JSON

Resource Profile: Immunization - Mappings

Draft as of 2024-12-02

Mappings for the Immunization resource profile.

Mappings for Workflow Pattern (http://hl7.org/fhir/workflow)

Immunization
Immunization	Event
status	Event.status
statusReason	Event.statusReason
vaccineCode	Event.code
patient	Event.subject
encounter	Event.context
occurrence[x]	Event.occurrence[x]
location	Event.location
performer	Event.performer
function	Event.performer.function
actor	Event.performer.actor
note	Event.note
reasonCode	Event.reasonCode
reasonReference	Event.reasonReference

Mappings for HL7 v2 Mapping (http://hl7.org/v2)

Immunization
Immunization	VXU_V04
identifier	CX / EI (occasionally, more often EI maps to a resource id or a URL)
vaccineCode	RXA-5
patient	PID-3
identifier	CX / EI (occasionally, more often EI maps to a resource id or a URL)
encounter	PV1-19
occurrence[x]	RXA-3
primarySource	RXA-9
reportOrigin	RXA-9
location	RXA-27 (or RXA-11, deprecated as of v2.7)
manufacturer	RXA-17
lotNumber	RXA-15
expirationDate	RXA-16
site	RXR-2
route	RXR-1
doseQuantity	RXA-6 / RXA-7
performer	ORC-12 / RXA-10
note	OBX-5 : OBX-3 = 48767-8
isSubpotent	RXA-20 = PA (partial administration)
education
documentType	OBX-5 : OBX-3 = 69764-9
publicationDate	OBX-5 : OBX-3 = 29768-9
presentationDate	OBX-5 : OBX-3 = 29769-7
programEligibility	OBX-5 : OBX-3 = 64994-7
reaction	OBX-3
date	OBX-14 (ideally this would be reported in an IAM segment, but IAM is not part of the HL7 v2 VXU message - most likely would appear in OBX segments if at all)
detail	OBX-5
reported	(HL7 v2 doesn't seem to provide for this)

Mappings for RIM Mapping (http://hl7.org/v3)

Immunization
Immunization	Entity. Role, or Act, SubstanceAdministration
text	Act.text?
contained	N/A
extension	N/A
modifierExtension	N/A
identifier	n/a, II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
status	statusCode
statusReason	.inboundRelationship[typeCode=SUBJ].source[classCode=CACT, moodCode=EVN].reasonCOde
vaccineCode	.code
patient	.partipication[ttypeCode=].role
id	n/a
extension	n/a
reference	N/A
type	N/A
identifier	n/a, II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
display	N/A
encounter	component->EncounterEvent
occurrence[x]	.effectiveTime
recorded	.participation[typeCode=AUT].time
primarySource	immunization.uncertaintycode (if primary source=false, uncertainty=U)
reportOrigin	.participation[typeCode=INF].role[classCode=PAT] (this syntax for self-reported) .participation[typeCode=INF].role[classCode=LIC] (this syntax for health care professional) .participation[typeCode=INF].role[classCode=PRS] (this syntax for family member)
location	.participation[typeCode=LOC].COCT_MT240000UV
manufacturer	.participation[typeCode=CSM].role[classCode=INST].scopedRole.scoper[classCode=ORG]
lotNumber	.participation[typeCode=CSM].role[classCode=INST].scopedRole.scoper[classCode=MMAT].id
expirationDate	.participation[typeCode=CSM].role[classCode=INST].scopedRole.scoper[classCode=MMAT].expirationTime
site	observation.targetSiteCode
route	.routeCode
doseQuantity	.doseQuantity
performer	.participation[typeCode=PRF].role[scoper.determinerCode=INSTANCE]
id	n/a
extension	n/a
modifierExtension	N/A
function	.participation.functionCode
actor	.player
note	note
reasonCode	[actionNegationInd=false].reasonCode
reasonReference	N/A
isSubpotent	N/A
subpotentReason	N/A
education	N/A
id	n/a
extension	n/a
modifierExtension	N/A
documentType	N/A
reference	N/A
publicationDate	N/A
presentationDate	N/A
programEligibility	N/A
fundingSource	N/A
reaction	Observation[classCode=obs].code
id	n/a
extension	n/a
modifierExtension	N/A
date	.effectiveTime
detail	.value
reported	.participation[typeCode=INF].role[classCode=PAT] (this syntax for self-reported=true)
protocolApplied	N/A
id	n/a
extension	n/a
modifierExtension	N/A
series	N/A
authority	N/A
targetDisease	N/A
doseNumber[x]	N/A
seriesDoses[x]	N/A

Mappings for FiveWs Pattern Mapping (http://hl7.org/fhir/fivews)

Immunization
Immunization
status	FiveWs.status
vaccineCode	FiveWs.what[x]
patient	FiveWs.subject[x], FiveWs.subject
encounter	FiveWs.context
occurrence[x]	FiveWs.done[x]
recorded	FiveWs.recorded
primarySource	FiveWs.source
reportOrigin	FiveWs.source
location	FiveWs.where[x]
performer
actor	FiveWs.actor

Mappings for CDA (R2) (http://hl7.org/v3/cda)

Immunization
Immunization
vaccineCode	ClinicalDocument/component/StructuredBody/component/section/entry/substanceAdministration/consumable/manfacturedProduct/manufacturedMaterial/realmCode/code
occurrence[x]	ClinicalDocument/component/StructuredBody/component/section/entry/substanceAdministration/effectiveTime/value
manufacturer	ClinicalDocument/component/StructuredBody/component/section/entry/substanceAdministration/consumable/manfacturedProduct/manufacuturerOrganization/name
lotNumber	ClinicalDocument/component/StructuredBody/component/section/entry/substanceAdministration/consumable/manfacturedProduct/manufacturedMaterial/lotNumberText
site	ClinicalDocument/component/StructuredBody/component/section/entry/substanceAdministration/approachSiteCode/code
route	ClinicalDocument/component/StructuredBody/component/section/entry/substanceAdministration/routeCode/code