Consolidated CDA (C-CDA)
4.0.0 - STU4 United States of America flag

Consolidated CDA (C-CDA), published by Health Level Seven. This guide is not an authorized publication; it is the continuous build for version 4.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/CDA-ccda/ and changes regularly. See the Directory of published versions

Logical Model: Planned Medication Activity

Official URL: http://hl7.org/cda/us/ccda/StructureDefinition/PlannedMedicationActivity Version: 4.0.0
Draft as of 2025-10-02 Computable Name: PlannedMedicationActivity
Other Identifiers: urn:ietf:rfc:3986#Uniform Resource Identifier (URI)#urn:hl7ii:2.16.840.1.113883.10.20.22.4.42:2014-06-09

This template represents planned medication activities. The priority of the medication activity to the patient and provider is communicated through Priority Preference. The effectiveTime indicates the time when the medication activity is intended to take place. The authorTime indicates when the documentation of the plan occurred.

Templates Used

Although open templates may contain any valid CDA content, the following templates are specifically called out by this template:

Optional EntryRelationships: Indication, InstructionObservation, PriorityPreference

Usages:

You can also check for usages in the FHIR IG Statistics

Changes since version 3.0.0:

  • New Content

    • Formal Views of Template Content

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

    This structure is derived from SubstanceAdministration

    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. SubstanceAdministration C 1..1 SubstanceAdministration XML Namespace: urn:hl7-org:v3
    Base for all types and resources
    Instance of this type are validated by templateId
    Logical Container: ClinicalDocument (CDA Class)
    Constraints: should-text-ref-value, dose-unit-or-admin-unit, should-author
    ... Slices for templateId 1..* II Slice: Unordered, Open by value:root, value:extension
    .... templateId:planned-med-activity 1..1 II
    ..... @root 1..1 oid, uuid, ruid Required Pattern: 2.16.840.1.113883.10.20.22.4.42
    ..... @extension 1..1 st Required Pattern: 2014-06-09
    ... @classCode 1..1 cs
    ... @moodCode 1..1 cs Binding: Planned moodCode (SubstanceAdministration/Supply) . (required)
    ... text 0..1 ED SHOULD reference the portion of section narrative text corresponding to this entry
    .... reference C 0..1 TEL Constraints: value-starts-octothorpe
    ... statusCode 1..1 CS
    .... @code 1..1 cs Fixed Value: active
    ... Slices for effectiveTime 1..* SXCM_TS, IVL_TS, EIVL_TS, PIVL_TS, SXPR_TS Slice: Unordered, Open by type:$this
    .... effectiveTime:duration C 1..1 IVL_TS The effectiveTime in a planned medication activity represents the time that the medication activity should occur.
    Constraints: 1098-32890, should-value-att, should-low
    ..... @value 0..1 ts indicates a single-administration timestamp
    ..... low 0..1 IVXB_TS indicates when medication started
    ..... high 0..1 IVXB_TS indicates when medication stopped
    .... effectiveTime:periodicFrequency 0..1 EIVL_TS This effectiveTime represents a periodic medication frequency (e.g., administration times per day).
    ..... @operator 1..1 cs Required Pattern: A
    .... effectiveTime:eventFrequency 0..1 PIVL_TS This effectiveTime represents an event-based medication frequency (e.g., administration at bedtime).
    ..... @operator 1..1 cs Required Pattern: A
    ... repeatNumber 0..1 IVL_INT In a Planned Medication Activity, repeatNumber defines the number of allowed administrations. For example, a repeatNumber of "3" means that the substance can be administered up to 3 times.
    ... routeCode C 0..1 CE Binding: SPL Drug Route of Administration Terminology . (required)
    Constraints: should-translation
    .... translation 0..* CD Binding: Medication Route . (preferred)
    ... approachSiteCode 0..* CD Binding: Body Site Value Set . (required)
    ... doseQuantity C 0..1 IVL_PQ Constraints: should-unit
    .... @unit 0..1 cs NOTE: The base CDA R2.0 standard requires @unit to be drawn from UCUM, and best practice is to use case sensitive UCUM units
    Binding: UnitsOfMeasureCaseSensitive (preferred)
    ... rateQuantity C 0..1 IVL_PQ Constraints: should-unit
    .... @unit 0..1 cs NOTE: The base CDA R2.0 standard requires @unit to be drawn from UCUM, and best practice is to use case sensitive UCUM units
    Binding: UnitsOfMeasureCaseSensitive (required)
    ... maxDoseQuantity 0..1 RTO_PQ_PQ
    ... administrationUnitCode 0..1 CE Binding: AdministrationUnitDoseForm . (required)
    ... consumable 1..1 InfrastructureRoot
    .... manufacturedProduct 1..1 MedicationInformation
    ... performer 0..* Performer2 The clinician who is expected to perform the medication activity could be identified using substanceAdministration/performer.
    ... author 0..1 AuthorParticipation The author in a planned medication activity represents the clinician who is requesting or planning the medication activity.
    ... Slices for entryRelationship 0..* EntryRelationship Slice: Unordered, Open by profile:observation
    .... entryRelationship:priorityPreference 0..* EntryRelationship The following entryRelationship represents the priority that a patient or a provider places on the planned medication activity.
    ..... @typeCode 1..1 cs Fixed Value: REFR
    ..... observation 1..1 PriorityPreference
    .... entryRelationship:indication 0..* EntryRelationship The following entryRelationship represents the indication for the planned medication activity.
    ..... @typeCode 1..1 cs Fixed Value: RSON
    ..... observation 1..1 Indication
    .... entryRelationship:instruction 0..* EntryRelationship The following entryRelationship captures any instructions associated with the planned medication activity.
    ..... @typeCode 1..1 cs Fixed Value: SUBJ
    ..... observation 1..1 InstructionObservation
    ... precondition 0..* Precondition
    .... @typeCode 1..1 cs
    .... criterion 1..1 PreconditionforSubstanceAdministration

    doco Documentation for this format

    Terminology Bindings (Differential)

    Path Status Usage ValueSet Version Source
    SubstanceAdministration.​moodCode Base required Planned moodCode (SubstanceAdministration/Supply) . 📦20240606 VSAC v0.23
    SubstanceAdministration.​routeCode Base required SPL Drug Route of Administration Terminology . 📦20240716 VSAC v0.23
    SubstanceAdministration.​routeCode.translation Base preferred Medication Route . 📦20240606 VSAC v0.23
    SubstanceAdministration.​approachSiteCode Base required Body Site Value Set . 📦20240606 VSAC v0.23
    SubstanceAdministration.​doseQuantity.unit Base preferred UnitsOfMeasureCaseSensitive 📦3.0.0 THO v6.5
    SubstanceAdministration.​rateQuantity.unit Base required UnitsOfMeasureCaseSensitive 📦3.0.0 THO v6.5
    SubstanceAdministration.​administrationUnitCode Base required AdministrationUnitDoseForm . 📦20240606 VSAC v0.23

    Constraints

    Id Grade Path(s) Description Expression
    1098-32890 error SubstanceAdministration.effectiveTime:duration This effectiveTime **SHALL** contain either a low or a @value but not both (CONF:1098-32890). (value.exists() or low.exists()) and ((value.exists() and low.exists()).not())
    dose-unit-or-admin-unit error SubstanceAdministration If doseQuantity/@unit is present, then administrationUnitCode SHALL NOT be present. doseQuantity.unit.exists() implies administrationUnitCode.empty()
    should-author warning SubstanceAdministration SHOULD contain author author.exists()
    should-low warning SubstanceAdministration.effectiveTime:duration SHOULD contain low low.exists()
    should-text-ref-value warning SubstanceAdministration SHOULD contain text/reference/@value text.reference.value.exists()
    should-translation warning SubstanceAdministration.routeCode SHOULD contain translation translation.exists()
    should-unit warning SubstanceAdministration.doseQuantity, SubstanceAdministration.rateQuantity SHOULD contain @unit nullFlavor.exists() or unit.exists()
    should-value-att warning SubstanceAdministration.effectiveTime:duration SHOULD contain @value value.exists()
    value-starts-octothorpe error SubstanceAdministration.text.reference If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative value.exists() implies value.startsWith('#')
    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. SubstanceAdministration C 1..1 SubstanceAdministration XML Namespace: urn:hl7-org:v3
    Base for all types and resources
    Instance of this type are validated by templateId
    Logical Container: ClinicalDocument (CDA Class)
    Constraints: should-text-ref-value, dose-unit-or-admin-unit, should-author
    ... @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
    ... Slices for templateId 1..* II Slice: Unordered, Open by value:root, value:extension
    .... templateId:planned-med-activity 1..1 II
    ..... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    ..... @assigningAuthorityName 0..1 st
    ..... @displayable 0..1 bl
    ..... @root 1..1 oid, uuid, ruid Required Pattern: 2.16.840.1.113883.10.20.22.4.42
    ..... @extension 1..1 st Required Pattern: 2014-06-09
    ... @classCode 1..1 cs Binding: CDAActClass (required)
    Fixed Value: SBADM
    ... @moodCode 1..1 cs Binding: Planned moodCode (SubstanceAdministration/Supply) . (required)
    ... id 1..* II
    ... code 0..1 CD Binding: CDAActSubstanceAdministrationCode (example)
    ... @negationInd 0..1 bl
    ... text 0..1 ED SHOULD reference the portion of section narrative text corresponding to this entry
    .... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    .... @compression 0..1 cs Binding: CDACompressionAlgorithm (required)
    .... @integrityCheck 0..1 bin
    .... @integrityCheckAlgorithm 0..1 cs Binding: IntegrityCheckAlgorithm (2.0.0) (required)
    .... @language 0..1 cs
    .... @mediaType 0..1 cs Binding: MediaType (example)
    .... @representation 0..1 cs Binding: CDABinaryDataEncoding (required)
    .... xmlText 0..1 st Allows for mixed text content. If @representation='B64', this SHALL be a base64binary string.
    .... reference C 0..1 TEL Constraints: value-starts-octothorpe
    .... thumbnail 0..1 ED
    ... statusCode 1..1 CS Binding: ActStatus (required)
    .... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    .... @code 1..1 cs Fixed Value: active
    .... @sdtcValueSet 0..1 oid XML Namespace: urn:hl7-org:sdtc
    XML: valueSet (urn:hl7-org:sdtc)
    .... @sdtcValueSetVersion 0..1 st XML Namespace: urn:hl7-org:sdtc
    XML: valueSetVersion (urn:hl7-org:sdtc)
    ... Slices for effectiveTime 1..* Slice: Unordered, Open by type:$this
    .... effectiveTime SXCM_TS
    .... effectiveTime IVL_TS
    .... effectiveTime EIVL_TS
    .... effectiveTime PIVL_TS
    .... effectiveTime SXPR_TS
    .... effectiveTime:duration C 1..1 IVL_TS The effectiveTime in a planned medication activity represents the time that the medication activity should occur.
    Constraints: 1098-32890, should-value-att, should-low
    ..... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    ..... @value 0..1 ts indicates a single-administration timestamp
    Date Format: YYYYMMDDHHMMSS.UUUU[+|-ZZzz]
    ..... @operator 0..1 cs Binding: CDASetOperator (required)
    ..... low 0..1 IVXB_TS indicates when medication started
    ..... center 0..1 TS
    ..... width 0..1 PQ
    ..... high 0..1 IVXB_TS indicates when medication stopped
    .... effectiveTime:periodicFrequency 0..1 EIVL_TS This effectiveTime represents a periodic medication frequency (e.g., administration times per day).
    ..... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    ..... @operator 1..1 cs Binding: CDASetOperator (required)
    Required Pattern: A
    ..... event 0..1 CE
    ..... offset 0..1 IVL_PQ
    .... effectiveTime:eventFrequency 0..1 PIVL_TS This effectiveTime represents an event-based medication frequency (e.g., administration at bedtime).
    ..... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    ..... @operator 1..1 cs Binding: CDASetOperator (required)
    Required Pattern: A
    ..... phase 0..1 IVL_TS
    ..... period 0..1 PQ
    ..... @alignment 0..1 cs
    ..... @institutionSpecified 0..1 bl
    ... priorityCode 0..1 CE Binding: ActPriority (example)
    ... repeatNumber 0..1 IVL_INT In a Planned Medication Activity, repeatNumber defines the number of allowed administrations. For example, a repeatNumber of "3" means that the substance can be administered up to 3 times.
    ... routeCode C 0..1 CE Binding: SPL Drug Route of Administration Terminology . (required)
    Constraints: should-translation
    .... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    .... @code 0..1 cs
    .... @codeSystem 0..1 oid, uuid, ruid
    .... @codeSystemName 0..1 st
    .... @codeSystemVersion 0..1 st
    .... @displayName 0..1 st
    .... @sdtcValueSet 0..1 oid XML Namespace: urn:hl7-org:sdtc
    XML: valueSet (urn:hl7-org:sdtc)
    .... @sdtcValueSetVersion 0..1 st XML Namespace: urn:hl7-org:sdtc
    XML: valueSetVersion (urn:hl7-org:sdtc)
    .... originalText 0..1 ED
    .... translation 0..* CD Binding: Medication Route . (preferred)
    ... approachSiteCode 0..* CD Binding: Body Site Value Set . (required)
    ... doseQuantity C 0..1 IVL_PQ Constraints: should-unit
    .... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    .... @unit 0..1 cs NOTE: The base CDA R2.0 standard requires @unit to be drawn from UCUM, and best practice is to use case sensitive UCUM units
    Binding: UnitsOfMeasureCaseSensitive (preferred)
    .... @value 0..1 real
    .... translation 0..* PQR
    .... @operator 0..1 cs Binding: CDASetOperator (required)
    .... low 0..1 IVXB_PQ
    .... center 0..1 PQ
    .... width 0..1 PQ
    .... high 0..1 IVXB_PQ
    ... rateQuantity C 0..1 IVL_PQ Constraints: should-unit
    .... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    .... @unit 0..1 cs NOTE: The base CDA R2.0 standard requires @unit to be drawn from UCUM, and best practice is to use case sensitive UCUM units
    Binding: UnitsOfMeasureCaseSensitive (required)
    .... @value 0..1 real
    .... translation 0..* PQR
    .... @operator 0..1 cs Binding: CDASetOperator (required)
    .... low 0..1 IVXB_PQ
    .... center 0..1 PQ
    .... width 0..1 PQ
    .... high 0..1 IVXB_PQ
    ... maxDoseQuantity 0..1 RTO_PQ_PQ
    ... administrationUnitCode 0..1 CE Binding: AdministrationUnitDoseForm . (required)
    ... consumable 1..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: CSM
    .... manufacturedProduct 1..1 MedicationInformation
    ... subject 0..1 Subject
    ... specimen 0..* Specimen
    ... performer 0..* Performer2 The clinician who is expected to perform the medication activity could be identified using substanceAdministration/performer.
    ... author 0..1 AuthorParticipation The author in a planned medication activity represents the clinician who is requesting or planning the medication activity.
    ... informant 0..* Informant
    ... participant 0..* Participant2
    ... Slices for entryRelationship 0..* EntryRelationship Slice: Unordered, Open by profile:observation
    .... entryRelationship:priorityPreference 0..* EntryRelationship The following entryRelationship represents the priority that a patient or a provider places on the planned medication activity.
    ..... @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 1..1 cs Binding: x_ActRelationshipEntryRelationship (required)
    Fixed Value: REFR
    ..... @inversionInd 0..1 bl
    ..... @contextConductionInd 0..1 bl
    ..... @negationInd 0..1 bl
    ..... sequenceNumber 0..1 INT
    ..... seperatableInd 0..1 BL
    ..... act 0..1 Act
    ..... encounter 0..1 Encounter
    ..... observation 1..1 PriorityPreference
    ..... observationMedia 0..1 ObservationMedia
    ..... organizer 0..1 Organizer
    ..... procedure 0..1 Procedure
    ..... regionOfInterest 0..1 RegionOfInterest
    ..... substanceAdministration 0..1 SubstanceAdministration
    ..... supply 0..1 Supply
    .... entryRelationship:indication 0..* EntryRelationship The following entryRelationship represents the indication for the planned medication activity.
    ..... @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 1..1 cs Binding: x_ActRelationshipEntryRelationship (required)
    Fixed Value: RSON
    ..... @inversionInd 0..1 bl
    ..... @contextConductionInd 0..1 bl
    ..... @negationInd 0..1 bl
    ..... sequenceNumber 0..1 INT
    ..... seperatableInd 0..1 BL
    ..... act 0..1 Act
    ..... encounter 0..1 Encounter
    ..... observation 1..1 Indication
    ..... observationMedia 0..1 ObservationMedia
    ..... organizer 0..1 Organizer
    ..... procedure 0..1 Procedure
    ..... regionOfInterest 0..1 RegionOfInterest
    ..... substanceAdministration 0..1 SubstanceAdministration
    ..... supply 0..1 Supply
    .... entryRelationship:instruction 0..* EntryRelationship The following entryRelationship captures any instructions associated with the planned medication activity.
    ..... @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 1..1 cs Binding: x_ActRelationshipEntryRelationship (required)
    Fixed Value: SUBJ
    ..... @inversionInd 0..1 bl
    ..... @contextConductionInd 0..1 bl
    ..... @negationInd 0..1 bl
    ..... sequenceNumber 0..1 INT
    ..... seperatableInd 0..1 BL
    ..... act 0..1 Act
    ..... encounter 0..1 Encounter
    ..... observation 1..1 InstructionObservation
    ..... observationMedia 0..1 ObservationMedia
    ..... organizer 0..1 Organizer
    ..... procedure 0..1 Procedure
    ..... regionOfInterest 0..1 RegionOfInterest
    ..... substanceAdministration 0..1 SubstanceAdministration
    ..... supply 0..1 Supply
    ... reference 0..* Reference
    ... precondition 0..* Precondition
    .... @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 1..1 cs Binding: CDAActRelationshipType (required)
    Fixed Value: PRCN
    .... criterion 1..1 PreconditionforSubstanceAdministration
    ... sdtcInFulfillmentOf1 0..* InFulfillmentOf1 XML Namespace: urn:hl7-org:sdtc
    XML: inFulfillmentOf1 (urn:hl7-org:sdtc)

    doco Documentation for this format

    Terminology Bindings

    Path Status Usage ValueSet Version Source
    SubstanceAdministration.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​typeId.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​templateId:planned-med-activity.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​classCode Base required CDAActClass 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​moodCode Base required Planned moodCode (SubstanceAdministration/Supply) . 📦20240606 VSAC v0.23
    SubstanceAdministration.​code Base example CDAActSubstanceAdministrationCode 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​text.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​text.compression Base required CDACompressionAlgorithm 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​text.integrityCheckAlgorithm Base required IntegrityCheckAlgorithm 📍2.0.0 THO v5.2
    SubstanceAdministration.​text.mediaType Base example MediaType 📦3.0.0 THO v6.5
    SubstanceAdministration.​text.representation Base required CDABinaryDataEncoding 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​statusCode Base required ActStatus 📦3.0.0 THO v6.5
    SubstanceAdministration.​statusCode.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​effectiveTime:duration.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​effectiveTime:duration.​operator Base required CDASetOperator 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​effectiveTime:periodicFrequency.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​effectiveTime:periodicFrequency.​operator Base required CDASetOperator 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​effectiveTime:eventFrequency.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​effectiveTime:eventFrequency.​operator Base required CDASetOperator 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​priorityCode Base example ActPriority 📦3.0.0 THO v6.5
    SubstanceAdministration.​routeCode Base required SPL Drug Route of Administration Terminology . 📦20240716 VSAC v0.23
    SubstanceAdministration.​routeCode.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​routeCode.translation Base preferred Medication Route . 📦20240606 VSAC v0.23
    SubstanceAdministration.​approachSiteCode Base required Body Site Value Set . 📦20240606 VSAC v0.23
    SubstanceAdministration.​doseQuantity.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​doseQuantity.unit Base preferred UnitsOfMeasureCaseSensitive 📦3.0.0 THO v6.5
    SubstanceAdministration.​doseQuantity.operator Base required CDASetOperator 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​rateQuantity.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​rateQuantity.unit Base required UnitsOfMeasureCaseSensitive 📦3.0.0 THO v6.5
    SubstanceAdministration.​rateQuantity.operator Base required CDASetOperator 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​administrationUnitCode Base required AdministrationUnitDoseForm . 📦20240606 VSAC v0.23
    SubstanceAdministration.​consumable.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​consumable.typeId.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​consumable.typeCode Base required CDAParticipationType 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​entryRelationship:priorityPreference.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​entryRelationship:priorityPreference.​typeId.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​entryRelationship:priorityPreference.​typeCode Base required x_ActRelationshipEntryRelationship 📦3.0.0 THO v6.5
    SubstanceAdministration.​entryRelationship:indication.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​entryRelationship:indication.​typeId.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​entryRelationship:indication.​typeCode Base required x_ActRelationshipEntryRelationship 📦3.0.0 THO v6.5
    SubstanceAdministration.​entryRelationship:instruction.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​entryRelationship:instruction.​typeId.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​entryRelationship:instruction.​typeCode Base required x_ActRelationshipEntryRelationship 📦3.0.0 THO v6.5
    SubstanceAdministration.​precondition.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​precondition.typeId.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​precondition.typeCode Base required CDAActRelationshipType 📦2.0.1-sd Clinical Document Architecture v2.0

    Constraints

    Id Grade Path(s) Description Expression
    1098-32890 error SubstanceAdministration.effectiveTime:duration This effectiveTime **SHALL** contain either a low or a @value but not both (CONF:1098-32890). (value.exists() or low.exists()) and ((value.exists() and low.exists()).not())
    II-1 error SubstanceAdministration.typeId, SubstanceAdministration.consumable.typeId, SubstanceAdministration.entryRelationship:priorityPreference.typeId, SubstanceAdministration.entryRelationship:indication.typeId, SubstanceAdministration.entryRelationship:instruction.typeId, SubstanceAdministration.precondition.typeId An II instance must have either a root or an nullFlavor. root.exists() or nullFlavor.exists()
    dose-unit-or-admin-unit error SubstanceAdministration If doseQuantity/@unit is present, then administrationUnitCode SHALL NOT be present. doseQuantity.unit.exists() implies administrationUnitCode.empty()
    should-author warning SubstanceAdministration SHOULD contain author author.exists()
    should-low warning SubstanceAdministration.effectiveTime:duration SHOULD contain low low.exists()
    should-text-ref-value warning SubstanceAdministration SHOULD contain text/reference/@value text.reference.value.exists()
    should-translation warning SubstanceAdministration.routeCode SHOULD contain translation translation.exists()
    should-unit warning SubstanceAdministration.doseQuantity, SubstanceAdministration.rateQuantity SHOULD contain @unit nullFlavor.exists() or unit.exists()
    should-value-att warning SubstanceAdministration.effectiveTime:duration SHOULD contain @value value.exists()
    value-starts-octothorpe error SubstanceAdministration.text.reference If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative value.exists() implies value.startsWith('#')
    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. SubstanceAdministration C 1..1 SubstanceAdministration XML Namespace: urn:hl7-org:v3
    Base for all types and resources
    Instance of this type are validated by templateId
    Logical Container: ClinicalDocument (CDA Class)
    Constraints: should-text-ref-value, dose-unit-or-admin-unit, should-author
    ... @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
    ... Slices for templateId 1..* II Slice: Unordered, Open by value:root, value:extension
    .... templateId:planned-med-activity 1..1 II
    ..... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    ..... @assigningAuthorityName 0..1 st
    ..... @displayable 0..1 bl
    ..... @root 1..1 oid, uuid, ruid Required Pattern: 2.16.840.1.113883.10.20.22.4.42
    ..... @extension 1..1 st Required Pattern: 2014-06-09
    ... @classCode 1..1 cs Binding: CDAActClass (required)
    Fixed Value: SBADM
    ... @moodCode 1..1 cs Binding: Planned moodCode (SubstanceAdministration/Supply) . (required)
    ... id 1..* II
    ... code 0..1 CD Binding: CDAActSubstanceAdministrationCode (example)
    ... @negationInd 0..1 bl
    ... text 0..1 ED SHOULD reference the portion of section narrative text corresponding to this entry
    .... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    .... @compression 0..1 cs Binding: CDACompressionAlgorithm (required)
    .... @integrityCheck 0..1 bin
    .... @integrityCheckAlgorithm 0..1 cs Binding: IntegrityCheckAlgorithm (2.0.0) (required)
    .... @language 0..1 cs
    .... @mediaType 0..1 cs Binding: MediaType (example)
    .... @representation 0..1 cs Binding: CDABinaryDataEncoding (required)
    .... xmlText 0..1 st Allows for mixed text content. If @representation='B64', this SHALL be a base64binary string.
    .... reference C 0..1 TEL Constraints: value-starts-octothorpe
    .... thumbnail 0..1 ED
    ... statusCode 1..1 CS Binding: ActStatus (required)
    .... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    .... @code 1..1 cs Fixed Value: active
    .... @sdtcValueSet 0..1 oid XML Namespace: urn:hl7-org:sdtc
    XML: valueSet (urn:hl7-org:sdtc)
    .... @sdtcValueSetVersion 0..1 st XML Namespace: urn:hl7-org:sdtc
    XML: valueSetVersion (urn:hl7-org:sdtc)
    ... Slices for effectiveTime 1..* Slice: Unordered, Open by type:$this
    .... effectiveTime SXCM_TS
    .... effectiveTime IVL_TS
    .... effectiveTime EIVL_TS
    .... effectiveTime PIVL_TS
    .... effectiveTime SXPR_TS
    .... effectiveTime:duration C 1..1 IVL_TS The effectiveTime in a planned medication activity represents the time that the medication activity should occur.
    Constraints: 1098-32890, should-value-att, should-low
    ..... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    ..... @value 0..1 ts indicates a single-administration timestamp
    Date Format: YYYYMMDDHHMMSS.UUUU[+|-ZZzz]
    ..... @operator 0..1 cs Binding: CDASetOperator (required)
    ..... low 0..1 IVXB_TS indicates when medication started
    ..... center 0..1 TS
    ..... width 0..1 PQ
    ..... high 0..1 IVXB_TS indicates when medication stopped
    .... effectiveTime:periodicFrequency 0..1 EIVL_TS This effectiveTime represents a periodic medication frequency (e.g., administration times per day).
    ..... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    ..... @operator 1..1 cs Binding: CDASetOperator (required)
    Required Pattern: A
    ..... event 0..1 CE
    ..... offset 0..1 IVL_PQ
    .... effectiveTime:eventFrequency 0..1 PIVL_TS This effectiveTime represents an event-based medication frequency (e.g., administration at bedtime).
    ..... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    ..... @operator 1..1 cs Binding: CDASetOperator (required)
    Required Pattern: A
    ..... phase 0..1 IVL_TS
    ..... period 0..1 PQ
    ..... @alignment 0..1 cs
    ..... @institutionSpecified 0..1 bl
    ... priorityCode 0..1 CE Binding: ActPriority (example)
    ... repeatNumber 0..1 IVL_INT In a Planned Medication Activity, repeatNumber defines the number of allowed administrations. For example, a repeatNumber of "3" means that the substance can be administered up to 3 times.
    ... routeCode C 0..1 CE Binding: SPL Drug Route of Administration Terminology . (required)
    Constraints: should-translation
    .... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    .... @code 0..1 cs
    .... @codeSystem 0..1 oid, uuid, ruid
    .... @codeSystemName 0..1 st
    .... @codeSystemVersion 0..1 st
    .... @displayName 0..1 st
    .... @sdtcValueSet 0..1 oid XML Namespace: urn:hl7-org:sdtc
    XML: valueSet (urn:hl7-org:sdtc)
    .... @sdtcValueSetVersion 0..1 st XML Namespace: urn:hl7-org:sdtc
    XML: valueSetVersion (urn:hl7-org:sdtc)
    .... originalText 0..1 ED
    .... translation 0..* CD Binding: Medication Route . (preferred)
    ... approachSiteCode 0..* CD Binding: Body Site Value Set . (required)
    ... doseQuantity C 0..1 IVL_PQ Constraints: should-unit
    .... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    .... @unit 0..1 cs NOTE: The base CDA R2.0 standard requires @unit to be drawn from UCUM, and best practice is to use case sensitive UCUM units
    Binding: UnitsOfMeasureCaseSensitive (preferred)
    .... @value 0..1 real
    .... translation 0..* PQR
    .... @operator 0..1 cs Binding: CDASetOperator (required)
    .... low 0..1 IVXB_PQ
    .... center 0..1 PQ
    .... width 0..1 PQ
    .... high 0..1 IVXB_PQ
    ... rateQuantity C 0..1 IVL_PQ Constraints: should-unit
    .... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    .... @unit 0..1 cs NOTE: The base CDA R2.0 standard requires @unit to be drawn from UCUM, and best practice is to use case sensitive UCUM units
    Binding: UnitsOfMeasureCaseSensitive (required)
    .... @value 0..1 real
    .... translation 0..* PQR
    .... @operator 0..1 cs Binding: CDASetOperator (required)
    .... low 0..1 IVXB_PQ
    .... center 0..1 PQ
    .... width 0..1 PQ
    .... high 0..1 IVXB_PQ
    ... maxDoseQuantity 0..1 RTO_PQ_PQ
    ... administrationUnitCode 0..1 CE Binding: AdministrationUnitDoseForm . (required)
    ... consumable 1..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: CSM
    .... manufacturedProduct 1..1 MedicationInformation
    ... subject 0..1 Subject
    ... specimen 0..* Specimen
    ... performer 0..* Performer2 The clinician who is expected to perform the medication activity could be identified using substanceAdministration/performer.
    ... author 0..1 AuthorParticipation The author in a planned medication activity represents the clinician who is requesting or planning the medication activity.
    ... informant 0..* Informant
    ... participant 0..* Participant2
    ... Slices for entryRelationship 0..* EntryRelationship Slice: Unordered, Open by profile:observation
    .... entryRelationship:priorityPreference 0..* EntryRelationship The following entryRelationship represents the priority that a patient or a provider places on the planned medication activity.
    ..... @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 1..1 cs Binding: x_ActRelationshipEntryRelationship (required)
    Fixed Value: REFR
    ..... @inversionInd 0..1 bl
    ..... @contextConductionInd 0..1 bl
    ..... @negationInd 0..1 bl
    ..... sequenceNumber 0..1 INT
    ..... seperatableInd 0..1 BL
    ..... act 0..1 Act
    ..... encounter 0..1 Encounter
    ..... observation 1..1 PriorityPreference
    ..... observationMedia 0..1 ObservationMedia
    ..... organizer 0..1 Organizer
    ..... procedure 0..1 Procedure
    ..... regionOfInterest 0..1 RegionOfInterest
    ..... substanceAdministration 0..1 SubstanceAdministration
    ..... supply 0..1 Supply
    .... entryRelationship:indication 0..* EntryRelationship The following entryRelationship represents the indication for the planned medication activity.
    ..... @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 1..1 cs Binding: x_ActRelationshipEntryRelationship (required)
    Fixed Value: RSON
    ..... @inversionInd 0..1 bl
    ..... @contextConductionInd 0..1 bl
    ..... @negationInd 0..1 bl
    ..... sequenceNumber 0..1 INT
    ..... seperatableInd 0..1 BL
    ..... act 0..1 Act
    ..... encounter 0..1 Encounter
    ..... observation 1..1 Indication
    ..... observationMedia 0..1 ObservationMedia
    ..... organizer 0..1 Organizer
    ..... procedure 0..1 Procedure
    ..... regionOfInterest 0..1 RegionOfInterest
    ..... substanceAdministration 0..1 SubstanceAdministration
    ..... supply 0..1 Supply
    .... entryRelationship:instruction 0..* EntryRelationship The following entryRelationship captures any instructions associated with the planned medication activity.
    ..... @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 1..1 cs Binding: x_ActRelationshipEntryRelationship (required)
    Fixed Value: SUBJ
    ..... @inversionInd 0..1 bl
    ..... @contextConductionInd 0..1 bl
    ..... @negationInd 0..1 bl
    ..... sequenceNumber 0..1 INT
    ..... seperatableInd 0..1 BL
    ..... act 0..1 Act
    ..... encounter 0..1 Encounter
    ..... observation 1..1 InstructionObservation
    ..... observationMedia 0..1 ObservationMedia
    ..... organizer 0..1 Organizer
    ..... procedure 0..1 Procedure
    ..... regionOfInterest 0..1 RegionOfInterest
    ..... substanceAdministration 0..1 SubstanceAdministration
    ..... supply 0..1 Supply
    ... reference 0..* Reference
    ... precondition 0..* Precondition
    .... @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 1..1 cs Binding: CDAActRelationshipType (required)
    Fixed Value: PRCN
    .... criterion 1..1 PreconditionforSubstanceAdministration
    ... sdtcInFulfillmentOf1 0..* InFulfillmentOf1 XML Namespace: urn:hl7-org:sdtc
    XML: inFulfillmentOf1 (urn:hl7-org:sdtc)

    doco Documentation for this format

    Terminology Bindings

    Path Status Usage ValueSet Version Source
    SubstanceAdministration.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​typeId.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​templateId:planned-med-activity.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​classCode Base required CDAActClass 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​moodCode Base required Planned moodCode (SubstanceAdministration/Supply) . 📦20240606 VSAC v0.23
    SubstanceAdministration.​code Base example CDAActSubstanceAdministrationCode 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​text.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​text.compression Base required CDACompressionAlgorithm 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​text.integrityCheckAlgorithm Base required IntegrityCheckAlgorithm 📍2.0.0 THO v5.2
    SubstanceAdministration.​text.mediaType Base example MediaType 📦3.0.0 THO v6.5
    SubstanceAdministration.​text.representation Base required CDABinaryDataEncoding 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​statusCode Base required ActStatus 📦3.0.0 THO v6.5
    SubstanceAdministration.​statusCode.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​effectiveTime:duration.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​effectiveTime:duration.​operator Base required CDASetOperator 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​effectiveTime:periodicFrequency.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​effectiveTime:periodicFrequency.​operator Base required CDASetOperator 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​effectiveTime:eventFrequency.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​effectiveTime:eventFrequency.​operator Base required CDASetOperator 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​priorityCode Base example ActPriority 📦3.0.0 THO v6.5
    SubstanceAdministration.​routeCode Base required SPL Drug Route of Administration Terminology . 📦20240716 VSAC v0.23
    SubstanceAdministration.​routeCode.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​routeCode.translation Base preferred Medication Route . 📦20240606 VSAC v0.23
    SubstanceAdministration.​approachSiteCode Base required Body Site Value Set . 📦20240606 VSAC v0.23
    SubstanceAdministration.​doseQuantity.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​doseQuantity.unit Base preferred UnitsOfMeasureCaseSensitive 📦3.0.0 THO v6.5
    SubstanceAdministration.​doseQuantity.operator Base required CDASetOperator 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​rateQuantity.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​rateQuantity.unit Base required UnitsOfMeasureCaseSensitive 📦3.0.0 THO v6.5
    SubstanceAdministration.​rateQuantity.operator Base required CDASetOperator 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​administrationUnitCode Base required AdministrationUnitDoseForm . 📦20240606 VSAC v0.23
    SubstanceAdministration.​consumable.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​consumable.typeId.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​consumable.typeCode Base required CDAParticipationType 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​entryRelationship:priorityPreference.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​entryRelationship:priorityPreference.​typeId.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​entryRelationship:priorityPreference.​typeCode Base required x_ActRelationshipEntryRelationship 📦3.0.0 THO v6.5
    SubstanceAdministration.​entryRelationship:indication.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​entryRelationship:indication.​typeId.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​entryRelationship:indication.​typeCode Base required x_ActRelationshipEntryRelationship 📦3.0.0 THO v6.5
    SubstanceAdministration.​entryRelationship:instruction.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​entryRelationship:instruction.​typeId.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​entryRelationship:instruction.​typeCode Base required x_ActRelationshipEntryRelationship 📦3.0.0 THO v6.5
    SubstanceAdministration.​precondition.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​precondition.typeId.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​precondition.typeCode Base required CDAActRelationshipType 📦2.0.1-sd Clinical Document Architecture v2.0

    Constraints

    Id Grade Path(s) Description Expression
    1098-32890 error SubstanceAdministration.effectiveTime:duration This effectiveTime **SHALL** contain either a low or a @value but not both (CONF:1098-32890). (value.exists() or low.exists()) and ((value.exists() and low.exists()).not())
    II-1 error SubstanceAdministration.typeId, SubstanceAdministration.consumable.typeId, SubstanceAdministration.entryRelationship:priorityPreference.typeId, SubstanceAdministration.entryRelationship:indication.typeId, SubstanceAdministration.entryRelationship:instruction.typeId, SubstanceAdministration.precondition.typeId An II instance must have either a root or an nullFlavor. root.exists() or nullFlavor.exists()
    dose-unit-or-admin-unit error SubstanceAdministration If doseQuantity/@unit is present, then administrationUnitCode SHALL NOT be present. doseQuantity.unit.exists() implies administrationUnitCode.empty()
    should-author warning SubstanceAdministration SHOULD contain author author.exists()
    should-low warning SubstanceAdministration.effectiveTime:duration SHOULD contain low low.exists()
    should-text-ref-value warning SubstanceAdministration SHOULD contain text/reference/@value text.reference.value.exists()
    should-translation warning SubstanceAdministration.routeCode SHOULD contain translation translation.exists()
    should-unit warning SubstanceAdministration.doseQuantity, SubstanceAdministration.rateQuantity SHOULD contain @unit nullFlavor.exists() or unit.exists()
    should-value-att warning SubstanceAdministration.effectiveTime:duration SHOULD contain @value value.exists()
    value-starts-octothorpe error SubstanceAdministration.text.reference If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative value.exists() implies value.startsWith('#')

    This structure is derived from SubstanceAdministration

    Summary

    Mandatory: 9 elements(6 nested mandatory elements)
    Fixed: 4 elements

    Structures

    This structure refers to these other structures:

    Slices

    This structure defines the following Slices:

    • The element 2 is sliced based on the values of SubstanceAdministration.templateId
    • The element 1 is sliced based on the value of SubstanceAdministration.effectiveTime
    • The element 1 is sliced based on the value of SubstanceAdministration.entryRelationship

    Differential View

    This structure is derived from SubstanceAdministration

    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. SubstanceAdministration C 1..1 SubstanceAdministration XML Namespace: urn:hl7-org:v3
    Base for all types and resources
    Instance of this type are validated by templateId
    Logical Container: ClinicalDocument (CDA Class)
    Constraints: should-text-ref-value, dose-unit-or-admin-unit, should-author
    ... Slices for templateId 1..* II Slice: Unordered, Open by value:root, value:extension
    .... templateId:planned-med-activity 1..1 II
    ..... @root 1..1 oid, uuid, ruid Required Pattern: 2.16.840.1.113883.10.20.22.4.42
    ..... @extension 1..1 st Required Pattern: 2014-06-09
    ... @classCode 1..1 cs
    ... @moodCode 1..1 cs Binding: Planned moodCode (SubstanceAdministration/Supply) . (required)
    ... text 0..1 ED SHOULD reference the portion of section narrative text corresponding to this entry
    .... reference C 0..1 TEL Constraints: value-starts-octothorpe
    ... statusCode 1..1 CS
    .... @code 1..1 cs Fixed Value: active
    ... Slices for effectiveTime 1..* SXCM_TS, IVL_TS, EIVL_TS, PIVL_TS, SXPR_TS Slice: Unordered, Open by type:$this
    .... effectiveTime:duration C 1..1 IVL_TS The effectiveTime in a planned medication activity represents the time that the medication activity should occur.
    Constraints: 1098-32890, should-value-att, should-low
    ..... @value 0..1 ts indicates a single-administration timestamp
    ..... low 0..1 IVXB_TS indicates when medication started
    ..... high 0..1 IVXB_TS indicates when medication stopped
    .... effectiveTime:periodicFrequency 0..1 EIVL_TS This effectiveTime represents a periodic medication frequency (e.g., administration times per day).
    ..... @operator 1..1 cs Required Pattern: A
    .... effectiveTime:eventFrequency 0..1 PIVL_TS This effectiveTime represents an event-based medication frequency (e.g., administration at bedtime).
    ..... @operator 1..1 cs Required Pattern: A
    ... repeatNumber 0..1 IVL_INT In a Planned Medication Activity, repeatNumber defines the number of allowed administrations. For example, a repeatNumber of "3" means that the substance can be administered up to 3 times.
    ... routeCode C 0..1 CE Binding: SPL Drug Route of Administration Terminology . (required)
    Constraints: should-translation
    .... translation 0..* CD Binding: Medication Route . (preferred)
    ... approachSiteCode 0..* CD Binding: Body Site Value Set . (required)
    ... doseQuantity C 0..1 IVL_PQ Constraints: should-unit
    .... @unit 0..1 cs NOTE: The base CDA R2.0 standard requires @unit to be drawn from UCUM, and best practice is to use case sensitive UCUM units
    Binding: UnitsOfMeasureCaseSensitive (preferred)
    ... rateQuantity C 0..1 IVL_PQ Constraints: should-unit
    .... @unit 0..1 cs NOTE: The base CDA R2.0 standard requires @unit to be drawn from UCUM, and best practice is to use case sensitive UCUM units
    Binding: UnitsOfMeasureCaseSensitive (required)
    ... maxDoseQuantity 0..1 RTO_PQ_PQ
    ... administrationUnitCode 0..1 CE Binding: AdministrationUnitDoseForm . (required)
    ... consumable 1..1 InfrastructureRoot
    .... manufacturedProduct 1..1 MedicationInformation
    ... performer 0..* Performer2 The clinician who is expected to perform the medication activity could be identified using substanceAdministration/performer.
    ... author 0..1 AuthorParticipation The author in a planned medication activity represents the clinician who is requesting or planning the medication activity.
    ... Slices for entryRelationship 0..* EntryRelationship Slice: Unordered, Open by profile:observation
    .... entryRelationship:priorityPreference 0..* EntryRelationship The following entryRelationship represents the priority that a patient or a provider places on the planned medication activity.
    ..... @typeCode 1..1 cs Fixed Value: REFR
    ..... observation 1..1 PriorityPreference
    .... entryRelationship:indication 0..* EntryRelationship The following entryRelationship represents the indication for the planned medication activity.
    ..... @typeCode 1..1 cs Fixed Value: RSON
    ..... observation 1..1 Indication
    .... entryRelationship:instruction 0..* EntryRelationship The following entryRelationship captures any instructions associated with the planned medication activity.
    ..... @typeCode 1..1 cs Fixed Value: SUBJ
    ..... observation 1..1 InstructionObservation
    ... precondition 0..* Precondition
    .... @typeCode 1..1 cs
    .... criterion 1..1 PreconditionforSubstanceAdministration

    doco Documentation for this format

    Terminology Bindings (Differential)

    Path Status Usage ValueSet Version Source
    SubstanceAdministration.​moodCode Base required Planned moodCode (SubstanceAdministration/Supply) . 📦20240606 VSAC v0.23
    SubstanceAdministration.​routeCode Base required SPL Drug Route of Administration Terminology . 📦20240716 VSAC v0.23
    SubstanceAdministration.​routeCode.translation Base preferred Medication Route . 📦20240606 VSAC v0.23
    SubstanceAdministration.​approachSiteCode Base required Body Site Value Set . 📦20240606 VSAC v0.23
    SubstanceAdministration.​doseQuantity.unit Base preferred UnitsOfMeasureCaseSensitive 📦3.0.0 THO v6.5
    SubstanceAdministration.​rateQuantity.unit Base required UnitsOfMeasureCaseSensitive 📦3.0.0 THO v6.5
    SubstanceAdministration.​administrationUnitCode Base required AdministrationUnitDoseForm . 📦20240606 VSAC v0.23

    Constraints

    Id Grade Path(s) Description Expression
    1098-32890 error SubstanceAdministration.effectiveTime:duration This effectiveTime **SHALL** contain either a low or a @value but not both (CONF:1098-32890). (value.exists() or low.exists()) and ((value.exists() and low.exists()).not())
    dose-unit-or-admin-unit error SubstanceAdministration If doseQuantity/@unit is present, then administrationUnitCode SHALL NOT be present. doseQuantity.unit.exists() implies administrationUnitCode.empty()
    should-author warning SubstanceAdministration SHOULD contain author author.exists()
    should-low warning SubstanceAdministration.effectiveTime:duration SHOULD contain low low.exists()
    should-text-ref-value warning SubstanceAdministration SHOULD contain text/reference/@value text.reference.value.exists()
    should-translation warning SubstanceAdministration.routeCode SHOULD contain translation translation.exists()
    should-unit warning SubstanceAdministration.doseQuantity, SubstanceAdministration.rateQuantity SHOULD contain @unit nullFlavor.exists() or unit.exists()
    should-value-att warning SubstanceAdministration.effectiveTime:duration SHOULD contain @value value.exists()
    value-starts-octothorpe error SubstanceAdministration.text.reference If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative value.exists() implies value.startsWith('#')

    Key Elements View

    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. SubstanceAdministration C 1..1 SubstanceAdministration XML Namespace: urn:hl7-org:v3
    Base for all types and resources
    Instance of this type are validated by templateId
    Logical Container: ClinicalDocument (CDA Class)
    Constraints: should-text-ref-value, dose-unit-or-admin-unit, should-author
    ... @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
    ... Slices for templateId 1..* II Slice: Unordered, Open by value:root, value:extension
    .... templateId:planned-med-activity 1..1 II
    ..... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    ..... @assigningAuthorityName 0..1 st
    ..... @displayable 0..1 bl
    ..... @root 1..1 oid, uuid, ruid Required Pattern: 2.16.840.1.113883.10.20.22.4.42
    ..... @extension 1..1 st Required Pattern: 2014-06-09
    ... @classCode 1..1 cs Binding: CDAActClass (required)
    Fixed Value: SBADM
    ... @moodCode 1..1 cs Binding: Planned moodCode (SubstanceAdministration/Supply) . (required)
    ... id 1..* II
    ... code 0..1 CD Binding: CDAActSubstanceAdministrationCode (example)
    ... @negationInd 0..1 bl
    ... text 0..1 ED SHOULD reference the portion of section narrative text corresponding to this entry
    .... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    .... @compression 0..1 cs Binding: CDACompressionAlgorithm (required)
    .... @integrityCheck 0..1 bin
    .... @integrityCheckAlgorithm 0..1 cs Binding: IntegrityCheckAlgorithm (2.0.0) (required)
    .... @language 0..1 cs
    .... @mediaType 0..1 cs Binding: MediaType (example)
    .... @representation 0..1 cs Binding: CDABinaryDataEncoding (required)
    .... xmlText 0..1 st Allows for mixed text content. If @representation='B64', this SHALL be a base64binary string.
    .... reference C 0..1 TEL Constraints: value-starts-octothorpe
    .... thumbnail 0..1 ED
    ... statusCode 1..1 CS Binding: ActStatus (required)
    .... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    .... @code 1..1 cs Fixed Value: active
    .... @sdtcValueSet 0..1 oid XML Namespace: urn:hl7-org:sdtc
    XML: valueSet (urn:hl7-org:sdtc)
    .... @sdtcValueSetVersion 0..1 st XML Namespace: urn:hl7-org:sdtc
    XML: valueSetVersion (urn:hl7-org:sdtc)
    ... Slices for effectiveTime 1..* Slice: Unordered, Open by type:$this
    .... effectiveTime SXCM_TS
    .... effectiveTime IVL_TS
    .... effectiveTime EIVL_TS
    .... effectiveTime PIVL_TS
    .... effectiveTime SXPR_TS
    .... effectiveTime:duration C 1..1 IVL_TS The effectiveTime in a planned medication activity represents the time that the medication activity should occur.
    Constraints: 1098-32890, should-value-att, should-low
    ..... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    ..... @value 0..1 ts indicates a single-administration timestamp
    Date Format: YYYYMMDDHHMMSS.UUUU[+|-ZZzz]
    ..... @operator 0..1 cs Binding: CDASetOperator (required)
    ..... low 0..1 IVXB_TS indicates when medication started
    ..... center 0..1 TS
    ..... width 0..1 PQ
    ..... high 0..1 IVXB_TS indicates when medication stopped
    .... effectiveTime:periodicFrequency 0..1 EIVL_TS This effectiveTime represents a periodic medication frequency (e.g., administration times per day).
    ..... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    ..... @operator 1..1 cs Binding: CDASetOperator (required)
    Required Pattern: A
    ..... event 0..1 CE
    ..... offset 0..1 IVL_PQ
    .... effectiveTime:eventFrequency 0..1 PIVL_TS This effectiveTime represents an event-based medication frequency (e.g., administration at bedtime).
    ..... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    ..... @operator 1..1 cs Binding: CDASetOperator (required)
    Required Pattern: A
    ..... phase 0..1 IVL_TS
    ..... period 0..1 PQ
    ..... @alignment 0..1 cs
    ..... @institutionSpecified 0..1 bl
    ... priorityCode 0..1 CE Binding: ActPriority (example)
    ... repeatNumber 0..1 IVL_INT In a Planned Medication Activity, repeatNumber defines the number of allowed administrations. For example, a repeatNumber of "3" means that the substance can be administered up to 3 times.
    ... routeCode C 0..1 CE Binding: SPL Drug Route of Administration Terminology . (required)
    Constraints: should-translation
    .... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    .... @code 0..1 cs
    .... @codeSystem 0..1 oid, uuid, ruid
    .... @codeSystemName 0..1 st
    .... @codeSystemVersion 0..1 st
    .... @displayName 0..1 st
    .... @sdtcValueSet 0..1 oid XML Namespace: urn:hl7-org:sdtc
    XML: valueSet (urn:hl7-org:sdtc)
    .... @sdtcValueSetVersion 0..1 st XML Namespace: urn:hl7-org:sdtc
    XML: valueSetVersion (urn:hl7-org:sdtc)
    .... originalText 0..1 ED
    .... translation 0..* CD Binding: Medication Route . (preferred)
    ... approachSiteCode 0..* CD Binding: Body Site Value Set . (required)
    ... doseQuantity C 0..1 IVL_PQ Constraints: should-unit
    .... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    .... @unit 0..1 cs NOTE: The base CDA R2.0 standard requires @unit to be drawn from UCUM, and best practice is to use case sensitive UCUM units
    Binding: UnitsOfMeasureCaseSensitive (preferred)
    .... @value 0..1 real
    .... translation 0..* PQR
    .... @operator 0..1 cs Binding: CDASetOperator (required)
    .... low 0..1 IVXB_PQ
    .... center 0..1 PQ
    .... width 0..1 PQ
    .... high 0..1 IVXB_PQ
    ... rateQuantity C 0..1 IVL_PQ Constraints: should-unit
    .... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    .... @unit 0..1 cs NOTE: The base CDA R2.0 standard requires @unit to be drawn from UCUM, and best practice is to use case sensitive UCUM units
    Binding: UnitsOfMeasureCaseSensitive (required)
    .... @value 0..1 real
    .... translation 0..* PQR
    .... @operator 0..1 cs Binding: CDASetOperator (required)
    .... low 0..1 IVXB_PQ
    .... center 0..1 PQ
    .... width 0..1 PQ
    .... high 0..1 IVXB_PQ
    ... maxDoseQuantity 0..1 RTO_PQ_PQ
    ... administrationUnitCode 0..1 CE Binding: AdministrationUnitDoseForm . (required)
    ... consumable 1..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: CSM
    .... manufacturedProduct 1..1 MedicationInformation
    ... subject 0..1 Subject
    ... specimen 0..* Specimen
    ... performer 0..* Performer2 The clinician who is expected to perform the medication activity could be identified using substanceAdministration/performer.
    ... author 0..1 AuthorParticipation The author in a planned medication activity represents the clinician who is requesting or planning the medication activity.
    ... informant 0..* Informant
    ... participant 0..* Participant2
    ... Slices for entryRelationship 0..* EntryRelationship Slice: Unordered, Open by profile:observation
    .... entryRelationship:priorityPreference 0..* EntryRelationship The following entryRelationship represents the priority that a patient or a provider places on the planned medication activity.
    ..... @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 1..1 cs Binding: x_ActRelationshipEntryRelationship (required)
    Fixed Value: REFR
    ..... @inversionInd 0..1 bl
    ..... @contextConductionInd 0..1 bl
    ..... @negationInd 0..1 bl
    ..... sequenceNumber 0..1 INT
    ..... seperatableInd 0..1 BL
    ..... act 0..1 Act
    ..... encounter 0..1 Encounter
    ..... observation 1..1 PriorityPreference
    ..... observationMedia 0..1 ObservationMedia
    ..... organizer 0..1 Organizer
    ..... procedure 0..1 Procedure
    ..... regionOfInterest 0..1 RegionOfInterest
    ..... substanceAdministration 0..1 SubstanceAdministration
    ..... supply 0..1 Supply
    .... entryRelationship:indication 0..* EntryRelationship The following entryRelationship represents the indication for the planned medication activity.
    ..... @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 1..1 cs Binding: x_ActRelationshipEntryRelationship (required)
    Fixed Value: RSON
    ..... @inversionInd 0..1 bl
    ..... @contextConductionInd 0..1 bl
    ..... @negationInd 0..1 bl
    ..... sequenceNumber 0..1 INT
    ..... seperatableInd 0..1 BL
    ..... act 0..1 Act
    ..... encounter 0..1 Encounter
    ..... observation 1..1 Indication
    ..... observationMedia 0..1 ObservationMedia
    ..... organizer 0..1 Organizer
    ..... procedure 0..1 Procedure
    ..... regionOfInterest 0..1 RegionOfInterest
    ..... substanceAdministration 0..1 SubstanceAdministration
    ..... supply 0..1 Supply
    .... entryRelationship:instruction 0..* EntryRelationship The following entryRelationship captures any instructions associated with the planned medication activity.
    ..... @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 1..1 cs Binding: x_ActRelationshipEntryRelationship (required)
    Fixed Value: SUBJ
    ..... @inversionInd 0..1 bl
    ..... @contextConductionInd 0..1 bl
    ..... @negationInd 0..1 bl
    ..... sequenceNumber 0..1 INT
    ..... seperatableInd 0..1 BL
    ..... act 0..1 Act
    ..... encounter 0..1 Encounter
    ..... observation 1..1 InstructionObservation
    ..... observationMedia 0..1 ObservationMedia
    ..... organizer 0..1 Organizer
    ..... procedure 0..1 Procedure
    ..... regionOfInterest 0..1 RegionOfInterest
    ..... substanceAdministration 0..1 SubstanceAdministration
    ..... supply 0..1 Supply
    ... reference 0..* Reference
    ... precondition 0..* Precondition
    .... @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 1..1 cs Binding: CDAActRelationshipType (required)
    Fixed Value: PRCN
    .... criterion 1..1 PreconditionforSubstanceAdministration
    ... sdtcInFulfillmentOf1 0..* InFulfillmentOf1 XML Namespace: urn:hl7-org:sdtc
    XML: inFulfillmentOf1 (urn:hl7-org:sdtc)

    doco Documentation for this format

    Terminology Bindings

    Path Status Usage ValueSet Version Source
    SubstanceAdministration.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​typeId.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​templateId:planned-med-activity.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​classCode Base required CDAActClass 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​moodCode Base required Planned moodCode (SubstanceAdministration/Supply) . 📦20240606 VSAC v0.23
    SubstanceAdministration.​code Base example CDAActSubstanceAdministrationCode 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​text.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​text.compression Base required CDACompressionAlgorithm 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​text.integrityCheckAlgorithm Base required IntegrityCheckAlgorithm 📍2.0.0 THO v5.2
    SubstanceAdministration.​text.mediaType Base example MediaType 📦3.0.0 THO v6.5
    SubstanceAdministration.​text.representation Base required CDABinaryDataEncoding 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​statusCode Base required ActStatus 📦3.0.0 THO v6.5
    SubstanceAdministration.​statusCode.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​effectiveTime:duration.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​effectiveTime:duration.​operator Base required CDASetOperator 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​effectiveTime:periodicFrequency.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​effectiveTime:periodicFrequency.​operator Base required CDASetOperator 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​effectiveTime:eventFrequency.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​effectiveTime:eventFrequency.​operator Base required CDASetOperator 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​priorityCode Base example ActPriority 📦3.0.0 THO v6.5
    SubstanceAdministration.​routeCode Base required SPL Drug Route of Administration Terminology . 📦20240716 VSAC v0.23
    SubstanceAdministration.​routeCode.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​routeCode.translation Base preferred Medication Route . 📦20240606 VSAC v0.23
    SubstanceAdministration.​approachSiteCode Base required Body Site Value Set . 📦20240606 VSAC v0.23
    SubstanceAdministration.​doseQuantity.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​doseQuantity.unit Base preferred UnitsOfMeasureCaseSensitive 📦3.0.0 THO v6.5
    SubstanceAdministration.​doseQuantity.operator Base required CDASetOperator 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​rateQuantity.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​rateQuantity.unit Base required UnitsOfMeasureCaseSensitive 📦3.0.0 THO v6.5
    SubstanceAdministration.​rateQuantity.operator Base required CDASetOperator 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​administrationUnitCode Base required AdministrationUnitDoseForm . 📦20240606 VSAC v0.23
    SubstanceAdministration.​consumable.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​consumable.typeId.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​consumable.typeCode Base required CDAParticipationType 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​entryRelationship:priorityPreference.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​entryRelationship:priorityPreference.​typeId.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​entryRelationship:priorityPreference.​typeCode Base required x_ActRelationshipEntryRelationship 📦3.0.0 THO v6.5
    SubstanceAdministration.​entryRelationship:indication.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​entryRelationship:indication.​typeId.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​entryRelationship:indication.​typeCode Base required x_ActRelationshipEntryRelationship 📦3.0.0 THO v6.5
    SubstanceAdministration.​entryRelationship:instruction.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​entryRelationship:instruction.​typeId.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​entryRelationship:instruction.​typeCode Base required x_ActRelationshipEntryRelationship 📦3.0.0 THO v6.5
    SubstanceAdministration.​precondition.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​precondition.typeId.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​precondition.typeCode Base required CDAActRelationshipType 📦2.0.1-sd Clinical Document Architecture v2.0

    Constraints

    Id Grade Path(s) Description Expression
    1098-32890 error SubstanceAdministration.effectiveTime:duration This effectiveTime **SHALL** contain either a low or a @value but not both (CONF:1098-32890). (value.exists() or low.exists()) and ((value.exists() and low.exists()).not())
    II-1 error SubstanceAdministration.typeId, SubstanceAdministration.consumable.typeId, SubstanceAdministration.entryRelationship:priorityPreference.typeId, SubstanceAdministration.entryRelationship:indication.typeId, SubstanceAdministration.entryRelationship:instruction.typeId, SubstanceAdministration.precondition.typeId An II instance must have either a root or an nullFlavor. root.exists() or nullFlavor.exists()
    dose-unit-or-admin-unit error SubstanceAdministration If doseQuantity/@unit is present, then administrationUnitCode SHALL NOT be present. doseQuantity.unit.exists() implies administrationUnitCode.empty()
    should-author warning SubstanceAdministration SHOULD contain author author.exists()
    should-low warning SubstanceAdministration.effectiveTime:duration SHOULD contain low low.exists()
    should-text-ref-value warning SubstanceAdministration SHOULD contain text/reference/@value text.reference.value.exists()
    should-translation warning SubstanceAdministration.routeCode SHOULD contain translation translation.exists()
    should-unit warning SubstanceAdministration.doseQuantity, SubstanceAdministration.rateQuantity SHOULD contain @unit nullFlavor.exists() or unit.exists()
    should-value-att warning SubstanceAdministration.effectiveTime:duration SHOULD contain @value value.exists()
    value-starts-octothorpe error SubstanceAdministration.text.reference If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative value.exists() implies value.startsWith('#')

    Snapshot View

    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. SubstanceAdministration C 1..1 SubstanceAdministration XML Namespace: urn:hl7-org:v3
    Base for all types and resources
    Instance of this type are validated by templateId
    Logical Container: ClinicalDocument (CDA Class)
    Constraints: should-text-ref-value, dose-unit-or-admin-unit, should-author
    ... @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
    ... Slices for templateId 1..* II Slice: Unordered, Open by value:root, value:extension
    .... templateId:planned-med-activity 1..1 II
    ..... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    ..... @assigningAuthorityName 0..1 st
    ..... @displayable 0..1 bl
    ..... @root 1..1 oid, uuid, ruid Required Pattern: 2.16.840.1.113883.10.20.22.4.42
    ..... @extension 1..1 st Required Pattern: 2014-06-09
    ... @classCode 1..1 cs Binding: CDAActClass (required)
    Fixed Value: SBADM
    ... @moodCode 1..1 cs Binding: Planned moodCode (SubstanceAdministration/Supply) . (required)
    ... id 1..* II
    ... code 0..1 CD Binding: CDAActSubstanceAdministrationCode (example)
    ... @negationInd 0..1 bl
    ... text 0..1 ED SHOULD reference the portion of section narrative text corresponding to this entry
    .... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    .... @compression 0..1 cs Binding: CDACompressionAlgorithm (required)
    .... @integrityCheck 0..1 bin
    .... @integrityCheckAlgorithm 0..1 cs Binding: IntegrityCheckAlgorithm (2.0.0) (required)
    .... @language 0..1 cs
    .... @mediaType 0..1 cs Binding: MediaType (example)
    .... @representation 0..1 cs Binding: CDABinaryDataEncoding (required)
    .... xmlText 0..1 st Allows for mixed text content. If @representation='B64', this SHALL be a base64binary string.
    .... reference C 0..1 TEL Constraints: value-starts-octothorpe
    .... thumbnail 0..1 ED
    ... statusCode 1..1 CS Binding: ActStatus (required)
    .... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    .... @code 1..1 cs Fixed Value: active
    .... @sdtcValueSet 0..1 oid XML Namespace: urn:hl7-org:sdtc
    XML: valueSet (urn:hl7-org:sdtc)
    .... @sdtcValueSetVersion 0..1 st XML Namespace: urn:hl7-org:sdtc
    XML: valueSetVersion (urn:hl7-org:sdtc)
    ... Slices for effectiveTime 1..* Slice: Unordered, Open by type:$this
    .... effectiveTime SXCM_TS
    .... effectiveTime IVL_TS
    .... effectiveTime EIVL_TS
    .... effectiveTime PIVL_TS
    .... effectiveTime SXPR_TS
    .... effectiveTime:duration C 1..1 IVL_TS The effectiveTime in a planned medication activity represents the time that the medication activity should occur.
    Constraints: 1098-32890, should-value-att, should-low
    ..... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    ..... @value 0..1 ts indicates a single-administration timestamp
    Date Format: YYYYMMDDHHMMSS.UUUU[+|-ZZzz]
    ..... @operator 0..1 cs Binding: CDASetOperator (required)
    ..... low 0..1 IVXB_TS indicates when medication started
    ..... center 0..1 TS
    ..... width 0..1 PQ
    ..... high 0..1 IVXB_TS indicates when medication stopped
    .... effectiveTime:periodicFrequency 0..1 EIVL_TS This effectiveTime represents a periodic medication frequency (e.g., administration times per day).
    ..... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    ..... @operator 1..1 cs Binding: CDASetOperator (required)
    Required Pattern: A
    ..... event 0..1 CE
    ..... offset 0..1 IVL_PQ
    .... effectiveTime:eventFrequency 0..1 PIVL_TS This effectiveTime represents an event-based medication frequency (e.g., administration at bedtime).
    ..... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    ..... @operator 1..1 cs Binding: CDASetOperator (required)
    Required Pattern: A
    ..... phase 0..1 IVL_TS
    ..... period 0..1 PQ
    ..... @alignment 0..1 cs
    ..... @institutionSpecified 0..1 bl
    ... priorityCode 0..1 CE Binding: ActPriority (example)
    ... repeatNumber 0..1 IVL_INT In a Planned Medication Activity, repeatNumber defines the number of allowed administrations. For example, a repeatNumber of "3" means that the substance can be administered up to 3 times.
    ... routeCode C 0..1 CE Binding: SPL Drug Route of Administration Terminology . (required)
    Constraints: should-translation
    .... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    .... @code 0..1 cs
    .... @codeSystem 0..1 oid, uuid, ruid
    .... @codeSystemName 0..1 st
    .... @codeSystemVersion 0..1 st
    .... @displayName 0..1 st
    .... @sdtcValueSet 0..1 oid XML Namespace: urn:hl7-org:sdtc
    XML: valueSet (urn:hl7-org:sdtc)
    .... @sdtcValueSetVersion 0..1 st XML Namespace: urn:hl7-org:sdtc
    XML: valueSetVersion (urn:hl7-org:sdtc)
    .... originalText 0..1 ED
    .... translation 0..* CD Binding: Medication Route . (preferred)
    ... approachSiteCode 0..* CD Binding: Body Site Value Set . (required)
    ... doseQuantity C 0..1 IVL_PQ Constraints: should-unit
    .... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    .... @unit 0..1 cs NOTE: The base CDA R2.0 standard requires @unit to be drawn from UCUM, and best practice is to use case sensitive UCUM units
    Binding: UnitsOfMeasureCaseSensitive (preferred)
    .... @value 0..1 real
    .... translation 0..* PQR
    .... @operator 0..1 cs Binding: CDASetOperator (required)
    .... low 0..1 IVXB_PQ
    .... center 0..1 PQ
    .... width 0..1 PQ
    .... high 0..1 IVXB_PQ
    ... rateQuantity C 0..1 IVL_PQ Constraints: should-unit
    .... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    .... @unit 0..1 cs NOTE: The base CDA R2.0 standard requires @unit to be drawn from UCUM, and best practice is to use case sensitive UCUM units
    Binding: UnitsOfMeasureCaseSensitive (required)
    .... @value 0..1 real
    .... translation 0..* PQR
    .... @operator 0..1 cs Binding: CDASetOperator (required)
    .... low 0..1 IVXB_PQ
    .... center 0..1 PQ
    .... width 0..1 PQ
    .... high 0..1 IVXB_PQ
    ... maxDoseQuantity 0..1 RTO_PQ_PQ
    ... administrationUnitCode 0..1 CE Binding: AdministrationUnitDoseForm . (required)
    ... consumable 1..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: CSM
    .... manufacturedProduct 1..1 MedicationInformation
    ... subject 0..1 Subject
    ... specimen 0..* Specimen
    ... performer 0..* Performer2 The clinician who is expected to perform the medication activity could be identified using substanceAdministration/performer.
    ... author 0..1 AuthorParticipation The author in a planned medication activity represents the clinician who is requesting or planning the medication activity.
    ... informant 0..* Informant
    ... participant 0..* Participant2
    ... Slices for entryRelationship 0..* EntryRelationship Slice: Unordered, Open by profile:observation
    .... entryRelationship:priorityPreference 0..* EntryRelationship The following entryRelationship represents the priority that a patient or a provider places on the planned medication activity.
    ..... @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 1..1 cs Binding: x_ActRelationshipEntryRelationship (required)
    Fixed Value: REFR
    ..... @inversionInd 0..1 bl
    ..... @contextConductionInd 0..1 bl
    ..... @negationInd 0..1 bl
    ..... sequenceNumber 0..1 INT
    ..... seperatableInd 0..1 BL
    ..... act 0..1 Act
    ..... encounter 0..1 Encounter
    ..... observation 1..1 PriorityPreference
    ..... observationMedia 0..1 ObservationMedia
    ..... organizer 0..1 Organizer
    ..... procedure 0..1 Procedure
    ..... regionOfInterest 0..1 RegionOfInterest
    ..... substanceAdministration 0..1 SubstanceAdministration
    ..... supply 0..1 Supply
    .... entryRelationship:indication 0..* EntryRelationship The following entryRelationship represents the indication for the planned medication activity.
    ..... @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 1..1 cs Binding: x_ActRelationshipEntryRelationship (required)
    Fixed Value: RSON
    ..... @inversionInd 0..1 bl
    ..... @contextConductionInd 0..1 bl
    ..... @negationInd 0..1 bl
    ..... sequenceNumber 0..1 INT
    ..... seperatableInd 0..1 BL
    ..... act 0..1 Act
    ..... encounter 0..1 Encounter
    ..... observation 1..1 Indication
    ..... observationMedia 0..1 ObservationMedia
    ..... organizer 0..1 Organizer
    ..... procedure 0..1 Procedure
    ..... regionOfInterest 0..1 RegionOfInterest
    ..... substanceAdministration 0..1 SubstanceAdministration
    ..... supply 0..1 Supply
    .... entryRelationship:instruction 0..* EntryRelationship The following entryRelationship captures any instructions associated with the planned medication activity.
    ..... @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 1..1 cs Binding: x_ActRelationshipEntryRelationship (required)
    Fixed Value: SUBJ
    ..... @inversionInd 0..1 bl
    ..... @contextConductionInd 0..1 bl
    ..... @negationInd 0..1 bl
    ..... sequenceNumber 0..1 INT
    ..... seperatableInd 0..1 BL
    ..... act 0..1 Act
    ..... encounter 0..1 Encounter
    ..... observation 1..1 InstructionObservation
    ..... observationMedia 0..1 ObservationMedia
    ..... organizer 0..1 Organizer
    ..... procedure 0..1 Procedure
    ..... regionOfInterest 0..1 RegionOfInterest
    ..... substanceAdministration 0..1 SubstanceAdministration
    ..... supply 0..1 Supply
    ... reference 0..* Reference
    ... precondition 0..* Precondition
    .... @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 1..1 cs Binding: CDAActRelationshipType (required)
    Fixed Value: PRCN
    .... criterion 1..1 PreconditionforSubstanceAdministration
    ... sdtcInFulfillmentOf1 0..* InFulfillmentOf1 XML Namespace: urn:hl7-org:sdtc
    XML: inFulfillmentOf1 (urn:hl7-org:sdtc)

    doco Documentation for this format

    Terminology Bindings

    Path Status Usage ValueSet Version Source
    SubstanceAdministration.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​typeId.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​templateId:planned-med-activity.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​classCode Base required CDAActClass 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​moodCode Base required Planned moodCode (SubstanceAdministration/Supply) . 📦20240606 VSAC v0.23
    SubstanceAdministration.​code Base example CDAActSubstanceAdministrationCode 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​text.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​text.compression Base required CDACompressionAlgorithm 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​text.integrityCheckAlgorithm Base required IntegrityCheckAlgorithm 📍2.0.0 THO v5.2
    SubstanceAdministration.​text.mediaType Base example MediaType 📦3.0.0 THO v6.5
    SubstanceAdministration.​text.representation Base required CDABinaryDataEncoding 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​statusCode Base required ActStatus 📦3.0.0 THO v6.5
    SubstanceAdministration.​statusCode.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​effectiveTime:duration.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​effectiveTime:duration.​operator Base required CDASetOperator 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​effectiveTime:periodicFrequency.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​effectiveTime:periodicFrequency.​operator Base required CDASetOperator 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​effectiveTime:eventFrequency.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​effectiveTime:eventFrequency.​operator Base required CDASetOperator 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​priorityCode Base example ActPriority 📦3.0.0 THO v6.5
    SubstanceAdministration.​routeCode Base required SPL Drug Route of Administration Terminology . 📦20240716 VSAC v0.23
    SubstanceAdministration.​routeCode.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​routeCode.translation Base preferred Medication Route . 📦20240606 VSAC v0.23
    SubstanceAdministration.​approachSiteCode Base required Body Site Value Set . 📦20240606 VSAC v0.23
    SubstanceAdministration.​doseQuantity.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​doseQuantity.unit Base preferred UnitsOfMeasureCaseSensitive 📦3.0.0 THO v6.5
    SubstanceAdministration.​doseQuantity.operator Base required CDASetOperator 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​rateQuantity.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​rateQuantity.unit Base required UnitsOfMeasureCaseSensitive 📦3.0.0 THO v6.5
    SubstanceAdministration.​rateQuantity.operator Base required CDASetOperator 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​administrationUnitCode Base required AdministrationUnitDoseForm . 📦20240606 VSAC v0.23
    SubstanceAdministration.​consumable.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​consumable.typeId.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​consumable.typeCode Base required CDAParticipationType 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​entryRelationship:priorityPreference.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​entryRelationship:priorityPreference.​typeId.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​entryRelationship:priorityPreference.​typeCode Base required x_ActRelationshipEntryRelationship 📦3.0.0 THO v6.5
    SubstanceAdministration.​entryRelationship:indication.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​entryRelationship:indication.​typeId.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​entryRelationship:indication.​typeCode Base required x_ActRelationshipEntryRelationship 📦3.0.0 THO v6.5
    SubstanceAdministration.​entryRelationship:instruction.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​entryRelationship:instruction.​typeId.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​entryRelationship:instruction.​typeCode Base required x_ActRelationshipEntryRelationship 📦3.0.0 THO v6.5
    SubstanceAdministration.​precondition.nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​precondition.typeId.​nullFlavor Base required CDANullFlavor 📦2.0.1-sd Clinical Document Architecture v2.0
    SubstanceAdministration.​precondition.typeCode Base required CDAActRelationshipType 📦2.0.1-sd Clinical Document Architecture v2.0

    Constraints

    Id Grade Path(s) Description Expression
    1098-32890 error SubstanceAdministration.effectiveTime:duration This effectiveTime **SHALL** contain either a low or a @value but not both (CONF:1098-32890). (value.exists() or low.exists()) and ((value.exists() and low.exists()).not())
    II-1 error SubstanceAdministration.typeId, SubstanceAdministration.consumable.typeId, SubstanceAdministration.entryRelationship:priorityPreference.typeId, SubstanceAdministration.entryRelationship:indication.typeId, SubstanceAdministration.entryRelationship:instruction.typeId, SubstanceAdministration.precondition.typeId An II instance must have either a root or an nullFlavor. root.exists() or nullFlavor.exists()
    dose-unit-or-admin-unit error SubstanceAdministration If doseQuantity/@unit is present, then administrationUnitCode SHALL NOT be present. doseQuantity.unit.exists() implies administrationUnitCode.empty()
    should-author warning SubstanceAdministration SHOULD contain author author.exists()
    should-low warning SubstanceAdministration.effectiveTime:duration SHOULD contain low low.exists()
    should-text-ref-value warning SubstanceAdministration SHOULD contain text/reference/@value text.reference.value.exists()
    should-translation warning SubstanceAdministration.routeCode SHOULD contain translation translation.exists()
    should-unit warning SubstanceAdministration.doseQuantity, SubstanceAdministration.rateQuantity SHOULD contain @unit nullFlavor.exists() or unit.exists()
    should-value-att warning SubstanceAdministration.effectiveTime:duration SHOULD contain @value value.exists()
    value-starts-octothorpe error SubstanceAdministration.text.reference If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative value.exists() implies value.startsWith('#')

    This structure is derived from SubstanceAdministration

    Summary

    Mandatory: 9 elements(6 nested mandatory elements)
    Fixed: 4 elements

    Structures

    This structure refers to these other structures:

    Slices

    This structure defines the following Slices:

    • The element 2 is sliced based on the values of SubstanceAdministration.templateId
    • The element 1 is sliced based on the value of SubstanceAdministration.effectiveTime
    • The element 1 is sliced based on the value of SubstanceAdministration.entryRelationship

     

    Other representations of profile: CSV, Excel