SMART Health Cards: Vaccination & Testing Implementation Guide
1.0.0 - STU 1 International flag

SMART Health Cards: Vaccination & Testing Implementation Guide, published by HL7 International / Public Health. This guide is not an authorized publication; it is the continuous build for version 1.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhir-shc-vaccination-ig/ and changes regularly. See the Directory of published versions

Resource Profile: Patient Profile - United States - Data Minimization

Official URL: http://hl7.org/fhir/uv/shc-vaccination/StructureDefinition/shc-patient-us-dm Version: 1.0.0
Standards status: Trial-use Maturity Level: 4 Computable Name: SHCPatientUnitedStatesDM

Defines a primary (DM) profile representing a patient in a health card related to infectious disease vaccination and testing issued in the United States.

See here for implementation details.

Start here!
Profile Group: Patient

Description:

For representing the minimal information needed to identify a patient in a SMART Health Card.

Primary profile (DM) Fallback profile (AD) Scope of profile pair
Patient - General Fallback For general use where no geographic-specific profile exists
Patient - United States Fallback United States only
For more information about the types of profiles in this IG, see the profiles page.

Usages:

  • This Profile is not used by any profiles in this Implementation Guide

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Patient 0..* SHCPatientGeneralDM Information about an individual receiving an individual receiving a vaccination or infectious disease-related laboratory test
... name SΣC 1..1 HumanName Official name (i.e., legal name) of patient
Constraints: vc-name-invariant
.... extension 0..0 Extension
Slice: Unordered, Open by value:url
.... family SΣ 0..1 string Family name (often called 'Surname')
.... given SΣ 0..* string Parts of patient's name other than their family name that appear on photo ID; e.g., first and middle names
This repeating element order: Given Names appear in the correct order for presenting the name
.... prefix SΣ 0..* string Parts that come before the name
This repeating element order: Prefixes appear in the correct order for presenting the name
.... suffix SΣ 0..* string Parts that come after the name
This repeating element order: Suffixes appear in the correct order for presenting the name
... birthDate SΣ 0..1 date The date of birth for the individual

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Patient.telecom.use Base required ContactPointUse 📍4.0.1 FHIR Std.
Patient.address.use Base required AddressUse 📍4.0.1 FHIR Std.
Patient.communication.​language Base preferred Common Languages 📍4.0.1 FHIR Std.
Patient.link.type Base required LinkType 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Patient If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Patient 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-4 error Patient 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-5 error Patient If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Patient A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
vc-name-invariant error Patient.name Require one of the key name elements to be filled. Allows for `text` for names that cannot be cleanly categorized into `family` and `given` (https://www.nature.com/articles/d41586-020-02761-z). (family.exists() and given.exists()) xor text.exists()

This structure is derived from SHCPatientGeneralDM

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Patient 0..* SHCPatientGeneralDM Information about an individual receiving an individual receiving a vaccination or infectious disease-related laboratory test
... identifier 0..0 An identifier for this patient

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Patient 0..* SHCPatientGeneralDM Information about an individual receiving an individual receiving a vaccination or infectious disease-related laboratory test
... name SΣC 1..1 HumanName Official name (i.e., legal name) of patient
Constraints: vc-name-invariant
.... extension 0..0 Extension
Slice: Unordered, Open by value:url
.... text Σ 0..1 string Use instead of `family` and `given` if the patient's name cannot be easily split into these elements
.... family SΣ 0..1 string Family name (often called 'Surname')
.... given SΣ 0..* string Parts of patient's name other than their family name that appear on photo ID; e.g., first and middle names
This repeating element order: Given Names appear in the correct order for presenting the name
.... prefix SΣ 0..* string Parts that come before the name
This repeating element order: Prefixes appear in the correct order for presenting the name
.... suffix SΣ 0..* string Parts that come after the name
This repeating element order: Suffixes appear in the correct order for presenting the name
.... period Σ 0..1 Period Time period when name was/is in use
... gender ΣC 0..1 code Administrative gender
Binding: AdministrativeGender (required): The gender of a person used for administrative purposes.
Constraints: use-only-if-required-by-law
... birthDate SΣ 0..1 date The date of birth for the individual

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Patient.telecom.system Base required ContactPointSystem 📍4.0.1 FHIR Std.
Patient.telecom.use Base required ContactPointUse 📍4.0.1 FHIR Std.
Patient.gender Base required AdministrativeGender 📍4.0.1 FHIR Std.
Patient.address.use Base required AddressUse 📍4.0.1 FHIR Std.
Patient.address.type Base required AddressType 📍4.0.1 FHIR Std.
Patient.contact.relationship Base extensible Patient Contact Relationship 📍4.0.1 FHIR Std.
Patient.contact.gender Base required AdministrativeGender 📍4.0.1 FHIR Std.
Patient.communication.​language Base preferred Common Languages 📍4.0.1 FHIR Std.
Patient.link.type Base required LinkType 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Patient If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Patient 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-4 error Patient 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-5 error Patient If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Patient A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
use-only-if-required-by-law warning Patient.gender SHALL be omitted UNLESS required by law in jurisdiction where SHC is issued $this.length() = 0
vc-name-invariant error Patient.name Require one of the key name elements to be filled. Allows for `text` for names that cannot be cleanly categorized into `family` and `given` (https://www.nature.com/articles/d41586-020-02761-z). (family.exists() and given.exists()) xor text.exists()
vc-should-be-omitted-privacy warning Patient.telecom.value, Patient.address.city, Patient.address.district, Patient.address.state, Patient.address.postalCode SHOULD be omitted to protect privacy and for data minimization. $this.length() = 0

This structure is derived from SHCPatientGeneralDM

Summary

Prohibited: 1 element

Maturity: 4

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Patient 0..* SHCPatientGeneralDM Information about an individual receiving an individual receiving a vaccination or infectious disease-related laboratory test
... name SΣC 1..1 HumanName Official name (i.e., legal name) of patient
Constraints: vc-name-invariant
.... extension 0..0 Extension
Slice: Unordered, Open by value:url
.... family SΣ 0..1 string Family name (often called 'Surname')
.... given SΣ 0..* string Parts of patient's name other than their family name that appear on photo ID; e.g., first and middle names
This repeating element order: Given Names appear in the correct order for presenting the name
.... prefix SΣ 0..* string Parts that come before the name
This repeating element order: Prefixes appear in the correct order for presenting the name
.... suffix SΣ 0..* string Parts that come after the name
This repeating element order: Suffixes appear in the correct order for presenting the name
... birthDate SΣ 0..1 date The date of birth for the individual

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Patient.telecom.use Base required ContactPointUse 📍4.0.1 FHIR Std.
Patient.address.use Base required AddressUse 📍4.0.1 FHIR Std.
Patient.communication.​language Base preferred Common Languages 📍4.0.1 FHIR Std.
Patient.link.type Base required LinkType 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Patient If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Patient 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-4 error Patient 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-5 error Patient If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Patient A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
vc-name-invariant error Patient.name Require one of the key name elements to be filled. Allows for `text` for names that cannot be cleanly categorized into `family` and `given` (https://www.nature.com/articles/d41586-020-02761-z). (family.exists() and given.exists()) xor text.exists()

Differential View

This structure is derived from SHCPatientGeneralDM

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Patient 0..* SHCPatientGeneralDM Information about an individual receiving an individual receiving a vaccination or infectious disease-related laboratory test
... identifier 0..0 An identifier for this patient

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Patient 0..* SHCPatientGeneralDM Information about an individual receiving an individual receiving a vaccination or infectious disease-related laboratory test
... name SΣC 1..1 HumanName Official name (i.e., legal name) of patient
Constraints: vc-name-invariant
.... extension 0..0 Extension
Slice: Unordered, Open by value:url
.... text Σ 0..1 string Use instead of `family` and `given` if the patient's name cannot be easily split into these elements
.... family SΣ 0..1 string Family name (often called 'Surname')
.... given SΣ 0..* string Parts of patient's name other than their family name that appear on photo ID; e.g., first and middle names
This repeating element order: Given Names appear in the correct order for presenting the name
.... prefix SΣ 0..* string Parts that come before the name
This repeating element order: Prefixes appear in the correct order for presenting the name
.... suffix SΣ 0..* string Parts that come after the name
This repeating element order: Suffixes appear in the correct order for presenting the name
.... period Σ 0..1 Period Time period when name was/is in use
... gender ΣC 0..1 code Administrative gender
Binding: AdministrativeGender (required): The gender of a person used for administrative purposes.
Constraints: use-only-if-required-by-law
... birthDate SΣ 0..1 date The date of birth for the individual

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Patient.telecom.system Base required ContactPointSystem 📍4.0.1 FHIR Std.
Patient.telecom.use Base required ContactPointUse 📍4.0.1 FHIR Std.
Patient.gender Base required AdministrativeGender 📍4.0.1 FHIR Std.
Patient.address.use Base required AddressUse 📍4.0.1 FHIR Std.
Patient.address.type Base required AddressType 📍4.0.1 FHIR Std.
Patient.contact.relationship Base extensible Patient Contact Relationship 📍4.0.1 FHIR Std.
Patient.contact.gender Base required AdministrativeGender 📍4.0.1 FHIR Std.
Patient.communication.​language Base preferred Common Languages 📍4.0.1 FHIR Std.
Patient.link.type Base required LinkType 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Patient If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Patient 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-4 error Patient 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-5 error Patient If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Patient A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
use-only-if-required-by-law warning Patient.gender SHALL be omitted UNLESS required by law in jurisdiction where SHC is issued $this.length() = 0
vc-name-invariant error Patient.name Require one of the key name elements to be filled. Allows for `text` for names that cannot be cleanly categorized into `family` and `given` (https://www.nature.com/articles/d41586-020-02761-z). (family.exists() and given.exists()) xor text.exists()
vc-should-be-omitted-privacy warning Patient.telecom.value, Patient.address.city, Patient.address.district, Patient.address.state, Patient.address.postalCode SHOULD be omitted to protect privacy and for data minimization. $this.length() = 0

This structure is derived from SHCPatientGeneralDM

Summary

Prohibited: 1 element

Maturity: 4

 

Other representations of profile: CSV, Excel, Schematron