Clinical Document Architecture
2.0.1-sd - release

Clinical Document Architecture, published by Health Level 7. This guide is not an authorized publication; it is the continuous build for version 2.0.1-sd built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/CDA-core-sd/ and changes regularly. See the Directory of published versions

Logical Model: EncompassingEncounter (CDA Class)

Official URL: http://hl7.org/cda/stds/core/StructureDefinition/EncompassingEncounter Version: 2.0.1-sd
Active as of 2025-10-02 Computable Name: EncompassingEncounter

This optional class represents the setting of the clinical encounter during which the documented act(s) or ServiceEvent occurred. Documents are not necessarily generated during an encounter, such as when a clinician, in response to an abnormal lab result, attempts to contact the patient but can't, and writes a Progress Note.

In some cases, the setting of the encounter is inherent in the ClinicalDocument.code, such as where ClinicalDocument.code is "Diabetes Clinic Progress Note". The setting of an encounter can also be transmitted in the HealthCareFacility.code attribute. If HealthCareFacility.code is sent, it should be equivalent to or further specialize the value inherent in the ClinicalDocument.code (such as where the ClinicalDocument.code is simply "Clinic Progress Note" and the value of HealthCareFacility.code is "cardiology clinic"), and shall not conflict with the value inherent in the ClinicalDocument.code, as such a conflict would constitute an ambiguous situation.

EncompassingEncounter.dischargeDispositionCode can be used to depict the disposition of the patient at the time of hospital discharge (e.g., discharged to home, expired, against medical advice, etc.).

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Template Content

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

This structure is derived from InfrastructureRoot

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. EncompassingEncounter 1..1 InfrastructureRoot XML Namespace: urn:hl7-org:v3
Base for all types and resources

Elements defined in Ancestors:@nullFlavor, realmCode, typeId, templateId
Instance of this type are validated by templateId
Logical Container: ClinicalDocument (CDA Class)
... @classCode 0..1 cs Binding: CDAActClass (required)
Fixed Value: ENC
... @moodCode 0..1 cs Binding: CDAActMood (required)
Fixed Value: EVN
... id 0..* II
... effectiveTime 1..1 IVL_TS
... sdtcAdmissionReferralSourceCode 0..1 CE XML Namespace: urn:hl7-org:sdtc
XML: admissionReferralSourceCode (urn:hl7-org:sdtc)
... dischargeDispositionCode 0..1 CE Binding: USEncounterDischargeDisposition (example)
... responsibleParty 0..1 InfrastructureRoot
.... @typeCode 0..1 cs Binding: CDAParticipationType (required)
Fixed Value: RESP
.... assignedEntity 1..1 AssignedEntity
... encounterParticipant 0..* EncounterParticipant
... location 0..1 InfrastructureRoot
.... @typeCode 0..1 cs Binding: ParticipationTargetLocation (required)
Fixed Value: LOC
.... healthCareFacility 1..1 HealthCareFacility

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
EncompassingEncounter.​classCode Base required CDAActClass 📦2.0.1-sd This IG
EncompassingEncounter.​moodCode Base required CDAActMood 📦2.0.1-sd This IG
EncompassingEncounter.​code Base example ActEncounterCode 📦2.0.0 THO v5.2
EncompassingEncounter.​dischargeDispositionCode Base example USEncounterDischargeDisposition 📦2.0.0 THO v5.2
EncompassingEncounter.​responsibleParty.typeCode Base required CDAParticipationType 📦2.0.1-sd This IG
EncompassingEncounter.​location.typeCode Base required ParticipationTargetLocation 📦2.0.0 THO v5.2
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. EncompassingEncounter 1..1 InfrastructureRoot XML Namespace: urn:hl7-org:v3
Base for all types and resources

Elements defined in Ancestors:@nullFlavor, realmCode, typeId, templateId
Instance of this type are validated by templateId
Logical Container: ClinicalDocument (CDA Class)
... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
... realmCode 0..* CS
... typeId C 0..1 II Constraints: II-1
.... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
.... @assigningAuthorityName 0..1 st
.... @displayable 0..1 bl
.... @root 1..1 oid, uuid, ruid Fixed Value: 2.16.840.1.113883.1.3
.... @extension 1..1 st
... @classCode 0..1 cs Binding: CDAActClass (required)
Fixed Value: ENC
... @moodCode 0..1 cs Binding: CDAActMood (required)
Fixed Value: EVN
... id 0..* II
... code 0..1 CE Binding: ActEncounterCode (example)
... effectiveTime 1..1 IVL_TS
... sdtcAdmissionReferralSourceCode 0..1 CE XML Namespace: urn:hl7-org:sdtc
XML: admissionReferralSourceCode (urn:hl7-org:sdtc)
... dischargeDispositionCode 0..1 CE Binding: USEncounterDischargeDisposition (example)
... responsibleParty 0..1 InfrastructureRoot
.... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
.... realmCode 0..* CS
.... typeId C 0..1 II Constraints: II-1
..... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
..... @assigningAuthorityName 0..1 st
..... @displayable 0..1 bl
..... @root 1..1 oid, uuid, ruid Fixed Value: 2.16.840.1.113883.1.3
..... @extension 1..1 st
.... templateId 0..* II
.... @typeCode 0..1 cs Binding: CDAParticipationType (required)
Fixed Value: RESP
.... assignedEntity 1..1 AssignedEntity
... encounterParticipant 0..* EncounterParticipant
... location 0..1 InfrastructureRoot
.... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
.... realmCode 0..* CS
.... typeId C 0..1 II Constraints: II-1
..... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
..... @assigningAuthorityName 0..1 st
..... @displayable 0..1 bl
..... @root 1..1 oid, uuid, ruid Fixed Value: 2.16.840.1.113883.1.3
..... @extension 1..1 st
.... templateId 0..* II
.... @typeCode 0..1 cs Binding: ParticipationTargetLocation (required)
Fixed Value: LOC
.... healthCareFacility 1..1 HealthCareFacility

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
EncompassingEncounter.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd This IG
EncompassingEncounter.​typeId.nullFlavor Base required CDANullFlavor 📦2.0.1-sd This IG
EncompassingEncounter.​classCode Base required CDAActClass 📦2.0.1-sd This IG
EncompassingEncounter.​moodCode Base required CDAActMood 📦2.0.1-sd This IG
EncompassingEncounter.​code Base example ActEncounterCode 📦2.0.0 THO v5.2
EncompassingEncounter.​dischargeDispositionCode Base example USEncounterDischargeDisposition 📦2.0.0 THO v5.2
EncompassingEncounter.​responsibleParty.nullFlavor Base required CDANullFlavor 📦2.0.1-sd This IG
EncompassingEncounter.​responsibleParty.typeId.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd This IG
EncompassingEncounter.​responsibleParty.typeCode Base required CDAParticipationType 📦2.0.1-sd This IG
EncompassingEncounter.​location.nullFlavor Base required CDANullFlavor 📦2.0.1-sd This IG
EncompassingEncounter.​location.typeId.nullFlavor Base required CDANullFlavor 📦2.0.1-sd This IG
EncompassingEncounter.​location.typeCode Base required ParticipationTargetLocation 📦2.0.0 THO v5.2

Constraints

Id Grade Path(s) Description Expression
II-1 error EncompassingEncounter.typeId, EncompassingEncounter.responsibleParty.typeId, EncompassingEncounter.location.typeId An II instance must have either a root or an nullFlavor. root.exists() or nullFlavor.exists()
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. EncompassingEncounter 1..1 InfrastructureRoot XML Namespace: urn:hl7-org:v3
Base for all types and resources

Elements defined in Ancestors:@nullFlavor, realmCode, typeId, templateId
Instance of this type are validated by templateId
Logical Container: ClinicalDocument (CDA Class)
... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
... realmCode 0..* CS
... typeId C 0..1 II Constraints: II-1
.... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
.... @assigningAuthorityName 0..1 st
.... @displayable 0..1 bl
.... @root 1..1 oid, uuid, ruid Fixed Value: 2.16.840.1.113883.1.3
.... @extension 1..1 st
... @classCode 0..1 cs Binding: CDAActClass (required)
Fixed Value: ENC
... @moodCode 0..1 cs Binding: CDAActMood (required)
Fixed Value: EVN
... id 0..* II
... code 0..1 CE Binding: ActEncounterCode (example)
... effectiveTime 1..1 IVL_TS
... sdtcAdmissionReferralSourceCode 0..1 CE XML Namespace: urn:hl7-org:sdtc
XML: admissionReferralSourceCode (urn:hl7-org:sdtc)
... dischargeDispositionCode 0..1 CE Binding: USEncounterDischargeDisposition (example)
... responsibleParty 0..1 InfrastructureRoot
.... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
.... realmCode 0..* CS
.... typeId C 0..1 II Constraints: II-1
..... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
..... @assigningAuthorityName 0..1 st
..... @displayable 0..1 bl
..... @root 1..1 oid, uuid, ruid Fixed Value: 2.16.840.1.113883.1.3
..... @extension 1..1 st
.... templateId 0..* II
.... @typeCode 0..1 cs Binding: CDAParticipationType (required)
Fixed Value: RESP
.... assignedEntity 1..1 AssignedEntity
... encounterParticipant 0..* EncounterParticipant
... location 0..1 InfrastructureRoot
.... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
.... realmCode 0..* CS
.... typeId C 0..1 II Constraints: II-1
..... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
..... @assigningAuthorityName 0..1 st
..... @displayable 0..1 bl
..... @root 1..1 oid, uuid, ruid Fixed Value: 2.16.840.1.113883.1.3
..... @extension 1..1 st
.... templateId 0..* II
.... @typeCode 0..1 cs Binding: ParticipationTargetLocation (required)
Fixed Value: LOC
.... healthCareFacility 1..1 HealthCareFacility

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
EncompassingEncounter.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd This IG
EncompassingEncounter.​typeId.nullFlavor Base required CDANullFlavor 📦2.0.1-sd This IG
EncompassingEncounter.​classCode Base required CDAActClass 📦2.0.1-sd This IG
EncompassingEncounter.​moodCode Base required CDAActMood 📦2.0.1-sd This IG
EncompassingEncounter.​code Base example ActEncounterCode 📦2.0.0 THO v5.2
EncompassingEncounter.​dischargeDispositionCode Base example USEncounterDischargeDisposition 📦2.0.0 THO v5.2
EncompassingEncounter.​responsibleParty.nullFlavor Base required CDANullFlavor 📦2.0.1-sd This IG
EncompassingEncounter.​responsibleParty.typeId.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd This IG
EncompassingEncounter.​responsibleParty.typeCode Base required CDAParticipationType 📦2.0.1-sd This IG
EncompassingEncounter.​location.nullFlavor Base required CDANullFlavor 📦2.0.1-sd This IG
EncompassingEncounter.​location.typeId.nullFlavor Base required CDANullFlavor 📦2.0.1-sd This IG
EncompassingEncounter.​location.typeCode Base required ParticipationTargetLocation 📦2.0.0 THO v5.2

Constraints

Id Grade Path(s) Description Expression
II-1 error EncompassingEncounter.typeId, EncompassingEncounter.responsibleParty.typeId, EncompassingEncounter.location.typeId An II instance must have either a root or an nullFlavor. root.exists() or nullFlavor.exists()

This structure is derived from InfrastructureRoot

Summary

Mandatory: 0 element(3 nested mandatory elements)
Fixed: 4 elements

Structures

This structure refers to these other structures:

Differential View

This structure is derived from InfrastructureRoot

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. EncompassingEncounter 1..1 InfrastructureRoot XML Namespace: urn:hl7-org:v3
Base for all types and resources

Elements defined in Ancestors:@nullFlavor, realmCode, typeId, templateId
Instance of this type are validated by templateId
Logical Container: ClinicalDocument (CDA Class)
... @classCode 0..1 cs Binding: CDAActClass (required)
Fixed Value: ENC
... @moodCode 0..1 cs Binding: CDAActMood (required)
Fixed Value: EVN
... id 0..* II
... effectiveTime 1..1 IVL_TS
... sdtcAdmissionReferralSourceCode 0..1 CE XML Namespace: urn:hl7-org:sdtc
XML: admissionReferralSourceCode (urn:hl7-org:sdtc)
... dischargeDispositionCode 0..1 CE Binding: USEncounterDischargeDisposition (example)
... responsibleParty 0..1 InfrastructureRoot
.... @typeCode 0..1 cs Binding: CDAParticipationType (required)
Fixed Value: RESP
.... assignedEntity 1..1 AssignedEntity
... encounterParticipant 0..* EncounterParticipant
... location 0..1 InfrastructureRoot
.... @typeCode 0..1 cs Binding: ParticipationTargetLocation (required)
Fixed Value: LOC
.... healthCareFacility 1..1 HealthCareFacility

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
EncompassingEncounter.​classCode Base required CDAActClass 📦2.0.1-sd This IG
EncompassingEncounter.​moodCode Base required CDAActMood 📦2.0.1-sd This IG
EncompassingEncounter.​code Base example ActEncounterCode 📦2.0.0 THO v5.2
EncompassingEncounter.​dischargeDispositionCode Base example USEncounterDischargeDisposition 📦2.0.0 THO v5.2
EncompassingEncounter.​responsibleParty.typeCode Base required CDAParticipationType 📦2.0.1-sd This IG
EncompassingEncounter.​location.typeCode Base required ParticipationTargetLocation 📦2.0.0 THO v5.2

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. EncompassingEncounter 1..1 InfrastructureRoot XML Namespace: urn:hl7-org:v3
Base for all types and resources

Elements defined in Ancestors:@nullFlavor, realmCode, typeId, templateId
Instance of this type are validated by templateId
Logical Container: ClinicalDocument (CDA Class)
... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
... realmCode 0..* CS
... typeId C 0..1 II Constraints: II-1
.... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
.... @assigningAuthorityName 0..1 st
.... @displayable 0..1 bl
.... @root 1..1 oid, uuid, ruid Fixed Value: 2.16.840.1.113883.1.3
.... @extension 1..1 st
... @classCode 0..1 cs Binding: CDAActClass (required)
Fixed Value: ENC
... @moodCode 0..1 cs Binding: CDAActMood (required)
Fixed Value: EVN
... id 0..* II
... code 0..1 CE Binding: ActEncounterCode (example)
... effectiveTime 1..1 IVL_TS
... sdtcAdmissionReferralSourceCode 0..1 CE XML Namespace: urn:hl7-org:sdtc
XML: admissionReferralSourceCode (urn:hl7-org:sdtc)
... dischargeDispositionCode 0..1 CE Binding: USEncounterDischargeDisposition (example)
... responsibleParty 0..1 InfrastructureRoot
.... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
.... realmCode 0..* CS
.... typeId C 0..1 II Constraints: II-1
..... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
..... @assigningAuthorityName 0..1 st
..... @displayable 0..1 bl
..... @root 1..1 oid, uuid, ruid Fixed Value: 2.16.840.1.113883.1.3
..... @extension 1..1 st
.... templateId 0..* II
.... @typeCode 0..1 cs Binding: CDAParticipationType (required)
Fixed Value: RESP
.... assignedEntity 1..1 AssignedEntity
... encounterParticipant 0..* EncounterParticipant
... location 0..1 InfrastructureRoot
.... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
.... realmCode 0..* CS
.... typeId C 0..1 II Constraints: II-1
..... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
..... @assigningAuthorityName 0..1 st
..... @displayable 0..1 bl
..... @root 1..1 oid, uuid, ruid Fixed Value: 2.16.840.1.113883.1.3
..... @extension 1..1 st
.... templateId 0..* II
.... @typeCode 0..1 cs Binding: ParticipationTargetLocation (required)
Fixed Value: LOC
.... healthCareFacility 1..1 HealthCareFacility

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
EncompassingEncounter.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd This IG
EncompassingEncounter.​typeId.nullFlavor Base required CDANullFlavor 📦2.0.1-sd This IG
EncompassingEncounter.​classCode Base required CDAActClass 📦2.0.1-sd This IG
EncompassingEncounter.​moodCode Base required CDAActMood 📦2.0.1-sd This IG
EncompassingEncounter.​code Base example ActEncounterCode 📦2.0.0 THO v5.2
EncompassingEncounter.​dischargeDispositionCode Base example USEncounterDischargeDisposition 📦2.0.0 THO v5.2
EncompassingEncounter.​responsibleParty.nullFlavor Base required CDANullFlavor 📦2.0.1-sd This IG
EncompassingEncounter.​responsibleParty.typeId.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd This IG
EncompassingEncounter.​responsibleParty.typeCode Base required CDAParticipationType 📦2.0.1-sd This IG
EncompassingEncounter.​location.nullFlavor Base required CDANullFlavor 📦2.0.1-sd This IG
EncompassingEncounter.​location.typeId.nullFlavor Base required CDANullFlavor 📦2.0.1-sd This IG
EncompassingEncounter.​location.typeCode Base required ParticipationTargetLocation 📦2.0.0 THO v5.2

Constraints

Id Grade Path(s) Description Expression
II-1 error EncompassingEncounter.typeId, EncompassingEncounter.responsibleParty.typeId, EncompassingEncounter.location.typeId An II instance must have either a root or an nullFlavor. root.exists() or nullFlavor.exists()

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. EncompassingEncounter 1..1 InfrastructureRoot XML Namespace: urn:hl7-org:v3
Base for all types and resources

Elements defined in Ancestors:@nullFlavor, realmCode, typeId, templateId
Instance of this type are validated by templateId
Logical Container: ClinicalDocument (CDA Class)
... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
... realmCode 0..* CS
... typeId C 0..1 II Constraints: II-1
.... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
.... @assigningAuthorityName 0..1 st
.... @displayable 0..1 bl
.... @root 1..1 oid, uuid, ruid Fixed Value: 2.16.840.1.113883.1.3
.... @extension 1..1 st
... @classCode 0..1 cs Binding: CDAActClass (required)
Fixed Value: ENC
... @moodCode 0..1 cs Binding: CDAActMood (required)
Fixed Value: EVN
... id 0..* II
... code 0..1 CE Binding: ActEncounterCode (example)
... effectiveTime 1..1 IVL_TS
... sdtcAdmissionReferralSourceCode 0..1 CE XML Namespace: urn:hl7-org:sdtc
XML: admissionReferralSourceCode (urn:hl7-org:sdtc)
... dischargeDispositionCode 0..1 CE Binding: USEncounterDischargeDisposition (example)
... responsibleParty 0..1 InfrastructureRoot
.... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
.... realmCode 0..* CS
.... typeId C 0..1 II Constraints: II-1
..... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
..... @assigningAuthorityName 0..1 st
..... @displayable 0..1 bl
..... @root 1..1 oid, uuid, ruid Fixed Value: 2.16.840.1.113883.1.3
..... @extension 1..1 st
.... templateId 0..* II
.... @typeCode 0..1 cs Binding: CDAParticipationType (required)
Fixed Value: RESP
.... assignedEntity 1..1 AssignedEntity
... encounterParticipant 0..* EncounterParticipant
... location 0..1 InfrastructureRoot
.... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
.... realmCode 0..* CS
.... typeId C 0..1 II Constraints: II-1
..... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
..... @assigningAuthorityName 0..1 st
..... @displayable 0..1 bl
..... @root 1..1 oid, uuid, ruid Fixed Value: 2.16.840.1.113883.1.3
..... @extension 1..1 st
.... templateId 0..* II
.... @typeCode 0..1 cs Binding: ParticipationTargetLocation (required)
Fixed Value: LOC
.... healthCareFacility 1..1 HealthCareFacility

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
EncompassingEncounter.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd This IG
EncompassingEncounter.​typeId.nullFlavor Base required CDANullFlavor 📦2.0.1-sd This IG
EncompassingEncounter.​classCode Base required CDAActClass 📦2.0.1-sd This IG
EncompassingEncounter.​moodCode Base required CDAActMood 📦2.0.1-sd This IG
EncompassingEncounter.​code Base example ActEncounterCode 📦2.0.0 THO v5.2
EncompassingEncounter.​dischargeDispositionCode Base example USEncounterDischargeDisposition 📦2.0.0 THO v5.2
EncompassingEncounter.​responsibleParty.nullFlavor Base required CDANullFlavor 📦2.0.1-sd This IG
EncompassingEncounter.​responsibleParty.typeId.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd This IG
EncompassingEncounter.​responsibleParty.typeCode Base required CDAParticipationType 📦2.0.1-sd This IG
EncompassingEncounter.​location.nullFlavor Base required CDANullFlavor 📦2.0.1-sd This IG
EncompassingEncounter.​location.typeId.nullFlavor Base required CDANullFlavor 📦2.0.1-sd This IG
EncompassingEncounter.​location.typeCode Base required ParticipationTargetLocation 📦2.0.0 THO v5.2

Constraints

Id Grade Path(s) Description Expression
II-1 error EncompassingEncounter.typeId, EncompassingEncounter.responsibleParty.typeId, EncompassingEncounter.location.typeId An II instance must have either a root or an nullFlavor. root.exists() or nullFlavor.exists()

This structure is derived from InfrastructureRoot

Summary

Mandatory: 0 element(3 nested mandatory elements)
Fixed: 4 elements

Structures

This structure refers to these other structures:

 

Other representations of profile: CSV, Excel