NHS England FHIR Implementation Guide (deprecated)

Element Id

Immunization.extension

Short description

Additional content defined by implementations

Alternate names

extensions, user content

Definition

May be used to represent additional information that is not part of the basic definition of the resource. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Data Type

Sliced:

Unordered, Open, by url(Value)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

parentPresent

0..1

There are no (further) constraints on this element

Element Id

Immunization.extension:parentPresent

Short description

Was a parent of the patient present at an immunisation?

Alternate names

extensions, user content

Definition

Was a parent of the patient present at an immunisation?

Comments

Data Type

https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-ParentPresent

Extension URL

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

vaccinationProcedure

S I

0..1

Extension(CodeableConcept)Binding

Element Id

Immunization.extension:vaccinationProcedure

Short description

An extension to hold an immunization procedure code

Alternate names

extensions, user content

Definition

Where status=completed this is Mandatory This relates to the vaccine that was administered (procedure) and is a SNOMED CT from {{link:https://fhir.hl7.org.uk/ValueSet/UKCore-VaccinationProcedure}}

In addition to the codes in the following codes are recommended.

Vaccination Procedure	UK SNOMED self
Administration of first dose of SARS-CoV-2 (severe acute respiratory syndrome coronavirus 2) vaccine	1324681000000101
Administration of second dose of SARS-CoV-2 (severe acute respiratory syndrome coronavirus 2) vaccine	1324691000000104

"extension":  [
        {
            "url": "https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-VaccinationProcedure",
            "valueCodeableConcept": {
                "coding":  [
                    {
                        "system": "http://snomed.info/sct",
                        "code": "1324681000000101",
                        "display": "Administration of first dose of severe acute respiratory syndrome coronavirus 2 vaccine (procedure)"
                    }
                ]
            }
        }
    ],

Comments

Data Type

Extension(CodeableConcept)

Extension URL

https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-VaccinationProcedure

Binding

https://fhir.nhs.uk/ValueSet/NHSDigital-VaccinationProcedure

(unbound) (required)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

identifier

1..*

Element Id

Immunization.identifier

Short description

Business identifier

Definition

identifier.system

A URI for the system that has allocated the vaccination identifier. Note, this must be unique within a given Supplier system or instance of Supplier system

e.g.

Example of a “single instance for all customers” Supplier system https://supplierABC/identifiers/vacc
Example of “per customer instance” Supplier system https://supplierABC/ODSCode/NKO41/identifiers/vacc

identifier.value

A unique identifier for the vaccination record, that is consistent between any subsequent update or delete records.

Ideally this would be a GUID / UUID

Value in combination with UNIQUE_ID_URI must be globally unique In other words, a combination of identifier.value and identifier.system act as composite primary key to allow lookup of any Adverse Reactions records from the corresponding Adverse Reaction data file.

UUID example: e045626e-4dc5-4df3-bc35-da25263f901e
Example of a “single instance for all customers” Supplier system ACME-vacc123456
Example of “per customer instance” Supplier system ACME-CUSTOMER1-vacc123456 ACME-CUSTOMER2-vacc123456

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
workflow:Event.identifier
w5:FiveWs.identifier
rim:.id
cda:ClinicalDocument/component/StructuredBody/component/section/entry/substanceAdministration/id

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

Immunization.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

Immunization.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

This element deals only with general categories of identifiers. It SHOULD not be used for codes that correspond 1..1 with the Identifier.system. Some identifiers may fall into multiple categories due to common usage. Where the system is known, a type is unnecessary because the type is always part of the system definition. However systems often need to handle identifiers where the system is not known. There is not a 1:1 relationship between type and system, since many different systems have the same type.

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

1..1

There are no (further) constraints on this element

Element Id

Immunization.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

1..1

There are no (further) constraints on this element

Element Id

Immunization.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

If the value is a full URI, then the system SHALL be urn:ietf:rfc:3986. The value's primary purpose is computational mapping. As a result, it may be normalized for comparison purposes (e.g. removing non-significant whitespace, dashes, etc.) A value formatted for human display can be conveyed using the Rendered Value extension. Identifier.value is to be treated as case sensitive unless knowledge of the Identifier.system allows the processer to be confident that non-case-sensitive processing is safe.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

A Period specifies a range of time; the context of use will specify whether the entire range applies (e.g. "the patient was an inpatient of the hospital for this time range") or one value from the range applies (e.g. "give to the patient between these two times").

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

status

S Σ ?!

1..1

codeBinding

Element Id

Immunization.status

Short description

completed | entered-in-error | not-done

Definition

For a vaccination that has been administered, the status will be completed. This status does not indicate a vaccination course has been completed. When the vaccination has not been administered, the status will be not-done and a statusReason should be supplied.

Comments

Will generally be set to show that the immunization has been completed or not done. This element is labeled as a modifier because the status contains codes that mark the resource as not currently valid.

Data Type

ImmunizationStatusCodes (required)

Binding

A set of codes indicating the current status of an Immunization.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
workflow:Event.status
w5:FiveWs.status
rim:statusCode

statusReason

0..1

CodeableConceptBinding

Element Id

Immunization.statusReason

Short description

Reason not done

Definition

Indicates the reason the immunization event was not performed.

Comments

This is generally only used for the status of "not-done". The reason for performing the immunization event is captured in reasonCode, not here.

Data Type

NHSDigital Reason Immunization Not Administered (required)

Binding

The reason why a vaccine was not administered.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
workflow:Event.statusReason
rim:.inboundRelationship[typeCode=SUBJ].source[classCode=CACT, moodCode=EVN].reasonCOde

coding

1..*

There are no (further) constraints on this element

Element Id

Immunization.statusReason.coding

Short description

Code defined by a terminology system

Definition

A reference to a code defined by a terminology system.

Requirements

Allows for alternative encodings within a code system, and translations to other code systems.

Comments

Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labeled as UserSelected = true.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
rim:CV
orim:fhir:Coding rdfs:subClassOf dt:CDCoding
v2:C*E.1-8, C*E.10-22
rim:union(., ./translation)
orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

system

1..1

There are no (further) constraints on this element

Element Id

Immunization.statusReason.coding.system

Short description

Identity of the terminology system

Definition

The identification of the code system that defines the meaning of the symbol in the code.

Requirements

Need to be unambiguous about the source of the definition of the symbol.

Comments

The URI may be an OID (urn:oid:...) or a UUID (urn:uuid:...). OIDs and UUIDs SHALL be references to the HL7 OID registry. Otherwise, the URI should come from HL7's list of FHIR defined special URIs or it should reference to some definition that establishes the system clearly and unambiguously.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.3
rim:./codeSystem
orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

version

0..1

There are no (further) constraints on this element

Element Id

Immunization.statusReason.coding.version

Short description

Version of the system - if relevant

Definition

The version of the code system which was used when choosing this code. Note that a well-maintained code system does not need the version reported, because the meaning of codes is consistent across versions. However this cannot consistently be assured, and when the meaning is not guaranteed to be consistent, the version SHOULD be exchanged.

Comments

Where the terminology does not clearly define what string should be used to identify code system versions, the recommendation is to use the date (expressed in FHIR date format) on which that version was officially published as the version date.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.7
rim:./codeSystemVersion
orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

code

1..1

There are no (further) constraints on this element

Element Id

Immunization.statusReason.coding.code

Short description

Symbol in syntax defined by the system

Definition

A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

Requirements

Need to refer to a particular code in the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.1
rim:./code
orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

display

1..1

There are no (further) constraints on this element

Element Id

Immunization.statusReason.coding.display

Short description

Representation defined by the system

Definition

A representation of the meaning of the code in the system, following the rules of the system.

Requirements

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.2 - but note this is not well followed
rim:CV.displayName
orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

userSelected

0..1

There are no (further) constraints on this element

Element Id

Immunization.statusReason.coding.userSelected

Short description

If this coding was chosen directly by the user

Definition

Indicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).

Requirements

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Comments

Amongst a set of alternatives, a directly chosen code is the most appropriate starting point for new translations. There is some ambiguity about what exactly 'directly chosen' implies, and trading partner agreement may be needed to clarify the use of this element and its consequences more completely.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:Sometimes implied by being first
rim:CD.codingRationale
orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

text

0..1

There are no (further) constraints on this element

Element Id

Immunization.statusReason.text

Short description

Plain text representation of the concept

Definition

A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.

Requirements

The codes from the terminologies do not always capture the correct meaning with all the nuances of the human using them, or sometimes there is no appropriate code at all. In these cases, the text is used to capture the full meaning of the source.

Comments

Very often the text is the same as a displayName of one of the codings.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.9. But note many systems use C*E.2 for this
rim:./originalText[mediaType/code="text/plain"]/data
orim:fhir:CodeableConcept.text rdfs:subPropertyOf dt:CD.originalText

vaccineCode

1..1

CodeableConceptBinding

Element Id

Immunization.vaccineCode

Short description

Vaccine product administered

Definition

Where status is completed this is Mandatory. This indicates vaccine product administered. This should be a SNOMED CT code from {{link:https://fhir.hl7.org.uk/ValueSet/UKCore-VaccineCode}} AMPP codes should not be used.

Vaccine Reference Set	UK SNOMED Members Of	UK SNOMED Descendents Of
Meningococcal ACWY vaccines	999000811000001105
Influenza vaccines prescribable within general practice	12465201000001105
Meningococcal B vaccines	999000831000001104
Pneumococcal vaccines	999000841000001106
Seasonal Flu vaccines	999000821000001101
COVID-19 vaccines		39330711000001103

"vaccineCode": {
        "coding":  [
            {
                "system": "http://snomed.info/sct",
                "code": "39114911000001105",
                "display": "COVID-19 Vaccine AstraZeneca (ChAdOx1 S [recombinant]) 5x10,000,000,000 viral particles/0.5ml dose solution for injection multidose vials (AstraZeneca)"
            }
        ]
    },

For EU/international purposes, a vaccination type code can be also be included. The SNOMED CT concept should be from Vaccines (GPS) - IPS and EU SNOMED CT Vaccine List (COVID-19)

"vaccineCode": {
        "coding":  [
            {
                "system": "http://snomed.info/sct",
                "code": "39114911000001105",
                "display": "COVID-19 Vaccine AstraZeneca (ChAdOx1 S [recombinant]) 5x10,000,000,000 viral particles/0.5ml dose solution for injection multidose vials (AstraZeneca)"
            },
            {
                "system": "http://snomed.info/sct",
                "code": "1119305005",
                "display": "SARS-CoV-2 antigen vaccine"
            }
        ]
    },

Comments

Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination.

Data Type

NHS Digital Vaccine Code (extensible)

Binding

The code for vaccine product administered.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
workflow:Event.code
w5:FiveWs.what[x]
v2:RXA-5
rim:.code
cda:ClinicalDocument/component/StructuredBody/component/section/entry/substanceAdministration/consumable/manfacturedProduct/manufacturedMaterial/realmCode/code

coding

S Σ

1..*

There are no (further) constraints on this element

Element Id

Immunization.vaccineCode.coding

Short description

Code defined by a terminology system

Definition

A reference to a code defined by a terminology system.

Requirements

Allows for alternative encodings within a code system, and translations to other code systems.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
rim:CV
orim:fhir:Coding rdfs:subClassOf dt:CDCoding
v2:C*E.1-8, C*E.10-22
rim:union(., ./translation)
orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

system

1..1

There are no (further) constraints on this element

Element Id

Immunization.vaccineCode.coding.system

Short description

Identity of the terminology system

Definition

The identification of the code system that defines the meaning of the symbol in the code.

Requirements

Need to be unambiguous about the source of the definition of the symbol.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.3
rim:./codeSystem
orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

version

0..1

There are no (further) constraints on this element

Element Id

Immunization.vaccineCode.coding.version

Short description

Version of the system - if relevant

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.7
rim:./codeSystemVersion
orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

code

1..1

There are no (further) constraints on this element

Element Id

Immunization.vaccineCode.coding.code

Short description

Symbol in syntax defined by the system

Definition

A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

Requirements

Need to refer to a particular code in the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.1
rim:./code
orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

display

1..1

There are no (further) constraints on this element

Element Id

Immunization.vaccineCode.coding.display

Short description

Representation defined by the system

Definition

A representation of the meaning of the code in the system, following the rules of the system.

Requirements

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.2 - but note this is not well followed
rim:CV.displayName
orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

userSelected

0..1

There are no (further) constraints on this element

Element Id

Immunization.vaccineCode.coding.userSelected

Short description

If this coding was chosen directly by the user

Definition

Indicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).

Requirements

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:Sometimes implied by being first
rim:CD.codingRationale
orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

text

0..1

There are no (further) constraints on this element

Element Id

Immunization.vaccineCode.text

Short description

Plain text representation of the concept

Definition

A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.

Requirements

Comments

Very often the text is the same as a displayName of one of the codings.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.9. But note many systems use C*E.2 for this
rim:./originalText[mediaType/code="text/plain"]/data
orim:fhir:CodeableConcept.text rdfs:subPropertyOf dt:CD.originalText

patient

S Σ I

1..1

Element Id

Immunization.patient

Short description

Who was immunized

Definition

A traced NHS Number SHOULD be provided and when applicable a resource reference to the Patient resource.

"patient": {
                    "reference": "urn:uuid:edea022a-2d81-11eb-adc1-0242ac120002",
                    "type": "Patient",
                    "identifier": {
                        "system": "https://fhir.nhs.uk/Id/nhs-number",
                        "value": "9912003888"
                    }
                },

Comments

References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc.). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))
patient-reference:subject - An identifier reference or resource reference must be provided
(reference.exists() or (identifier.exists()))
patient-nhs:Supplied NHS Number is outside the English and Welsh NHS Number range or length of the number is wrong.
identifier.where(system='https://fhir.nhs.uk/Id/nhs-number').exists().not() or (identifier.where(system='https://fhir.nhs.uk/Id/nhs-number').exists() and identifier.where(system='https://fhir.nhs.uk/Id/nhs-number').value.matches('^([456789]{1}[0-9]{9})$'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
workflow:Event.subject
w5:FiveWs.subject[x]
v2:PID-3
rim:.partipication[ttypeCode=].role
w5:FiveWs.subject

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.patient.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

A reference to a location at which the other resource is found. The reference may be a relative reference, in which case it is relative to the service base URL, or an absolute URL that resolves to the location where the resource is found. The reference may be version specific or not. If the reference is not to a FHIR RESTful server, then it should be assumed to be version specific. Internal fragment references (start with '#') refer to contained resources.

Comments

Using absolute URLs provides a stable scalable approach suitable for a cloud/web context, while using relative/logical references provides a flexible approach suitable for use when trading across closed eco-system boundaries. Absolute URLs do not need to point to a FHIR RESTful server, though this is the preferred approach. If the URL conforms to the structure "/[type]/[id]" then it should be assumed that the reference is to a FHIR RESTful server.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

Immunization.patient.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

The type is the Canonical URL of Resource Definition that is the type this reference refers to. References are URLs that are relative to http://hl7.org/fhir/StructureDefinition/ e.g. "Patient" is a reference to http://hl7.org/fhir/StructureDefinition/Patient. Absolute URLs are only allowed for logical models (and can only be used in references in logical models, not resources).

Comments

This element is used to indicate the type of the target of the reference. This may be used which ever of the other elements are populated (or not). In some cases, the type of the target may be determined by inspection of the reference (e.g. a RESTful URL) or by resolving the target of the reference; if both the type and a reference is provided, the reference SHALL resolve to a resource of the same type as that specified.

Data Type

Binding

A resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

1..1

There are no (further) constraints on this element

Element Id

Immunization.patient.identifier

Short description

Logical reference, when literal reference is not known

Definition

An identifier for the target resource. This is used when there is no way to reference the other resource directly, either because the entity it represents is not available through a FHIR server, or because there is no way for the author of the resource to convert a known identifier to an actual location. There is no requirement that a Reference.identifier point to something that is actually exposed as a FHIR instance, but it SHALL point to a business concept that would be expected to be exposed as a FHIR instance, and that instance would need to be of a FHIR resource type allowed by the reference.

Comments

When an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy.

When both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Reference is intended to point to a structure that can potentially be expressed as a FHIR resource, though there is no need for it to exist as an actual FHIR resource instance - except in as much as an application wishes to actual find the target of the reference. The content referred to be the identifier must meet the logical constraints implied by any limitations on what resource types are permitted for the reference. For example, it would not be legitimate to send the identifier for a drug prescription if the type were Reference(Observation|DiagnosticReport). One of the use-cases for Reference.identifier is the situation where no FHIR representation exists (where the type is Reference (Any).

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

Immunization.patient.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

Immunization.patient.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

1..1

uriFixed Value

Element Id

Immunization.patient.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Fixed Value

https://fhir.nhs.uk/Id/nhs-number

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

1..1

There are no (further) constraints on this element

Element Id

Immunization.patient.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.patient.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.patient.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

Immunization.patient.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

encounter

0..1

There are no (further) constraints on this element

Element Id

Immunization.encounter

Short description

Encounter immunization was part of

Definition

The visit or admission or other contact between patient and healthcare provider the immunization was performed as part of.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
workflow:Event.context
w5:FiveWs.context
v2:PV1-19
rim:component->EncounterEvent

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.encounter.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

Immunization.encounter.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

A resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

Immunization.encounter.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

Immunization.encounter.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

Immunization.encounter.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

Immunization.encounter.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

Immunization.encounter.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.encounter.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.encounter.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

Immunization.encounter.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

occurrence[x]

S Σ

1..1

Element Id

Immunization.occurrence[x]

Short description

Vaccine administration date

Definition

The date and time on which the vaccination intervention was carried out or was meant to be administered.

Comments

When immunizations are given a specific date and time should always be known. When immunizations are patient reported, a specific date might not be known. Although partial dates are allowed, an adult patient might not be able to recall the year a childhood immunization was given. An exact date is always preferable, but the use of the String data type is acceptable when an exact date is not known. A small number of vaccines (e.g. live oral typhoid vaccine) are given as a series of patient self-administered dose over a span of time. In cases like this, often, only the first dose (typically a provider supervised dose) is recorded with the occurrence indicating the date/time of the first dose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
workflow:Event.occurrence[x]
w5:FiveWs.done[x]
v2:RXA-3
rim:.effectiveTime
cda:ClinicalDocument/component/StructuredBody/component/section/entry/substanceAdministration/effectiveTime/value

occurrenceDateTime

Data Type

recorded

0..1

Element Id

Immunization.recorded

Short description

When the immunization was first captured in the subject's record

Definition

The date that the vaccination administered (procedure) or not administered (situation) was recorded in the source system.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
w5:FiveWs.recorded
rim:.participation[typeCode=AUT].time

primarySource

S Σ

1..1

Element Id

Immunization.primarySource

Short description

Indicates context the data was recorded in

Definition

Set as TRUE when the content of the record is based on information from the person performing the vaccine or who has clinical responsibility for the vaccination, and the system can be considered a primary source of the vaccination event. Set as FALSE when the information has NOT come directly from people performing the vaccine (e.g. a patient or patient’s carer), and the system should not be treated as a primary source for this record. This is used to help identify and eliminate duplicate records held centrally.

Comments

Reflects the “reliability” of the content.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
w5:FiveWs.source
v2:RXA-9
rim:immunization.uncertaintycode (if primary source=false, uncertainty=U)

reportOrigin

0..1

Element Id

Immunization.reportOrigin

Short description

Indicates the source of a secondarily reported record

Definition

Where primarySource=false,

The ODS code should be set to the location of the primary source of the data where the report of the vaccination event is held

Where primarySource=false and the vaccination event has been stored in local Primary Care System.

The ODS code should be set to the ODS code of the organisation where the event has been stored e.g. GP practice or PCN.
Note this field will be used to determine whether or not to send the vaccination event to the patient’s registered GP


"reportOrigin": {
        "text": "RR8 - LEEDS TEACHING HOSPITALS NHS TRUST"
    },

Comments

Should not be populated if primarySource = True, not required even if primarySource = False.

Data Type

ImmunizationOriginCodes (example)

Binding

The source of the data for a record which is not from a primary source.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
w5:FiveWs.source
v2:RXA-9
rim:.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

S I

0..1

Element Id

Immunization.location

Short description

Where immunization occurred

Definition

Country where the vaccination took place. This should follow Using ISO 3166 Country Codes with FHIR or a SNOMED Country Code.


"location": {
        "identifier": {
            "system": "urn:iso:std:iso:3166",
            "value": "FR"
        },
        "display": "France"
    },

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
workflow:Event.location
w5:FiveWs.where[x]
v2:RXA-27 (or RXA-11, deprecated as of v2.7)
rim:.participation[typeCode=LOC].COCT_MT240000UV

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.location.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

Immunization.location.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

A resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

Immunization.location.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

Immunization.location.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

Immunization.location.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

Immunization.location.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

Immunization.location.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.location.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.location.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

Immunization.location.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

manufacturer

S I

0..1

Element Id

Immunization.manufacturer

Short description

Vaccine manufacturer

Definition

Manufacturer of vaccine product. Only the display is expected to be populated.


"manufacturer": {
        "display": "DREAMLAND Pharmaceuticals Ltd"
    },

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:RXA-17
rim:.participation[typeCode=CSM].role[classCode=INST].scopedRole.scoper[classCode=ORG]
cda:ClinicalDocument/component/StructuredBody/component/section/entry/substanceAdministration/consumable/manfacturedProduct/manufacuturerOrganization/name

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.manufacturer.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

Immunization.manufacturer.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

A resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

Immunization.manufacturer.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

Immunization.manufacturer.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

Immunization.manufacturer.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

Immunization.manufacturer.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

Immunization.manufacturer.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.manufacturer.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.manufacturer.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

1..1

There are no (further) constraints on this element

Element Id

Immunization.manufacturer.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

lotNumber

0..1

Element Id

Immunization.lotNumber

Short description

Vaccine lot number

Definition

Where status=completed this is Mandatory. This should be captured at source ideally via use of automated scanning technology (GS1 GTIN / NTIN standard).


   "lotNumber": "R04X",

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:RXA-15
rim:.participation[typeCode=CSM].role[classCode=INST].scopedRole.scoper[classCode=MMAT].id
cda:ClinicalDocument/component/StructuredBody/component/section/entry/substanceAdministration/consumable/manfacturedProduct/manufacturedMaterial/lotNumberText

expirationDate

0..1

Element Id

Immunization.expirationDate

Short description

Vaccine expiration date

Definition

Shorter date of either:

Manufacturer expiry date of the vaccine
Coronavirus point of care sites will only put in the defrost expiry date

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:RXA-16
rim:.participation[typeCode=CSM].role[classCode=INST].scopedRole.scoper[classCode=MMAT].expirationTime

site

0..1

CodeableConceptBinding

Element Id

Immunization.site

Short description

Body site vaccine was administered

Definition

Body site vaccine was administered into. A SNOMED Concept ID value from UK published reference set “Vaccine body site of administration simple reference set” (1127941000000100) should be used {{link:https://fhir.hl7.org.uk/ValueSet/UKCore-BodySite}}


"site": {
        "coding":  [
            {
                "system": "http://snomed.info/sct",
                "code": "368208006",
                "display": "Left upper arm structure (body structure)"
            }
        ]
    },

Comments

Data Type

Binding

The site at which the vaccine was administered.

UKCoreBodySite (extensible)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:RXR-2
rim:observation.targetSiteCode
cda:ClinicalDocument/component/StructuredBody/component/section/entry/substanceAdministration/approachSiteCode/code

coding

1..*

There are no (further) constraints on this element

Element Id

Immunization.site.coding

Short description

Code defined by a terminology system

Definition

A reference to a code defined by a terminology system.

Requirements

Allows for alternative encodings within a code system, and translations to other code systems.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
rim:CV
orim:fhir:Coding rdfs:subClassOf dt:CDCoding
v2:C*E.1-8, C*E.10-22
rim:union(., ./translation)
orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

system

1..1

There are no (further) constraints on this element

Element Id

Immunization.site.coding.system

Short description

Identity of the terminology system

Definition

The identification of the code system that defines the meaning of the symbol in the code.

Requirements

Need to be unambiguous about the source of the definition of the symbol.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.3
rim:./codeSystem
orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

version

0..1

There are no (further) constraints on this element

Element Id

Immunization.site.coding.version

Short description

Version of the system - if relevant

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.7
rim:./codeSystemVersion
orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

code

1..1

There are no (further) constraints on this element

Element Id

Immunization.site.coding.code

Short description

Symbol in syntax defined by the system

Definition

A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

Requirements

Need to refer to a particular code in the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.1
rim:./code
orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

display

1..1

There are no (further) constraints on this element

Element Id

Immunization.site.coding.display

Short description

Representation defined by the system

Definition

A representation of the meaning of the code in the system, following the rules of the system.

Requirements

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.2 - but note this is not well followed
rim:CV.displayName
orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

userSelected

0..1

There are no (further) constraints on this element

Element Id

Immunization.site.coding.userSelected

Short description

If this coding was chosen directly by the user

Definition

Indicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).

Requirements

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:Sometimes implied by being first
rim:CD.codingRationale
orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

text

0..1

There are no (further) constraints on this element

Element Id

Immunization.site.text

Short description

Plain text representation of the concept

Definition

A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.

Requirements

Comments

Very often the text is the same as a displayName of one of the codings.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.9. But note many systems use C*E.2 for this
rim:./originalText[mediaType/code="text/plain"]/data
orim:fhir:CodeableConcept.text rdfs:subPropertyOf dt:CD.originalText

route

0..1

CodeableConceptBinding

Element Id

Immunization.route

Short description

How vaccine entered body

Definition

A SNOMED concept ID value from either of the following should be used: UK “ePrescribing route of administration simple reference set (foundation metadata concept)” (999000051000001100) [UKCore-MedicationDosageRoute](https://simplifier.net/resolve?target=simplifier&scope=uk.nhsdigital.r4&canonical=https://fhir.hl7.org.uk/ValueSet/UKCore-MedicationDosageRoute} Or: UK published reference set “Vaccine route of administration simple reference set” (115231000001104)


 "route": {
        "coding":  [
            {
                "system": "http://snomed.info/sct",
                "code": "78421000",
                "display": "Intramuscular route (qualifier value)"
            }
        ]
    },

Comments

Data Type

UKCoreSubstanceOrProductAdministrationRoute (preferred)

Binding

The route by which the vaccine was administered.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:RXR-1
rim:.routeCode
cda:ClinicalDocument/component/StructuredBody/component/section/entry/substanceAdministration/routeCode/code

doseQuantity

S I

0..1

Element Id

Immunization.doseQuantity

Short description

Amount of vaccine administered

Definition

A dm+d (SNOMED) Concept ID value representing the Unit of measure used.

For COVID-19 a reference set has been published here: https://dd4c.digital.nhs.uk/dd4c/publishedmetadatas/intid/980?size=10


 "doseQuantity": {
        "value": 1,
        "unit": "pre-filled disposable injection",
        "system": "http://snomed.info/sct",
        "code": "3318611000001100"
    },

Comments

The context of use may frequently define what kind of quantity this is and therefore what kind of units can be used. The context of use may also restrict the values for the comparator.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
qty-3:If a code for the unit is present, the system SHALL also be present
code.empty() or system.exists()
sqty-1:The comparator is not used on a SimpleQuantity
comparator.empty()

Mappings

rim:n/a
v2:SN (see also Range) or CQ
rim:PQ, IVL<PQ>, MO, CO, depending on the values
v2:RXA-6 / RXA-7
rim:.doseQuantity

performer

S Σ

0..*

Element Id

Immunization.performer

Short description

Who performed event

Definition

The organisation ODS code of the location where the vaccination event took place with corresponding system of https://fhir.nhs.uk/Id/ods-organization-code. For roving teams on home visits or care home visits use the site code of the responsible site e.g. GP practice or dedicated vaccination site. It is strongly recommend the name of the Organisation is present in the display field.

Vaccination professional should be recorded using professional codes, see NHSDigital-Practitioner for details.


"performer":  [
        {
            "actor": {
                "type": "Practitioner",
                "identifier": {
                    "system": "https://fhir.hl7.org.uk/Id/nmc-number",
                    "value": "5566789"
                },
                "display": "HOLDING, Rafferty"
            }
        },
        {
            "actor": {
                "type": "Organization",
                "identifier": {
                    "system": "https://fhir.nhs.uk/Id/ods-organization-code",
                    "value": "C4B2A"
                },
                "display": "ELLAND ROAD STADIUM - COVID VACCINATION CENTRE"
            }
        }
    ],

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
workflow:Event.performer
v2:ORC-12 / RXA-10
rim:.participation[typeCode=PRF].role[scoper.determinerCode=INSTANCE]

function

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

Immunization.performer.function

Short description

What type of performance was done

Definition

Describes the type of performance (e.g. ordering provider, administering provider, etc.).

Comments

Data Type

ImmunizationFunctionCodes (extensible)

Binding

The role a practitioner or organization plays in the immunization event.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
workflow:Event.performer.function
rim:.participation.functionCode

actor

S Σ I

1..1

NHSDigitalReference(NHSDigitalOrganization | NHSDigitalPractitionerRole | NHSDigitalPractitioner)

Element Id

Immunization.performer.actor

Short description

A reference from one resource to another

Definition

A reference from one resource to another.

Comments

Data Type

NHSDigitalReference(NHSDigitalOrganization | NHSDigitalPractitionerRole | NHSDigitalPractitioner)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))
usercode-reference:An identifier reference or resource reference must be provided
(reference.exists() or identifier.exists())
usercode-nmc:NMC must be of the format NNANNNNA
identifier.exists().not() or identifier.where(system='https://fhir.hl7.org.uk/Id/nmc-number').exists().not() or (identifier.where(system='https://fhir.hl7.org.uk/Id/nmc-number').exists() and identifier.where(system='https://fhir.hl7.org.uk/Id/nmc-number').value.matches('^[0-9]{2}[A-Z]{1}[0-9]{4}[A-Z]{1}$'))
usercode-gmp:GMP must be of the format GNNNNNNN and not be a spurious code (starts with G6 or G7)
identifier.exists().not() or identifier.where(system='https://fhir.hl7.org.uk/Id/gmp-number').exists().not() or (identifier.where(system='https://fhir.hl7.org.uk/Id/gmp-number').exists() and identifier.where(system='https://fhir.hl7.org.uk/Id/gmp-number').value.matches('^[G]{1}[01234589]{1}[0-9]{6}$'))
usercode-gmc:GMC must be of the format CNNNNNNN
identifier.exists().not() or identifier.where(system='https://fhir.hl7.org.uk/Id/gmc-number').exists().not() or (identifier.where(system='https://fhir.hl7.org.uk/Id/gmc-number').exists() and identifier.where(system='https://fhir.hl7.org.uk/Id/gmc-number').value.matches('^[C]{1}[0-9]{7}$'))
usercode-gphc:GPHC must be of the format NNNNNNN
identifier.exists().not() or identifier.where(system='https://fhir.hl7.org.uk/Id/gphc-number').exists().not() or (identifier.where(system='https://fhir.hl7.org.uk/Id/gphc-number').exists() and identifier.where(system='https://fhir.hl7.org.uk/Id/gphc-number').value.matches('^[0-9]{7}$'))
usercode-hcpc:HCPC must be of the format AANNNNNN
identifier.exists().not() or identifier.where(system='https://fhir.hl7.org.uk/Id/hcpc-number').exists().not() or (identifier.where(system='https://fhir.hl7.org.uk/Id/hcpc-number').exists() and identifier.where(system='https://fhir.hl7.org.uk/Id/hcpc-number').value.matches('^[A-Z]{2}[0-9]{6}$'))
usercode-din:DIN format must be NNNNNN
identifier.exists().not() or identifier.where(system='https://fhir.hl7.org.uk/Id/din-number').exists().not() or (identifier.where(system='https://fhir.hl7.org.uk/Id/din-number').exists() and identifier.where(system='https://fhir.hl7.org.uk/Id/din-number').value.matches('^[0-9]{6}$'))
role-sds-role-profile:SDS Role Profile Id must be 12 digits
identifier.where(system='https://fhir.nhs.uk/Id/sds-role-profile-id').exists().not() or (identifier.where(system='https://fhir.nhs.uk/Id/sds-role-profile-id').exists() and identifier.where(system='https://fhir.nhs.uk/Id/sds-role-profile-id').value.matches('^[0-9]{12}$'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
workflow:Event.performer.actor
w5:FiveWs.actor
rim:.player

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.performer.actor.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

1..1

uriBinding

There are no (further) constraints on this element

Element Id

Immunization.performer.actor.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

Aa resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

Immunization.performer.actor.identifier

Short description

An identifier intended for computation

Definition

An identifier - identifies some entity uniquely and unambiguously. Typically this is used for business identifiers.

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

Immunization.performer.actor.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

Immunization.performer.actor.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

NHSDigital Identifier Type (required)

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

1..1

There are no (further) constraints on this element

Element Id

Immunization.performer.actor.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

1..1

There are no (further) constraints on this element

Element Id

Immunization.performer.actor.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.performer.actor.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.performer.actor.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

Immunization.performer.actor.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

note

0..*

There are no (further) constraints on this element

Element Id

Immunization.note

Short description

Additional immunization notes

Definition

Extra information about the immunization that is not conveyed by the other attributes.

Comments

For systems that do not have structured annotations, they can simply communicate a single annotation with no author or time. This element may need to be included in narrative because of the potential for modifying information. Annotations SHOULD NOT be used to communicate "modifying" information that could be computable. (This is a SHOULD because enforcing user behavior is nearly impossible).

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Act
workflow:Event.note
v2:OBX-5 : OBX-3 = 48767-8
rim:note

author[x]

0..1

There are no (further) constraints on this element

Element Id

Immunization.note.author[x]

Short description

Individual responsible for the annotation

Definition

The individual responsible for making the annotation.

Comments

Organization is used when there's no need for specific attribution as to who made the comment.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Act.participant[typeCode=AUT].role

authorString

There are no (further) constraints on this element

Data Type

authorReference

Reference(UK Core Practitioner | UK Core Patient | UK Core RelatedPerson | UK Core Organization)

There are no (further) constraints on this element

Data Type

Reference(UK Core Practitioner | UK Core Patient | UK Core RelatedPerson | UK Core Organization)

time

0..1

There are no (further) constraints on this element

Element Id

Immunization.note.time

Short description

When the annotation was made

Definition

Indicates when this particular annotation was made.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Act.effectiveTime

text

1..1

There are no (further) constraints on this element

Element Id

Immunization.note.text

Short description

The annotation - text content (as markdown)

Definition

The text of the annotation in markdown format.

Comments

Systems are not required to have markdown support, so the text should be readable without markdown processing. The markdown syntax is GFM - see https://github.github.com/gfm/

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Act.text

reasonCode

0..*

CodeableConceptBinding

Element Id

Immunization.reasonCode

Short description

Why immunization occurred

Definition

A SNOMED Concept Id. For COVID19 and Flu see https://digital.nhs.uk/developer/api-catalogue/vaccination

Comments

Data Type

NHS Digital Immunization Explanation Reason (extensible)

Binding

The reason why a vaccine was administered.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
workflow:Event.reasonCode
rim:[actionNegationInd=false].reasonCode

coding

S Σ

1..*

There are no (further) constraints on this element

Element Id

Immunization.reasonCode.coding

Short description

Code defined by a terminology system

Definition

A reference to a code defined by a terminology system.

Requirements

Allows for alternative encodings within a code system, and translations to other code systems.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
rim:CV
orim:fhir:Coding rdfs:subClassOf dt:CDCoding
v2:C*E.1-8, C*E.10-22
rim:union(., ./translation)
orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

system

1..1

There are no (further) constraints on this element

Element Id

Immunization.reasonCode.coding.system

Short description

Identity of the terminology system

Definition

The identification of the code system that defines the meaning of the symbol in the code.

Requirements

Need to be unambiguous about the source of the definition of the symbol.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.3
rim:./codeSystem
orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

version

0..1

There are no (further) constraints on this element

Element Id

Immunization.reasonCode.coding.version

Short description

Version of the system - if relevant

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.7
rim:./codeSystemVersion
orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

code

1..1

There are no (further) constraints on this element

Element Id

Immunization.reasonCode.coding.code

Short description

Symbol in syntax defined by the system

Definition

A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

Requirements

Need to refer to a particular code in the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.1
rim:./code
orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

display

1..1

There are no (further) constraints on this element

Element Id

Immunization.reasonCode.coding.display

Short description

Representation defined by the system

Definition

A representation of the meaning of the code in the system, following the rules of the system.

Requirements

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.2 - but note this is not well followed
rim:CV.displayName
orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

userSelected

0..1

There are no (further) constraints on this element

Element Id

Immunization.reasonCode.coding.userSelected

Short description

If this coding was chosen directly by the user

Definition

Indicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).

Requirements

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:Sometimes implied by being first
rim:CD.codingRationale
orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

text

0..1

There are no (further) constraints on this element

Element Id

Immunization.reasonCode.text

Short description

Plain text representation of the concept

Definition

A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.

Requirements

Comments

Very often the text is the same as a displayName of one of the codings.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.9. But note many systems use C*E.2 for this
rim:./originalText[mediaType/code="text/plain"]/data
orim:fhir:CodeableConcept.text rdfs:subPropertyOf dt:CD.originalText

reasonReference

0..*

Reference(UK Core Condition | UK Core Observation | UK Core DiagnosticReport)

There are no (further) constraints on this element

Element Id

Immunization.reasonReference

Short description

Why immunization occurred

Definition

Condition, Observation or DiagnosticReport that supports why the immunization was administered.

Comments

Data Type

Reference(UK Core Condition | UK Core Observation | UK Core DiagnosticReport)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
workflow:Event.reasonReference
rim:N/A

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.reasonReference.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

Immunization.reasonReference.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

A resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

Immunization.reasonReference.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

Immunization.reasonReference.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

Immunization.reasonReference.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

Immunization.reasonReference.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

Immunization.reasonReference.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.reasonReference.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.reasonReference.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

Immunization.reasonReference.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

isSubpotent

Σ ?!

0..1

There are no (further) constraints on this element

Element Id

Immunization.isSubpotent

Short description

Dose potency

Definition

Indication if a dose is considered to be subpotent. By default, a dose should be considered to be potent.

Comments

Typically, the recognition of the dose being sub-potent is retrospective, after the administration (ex. notification of a manufacturer recall after administration). However, in the case of a partial administration (the patient moves unexpectedly and only some of the dose is actually administered), subpotency may be recognized immediately, but it is still important to record the event.

Meaning When Missing

By default, a dose should be considered to be potent.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:RXA-20 = PA (partial administration)
rim:N/A

subpotentReason

0..*

There are no (further) constraints on this element

Element Id

Immunization.subpotentReason

Short description

Reason for being subpotent

Definition

Reason why a dose is considered to be subpotent.

Comments

Data Type

ImmunizationSubpotentReason (example)

Binding

The reason why a dose is considered to be subpotent.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
rim:N/A

education

0..*

There are no (further) constraints on this element

Element Id

Immunization.education

Short description

Educational material presented to patient

Definition

Educational material presented to the patient (or guardian) at the time of vaccine administration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
imm-1:One of documentType or reference SHALL be present
documentType.exists() or reference.exists()

Mappings

rim:n/a
rim:N/A

documentType

0..1

There are no (further) constraints on this element

Element Id

Immunization.education.documentType

Short description

Educational material document identifier

Definition

Identifier of the material presented to the patient.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:OBX-5 : OBX-3 = 69764-9
rim:N/A

reference

0..1

There are no (further) constraints on this element

Element Id

Immunization.education.reference

Short description

Educational material reference pointer

Definition

Reference pointer to the educational material given to the patient if the information was on line.

Comments

see http://en.wikipedia.org/wiki/Uniform_resource_identifier

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

publicationDate

0..1

There are no (further) constraints on this element

Element Id

Immunization.education.publicationDate

Short description

Educational material publication date

Definition

Date the educational material was published.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:OBX-5 : OBX-3 = 29768-9
rim:N/A

presentationDate

0..1

There are no (further) constraints on this element

Element Id

Immunization.education.presentationDate

Short description

Educational material presentation date

Definition

Date the educational material was given to the patient.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:OBX-5 : OBX-3 = 29769-7
rim:N/A

programEligibility

0..*

There are no (further) constraints on this element

Element Id

Immunization.programEligibility

Short description

Patient eligibility for a vaccination program

Definition

Indicates a patient's eligibility for a funding program.

Comments

Data Type

ImmunizationProgramEligibility (example)

Binding

The patient's eligibility for a vaccation program.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:OBX-5 : OBX-3 = 64994-7
rim:N/A

fundingSource

0..1

There are no (further) constraints on this element

Element Id

Immunization.fundingSource

Short description

Funding source for the vaccine

Definition

Indicates the source of the vaccine actually administered. This may be different than the patient eligibility (e.g. the patient may be eligible for a publically purchased vaccine but due to inventory issues, vaccine purchased with private funds was actually administered).

Comments

Data Type

ImmunizationFundingSource (example)

Binding

The source of funding used to purchase the vaccine administered.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
rim:N/A

reaction

0..*

There are no (further) constraints on this element

Element Id

Immunization.reaction

Short description

Details of a reaction that follows immunization

Definition

Categorical data indicating that an adverse event is associated in time to an immunization.

Comments

A reaction may be an indication of an allergy or intolerance and, if this is determined to be the case, it should be recorded as a new AllergyIntolerance resource instance as most systems will not query against past Immunization.reaction elements.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:OBX-3
rim:Observation[classCode=obs].code

date

0..1

There are no (further) constraints on this element

Element Id

Immunization.reaction.date

Short description

When reaction started

Definition

Date of reaction to the immunization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2: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)
rim:.effectiveTime

detail

0..1

There are no (further) constraints on this element

Element Id

Immunization.reaction.detail

Short description

Additional information on reaction

Definition

Details of the reaction.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:OBX-5
rim:.value

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.reaction.detail.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

Immunization.reaction.detail.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

A resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

Immunization.reaction.detail.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

Immunization.reaction.detail.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

Immunization.reaction.detail.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

Immunization.reaction.detail.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

Immunization.reaction.detail.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.reaction.detail.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.reaction.detail.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

Immunization.reaction.detail.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

reported

0..1

There are no (further) constraints on this element

Element Id

Immunization.reaction.reported

Short description

Indicates self-reported reaction

Definition

Self-reported indicator.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:(HL7 v2 doesn't seem to provide for this)
rim:.participation[typeCode=INF].role[classCode=PAT] (this syntax for self-reported=true)

protocolApplied

0..*

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied

Short description

Protocol followed by the provider

Definition

The protocol (set of recommendations) being followed by the provider who administered the dose.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

series

0..1

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied.series

Short description

Name of vaccine series

Definition

One possible path to achieve presumed immunity against a disease - within the context of an authority.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

authority

0..1

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied.authority

Short description

Who is responsible for publishing the recommendations

Definition

Indicates the authority who published the protocol (e.g. ACIP) that is being followed.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
rim:N/A

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied.authority.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied.authority.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

A resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied.authority.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied.authority.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied.authority.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied.authority.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied.authority.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied.authority.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied.authority.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied.authority.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

targetDisease

0..*

CodeableConceptBinding

Element Id

Immunization.protocolApplied.targetDisease

Short description

Vaccine preventatable disease being targetted

Definition

The vaccine preventable disease the dose is being administered against.

Comments

Data Type

http://hl7.eu/fhir/ig/dgc/ValueSet/covid-19-diseases (required)

Binding

(Work in progress) The vaccine preventable disease the dose is being administered for.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
rim:N/A

doseNumber[x]

1..1

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied.doseNumber[x]

Short description

Dose number within series

Definition

Nominal position in a series.

Comments

The use of an integer is preferred if known. A string should only be used in cases where an integer is not available (such as when documenting a recurring booster dose).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

doseNumberPositiveInt

There are no (further) constraints on this element

Data Type

doseNumberString

There are no (further) constraints on this element

Data Type

seriesDoses[x]

0..1

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied.seriesDoses[x]

Short description

Recommended number of doses for immunity

Definition

The recommended number of doses to achieve immunity.

Comments

The use of an integer is preferred if known. A string should only be used in cases where an integer is not available (such as when documenting a recurring booster dose).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

seriesDosesPositiveInt

There are no (further) constraints on this element

Data Type

seriesDosesString

There are no (further) constraints on this element

Data Type

Immunization

There are no (further) constraints on this element

Element Id

Immunization

Short description

Immunization event information

Definition

Describes the event of a patient being administered a vaccine or a record of an immunization as reported by a patient, a clinician or another party.

Data Type

Immunization

Constraints

dom-2:If the resource is contained in another resource, it SHALL NOT contain nested Resources
contained.contained.empty()
dom-4:If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-3:If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-6:A resource should have narrative for robust management
text.`div`.exists()
dom-5:If a resource is contained in another resource, it SHALL NOT have a security label
contained.meta.security.empty()
ukcore-imm-1:If the immunization was not given then Immunization.status value SHALL = 'not-done', and the Immunization.statusReason SHALL be populated
(status != 'not-done') or (status = 'not-done' and statusReason.exists())

Mappings

rim:Entity. Role, or Act
workflow:Event
v2:VXU_V04
rim:SubstanceAdministration

extension

0..*

Element Id

Immunization.extension

Short description

Additional content defined by implementations

Alternate names

extensions, user content

Definition

Comments

Data Type

Sliced:

Unordered, Open, by url(Value)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

parentPresent

0..1

There are no (further) constraints on this element

Element Id

Immunization.extension:parentPresent

Short description

Was a parent of the patient present at an immunisation?

Alternate names

extensions, user content

Definition

Was a parent of the patient present at an immunisation?

Comments

Data Type

https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-ParentPresent

Extension URL

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

vaccinationProcedure

S I

0..1

Extension(CodeableConcept)Binding

Element Id

Immunization.extension:vaccinationProcedure

Short description

An extension to hold an immunization procedure code

Alternate names

extensions, user content

Definition

Where status=completed this is Mandatory This relates to the vaccine that was administered (procedure) and is a SNOMED CT from {{link:https://fhir.hl7.org.uk/ValueSet/UKCore-VaccinationProcedure}}

In addition to the codes in the following codes are recommended.

Vaccination Procedure	UK SNOMED self
Administration of first dose of SARS-CoV-2 (severe acute respiratory syndrome coronavirus 2) vaccine	1324681000000101
Administration of second dose of SARS-CoV-2 (severe acute respiratory syndrome coronavirus 2) vaccine	1324691000000104

"extension":  [
        {
            "url": "https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-VaccinationProcedure",
            "valueCodeableConcept": {
                "coding":  [
                    {
                        "system": "http://snomed.info/sct",
                        "code": "1324681000000101",
                        "display": "Administration of first dose of severe acute respiratory syndrome coronavirus 2 vaccine (procedure)"
                    }
                ]
            }
        }
    ],

Comments

Data Type

Extension(CodeableConcept)

Extension URL

https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-VaccinationProcedure

Binding

https://fhir.nhs.uk/ValueSet/NHSDigital-VaccinationProcedure

(unbound) (required)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

identifier

1..*

Element Id

Immunization.identifier

Short description

Business identifier

Definition

identifier.system

A URI for the system that has allocated the vaccination identifier. Note, this must be unique within a given Supplier system or instance of Supplier system

e.g.

Example of a “single instance for all customers” Supplier system https://supplierABC/identifiers/vacc
Example of “per customer instance” Supplier system https://supplierABC/ODSCode/NKO41/identifiers/vacc

identifier.value

A unique identifier for the vaccination record, that is consistent between any subsequent update or delete records.

Ideally this would be a GUID / UUID

UUID example: e045626e-4dc5-4df3-bc35-da25263f901e
Example of a “single instance for all customers” Supplier system ACME-vacc123456
Example of “per customer instance” Supplier system ACME-CUSTOMER1-vacc123456 ACME-CUSTOMER2-vacc123456

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
workflow:Event.identifier
w5:FiveWs.identifier
rim:.id
cda:ClinicalDocument/component/StructuredBody/component/section/entry/substanceAdministration/id

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

Immunization.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

Immunization.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

1..1

There are no (further) constraints on this element

Element Id

Immunization.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

1..1

There are no (further) constraints on this element

Element Id

Immunization.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

status

S Σ ?!

1..1

codeBinding

Element Id

Immunization.status

Short description

completed | entered-in-error | not-done

Definition

Comments

Data Type

ImmunizationStatusCodes (required)

Binding

A set of codes indicating the current status of an Immunization.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
workflow:Event.status
w5:FiveWs.status
rim:statusCode

statusReason

0..1

CodeableConceptBinding

Element Id

Immunization.statusReason

Short description

Reason not done

Definition

Indicates the reason the immunization event was not performed.

Comments

This is generally only used for the status of "not-done". The reason for performing the immunization event is captured in reasonCode, not here.

Data Type

NHSDigital Reason Immunization Not Administered (required)

Binding

The reason why a vaccine was not administered.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
workflow:Event.statusReason
rim:.inboundRelationship[typeCode=SUBJ].source[classCode=CACT, moodCode=EVN].reasonCOde

coding

1..*

There are no (further) constraints on this element

Element Id

Immunization.statusReason.coding

Short description

Code defined by a terminology system

Definition

A reference to a code defined by a terminology system.

Requirements

Allows for alternative encodings within a code system, and translations to other code systems.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
rim:CV
orim:fhir:Coding rdfs:subClassOf dt:CDCoding
v2:C*E.1-8, C*E.10-22
rim:union(., ./translation)
orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

system

1..1

There are no (further) constraints on this element

Element Id

Immunization.statusReason.coding.system

Short description

Identity of the terminology system

Definition

The identification of the code system that defines the meaning of the symbol in the code.

Requirements

Need to be unambiguous about the source of the definition of the symbol.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.3
rim:./codeSystem
orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

version

0..1

There are no (further) constraints on this element

Element Id

Immunization.statusReason.coding.version

Short description

Version of the system - if relevant

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.7
rim:./codeSystemVersion
orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

code

1..1

There are no (further) constraints on this element

Element Id

Immunization.statusReason.coding.code

Short description

Symbol in syntax defined by the system

Definition

A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

Requirements

Need to refer to a particular code in the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.1
rim:./code
orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

display

1..1

There are no (further) constraints on this element

Element Id

Immunization.statusReason.coding.display

Short description

Representation defined by the system

Definition

A representation of the meaning of the code in the system, following the rules of the system.

Requirements

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.2 - but note this is not well followed
rim:CV.displayName
orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

userSelected

0..1

There are no (further) constraints on this element

Element Id

Immunization.statusReason.coding.userSelected

Short description

If this coding was chosen directly by the user

Definition

Indicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).

Requirements

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:Sometimes implied by being first
rim:CD.codingRationale
orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

text

0..1

There are no (further) constraints on this element

Element Id

Immunization.statusReason.text

Short description

Plain text representation of the concept

Definition

A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.

Requirements

Comments

Very often the text is the same as a displayName of one of the codings.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.9. But note many systems use C*E.2 for this
rim:./originalText[mediaType/code="text/plain"]/data
orim:fhir:CodeableConcept.text rdfs:subPropertyOf dt:CD.originalText

vaccineCode

1..1

CodeableConceptBinding

Element Id

Immunization.vaccineCode

Short description

Vaccine product administered

Definition

Vaccine Reference Set	UK SNOMED Members Of	UK SNOMED Descendents Of
Meningococcal ACWY vaccines	999000811000001105
Influenza vaccines prescribable within general practice	12465201000001105
Meningococcal B vaccines	999000831000001104
Pneumococcal vaccines	999000841000001106
Seasonal Flu vaccines	999000821000001101
COVID-19 vaccines		39330711000001103

"vaccineCode": {
        "coding":  [
            {
                "system": "http://snomed.info/sct",
                "code": "39114911000001105",
                "display": "COVID-19 Vaccine AstraZeneca (ChAdOx1 S [recombinant]) 5x10,000,000,000 viral particles/0.5ml dose solution for injection multidose vials (AstraZeneca)"
            }
        ]
    },

For EU/international purposes, a vaccination type code can be also be included. The SNOMED CT concept should be from Vaccines (GPS) - IPS and EU SNOMED CT Vaccine List (COVID-19)

"vaccineCode": {
        "coding":  [
            {
                "system": "http://snomed.info/sct",
                "code": "39114911000001105",
                "display": "COVID-19 Vaccine AstraZeneca (ChAdOx1 S [recombinant]) 5x10,000,000,000 viral particles/0.5ml dose solution for injection multidose vials (AstraZeneca)"
            },
            {
                "system": "http://snomed.info/sct",
                "code": "1119305005",
                "display": "SARS-CoV-2 antigen vaccine"
            }
        ]
    },

Comments

Data Type

NHS Digital Vaccine Code (extensible)

Binding

The code for vaccine product administered.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
workflow:Event.code
w5:FiveWs.what[x]
v2:RXA-5
rim:.code
cda:ClinicalDocument/component/StructuredBody/component/section/entry/substanceAdministration/consumable/manfacturedProduct/manufacturedMaterial/realmCode/code

coding

S Σ

1..*

There are no (further) constraints on this element

Element Id

Immunization.vaccineCode.coding

Short description

Code defined by a terminology system

Definition

A reference to a code defined by a terminology system.

Requirements

Allows for alternative encodings within a code system, and translations to other code systems.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
rim:CV
orim:fhir:Coding rdfs:subClassOf dt:CDCoding
v2:C*E.1-8, C*E.10-22
rim:union(., ./translation)
orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

system

1..1

There are no (further) constraints on this element

Element Id

Immunization.vaccineCode.coding.system

Short description

Identity of the terminology system

Definition

The identification of the code system that defines the meaning of the symbol in the code.

Requirements

Need to be unambiguous about the source of the definition of the symbol.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.3
rim:./codeSystem
orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

version

0..1

There are no (further) constraints on this element

Element Id

Immunization.vaccineCode.coding.version

Short description

Version of the system - if relevant

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.7
rim:./codeSystemVersion
orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

code

1..1

There are no (further) constraints on this element

Element Id

Immunization.vaccineCode.coding.code

Short description

Symbol in syntax defined by the system

Definition

A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

Requirements

Need to refer to a particular code in the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.1
rim:./code
orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

display

1..1

There are no (further) constraints on this element

Element Id

Immunization.vaccineCode.coding.display

Short description

Representation defined by the system

Definition

A representation of the meaning of the code in the system, following the rules of the system.

Requirements

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.2 - but note this is not well followed
rim:CV.displayName
orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

userSelected

0..1

There are no (further) constraints on this element

Element Id

Immunization.vaccineCode.coding.userSelected

Short description

If this coding was chosen directly by the user

Definition

Indicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).

Requirements

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:Sometimes implied by being first
rim:CD.codingRationale
orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

text

0..1

There are no (further) constraints on this element

Element Id

Immunization.vaccineCode.text

Short description

Plain text representation of the concept

Definition

A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.

Requirements

Comments

Very often the text is the same as a displayName of one of the codings.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.9. But note many systems use C*E.2 for this
rim:./originalText[mediaType/code="text/plain"]/data
orim:fhir:CodeableConcept.text rdfs:subPropertyOf dt:CD.originalText

patient

S Σ I

1..1

Element Id

Immunization.patient

Short description

Who was immunized

Definition

A traced NHS Number SHOULD be provided and when applicable a resource reference to the Patient resource.

"patient": {
                    "reference": "urn:uuid:edea022a-2d81-11eb-adc1-0242ac120002",
                    "type": "Patient",
                    "identifier": {
                        "system": "https://fhir.nhs.uk/Id/nhs-number",
                        "value": "9912003888"
                    }
                },

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))
patient-reference:subject - An identifier reference or resource reference must be provided
(reference.exists() or (identifier.exists()))
patient-nhs:Supplied NHS Number is outside the English and Welsh NHS Number range or length of the number is wrong.
identifier.where(system='https://fhir.nhs.uk/Id/nhs-number').exists().not() or (identifier.where(system='https://fhir.nhs.uk/Id/nhs-number').exists() and identifier.where(system='https://fhir.nhs.uk/Id/nhs-number').value.matches('^([456789]{1}[0-9]{9})$'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
workflow:Event.subject
w5:FiveWs.subject[x]
v2:PID-3
rim:.partipication[ttypeCode=].role
w5:FiveWs.subject

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.patient.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

Immunization.patient.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

A resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

1..1

There are no (further) constraints on this element

Element Id

Immunization.patient.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

Immunization.patient.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

Immunization.patient.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

1..1

uriFixed Value

Element Id

Immunization.patient.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Fixed Value

https://fhir.nhs.uk/Id/nhs-number

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

1..1

There are no (further) constraints on this element

Element Id

Immunization.patient.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.patient.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.patient.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

Immunization.patient.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

encounter

0..1

There are no (further) constraints on this element

Element Id

Immunization.encounter

Short description

Encounter immunization was part of

Definition

The visit or admission or other contact between patient and healthcare provider the immunization was performed as part of.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
workflow:Event.context
w5:FiveWs.context
v2:PV1-19
rim:component->EncounterEvent

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.encounter.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

Immunization.encounter.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

A resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

Immunization.encounter.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

Immunization.encounter.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

Immunization.encounter.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

Immunization.encounter.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

Immunization.encounter.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.encounter.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.encounter.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

Immunization.encounter.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

occurrence[x]

S Σ

1..1

Element Id

Immunization.occurrence[x]

Short description

Vaccine administration date

Definition

The date and time on which the vaccination intervention was carried out or was meant to be administered.

Comments

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
workflow:Event.occurrence[x]
w5:FiveWs.done[x]
v2:RXA-3
rim:.effectiveTime
cda:ClinicalDocument/component/StructuredBody/component/section/entry/substanceAdministration/effectiveTime/value

occurrenceDateTime

Data Type

recorded

0..1

Element Id

Immunization.recorded

Short description

When the immunization was first captured in the subject's record

Definition

The date that the vaccination administered (procedure) or not administered (situation) was recorded in the source system.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
w5:FiveWs.recorded
rim:.participation[typeCode=AUT].time

primarySource

S Σ

1..1

Element Id

Immunization.primarySource

Short description

Indicates context the data was recorded in

Definition

Comments

Reflects the “reliability” of the content.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
w5:FiveWs.source
v2:RXA-9
rim:immunization.uncertaintycode (if primary source=false, uncertainty=U)

reportOrigin

0..1

Element Id

Immunization.reportOrigin

Short description

Indicates the source of a secondarily reported record

Definition

Where primarySource=false,

The ODS code should be set to the location of the primary source of the data where the report of the vaccination event is held

Where primarySource=false and the vaccination event has been stored in local Primary Care System.

The ODS code should be set to the ODS code of the organisation where the event has been stored e.g. GP practice or PCN.
Note this field will be used to determine whether or not to send the vaccination event to the patient’s registered GP


"reportOrigin": {
        "text": "RR8 - LEEDS TEACHING HOSPITALS NHS TRUST"
    },

Comments

Should not be populated if primarySource = True, not required even if primarySource = False.

Data Type

ImmunizationOriginCodes (example)

Binding

The source of the data for a record which is not from a primary source.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
w5:FiveWs.source
v2:RXA-9
rim:.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

S I

0..1

Element Id

Immunization.location

Short description

Where immunization occurred

Definition

Country where the vaccination took place. This should follow Using ISO 3166 Country Codes with FHIR or a SNOMED Country Code.


"location": {
        "identifier": {
            "system": "urn:iso:std:iso:3166",
            "value": "FR"
        },
        "display": "France"
    },

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
workflow:Event.location
w5:FiveWs.where[x]
v2:RXA-27 (or RXA-11, deprecated as of v2.7)
rim:.participation[typeCode=LOC].COCT_MT240000UV

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.location.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

Immunization.location.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

A resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

Immunization.location.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

Immunization.location.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

Immunization.location.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

Immunization.location.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

Immunization.location.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.location.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.location.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

Immunization.location.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

manufacturer

S I

0..1

Element Id

Immunization.manufacturer

Short description

Vaccine manufacturer

Definition

Manufacturer of vaccine product. Only the display is expected to be populated.


"manufacturer": {
        "display": "DREAMLAND Pharmaceuticals Ltd"
    },

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:RXA-17
rim:.participation[typeCode=CSM].role[classCode=INST].scopedRole.scoper[classCode=ORG]
cda:ClinicalDocument/component/StructuredBody/component/section/entry/substanceAdministration/consumable/manfacturedProduct/manufacuturerOrganization/name

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.manufacturer.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

Immunization.manufacturer.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

A resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

Immunization.manufacturer.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

Immunization.manufacturer.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

Immunization.manufacturer.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

Immunization.manufacturer.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

Immunization.manufacturer.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.manufacturer.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.manufacturer.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

1..1

There are no (further) constraints on this element

Element Id

Immunization.manufacturer.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

lotNumber

0..1

Element Id

Immunization.lotNumber

Short description

Vaccine lot number

Definition

Where status=completed this is Mandatory. This should be captured at source ideally via use of automated scanning technology (GS1 GTIN / NTIN standard).


   "lotNumber": "R04X",

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:RXA-15
rim:.participation[typeCode=CSM].role[classCode=INST].scopedRole.scoper[classCode=MMAT].id
cda:ClinicalDocument/component/StructuredBody/component/section/entry/substanceAdministration/consumable/manfacturedProduct/manufacturedMaterial/lotNumberText

expirationDate

0..1

Element Id

Immunization.expirationDate

Short description

Vaccine expiration date

Definition

Shorter date of either:

Manufacturer expiry date of the vaccine
Coronavirus point of care sites will only put in the defrost expiry date

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:RXA-16
rim:.participation[typeCode=CSM].role[classCode=INST].scopedRole.scoper[classCode=MMAT].expirationTime

site

0..1

CodeableConceptBinding

Element Id

Immunization.site

Short description

Body site vaccine was administered

Definition


"site": {
        "coding":  [
            {
                "system": "http://snomed.info/sct",
                "code": "368208006",
                "display": "Left upper arm structure (body structure)"
            }
        ]
    },

Comments

Data Type

Binding

The site at which the vaccine was administered.

UKCoreBodySite (extensible)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:RXR-2
rim:observation.targetSiteCode
cda:ClinicalDocument/component/StructuredBody/component/section/entry/substanceAdministration/approachSiteCode/code

coding

1..*

There are no (further) constraints on this element

Element Id

Immunization.site.coding

Short description

Code defined by a terminology system

Definition

A reference to a code defined by a terminology system.

Requirements

Allows for alternative encodings within a code system, and translations to other code systems.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
rim:CV
orim:fhir:Coding rdfs:subClassOf dt:CDCoding
v2:C*E.1-8, C*E.10-22
rim:union(., ./translation)
orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

system

1..1

There are no (further) constraints on this element

Element Id

Immunization.site.coding.system

Short description

Identity of the terminology system

Definition

The identification of the code system that defines the meaning of the symbol in the code.

Requirements

Need to be unambiguous about the source of the definition of the symbol.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.3
rim:./codeSystem
orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

version

0..1

There are no (further) constraints on this element

Element Id

Immunization.site.coding.version

Short description

Version of the system - if relevant

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.7
rim:./codeSystemVersion
orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

code

1..1

There are no (further) constraints on this element

Element Id

Immunization.site.coding.code

Short description

Symbol in syntax defined by the system

Definition

A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

Requirements

Need to refer to a particular code in the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.1
rim:./code
orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

display

1..1

There are no (further) constraints on this element

Element Id

Immunization.site.coding.display

Short description

Representation defined by the system

Definition

A representation of the meaning of the code in the system, following the rules of the system.

Requirements

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.2 - but note this is not well followed
rim:CV.displayName
orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

userSelected

0..1

There are no (further) constraints on this element

Element Id

Immunization.site.coding.userSelected

Short description

If this coding was chosen directly by the user

Definition

Indicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).

Requirements

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:Sometimes implied by being first
rim:CD.codingRationale
orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

text

0..1

There are no (further) constraints on this element

Element Id

Immunization.site.text

Short description

Plain text representation of the concept

Definition

A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.

Requirements

Comments

Very often the text is the same as a displayName of one of the codings.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.9. But note many systems use C*E.2 for this
rim:./originalText[mediaType/code="text/plain"]/data
orim:fhir:CodeableConcept.text rdfs:subPropertyOf dt:CD.originalText

route

0..1

CodeableConceptBinding

Element Id

Immunization.route

Short description

How vaccine entered body

Definition


 "route": {
        "coding":  [
            {
                "system": "http://snomed.info/sct",
                "code": "78421000",
                "display": "Intramuscular route (qualifier value)"
            }
        ]
    },

Comments

Data Type

UKCoreSubstanceOrProductAdministrationRoute (preferred)

Binding

The route by which the vaccine was administered.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:RXR-1
rim:.routeCode
cda:ClinicalDocument/component/StructuredBody/component/section/entry/substanceAdministration/routeCode/code

doseQuantity

S I

0..1

Element Id

Immunization.doseQuantity

Short description

Amount of vaccine administered

Definition

A dm+d (SNOMED) Concept ID value representing the Unit of measure used.

For COVID-19 a reference set has been published here: https://dd4c.digital.nhs.uk/dd4c/publishedmetadatas/intid/980?size=10


 "doseQuantity": {
        "value": 1,
        "unit": "pre-filled disposable injection",
        "system": "http://snomed.info/sct",
        "code": "3318611000001100"
    },

Comments

The context of use may frequently define what kind of quantity this is and therefore what kind of units can be used. The context of use may also restrict the values for the comparator.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
qty-3:If a code for the unit is present, the system SHALL also be present
code.empty() or system.exists()
sqty-1:The comparator is not used on a SimpleQuantity
comparator.empty()

Mappings

rim:n/a
v2:SN (see also Range) or CQ
rim:PQ, IVL<PQ>, MO, CO, depending on the values
v2:RXA-6 / RXA-7
rim:.doseQuantity

performer

S Σ

0..*

Element Id

Immunization.performer

Short description

Who performed event

Definition

Vaccination professional should be recorded using professional codes, see NHSDigital-Practitioner for details.


"performer":  [
        {
            "actor": {
                "type": "Practitioner",
                "identifier": {
                    "system": "https://fhir.hl7.org.uk/Id/nmc-number",
                    "value": "5566789"
                },
                "display": "HOLDING, Rafferty"
            }
        },
        {
            "actor": {
                "type": "Organization",
                "identifier": {
                    "system": "https://fhir.nhs.uk/Id/ods-organization-code",
                    "value": "C4B2A"
                },
                "display": "ELLAND ROAD STADIUM - COVID VACCINATION CENTRE"
            }
        }
    ],

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
workflow:Event.performer
v2:ORC-12 / RXA-10
rim:.participation[typeCode=PRF].role[scoper.determinerCode=INSTANCE]

function

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

Immunization.performer.function

Short description

What type of performance was done

Definition

Describes the type of performance (e.g. ordering provider, administering provider, etc.).

Comments

Data Type

ImmunizationFunctionCodes (extensible)

Binding

The role a practitioner or organization plays in the immunization event.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
workflow:Event.performer.function
rim:.participation.functionCode

actor

S Σ I

1..1

NHSDigitalReference(NHSDigitalOrganization | NHSDigitalPractitionerRole | NHSDigitalPractitioner)

Element Id

Immunization.performer.actor

Short description

A reference from one resource to another

Definition

A reference from one resource to another.

Comments

Data Type

NHSDigitalReference(NHSDigitalOrganization | NHSDigitalPractitionerRole | NHSDigitalPractitioner)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))
usercode-reference:An identifier reference or resource reference must be provided
(reference.exists() or identifier.exists())
usercode-nmc:NMC must be of the format NNANNNNA
identifier.exists().not() or identifier.where(system='https://fhir.hl7.org.uk/Id/nmc-number').exists().not() or (identifier.where(system='https://fhir.hl7.org.uk/Id/nmc-number').exists() and identifier.where(system='https://fhir.hl7.org.uk/Id/nmc-number').value.matches('^[0-9]{2}[A-Z]{1}[0-9]{4}[A-Z]{1}$'))
usercode-gmp:GMP must be of the format GNNNNNNN and not be a spurious code (starts with G6 or G7)
identifier.exists().not() or identifier.where(system='https://fhir.hl7.org.uk/Id/gmp-number').exists().not() or (identifier.where(system='https://fhir.hl7.org.uk/Id/gmp-number').exists() and identifier.where(system='https://fhir.hl7.org.uk/Id/gmp-number').value.matches('^[G]{1}[01234589]{1}[0-9]{6}$'))
usercode-gmc:GMC must be of the format CNNNNNNN
identifier.exists().not() or identifier.where(system='https://fhir.hl7.org.uk/Id/gmc-number').exists().not() or (identifier.where(system='https://fhir.hl7.org.uk/Id/gmc-number').exists() and identifier.where(system='https://fhir.hl7.org.uk/Id/gmc-number').value.matches('^[C]{1}[0-9]{7}$'))
usercode-gphc:GPHC must be of the format NNNNNNN
identifier.exists().not() or identifier.where(system='https://fhir.hl7.org.uk/Id/gphc-number').exists().not() or (identifier.where(system='https://fhir.hl7.org.uk/Id/gphc-number').exists() and identifier.where(system='https://fhir.hl7.org.uk/Id/gphc-number').value.matches('^[0-9]{7}$'))
usercode-hcpc:HCPC must be of the format AANNNNNN
identifier.exists().not() or identifier.where(system='https://fhir.hl7.org.uk/Id/hcpc-number').exists().not() or (identifier.where(system='https://fhir.hl7.org.uk/Id/hcpc-number').exists() and identifier.where(system='https://fhir.hl7.org.uk/Id/hcpc-number').value.matches('^[A-Z]{2}[0-9]{6}$'))
usercode-din:DIN format must be NNNNNN
identifier.exists().not() or identifier.where(system='https://fhir.hl7.org.uk/Id/din-number').exists().not() or (identifier.where(system='https://fhir.hl7.org.uk/Id/din-number').exists() and identifier.where(system='https://fhir.hl7.org.uk/Id/din-number').value.matches('^[0-9]{6}$'))
role-sds-role-profile:SDS Role Profile Id must be 12 digits
identifier.where(system='https://fhir.nhs.uk/Id/sds-role-profile-id').exists().not() or (identifier.where(system='https://fhir.nhs.uk/Id/sds-role-profile-id').exists() and identifier.where(system='https://fhir.nhs.uk/Id/sds-role-profile-id').value.matches('^[0-9]{12}$'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
workflow:Event.performer.actor
w5:FiveWs.actor
rim:.player

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.performer.actor.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

1..1

uriBinding

There are no (further) constraints on this element

Element Id

Immunization.performer.actor.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

Aa resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

Immunization.performer.actor.identifier

Short description

An identifier intended for computation

Definition

An identifier - identifies some entity uniquely and unambiguously. Typically this is used for business identifiers.

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

Immunization.performer.actor.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

Immunization.performer.actor.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

NHSDigital Identifier Type (required)

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

1..1

There are no (further) constraints on this element

Element Id

Immunization.performer.actor.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

1..1

There are no (further) constraints on this element

Element Id

Immunization.performer.actor.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.performer.actor.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.performer.actor.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

Immunization.performer.actor.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

note

0..*

There are no (further) constraints on this element

Element Id

Immunization.note

Short description

Additional immunization notes

Definition

Extra information about the immunization that is not conveyed by the other attributes.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Act
workflow:Event.note
v2:OBX-5 : OBX-3 = 48767-8
rim:note

author[x]

0..1

There are no (further) constraints on this element

Element Id

Immunization.note.author[x]

Short description

Individual responsible for the annotation

Definition

The individual responsible for making the annotation.

Comments

Organization is used when there's no need for specific attribution as to who made the comment.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Act.participant[typeCode=AUT].role

authorString

There are no (further) constraints on this element

Data Type

authorReference

Reference(UK Core Practitioner | UK Core Patient | UK Core RelatedPerson | UK Core Organization)

There are no (further) constraints on this element

Data Type

Reference(UK Core Practitioner | UK Core Patient | UK Core RelatedPerson | UK Core Organization)

time

0..1

There are no (further) constraints on this element

Element Id

Immunization.note.time

Short description

When the annotation was made

Definition

Indicates when this particular annotation was made.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Act.effectiveTime

text

1..1

There are no (further) constraints on this element

Element Id

Immunization.note.text

Short description

The annotation - text content (as markdown)

Definition

The text of the annotation in markdown format.

Comments

Systems are not required to have markdown support, so the text should be readable without markdown processing. The markdown syntax is GFM - see https://github.github.com/gfm/

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Act.text

reasonCode

0..*

CodeableConceptBinding

Element Id

Immunization.reasonCode

Short description

Why immunization occurred

Definition

A SNOMED Concept Id. For COVID19 and Flu see https://digital.nhs.uk/developer/api-catalogue/vaccination

Comments

Data Type

NHS Digital Immunization Explanation Reason (extensible)

Binding

The reason why a vaccine was administered.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
workflow:Event.reasonCode
rim:[actionNegationInd=false].reasonCode

coding

S Σ

1..*

There are no (further) constraints on this element

Element Id

Immunization.reasonCode.coding

Short description

Code defined by a terminology system

Definition

A reference to a code defined by a terminology system.

Requirements

Allows for alternative encodings within a code system, and translations to other code systems.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
rim:CV
orim:fhir:Coding rdfs:subClassOf dt:CDCoding
v2:C*E.1-8, C*E.10-22
rim:union(., ./translation)
orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

system

1..1

There are no (further) constraints on this element

Element Id

Immunization.reasonCode.coding.system

Short description

Identity of the terminology system

Definition

The identification of the code system that defines the meaning of the symbol in the code.

Requirements

Need to be unambiguous about the source of the definition of the symbol.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.3
rim:./codeSystem
orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

version

0..1

There are no (further) constraints on this element

Element Id

Immunization.reasonCode.coding.version

Short description

Version of the system - if relevant

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.7
rim:./codeSystemVersion
orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

code

1..1

There are no (further) constraints on this element

Element Id

Immunization.reasonCode.coding.code

Short description

Symbol in syntax defined by the system

Definition

A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

Requirements

Need to refer to a particular code in the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.1
rim:./code
orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

display

1..1

There are no (further) constraints on this element

Element Id

Immunization.reasonCode.coding.display

Short description

Representation defined by the system

Definition

A representation of the meaning of the code in the system, following the rules of the system.

Requirements

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.2 - but note this is not well followed
rim:CV.displayName
orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

userSelected

0..1

There are no (further) constraints on this element

Element Id

Immunization.reasonCode.coding.userSelected

Short description

If this coding was chosen directly by the user

Definition

Indicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).

Requirements

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:Sometimes implied by being first
rim:CD.codingRationale
orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

text

0..1

There are no (further) constraints on this element

Element Id

Immunization.reasonCode.text

Short description

Plain text representation of the concept

Definition

A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.

Requirements

Comments

Very often the text is the same as a displayName of one of the codings.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.9. But note many systems use C*E.2 for this
rim:./originalText[mediaType/code="text/plain"]/data
orim:fhir:CodeableConcept.text rdfs:subPropertyOf dt:CD.originalText

reasonReference

0..*

Reference(UK Core Condition | UK Core Observation | UK Core DiagnosticReport)

There are no (further) constraints on this element

Element Id

Immunization.reasonReference

Short description

Why immunization occurred

Definition

Condition, Observation or DiagnosticReport that supports why the immunization was administered.

Comments

Data Type

Reference(UK Core Condition | UK Core Observation | UK Core DiagnosticReport)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
workflow:Event.reasonReference
rim:N/A

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.reasonReference.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

Immunization.reasonReference.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

A resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

Immunization.reasonReference.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

Immunization.reasonReference.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

Immunization.reasonReference.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

Immunization.reasonReference.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

Immunization.reasonReference.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.reasonReference.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.reasonReference.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

Immunization.reasonReference.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

isSubpotent

Σ ?!

0..1

There are no (further) constraints on this element

Element Id

Immunization.isSubpotent

Short description

Dose potency

Definition

Indication if a dose is considered to be subpotent. By default, a dose should be considered to be potent.

Comments

Meaning When Missing

By default, a dose should be considered to be potent.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:RXA-20 = PA (partial administration)
rim:N/A

subpotentReason

0..*

There are no (further) constraints on this element

Element Id

Immunization.subpotentReason

Short description

Reason for being subpotent

Definition

Reason why a dose is considered to be subpotent.

Comments

Data Type

ImmunizationSubpotentReason (example)

Binding

The reason why a dose is considered to be subpotent.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
rim:N/A

education

0..*

There are no (further) constraints on this element

Element Id

Immunization.education

Short description

Educational material presented to patient

Definition

Educational material presented to the patient (or guardian) at the time of vaccine administration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
imm-1:One of documentType or reference SHALL be present
documentType.exists() or reference.exists()

Mappings

rim:n/a
rim:N/A

documentType

0..1

There are no (further) constraints on this element

Element Id

Immunization.education.documentType

Short description

Educational material document identifier

Definition

Identifier of the material presented to the patient.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:OBX-5 : OBX-3 = 69764-9
rim:N/A

reference

0..1

There are no (further) constraints on this element

Element Id

Immunization.education.reference

Short description

Educational material reference pointer

Definition

Reference pointer to the educational material given to the patient if the information was on line.

Comments

see http://en.wikipedia.org/wiki/Uniform_resource_identifier

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

publicationDate

0..1

There are no (further) constraints on this element

Element Id

Immunization.education.publicationDate

Short description

Educational material publication date

Definition

Date the educational material was published.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:OBX-5 : OBX-3 = 29768-9
rim:N/A

presentationDate

0..1

There are no (further) constraints on this element

Element Id

Immunization.education.presentationDate

Short description

Educational material presentation date

Definition

Date the educational material was given to the patient.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:OBX-5 : OBX-3 = 29769-7
rim:N/A

programEligibility

0..*

There are no (further) constraints on this element

Element Id

Immunization.programEligibility

Short description

Patient eligibility for a vaccination program

Definition

Indicates a patient's eligibility for a funding program.

Comments

Data Type

ImmunizationProgramEligibility (example)

Binding

The patient's eligibility for a vaccation program.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:OBX-5 : OBX-3 = 64994-7
rim:N/A

fundingSource

0..1

There are no (further) constraints on this element

Element Id

Immunization.fundingSource

Short description

Funding source for the vaccine

Definition

Comments

Data Type

ImmunizationFundingSource (example)

Binding

The source of funding used to purchase the vaccine administered.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
rim:N/A

reaction

0..*

There are no (further) constraints on this element

Element Id

Immunization.reaction

Short description

Details of a reaction that follows immunization

Definition

Categorical data indicating that an adverse event is associated in time to an immunization.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:OBX-3
rim:Observation[classCode=obs].code

date

0..1

There are no (further) constraints on this element

Element Id

Immunization.reaction.date

Short description

When reaction started

Definition

Date of reaction to the immunization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2: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)
rim:.effectiveTime

detail

0..1

There are no (further) constraints on this element

Element Id

Immunization.reaction.detail

Short description

Additional information on reaction

Definition

Details of the reaction.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:OBX-5
rim:.value

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.reaction.detail.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

Immunization.reaction.detail.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

A resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

Immunization.reaction.detail.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

Immunization.reaction.detail.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

Immunization.reaction.detail.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

Immunization.reaction.detail.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

Immunization.reaction.detail.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.reaction.detail.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.reaction.detail.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

Immunization.reaction.detail.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

reported

0..1

There are no (further) constraints on this element

Element Id

Immunization.reaction.reported

Short description

Indicates self-reported reaction

Definition

Self-reported indicator.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:(HL7 v2 doesn't seem to provide for this)
rim:.participation[typeCode=INF].role[classCode=PAT] (this syntax for self-reported=true)

protocolApplied

0..*

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied

Short description

Protocol followed by the provider

Definition

The protocol (set of recommendations) being followed by the provider who administered the dose.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

series

0..1

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied.series

Short description

Name of vaccine series

Definition

One possible path to achieve presumed immunity against a disease - within the context of an authority.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

authority

0..1

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied.authority

Short description

Who is responsible for publishing the recommendations

Definition

Indicates the authority who published the protocol (e.g. ACIP) that is being followed.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
rim:N/A

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied.authority.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied.authority.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

A resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied.authority.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied.authority.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied.authority.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied.authority.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied.authority.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied.authority.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied.authority.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied.authority.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

targetDisease

0..*

CodeableConceptBinding

Element Id

Immunization.protocolApplied.targetDisease

Short description

Vaccine preventatable disease being targetted

Definition

The vaccine preventable disease the dose is being administered against.

Comments

Data Type

http://hl7.eu/fhir/ig/dgc/ValueSet/covid-19-diseases (required)

Binding

(Work in progress) The vaccine preventable disease the dose is being administered for.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
rim:N/A

doseNumber[x]

1..1

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied.doseNumber[x]

Short description

Dose number within series

Definition

Nominal position in a series.

Comments

The use of an integer is preferred if known. A string should only be used in cases where an integer is not available (such as when documenting a recurring booster dose).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

doseNumberPositiveInt

There are no (further) constraints on this element

Data Type

doseNumberString

There are no (further) constraints on this element

Data Type

seriesDoses[x]

0..1

There are no (further) constraints on this element

Element Id

Immunization.protocolApplied.seriesDoses[x]

Short description

Recommended number of doses for immunity

Definition

The recommended number of doses to achieve immunity.

Comments

The use of an integer is preferred if known. A string should only be used in cases where an integer is not available (such as when documenting a recurring booster dose).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

seriesDosesPositiveInt

There are no (further) constraints on this element

Data Type

seriesDosesString

There are no (further) constraints on this element

Data Type