Clinical Document Architecture
2.0.1 - active

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

Logical Model: CDAR2.SubstanceAdministration - Detailed Descriptions

Active as of 2023-10-03

Definitions for the SubstanceAdministration logical model.

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

0. SubstanceAdministration
Control1..1
XML FormatIn the XML format, this property has the namespace urn:hl7-org:v3.
2. SubstanceAdministration.classCode
Control1..1
BindingThe codes SHALL be taken from ActClass
Typecode(cs: Coded Simple Value)
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
XML FormatIn the XML format, this property is represented as an attribute.
Default ValueSBADM
Fixed ValueSBADM
4. SubstanceAdministration.moodCode
Control1..1
Typecode(cs: Coded Simple Value)
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
XML FormatIn the XML format, this property is represented as an attribute.
6. SubstanceAdministration.realmCode
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/CS
8. SubstanceAdministration.typeId
Control0..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/II
10. SubstanceAdministration.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

Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/II
12. SubstanceAdministration.id
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/II
14. SubstanceAdministration.code
Control0..1
BindingUnless not suitable, these codes SHALL be taken from ActSubstanceAdministrationCode
Typehttp://hl7.org/cda/stds/core/StructureDefinition/CD
16. SubstanceAdministration.negationInd
Control0..1
Typeboolean(bl: Boolean)
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
XML FormatIn the XML format, this property is represented as an attribute.
18. SubstanceAdministration.text
Control0..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/ED
20. SubstanceAdministration.statusCode
Control0..1
BindingThe codes SHALL be taken from ActStatus
Typehttp://hl7.org/cda/stds/core/StructureDefinition/CS
22. SubstanceAdministration.effectiveTime
Control0..*
TypeChoice of: http://hl7.org/cda/stds/core/StructureDefinition/SXCM-TS, http://hl7.org/cda/stds/core/StructureDefinition/IVL-TS, http://hl7.org/cda/stds/core/StructureDefinition/EIVL-TS, http://hl7.org/cda/stds/core/StructureDefinition/PIVL-TS, http://hl7.org/cda/stds/core/StructureDefinition/SXPR-TS
Default Typehttp://hl7.org/cda/stds/core/StructureDefinition/SXCM-TS
XML FormatThe type of this property is determined using the xsi:typeattribute.
24. SubstanceAdministration.priorityCode
Control0..1
BindingUnless not suitable, these codes SHALL be taken from ActPriority
Typehttp://hl7.org/cda/stds/core/StructureDefinition/CE
26. SubstanceAdministration.repeatNumber
Control0..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/IVL-INT
28. SubstanceAdministration.routeCode
Control0..1
BindingUnless not suitable, these codes SHALL be taken from RouteOfAdministration
Typehttp://hl7.org/cda/stds/core/StructureDefinition/CE
30. SubstanceAdministration.approachSiteCode
Control0..*
BindingUnless not suitable, these codes SHALL be taken from v3 Value Set ActSite
Typehttp://hl7.org/cda/stds/core/StructureDefinition/CD
32. SubstanceAdministration.doseQuantity
Control0..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/IVL-PQ
34. SubstanceAdministration.rateQuantity
Control0..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/IVL-PQ
36. SubstanceAdministration.maxDoseQuantity
Control0..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/RTO-PQ-PQ
38. SubstanceAdministration.administrationUnitCode
Control0..1
BindingUnless not suitable, these codes SHALL be taken from AdministrableDrugForm
Typehttp://hl7.org/cda/stds/core/StructureDefinition/CE
40. SubstanceAdministration.consumable
Definition

The consumable participation is used to bring in the LabeledDrug or Material entity that describes the administered substance. The LabeledDrug class, which is an Entity class playing the Role of Manufactured Product, identifies the drug that is consumed in the substance administration. The medication is identified by means of the LabeledDrug.code or the LabeledDrug.name. The Material entity is used to identify non-drug administered substances such as vaccines and blood products.

Control1..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/InfrastructureRoot
42. SubstanceAdministration.consumable.typeCode
Control0..1
BindingThe codes SHALL be taken from ParticipationTargetDirect
Typecode(cs: Coded Simple Value)
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
XML FormatIn the XML format, this property is represented as an attribute.
Fixed ValueCSM
44. SubstanceAdministration.consumable.manufacturedProduct
Control1..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/ManufacturedProduct
46. SubstanceAdministration.subject
Control0..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/Subject
48. SubstanceAdministration.specimen
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/Specimen
50. SubstanceAdministration.performer
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/Performer2
52. SubstanceAdministration.author
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/Author
54. SubstanceAdministration.informant
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/Informant
56. SubstanceAdministration.participant
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/Participant2
58. SubstanceAdministration.entryRelationship
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/EntryRelationship
60. SubstanceAdministration.reference
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/Reference
62. SubstanceAdministration.precondition
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/Precondition

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

0. SubstanceAdministration
Definition

Base definition for all types defined in FHIR type system.

ShortBase for all types and resources
Control10..1*
Is Modifierfalse
XML FormatIn the XML format, this property has the namespace urn:hl7-org:v3.
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
2. SubstanceAdministration.classCode
Control1..1
BindingThe codes SHALL be taken from ActClass
Typecode(cs: Coded Simple Value)
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
XML FormatIn the XML format, this property is represented as an attribute.
Default ValueSBADM
Fixed ValueSBADM
4. SubstanceAdministration.moodCode
Control1..1
Typecode(cs: Coded Simple Value)
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
XML FormatIn the XML format, this property is represented as an attribute.
6. SubstanceAdministration.realmCode
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/CS
8. SubstanceAdministration.typeId
Control0..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/II
10. SubstanceAdministration.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

Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/II
12. SubstanceAdministration.id
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/II
14. SubstanceAdministration.code
Control0..1
BindingUnless not suitable, these codes SHALL be taken from ActSubstanceAdministrationCode
Typehttp://hl7.org/cda/stds/core/StructureDefinition/CD
16. SubstanceAdministration.negationInd
Control0..1
Typeboolean(bl: Boolean)
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
XML FormatIn the XML format, this property is represented as an attribute.
18. SubstanceAdministration.text
Control0..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/ED
20. SubstanceAdministration.statusCode
Control0..1
BindingThe codes SHALL be taken from ActStatus
Typehttp://hl7.org/cda/stds/core/StructureDefinition/CS
22. SubstanceAdministration.effectiveTime
Control0..*
TypeChoice of: http://hl7.org/cda/stds/core/StructureDefinition/SXCM-TS, http://hl7.org/cda/stds/core/StructureDefinition/IVL-TS, http://hl7.org/cda/stds/core/StructureDefinition/EIVL-TS, http://hl7.org/cda/stds/core/StructureDefinition/PIVL-TS, http://hl7.org/cda/stds/core/StructureDefinition/SXPR-TS
Default Typehttp://hl7.org/cda/stds/core/StructureDefinition/SXCM-TS
XML FormatThe type of this property is determined using the xsi:typeattribute.
24. SubstanceAdministration.priorityCode
Control0..1
BindingUnless not suitable, these codes SHALL be taken from ActPriority
Typehttp://hl7.org/cda/stds/core/StructureDefinition/CE
26. SubstanceAdministration.repeatNumber
Control0..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/IVL-INT
28. SubstanceAdministration.routeCode
Control0..1
BindingUnless not suitable, these codes SHALL be taken from RouteOfAdministration
Typehttp://hl7.org/cda/stds/core/StructureDefinition/CE
30. SubstanceAdministration.approachSiteCode
Control0..*
BindingUnless not suitable, these codes SHALL be taken from v3 Value Set ActSite
Typehttp://hl7.org/cda/stds/core/StructureDefinition/CD
32. SubstanceAdministration.doseQuantity
Control0..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/IVL-PQ
34. SubstanceAdministration.rateQuantity
Control0..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/IVL-PQ
36. SubstanceAdministration.maxDoseQuantity
Control0..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/RTO-PQ-PQ
38. SubstanceAdministration.administrationUnitCode
Control0..1
BindingUnless not suitable, these codes SHALL be taken from AdministrableDrugForm
Typehttp://hl7.org/cda/stds/core/StructureDefinition/CE
40. SubstanceAdministration.consumable
Definition

The consumable participation is used to bring in the LabeledDrug or Material entity that describes the administered substance. The LabeledDrug class, which is an Entity class playing the Role of Manufactured Product, identifies the drug that is consumed in the substance administration. The medication is identified by means of the LabeledDrug.code or the LabeledDrug.name. The Material entity is used to identify non-drug administered substances such as vaccines and blood products.

Control1..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/InfrastructureRoot
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
42. SubstanceAdministration.consumable.typeCode
Control0..1
BindingThe codes SHALL be taken from ParticipationTargetDirect
Typecode(cs: Coded Simple Value)
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
XML FormatIn the XML format, this property is represented as an attribute.
Fixed ValueCSM
44. SubstanceAdministration.consumable.manufacturedProduct
Control1..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/ManufacturedProduct
46. SubstanceAdministration.subject
Control0..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/Subject
48. SubstanceAdministration.specimen
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/Specimen
50. SubstanceAdministration.performer
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/Performer2
52. SubstanceAdministration.author
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/Author
54. SubstanceAdministration.informant
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/Informant
56. SubstanceAdministration.participant
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/Participant2
58. SubstanceAdministration.entryRelationship
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/EntryRelationship
60. SubstanceAdministration.reference
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/Reference
62. SubstanceAdministration.precondition
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/Precondition

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

0. SubstanceAdministration
Definition

Base definition for all types defined in FHIR type system.

ShortBase for all types and resources
Control1..1
Is Modifierfalse
XML FormatIn the XML format, this property has the namespace urn:hl7-org:v3.
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
2. SubstanceAdministration.classCode
Control1..1
BindingThe codes SHALL be taken from ActClass
Typecode(cs: Coded Simple Value)
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
XML FormatIn the XML format, this property is represented as an attribute.
Default ValueSBADM
Fixed ValueSBADM
4. SubstanceAdministration.moodCode
Control1..1
Typecode(cs: Coded Simple Value)
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
XML FormatIn the XML format, this property is represented as an attribute.
6. SubstanceAdministration.realmCode
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/CS
8. SubstanceAdministration.typeId
Control0..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/II
10. SubstanceAdministration.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

Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/II
12. SubstanceAdministration.id
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/II
14. SubstanceAdministration.code
Control0..1
BindingUnless not suitable, these codes SHALL be taken from ActSubstanceAdministrationCode
Typehttp://hl7.org/cda/stds/core/StructureDefinition/CD
16. SubstanceAdministration.negationInd
Control0..1
Typeboolean(bl: Boolean)
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
XML FormatIn the XML format, this property is represented as an attribute.
18. SubstanceAdministration.text
Control0..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/ED
20. SubstanceAdministration.statusCode
Control0..1
BindingThe codes SHALL be taken from ActStatus
Typehttp://hl7.org/cda/stds/core/StructureDefinition/CS
22. SubstanceAdministration.effectiveTime
Control0..*
TypeChoice of: http://hl7.org/cda/stds/core/StructureDefinition/SXCM-TS, http://hl7.org/cda/stds/core/StructureDefinition/IVL-TS, http://hl7.org/cda/stds/core/StructureDefinition/EIVL-TS, http://hl7.org/cda/stds/core/StructureDefinition/PIVL-TS, http://hl7.org/cda/stds/core/StructureDefinition/SXPR-TS
Default Typehttp://hl7.org/cda/stds/core/StructureDefinition/SXCM-TS
XML FormatThe type of this property is determined using the xsi:typeattribute.
24. SubstanceAdministration.priorityCode
Control0..1
BindingUnless not suitable, these codes SHALL be taken from ActPriority
Typehttp://hl7.org/cda/stds/core/StructureDefinition/CE
26. SubstanceAdministration.repeatNumber
Control0..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/IVL-INT
28. SubstanceAdministration.routeCode
Control0..1
BindingUnless not suitable, these codes SHALL be taken from RouteOfAdministration
Typehttp://hl7.org/cda/stds/core/StructureDefinition/CE
30. SubstanceAdministration.approachSiteCode
Control0..*
BindingUnless not suitable, these codes SHALL be taken from v3 Value Set ActSite
Typehttp://hl7.org/cda/stds/core/StructureDefinition/CD
32. SubstanceAdministration.doseQuantity
Control0..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/IVL-PQ
34. SubstanceAdministration.rateQuantity
Control0..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/IVL-PQ
36. SubstanceAdministration.maxDoseQuantity
Control0..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/RTO-PQ-PQ
38. SubstanceAdministration.administrationUnitCode
Control0..1
BindingUnless not suitable, these codes SHALL be taken from AdministrableDrugForm
Typehttp://hl7.org/cda/stds/core/StructureDefinition/CE
40. SubstanceAdministration.consumable
Definition

The consumable participation is used to bring in the LabeledDrug or Material entity that describes the administered substance. The LabeledDrug class, which is an Entity class playing the Role of Manufactured Product, identifies the drug that is consumed in the substance administration. The medication is identified by means of the LabeledDrug.code or the LabeledDrug.name. The Material entity is used to identify non-drug administered substances such as vaccines and blood products.

Control1..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/InfrastructureRoot
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
42. SubstanceAdministration.consumable.nullFlavor
Definition

If a value is an exceptional value (NULL-value), this specifies in what way and why proper information is missing.

Control0..1
BindingThe codes SHALL be taken from NullFlavor
Typecode(cs: Coded Simple Value)
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
XML FormatIn the XML format, this property is represented as an attribute.
LabelExceptional Value Detail
44. SubstanceAdministration.consumable.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

Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/CS
46. SubstanceAdministration.consumable.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.

Control0..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/II
48. SubstanceAdministration.consumable.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

Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/II
50. SubstanceAdministration.consumable.typeCode
Control0..1
BindingThe codes SHALL be taken from ParticipationTargetDirect
Typecode(cs: Coded Simple Value)
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
XML FormatIn the XML format, this property is represented as an attribute.
Fixed ValueCSM
52. SubstanceAdministration.consumable.manufacturedProduct
Control1..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/ManufacturedProduct
54. SubstanceAdministration.subject
Control0..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/Subject
56. SubstanceAdministration.specimen
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/Specimen
58. SubstanceAdministration.performer
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/Performer2
60. SubstanceAdministration.author
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/Author
62. SubstanceAdministration.informant
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/Informant
64. SubstanceAdministration.participant
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/Participant2
66. SubstanceAdministration.entryRelationship
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/EntryRelationship
68. SubstanceAdministration.reference
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/Reference
70. SubstanceAdministration.precondition
Control0..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/Precondition