CDAPatient - Definitions

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

Logical Model: CDAPatient - Detailed Descriptions

Draft as of 2025-10-22

Definitions for the CDAPatient logical model.

Key Elements Table
Differential Elements Table
Snapshot Elements Table

Guidance on how to interpret the contents of this table can be foundhere

0. Patient
Definition	Defines the basic properties of every data value. This is an abstract type, meaning that no value can be just a data value without belonging to any concrete type. Every concrete type is a specialization of this general abstract DataValue type.
Short	Base for all types and resources
Control	10..1*
Is Modifier	false
Logical Container	ClinicalDocument (CDA Class)
Validation	Instance of this type are validated by templateId
XML Format	In the XML format, this property has the namespace `urn:hl7-org:v3`.
2. Patient.nullFlavor
Definition	If a value is an exceptional value (NULL-value), this specifies in what way and why proper information is missing.
Control	0..1
Binding	The codes SHALL be taken from CDANullFlavor (required to `http://hl7.org/cda/stds/core/ValueSet/CDANullFlavor`)
Type	code(cs: Coded Simple Value)
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
XML Format	In the XML format, this property is represented as an attribute.
Label	Exceptional Value Detail
4. Patient.realmCode
Definition	When valued in an instance, this attribute signals the imposition of realm-specific constraints. The value of this attribute identifies the realm in question
Control	0..*
Type	http://hl7.org/cda/stds/core/StructureDefinition/CS
6. Patient.typeId
Definition	When valued in an instance, this attribute signals the imposition of constraints defined in an HL7-specified message type. This might be a common type (also known as CMET in the messaging communication environment), or content included within a wrapper. The value of this attribute provides a unique identifier for the type in question.
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/II
8. Patient.typeId.nullFlavor
Definition	If a value is an exceptional value (NULL-value), this specifies in what way and why proper information is missing.
Control	0..1
Binding	The codes SHALL be taken from CDANullFlavor (required to `http://hl7.org/cda/stds/core/ValueSet/CDANullFlavor`)
Type	code(cs: Coded Simple Value)
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
XML Format	In the XML format, this property is represented as an attribute.
Label	Exceptional Value Detail
10. Patient.typeId.assigningAuthorityName
Definition	A human readable name or mnemonic for the assigning authority. The Assigning Authority Name has no computational value. The purpose of a Assigning Authority Name is to assist an unaided human interpreter of an II value to interpret the authority. Note: no automated processing must depend on the assigning authority name to be present in any form.
Control	0..1
Type	string(st: Character String)
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
XML Format	In the XML format, this property is represented as an attribute.
Label	Assigning Authority Name
12. Patient.typeId.displayable
Definition	Specifies if the identifier is intended for human display and data entry (displayable = true) as opposed to pure machine interoperation (displayable = false).
Control	0..1
Type	boolean(bl: Boolean)
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
XML Format	In the XML format, this property is represented as an attribute.
Label	Displayable
14. Patient.typeId.root
Definition	Identifies the type as an HL7 Registered model
Control	1..1
Type	string(oid: ISO Object Identifier, uuid: DCE Universal Unique Identifier, ruid: HL7 Reserved Identifier Scheme)
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
XML Format	In the XML format, this property is represented as an attribute.
Label	Root
Fixed Value	`2.16.840.1.113883.1.3`
16. Patient.typeId.extension
Definition	A character string as a unique identifier within the scope of the identifier root.
Control	1..1
Type	string(st: Character String)
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
XML Format	In the XML format, this property is represented as an attribute.
Label	Extension
18. Patient.templateId
Definition	When valued in an instance, this attribute signals the imposition of a set of template-defined constraints. The value of this attribute provides a unique identifier for the templates in question
Control	0..*
Type	http://hl7.org/cda/stds/core/StructureDefinition/II
20. Patient.classCode
Control	0..1
Binding	The codes SHALL be taken from EntityClassLivingSubject (required to `http://terminology.hl7.org/ValueSet/v3-EntityClassLivingSubject`)
Type	code(cs: Coded Simple Value)
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
XML Format	In the XML format, this property is represented as an attribute.
Fixed Value	`PSN`
22. Patient.determinerCode
Control	0..1
Binding	The codes SHALL be taken from EntityDeterminer (required to `http://terminology.hl7.org/ValueSet/v3-EntityDeterminer`)
Type	code(cs: Coded Simple Value)
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
XML Format	In the XML format, this property is represented as an attribute.
Fixed Value	`INSTANCE`
24. Patient.id
Definition	The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes.
Short	Logical id of this artifact
Comments	The only time that a resource does not have an id is when it is being submitted to the server using a create operation.
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/IIid
Is Modifier	false
26. Patient.name
Definition	A name associated with the individual.
Short	A name associated with the patient
Comments	A patient may have multiple names with different uses or applicable periods. For animals, the name is a "HumanName" in the sense that is assigned and used by humans and has the same patterns.
Control	0..*
Type	http://hl7.org/cda/stds/core/StructureDefinition/PNHumanName
Is Modifier	false
Requirements	Need to be able to track the patient by multiple names. Examples are your official name and a partner name.
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
28. Patient.sdtcDesc
Definition	The desc extension allows multimedia depictions of patients, healthcare providers, or other individuals to be included in a CDA document.
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/ED
XML Format	In the XML format, this property has the namespace `urn:hl7-org:sdtc`.In the XML format, this property has the actual name`desc`.
30. Patient.administrativeGenderCode
Control	0..1
Binding	For example codes, see AdministrativeGender (example to `http://terminology.hl7.org/ValueSet/v3-AdministrativeGender`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
32. Patient.birthTime
Control	1..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/TS
34. Patient.sdtcDeceasedInd
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/BL
XML Format	In the XML format, this property has the namespace `urn:hl7-org:sdtc`.In the XML format, this property has the actual name`deceasedInd`.
36. Patient.sdtcDeceasedTime
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/TS
XML Format	In the XML format, this property has the namespace `urn:hl7-org:sdtc`.In the XML format, this property has the actual name`deceasedTime`.
38. Patient.sdtcMultipleBirthInd
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/BL
XML Format	In the XML format, this property has the namespace `urn:hl7-org:sdtc`.In the XML format, this property has the actual name`multipleBirthInd`.
40. Patient.sdtcMultipleBirthOrderNumber
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/INT-POS
XML Format	In the XML format, this property has the namespace `urn:hl7-org:sdtc`.In the XML format, this property has the actual name`multipleBirthOrderNumber`.
42. Patient.maritalStatusCode
Control	0..1
Binding	For example codes, see MaritalStatus (example to `http://terminology.hl7.org/ValueSet/v3-MaritalStatus`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
44. Patient.religiousAffiliationCode
Control	0..1
Binding	For example codes, see ReligiousAffiliation (example to `http://terminology.hl7.org/ValueSet/v3-ReligiousAffiliation`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
46. Patient.raceCode
Control	0..1
Binding	For example codes, see Race (example to `http://terminology.hl7.org/ValueSet/v3-Race`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
48. Patient.sdtcRaceCode
Control	0..*
Binding	For example codes, see Race (example to `http://terminology.hl7.org/ValueSet/v3-Race`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
XML Format	In the XML format, this property has the namespace `urn:hl7-org:sdtc`.In the XML format, this property has the actual name`raceCode`.
50. Patient.ethnicGroupCode
Control	0..1
Binding	For example codes, see Ethnicity (example to `http://terminology.hl7.org/ValueSet/v3-Ethnicity`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
52. Patient.sdtcEthnicGroupCode
Control	0..*
Binding	For example codes, see Ethnicity (example to `http://terminology.hl7.org/ValueSet/v3-Ethnicity`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
XML Format	In the XML format, this property has the namespace `urn:hl7-org:sdtc`.In the XML format, this property has the actual name`ethnicGroupCode`.
54. Patient.guardian
Control	0..*
Type	http://hl7.org/cda/stds/core/StructureDefinition/Guardian
56. Patient.birthplace
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/Birthplace
58. Patient.languageCommunication
Control	0..*
Type	http://hl7.org/cda/stds/core/StructureDefinition/LanguageCommunication

Guidance on how to interpret the contents of this table can be foundhere

0. Patient
Logical Container	ClinicalDocument (CDA Class)
Validation	Instance of this type are validated by templateId
XML Format	In the XML format, this property has the namespace `urn:hl7-org:v3`.
2. Patient.birthTime
Control	1..?

Guidance on how to interpret the contents of this table can be foundhere

0. Patient
Definition	Defines the basic properties of every data value. This is an abstract type, meaning that no value can be just a data value without belonging to any concrete type. Every concrete type is a specialization of this general abstract DataValue type.
Short	Base for all types and resources
Control	1..1
Is Modifier	false
Logical Container	ClinicalDocument (CDA Class)
Validation	Instance of this type are validated by templateId
XML Format	In the XML format, this property has the namespace `urn:hl7-org:v3`.
2. Patient.nullFlavor
Definition	If a value is an exceptional value (NULL-value), this specifies in what way and why proper information is missing.
Control	0..1
Binding	The codes SHALL be taken from CDANullFlavor (required to `http://hl7.org/cda/stds/core/ValueSet/CDANullFlavor`)
Type	code(cs: Coded Simple Value)
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
XML Format	In the XML format, this property is represented as an attribute.
Label	Exceptional Value Detail
4. Patient.realmCode
Definition	When valued in an instance, this attribute signals the imposition of realm-specific constraints. The value of this attribute identifies the realm in question
Control	0..*
Type	http://hl7.org/cda/stds/core/StructureDefinition/CS
6. Patient.typeId
Definition	When valued in an instance, this attribute signals the imposition of constraints defined in an HL7-specified message type. This might be a common type (also known as CMET in the messaging communication environment), or content included within a wrapper. The value of this attribute provides a unique identifier for the type in question.
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/II
8. Patient.typeId.nullFlavor
Definition	If a value is an exceptional value (NULL-value), this specifies in what way and why proper information is missing.
Control	0..1
Binding	The codes SHALL be taken from CDANullFlavor (required to `http://hl7.org/cda/stds/core/ValueSet/CDANullFlavor`)
Type	code(cs: Coded Simple Value)
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
XML Format	In the XML format, this property is represented as an attribute.
Label	Exceptional Value Detail
10. Patient.typeId.assigningAuthorityName
Definition	A human readable name or mnemonic for the assigning authority. The Assigning Authority Name has no computational value. The purpose of a Assigning Authority Name is to assist an unaided human interpreter of an II value to interpret the authority. Note: no automated processing must depend on the assigning authority name to be present in any form.
Control	0..1
Type	string(st: Character String)
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
XML Format	In the XML format, this property is represented as an attribute.
Label	Assigning Authority Name
12. Patient.typeId.displayable
Definition	Specifies if the identifier is intended for human display and data entry (displayable = true) as opposed to pure machine interoperation (displayable = false).
Control	0..1
Type	boolean(bl: Boolean)
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
XML Format	In the XML format, this property is represented as an attribute.
Label	Displayable
14. Patient.typeId.root
Definition	Identifies the type as an HL7 Registered model
Control	1..1
Type	string(oid: ISO Object Identifier, uuid: DCE Universal Unique Identifier, ruid: HL7 Reserved Identifier Scheme)
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
XML Format	In the XML format, this property is represented as an attribute.
Label	Root
Fixed Value	`2.16.840.1.113883.1.3`
16. Patient.typeId.extension
Definition	A character string as a unique identifier within the scope of the identifier root.
Control	1..1
Type	string(st: Character String)
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
XML Format	In the XML format, this property is represented as an attribute.
Label	Extension
18. Patient.templateId
Definition	When valued in an instance, this attribute signals the imposition of a set of template-defined constraints. The value of this attribute provides a unique identifier for the templates in question
Control	0..*
Type	http://hl7.org/cda/stds/core/StructureDefinition/II
20. Patient.classCode
Control	0..1
Binding	The codes SHALL be taken from EntityClassLivingSubject (required to `http://terminology.hl7.org/ValueSet/v3-EntityClassLivingSubject`)
Type	code(cs: Coded Simple Value)
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
XML Format	In the XML format, this property is represented as an attribute.
Fixed Value	`PSN`
22. Patient.determinerCode
Control	0..1
Binding	The codes SHALL be taken from EntityDeterminer (required to `http://terminology.hl7.org/ValueSet/v3-EntityDeterminer`)
Type	code(cs: Coded Simple Value)
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
XML Format	In the XML format, this property is represented as an attribute.
Fixed Value	`INSTANCE`
24. Patient.id
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/II
26. Patient.name
Control	0..*
Type	http://hl7.org/cda/stds/core/StructureDefinition/PN
28. Patient.sdtcDesc
Definition	The desc extension allows multimedia depictions of patients, healthcare providers, or other individuals to be included in a CDA document.
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/ED
XML Format	In the XML format, this property has the namespace `urn:hl7-org:sdtc`.In the XML format, this property has the actual name`desc`.
30. Patient.administrativeGenderCode
Control	0..1
Binding	For example codes, see AdministrativeGender (example to `http://terminology.hl7.org/ValueSet/v3-AdministrativeGender`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
32. Patient.birthTime
Control	1..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/TS
34. Patient.sdtcDeceasedInd
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/BL
XML Format	In the XML format, this property has the namespace `urn:hl7-org:sdtc`.In the XML format, this property has the actual name`deceasedInd`.
36. Patient.sdtcDeceasedTime
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/TS
XML Format	In the XML format, this property has the namespace `urn:hl7-org:sdtc`.In the XML format, this property has the actual name`deceasedTime`.
38. Patient.sdtcMultipleBirthInd
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/BL
XML Format	In the XML format, this property has the namespace `urn:hl7-org:sdtc`.In the XML format, this property has the actual name`multipleBirthInd`.
40. Patient.sdtcMultipleBirthOrderNumber
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/INT-POS
XML Format	In the XML format, this property has the namespace `urn:hl7-org:sdtc`.In the XML format, this property has the actual name`multipleBirthOrderNumber`.
42. Patient.maritalStatusCode
Control	0..1
Binding	For example codes, see MaritalStatus (example to `http://terminology.hl7.org/ValueSet/v3-MaritalStatus`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
44. Patient.religiousAffiliationCode
Control	0..1
Binding	For example codes, see ReligiousAffiliation (example to `http://terminology.hl7.org/ValueSet/v3-ReligiousAffiliation`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
46. Patient.raceCode
Control	0..1
Binding	For example codes, see Race (example to `http://terminology.hl7.org/ValueSet/v3-Race`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
48. Patient.sdtcRaceCode
Control	0..*
Binding	For example codes, see Race (example to `http://terminology.hl7.org/ValueSet/v3-Race`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
XML Format	In the XML format, this property has the namespace `urn:hl7-org:sdtc`.In the XML format, this property has the actual name`raceCode`.
50. Patient.ethnicGroupCode
Control	0..1
Binding	For example codes, see Ethnicity (example to `http://terminology.hl7.org/ValueSet/v3-Ethnicity`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
52. Patient.sdtcEthnicGroupCode
Control	0..*
Binding	For example codes, see Ethnicity (example to `http://terminology.hl7.org/ValueSet/v3-Ethnicity`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
XML Format	In the XML format, this property has the namespace `urn:hl7-org:sdtc`.In the XML format, this property has the actual name`ethnicGroupCode`.
54. Patient.guardian
Control	0..*
Type	http://hl7.org/cda/stds/core/StructureDefinition/Guardian
56. Patient.birthplace
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/Birthplace
58. Patient.languageCommunication
Control	0..*
Type	http://hl7.org/cda/stds/core/StructureDefinition/LanguageCommunication