Consolidated CDA
3.0.0-ballot - ballot United States of America flag

This page is part of the CCDA: Consolidated CDA Release (v3.0.0-ballot: CCDA 3.0 Ballot 1) based on FHIR (HL7® FHIR® Standard) v5.0.0. . For a full list of available versions, see the Directory of published versions

Logical Model: Medication Activity

Official URL: http://hl7.org/cda/us/ccda/StructureDefinition/MedicationActivity Version: 3.0.0-ballot
Draft as of 2023-12-21 Computable Name: MedicationActivity
Other Identifiers: id: urn:hl7ii:2.16.840.1.113883.10.20.22.4.16:2014-06-09

A Medication Activity describes substance administrations that have actually occurred (e.g., pills ingested or injections given) or are intended to occur (e.g., “take 2 tablets twice a day for the next 10 days”). Medication activities in “INT” mood are reflections of what a clinician intends a patient to be taking. For example, a clinician may intend that a patient be administered Lisinopril 20 mg PO for blood pressure control. If what was actually administered was Lisinopril 10 mg., then the Medication activities in the “EVN” mood would reflect actual use.

A moodCode of INT is allowed, but it is recommended that the Planned Medication Activity template be used for moodCodes other than EVN if the document type contains a section that includes Planned Medication Activity (for example a Care Plan document with Plan of Treatment, Intervention, or Goal sections).

At a minimum, a Medication Activity shall include an effectiveTime indicating the duration of the administration (or single-administration timestamp). Ambulatory medication lists generally provide a summary of use for a given medication over time - a medication activity in event mood with the duration reflecting when the medication started and stopped. Ongoing medications will not have a stop date (or will have a stop date with a suitable NULL value). Ambulatory medication lists will generally also have a frequency (e.g., a medication is being taken twice a day). Inpatient medications generally record each administration as a separate act.

The dose (doseQuantity) represents how many of the consumables are to be administered at each administration event. As a result, the dose is always relative to the consumable and the interval of administration. Thus, a patient consuming a single “metoprolol 25mg tablet “ per administration will have a doseQuantity of “1 “, whereas a patient consuming “metoprolol Oral Product “ (RxCUI 1163523) will have a dose of “25 mg “.

Usage:

Formal Views of Profile Content

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

This structure is derived from SubstanceAdministration

NameFlagsCard.TypeDescription & Constraintsdoco
.. SubstanceAdministration C1..1SubstanceAdministrationXML Namespace: urn:hl7-org:v3
Elements defined in Ancestors: @nullFlavor, realmCode, typeId, templateId, @classCode, @moodCode, id, code, @negationInd, text, statusCode, effectiveTime, priorityCode, repeatNumber, routeCode, approachSiteCode, doseQuantity, rateQuantity, maxDoseQuantity, administrationUnitCode, consumable, subject, specimen, performer, author, informant, participant, entryRelationship, reference, precondition, sdtcInFulfillmentOf1
Base for all types and resources
Instances of this type are validated by templateId
Logical Container: ClinicalDocument (CDA Class)
should-text-ref-value: SHOULD contain text/reference/@value
1098-7513: SHOULD contain zero or one [0..1] effectiveTime (CONF:1098-7513) such that it **SHALL** contain exactly one [1..1] @xsi:type="PIVL_TS" or "EIVL_TS" (CONF:1098-28499).
should-routeCode: SHOULD contain routeCode
dose-unit-or-admin-unit: If doseQuantity/@unit is present, then administrationUnitCode SHALL NOT be present.
should-author: SHOULD contain author
... Slices for templateId 1..*IISlice: Unordered, Open by value:root, value:extension
.... templateId:medication-activity 1..1II
..... @root 1..1oid, uuid, ruidRequired Pattern: 2.16.840.1.113883.10.20.22.4.16
..... @extension 1..1stRequired Pattern: 2014-06-09
... @classCode 1..1cs
... @moodCode 1..1csBinding: MoodCodeEvnInt (required)
... code 0..1CDSubstanceAdministration.code is an optional field. Per HL7 Pharmacy Committee, "this is intended to further specify the nature of the substance administration act. To date the committee has made no use of this attribute". Because the type of substance administration is generally implicit in the routeCode, in the consumable participant, etc., the field is generally not used, and there is no defined value set.
... text 0..1EDSHOULD reference the portion of section narrative text corresponding to this entry
.... reference C0..1TELvalue-starts-octothorpe: If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative
... statusCode 1..1CS
.... @code 1..1csThe substance administration effectiveTime field can repeat, in order to represent varying levels of complex dosing. effectiveTime can be used to represent the duration of administration (e.g., "10 days"), the frequency of administration (e.g., "every 8 hours"), and more. Here, we require that there SHALL be an effectiveTime documentation of the duration (or single-administration timestamp), and that there SHOULD be an effectiveTime documentation of the frequency. Other timing nuances, supported by the base CDA R2 standard, may also be included.
Binding: Medication Status (required)
... Slices for effectiveTime 1..*SXCM_TS, IVL_TS, EIVL_TS, PIVL_TS, SXPR_TSSlice: Unordered, Open by type:$this
.... effectiveTime:duration C1..1IVL_TSThe substance administration effectiveTime field can repeat, in order to represent varying levels of complex dosing. effectiveTime can be used to represent the duration of administration (e.g., "10 days"), the frequency of administration (e.g., "every 8 hours"), and more. Here, we require that there **SHALL** be an effectiveTime documentation of the duration (or single-administration timestamp), and that there **SHOULD** be an effectiveTime documentation of the frequency. Other timing nuances, supported by the base CDA R2 standard, may also be included. Note: This effectiveTime represents either the medication duration (i.e., the time the medication was started and stopped) or the single-administration timestamp.
1098-32890: This effectiveTime **SHALL** contain either a low or a @value but not both (CONF:1098-32890).
should-value-att: SHOULD contain @value
should-low: SHOULD contain low
..... @value 0..1tsindicates a single-administration timestamp
..... low 0..1IVXB_TSindicates when medication started
..... high 0..1IVXB_TSindicates when medication stopped
.... effectiveTime:periodicFrequency 0..1EIVL_TSThis effectiveTime represents a periodic medication frequency (e.g., administration times per day).
..... @operator 1..1csRequired Pattern: A
.... effectiveTime:eventFrequency 0..1PIVL_TSThis effectiveTime represents an event-based medication frequency (e.g., administration at bedtime).
..... @operator 1..1csRequired Pattern: A
... repeatNumber 0..1IVL_INTIn "INT" (intent) mood, the repeatNumber defines the number of allowed administrations. For example, a repeatNumber of "3" means that the substance can be administered up to 3 times. In "EVN" (event) mood, the repeatNumber is the number of occurrences. For example, a repeatNumber of "3" in a substance administration event means that the current administration is the 3rd in a series.
... routeCode C0..1CEBinding: SPL Drug Route of Administration Terminology (required)
should-translation: SHOULD contain translation
.... translation 0..*CDBinding: Medication Route (required)
... approachSiteCode 0..1CDBinding: Body Site Value Set (required)
... doseQuantity C1..1IVL_PQ(USCDI) Dose Unit of Measure
should-unit: SHOULD contain @unit
.... @unit 0..1csNOTE: 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)
... rateQuantity 0..1IVL_PQ
.... @unit 1..1csNOTE: 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..1RTO_PQ_PQ
... administrationUnitCode 0..1CEadministrationUnitCode@code describes the units of medication administration for an item using a code that is pre-coordinated to include a physical unit form (ointment, powder, solution, etc.) which differs from the units used in administering the consumable (capful, spray, drop, etc.). For example when recording medication administrations, 'metric drop (C48491)'' would be appropriate to accompany the RxNorm code of 198283 (Timolol 0.25% Ophthalmic Solution) where the number of drops would be specified in doseQuantity@value.
Binding: AdministrationUnitDoseForm (required)
... consumable 1..1InfrastructureRoot(USCDI) Medications
.... manufacturedProduct 1..1MedicationInformationBase for all types and resources
... performer 0..1Performer2
... author 0..*AuthorParticipationBase for all types and resources
... Slices for participant 0..*Participant2Slice: Unordered, Open by value:typeCode
.... participant:drugVehicle 0..*Participant2
..... @typeCode 1..1csFixed Value: CSM
..... participantRole 1..1DrugVehicleBase for all types and resources
... Slices for entryRelationship 0..*EntryRelationshipSlice: Unordered, Open by profile:substanceAdministration, profile:observation, profile:act, profile:supply
.... entryRelationship:indication 0..*EntryRelationship(USCDI) Indication
..... @typeCode 1..1csFixed Value: RSON
..... observation 1..1IndicationBase for all types and resources
.... entryRelationship:instruction 0..1EntryRelationship
..... @typeCode 1..1csFixed Value: SUBJ
..... @inversionInd 1..1blFixed Value: true
..... act 1..1InstructionBase for all types and resources
.... entryRelationship:supplyOrder 0..1EntryRelationship
..... @typeCode 1..1csFixed Value: REFR
..... supply 1..1MedicationSupplyOrderBase for all types and resources
.... entryRelationship:medicationDispense 0..*EntryRelationship
..... @typeCode 1..1csFixed Value: REFR
..... supply 1..1MedicationDispenseBase for all types and resources
.... entryRelationship:reaction 0..*EntryRelationship
..... @typeCode 1..1csFixed Value: CAUS
..... observation 1..1ReactionObservationBase for all types and resources
.... entryRelationship:drugMonitoring 0..1EntryRelationship
..... @typeCode 1..1csFixed Value: COMP
..... act 1..1DrugMonitoringActBase for all types and resources
.... entryRelationship:substanceAdministered 0..*EntryRelationshipThe following entryRelationship is used to indicate a given medication's order in a series. The nested Substance Administered Act identifies an administration in the series. The entryRelationship/sequenceNumber shows the order of this particular administration in that series.
..... @typeCode 1..1csFixed Value: COMP
..... @inversionInd 1..1blFixed Value: true
..... sequenceNumber 0..1INT
..... act 1..1SubstanceAdministeredActBase for all types and resources
.... entryRelationship:adherence 0..*EntryRelationship(USCDI) Medication Adherence
..... @typeCode 1..1csFixed Value: COMP
..... observation 1..1MedicationAdherenceBase for all types and resources
.... entryRelationship:signature 0..*EntryRelationship(USCDI) Medication Instructions
..... @typeCode 1..1csFixed Value: COMP
..... substanceAdministration 1..1MedicationFreeTextSigBase for all types and resources
... precondition 0..*Precondition
.... @typeCode 1..1cs
.... criterion 1..1PreconditionforSubstanceAdministrationBase for all types and resources

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSet
SubstanceAdministration.moodCoderequiredMoodCodeEvnInt
SubstanceAdministration.statusCode.coderequiredMedicationStatus
SubstanceAdministration.routeCoderequiredSPLDrugRouteOfAdministrationTerminology
SubstanceAdministration.routeCode.translationrequiredMedicationRoute
SubstanceAdministration.approachSiteCoderequiredBodySiteValueSet
SubstanceAdministration.doseQuantity.unitrequiredUnitsOfMeasureCaseSensitive (a valid code from UCUM)
SubstanceAdministration.rateQuantity.unitrequiredUnitsOfMeasureCaseSensitive (a valid code from UCUM)
SubstanceAdministration.administrationUnitCoderequiredAdministrationUnitDoseForm

Constraints

IdGradePath(s)DetailsRequirements
1098-7513warningSubstanceAdministrationSHOULD contain zero or one [0..1] effectiveTime (CONF:1098-7513) such that it **SHALL** contain exactly one [1..1] @xsi:type="PIVL_TS" or "EIVL_TS" (CONF:1098-28499).
: effectiveTime.ofType(CDA.PIVL_TS).exists() or effectiveTime.ofType(CDA.EIVL_TS).exists()
1098-32890errorSubstanceAdministration.effectiveTime:durationThis 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-uniterrorSubstanceAdministrationIf doseQuantity/@unit is present, then administrationUnitCode SHALL NOT be present.
: doseQuantity.unit.exists() implies administrationUnitCode.empty()
should-authorwarningSubstanceAdministrationSHOULD contain author
: author.exists()
should-lowwarningSubstanceAdministration.effectiveTime:durationSHOULD contain low
: low.exists()
should-routeCodewarningSubstanceAdministrationSHOULD contain routeCode
: routeCode.exists()
should-text-ref-valuewarningSubstanceAdministrationSHOULD contain text/reference/@value
: text.reference.value.exists()
should-translationwarningSubstanceAdministration.routeCodeSHOULD contain translation
: translation.exists()
should-unitwarningSubstanceAdministration.doseQuantitySHOULD contain @unit
: nullFlavor.exists() or unit.exists()
should-value-attwarningSubstanceAdministration.effectiveTime:durationSHOULD contain @value
: value.exists()
value-starts-octothorpeerrorSubstanceAdministration.text.referenceIf reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative
: value.exists() implies value.startsWith('#')
NameFlagsCard.TypeDescription & Constraintsdoco
.. SubstanceAdministration C1..1SubstanceAdministrationXML Namespace: urn:hl7-org:v3
Elements defined in Ancestors: @nullFlavor, realmCode, typeId, templateId, @classCode, @moodCode, id, code, @negationInd, text, statusCode, effectiveTime, priorityCode, repeatNumber, routeCode, approachSiteCode, doseQuantity, rateQuantity, maxDoseQuantity, administrationUnitCode, consumable, subject, specimen, performer, author, informant, participant, entryRelationship, reference, precondition, sdtcInFulfillmentOf1
Base for all types and resources
Instances of this type are validated by templateId
Logical Container: ClinicalDocument (CDA Class)
should-text-ref-value: SHOULD contain text/reference/@value
1098-7513: SHOULD contain zero or one [0..1] effectiveTime (CONF:1098-7513) such that it **SHALL** contain exactly one [1..1] @xsi:type="PIVL_TS" or "EIVL_TS" (CONF:1098-28499).
should-routeCode: SHOULD contain routeCode
dose-unit-or-admin-unit: If doseQuantity/@unit is present, then administrationUnitCode SHALL NOT be present.
should-author: SHOULD contain author
... Slices for templateId 1..*IISlice: Unordered, Open by value:root, value:extension
.... templateId:medication-activity 1..1II
..... @root 1..1oid, uuid, ruidRequired Pattern: 2.16.840.1.113883.10.20.22.4.16
..... @extension 1..1stRequired Pattern: 2014-06-09
... @classCode 1..1csBinding: ActClass (2.0.0) (required)
Fixed Value: SBADM
... @moodCode 1..1csBinding: MoodCodeEvnInt (required)
... code 0..1CDSubstanceAdministration.code is an optional field. Per HL7 Pharmacy Committee, "this is intended to further specify the nature of the substance administration act. To date the committee has made no use of this attribute". Because the type of substance administration is generally implicit in the routeCode, in the consumable participant, etc., the field is generally not used, and there is no defined value set.
Binding: ActSubstanceAdministrationCode (example)
... text 0..1EDSHOULD reference the portion of section narrative text corresponding to this entry
.... reference C0..1TELvalue-starts-octothorpe: If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative
... statusCode 1..1CSBinding: ActStatus (required)
.... @code 1..1csThe substance administration effectiveTime field can repeat, in order to represent varying levels of complex dosing. effectiveTime can be used to represent the duration of administration (e.g., "10 days"), the frequency of administration (e.g., "every 8 hours"), and more. Here, we require that there SHALL be an effectiveTime documentation of the duration (or single-administration timestamp), and that there SHOULD be an effectiveTime documentation of the frequency. Other timing nuances, supported by the base CDA R2 standard, may also be included.
Binding: Medication Status (required)
... Slices for effectiveTime 1..*Slice: Unordered, Open by type:$this
.... effectiveTimeSXCM_TS
.... effectiveTimeIVL_TS
.... effectiveTimeEIVL_TS
.... effectiveTimePIVL_TS
.... effectiveTimeSXPR_TS
.... effectiveTime:duration C1..1IVL_TSThe substance administration effectiveTime field can repeat, in order to represent varying levels of complex dosing. effectiveTime can be used to represent the duration of administration (e.g., "10 days"), the frequency of administration (e.g., "every 8 hours"), and more. Here, we require that there **SHALL** be an effectiveTime documentation of the duration (or single-administration timestamp), and that there **SHOULD** be an effectiveTime documentation of the frequency. Other timing nuances, supported by the base CDA R2 standard, may also be included. Note: This effectiveTime represents either the medication duration (i.e., the time the medication was started and stopped) or the single-administration timestamp.
1098-32890: This effectiveTime **SHALL** contain either a low or a @value but not both (CONF:1098-32890).
should-value-att: SHOULD contain @value
should-low: SHOULD contain low
..... @value 0..1tsindicates a single-administration timestamp
Date Format: YYYYMMDDHHMMSS.UUUU[+|-ZZzz]
..... low 0..1IVXB_TSindicates when medication started
..... high 0..1IVXB_TSindicates when medication stopped
.... effectiveTime:periodicFrequency 0..1EIVL_TSThis effectiveTime represents a periodic medication frequency (e.g., administration times per day).
..... @operator 1..1csBinding: SetOperator (required)
Required Pattern: A
.... effectiveTime:eventFrequency 0..1PIVL_TSThis effectiveTime represents an event-based medication frequency (e.g., administration at bedtime).
..... @operator 1..1csBinding: SetOperator (required)
Required Pattern: A
... repeatNumber 0..1IVL_INTIn "INT" (intent) mood, the repeatNumber defines the number of allowed administrations. For example, a repeatNumber of "3" means that the substance can be administered up to 3 times. In "EVN" (event) mood, the repeatNumber is the number of occurrences. For example, a repeatNumber of "3" in a substance administration event means that the current administration is the 3rd in a series.
... routeCode C0..1CEBinding: SPL Drug Route of Administration Terminology (required)
should-translation: SHOULD contain translation
.... translation 0..*CDBinding: Medication Route (required)
... approachSiteCode 0..1CDBinding: Body Site Value Set (required)
... doseQuantity C1..1IVL_PQ(USCDI) Dose Unit of Measure
should-unit: SHOULD contain @unit
.... @unit 0..1csNOTE: 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)
... rateQuantity 0..1IVL_PQ
.... @unit 1..1csNOTE: 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..1RTO_PQ_PQ
... administrationUnitCode 0..1CEadministrationUnitCode@code describes the units of medication administration for an item using a code that is pre-coordinated to include a physical unit form (ointment, powder, solution, etc.) which differs from the units used in administering the consumable (capful, spray, drop, etc.). For example when recording medication administrations, 'metric drop (C48491)'' would be appropriate to accompany the RxNorm code of 198283 (Timolol 0.25% Ophthalmic Solution) where the number of drops would be specified in doseQuantity@value.
Binding: AdministrationUnitDoseForm (required)
... consumable 1..1InfrastructureRoot(USCDI) Medications
.... manufacturedProduct C1..1MedicationInformationBase for all types and resources
... performer 0..1Performer2
... author 0..*AuthorParticipationBase for all types and resources
... Slices for participant 0..*Participant2Slice: Unordered, Open by value:typeCode
.... participant:drugVehicle 0..*Participant2
..... @typeCode 1..1csBinding: ParticipationType (required)
Fixed Value: CSM
..... participantRole C1..1DrugVehicleBase for all types and resources
... Slices for entryRelationship 0..*EntryRelationshipSlice: Unordered, Open by profile:substanceAdministration, profile:observation, profile:act, profile:supply
.... entryRelationship:indication 0..*EntryRelationship(USCDI) Indication
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: RSON
..... observation C1..1IndicationBase for all types and resources
.... entryRelationship:instruction 0..1EntryRelationship
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: SUBJ
..... @inversionInd 1..1blFixed Value: true
..... act C1..1InstructionBase for all types and resources
.... entryRelationship:supplyOrder 0..1EntryRelationship
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: REFR
..... supply C1..1MedicationSupplyOrderBase for all types and resources
.... entryRelationship:medicationDispense 0..*EntryRelationship
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: REFR
..... supply C1..1MedicationDispenseBase for all types and resources
.... entryRelationship:reaction 0..*EntryRelationship
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: CAUS
..... observation C1..1ReactionObservationBase for all types and resources
.... entryRelationship:drugMonitoring 0..1EntryRelationship
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: COMP
..... act C1..1DrugMonitoringActBase for all types and resources
.... entryRelationship:substanceAdministered 0..*EntryRelationshipThe following entryRelationship is used to indicate a given medication's order in a series. The nested Substance Administered Act identifies an administration in the series. The entryRelationship/sequenceNumber shows the order of this particular administration in that series.
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: COMP
..... @inversionInd 1..1blFixed Value: true
..... sequenceNumber 0..1INT
..... act C1..1SubstanceAdministeredActBase for all types and resources
.... entryRelationship:adherence 0..*EntryRelationship(USCDI) Medication Adherence
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: COMP
..... observation C1..1MedicationAdherenceBase for all types and resources
.... entryRelationship:signature 0..*EntryRelationship(USCDI) Medication Instructions
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: COMP
..... substanceAdministration C1..1MedicationFreeTextSigBase for all types and resources
... precondition 0..*Precondition
.... @typeCode 1..1csBinding: ActRelationshipType (required)
Fixed Value: PRCN
.... criterion 1..1PreconditionforSubstanceAdministrationBase for all types and resources

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / Code
SubstanceAdministration.classCoderequiredFixed Value: SBADM
SubstanceAdministration.moodCoderequiredMoodCodeEvnInt
SubstanceAdministration.codeexampleActSubstanceAdministrationCode
SubstanceAdministration.statusCoderequiredActStatus
SubstanceAdministration.statusCode.coderequiredMedicationStatus
SubstanceAdministration.effectiveTime:periodicFrequency.operatorrequiredPattern: A
SubstanceAdministration.effectiveTime:eventFrequency.operatorrequiredPattern: A
SubstanceAdministration.routeCoderequiredSPLDrugRouteOfAdministrationTerminology
SubstanceAdministration.routeCode.translationrequiredMedicationRoute
SubstanceAdministration.approachSiteCoderequiredBodySiteValueSet
SubstanceAdministration.doseQuantity.unitrequiredUnitsOfMeasureCaseSensitive (a valid code from UCUM)
SubstanceAdministration.rateQuantity.unitrequiredUnitsOfMeasureCaseSensitive (a valid code from UCUM)
SubstanceAdministration.administrationUnitCoderequiredAdministrationUnitDoseForm
SubstanceAdministration.participant:drugVehicle.typeCoderequiredFixed Value: CSM
SubstanceAdministration.entryRelationship:indication.typeCoderequiredFixed Value: RSON
SubstanceAdministration.entryRelationship:instruction.typeCoderequiredFixed Value: SUBJ
SubstanceAdministration.entryRelationship:supplyOrder.typeCoderequiredFixed Value: REFR
SubstanceAdministration.entryRelationship:medicationDispense.typeCoderequiredFixed Value: REFR
SubstanceAdministration.entryRelationship:reaction.typeCoderequiredFixed Value: CAUS
SubstanceAdministration.entryRelationship:drugMonitoring.typeCoderequiredFixed Value: COMP
SubstanceAdministration.entryRelationship:substanceAdministered.typeCoderequiredFixed Value: COMP
SubstanceAdministration.entryRelationship:adherence.typeCoderequiredFixed Value: COMP
SubstanceAdministration.entryRelationship:signature.typeCoderequiredFixed Value: COMP
SubstanceAdministration.precondition.typeCoderequiredFixed Value: PRCN

Constraints

IdGradePath(s)DetailsRequirements
1098-7513warningSubstanceAdministrationSHOULD contain zero or one [0..1] effectiveTime (CONF:1098-7513) such that it **SHALL** contain exactly one [1..1] @xsi:type="PIVL_TS" or "EIVL_TS" (CONF:1098-28499).
: effectiveTime.ofType(CDA.PIVL_TS).exists() or effectiveTime.ofType(CDA.EIVL_TS).exists()
1098-32890errorSubstanceAdministration.effectiveTime:durationThis 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-uniterrorSubstanceAdministrationIf doseQuantity/@unit is present, then administrationUnitCode SHALL NOT be present.
: doseQuantity.unit.exists() implies administrationUnitCode.empty()
product-choiceerrorSubstanceAdministration.consumable.manufacturedProductmanufacturedLabeledDrug and manufacturedMaterial are mutually exclusive (one must be present)
: (manufacturedLabeledDrug | manufacturedMaterial).count() = 1
role-choiceerrorSubstanceAdministration.participant:drugVehicle.participantRoleplayingDevice and playingEntity are mutually exclusive
: (playingDevice | playingEntity).count() <= 1
should-authorwarningSubstanceAdministrationSHOULD contain author
: author.exists()
should-effectiveTimewarningSubstanceAdministration.entryRelationship:indication.observation, SubstanceAdministration.entryRelationship:medicationDispense.supply, SubstanceAdministration.entryRelationship:reaction.observationSHOULD contain effectiveTime
: effectiveTime.exists()
should-informantwarningSubstanceAdministration.entryRelationship:adherence.observationSHOULD contain informant
: informant.exists()
should-lowwarningSubstanceAdministration.effectiveTime:durationSHOULD contain low
: low.exists()
should-quantitywarningSubstanceAdministration.entryRelationship:supplyOrder.supply, SubstanceAdministration.entryRelationship:medicationDispense.supplySHOULD contain quantity
: quantity.exists()
should-repeatNumberwarningSubstanceAdministration.entryRelationship:supplyOrder.supply, SubstanceAdministration.entryRelationship:medicationDispense.supplySHOULD contain repeatNumber
: repeatNumber.exists()
should-routeCodewarningSubstanceAdministrationSHOULD contain routeCode
: routeCode.exists()
should-text-ref-valuewarningSubstanceAdministrationSHOULD contain text/reference/@value
: text.reference.value.exists()
should-text-ref-valuewarningSubstanceAdministration.entryRelationship:indication.observation, SubstanceAdministration.entryRelationship:instruction.act, SubstanceAdministration.entryRelationship:supplyOrder.supply, SubstanceAdministration.entryRelationship:medicationDispense.supply, SubstanceAdministration.entryRelationship:reaction.observation, SubstanceAdministration.entryRelationship:drugMonitoring.act, SubstanceAdministration.entryRelationship:substanceAdministered.act, SubstanceAdministration.entryRelationship:adherence.observation, SubstanceAdministration.entryRelationship:signature.substanceAdministrationSHOULD contain text/reference/@value
: text.reference.value.exists()
should-translationwarningSubstanceAdministration.routeCodeSHOULD contain translation
: translation.exists()
should-unitwarningSubstanceAdministration.doseQuantitySHOULD contain @unit
: nullFlavor.exists() or unit.exists()
should-value-attwarningSubstanceAdministration.effectiveTime:durationSHOULD contain @value
: value.exists()
sig-closederrorSubstanceAdministration.entryRelationship:signature.substanceAdministrationThis is a closed template and shall not contain any elements besides code, text, and consumable
: (typeId | statusCode | effectiveTime | priorityCode | repeatNumber | routeCode | approachSiteCode | doseQuantity | rateQuantity | maxDoseQuantity | administrationUnitCode | subject | specimen | performer | informant | participant | entryRelationship | precondition).empty()
value-starts-octothorpeerrorSubstanceAdministration.text.referenceIf reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative
: value.exists() implies value.startsWith('#')
NameFlagsCard.TypeDescription & Constraintsdoco
.. SubstanceAdministration C1..1SubstanceAdministrationXML Namespace: urn:hl7-org:v3
Elements defined in Ancestors: @nullFlavor, realmCode, typeId, templateId, @classCode, @moodCode, id, code, @negationInd, text, statusCode, effectiveTime, priorityCode, repeatNumber, routeCode, approachSiteCode, doseQuantity, rateQuantity, maxDoseQuantity, administrationUnitCode, consumable, subject, specimen, performer, author, informant, participant, entryRelationship, reference, precondition, sdtcInFulfillmentOf1
Base for all types and resources
Instances of this type are validated by templateId
Logical Container: ClinicalDocument (CDA Class)
should-text-ref-value: SHOULD contain text/reference/@value
1098-7513: SHOULD contain zero or one [0..1] effectiveTime (CONF:1098-7513) such that it **SHALL** contain exactly one [1..1] @xsi:type="PIVL_TS" or "EIVL_TS" (CONF:1098-28499).
should-routeCode: SHOULD contain routeCode
dose-unit-or-admin-unit: If doseQuantity/@unit is present, then administrationUnitCode SHALL NOT be present.
should-author: SHOULD contain author
... @nullFlavor 0..1csBinding: CDANullFlavor (required)
... realmCode 0..*CS
... typeId 0..1II
.... @nullFlavor 0..1csBinding: CDANullFlavor (required)
.... @assigningAuthorityName 0..1st
.... @displayable 0..1bl
.... @root 1..1oid, uuid, ruidFixed Value: 2.16.840.1.113883.1.3
.... @extension 1..1st
... Slices for templateId 1..*IISlice: Unordered, Open by value:root, value:extension
.... templateId:medication-activity 1..1II
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... @assigningAuthorityName 0..1st
..... @displayable 0..1bl
..... @root 1..1oid, uuid, ruidRequired Pattern: 2.16.840.1.113883.10.20.22.4.16
..... @extension 1..1stRequired Pattern: 2014-06-09
... @classCode 1..1csBinding: ActClass (2.0.0) (required)
Fixed Value: SBADM
... @moodCode 1..1csBinding: MoodCodeEvnInt (required)
... id 1..*II
... code 0..1CDSubstanceAdministration.code is an optional field. Per HL7 Pharmacy Committee, "this is intended to further specify the nature of the substance administration act. To date the committee has made no use of this attribute". Because the type of substance administration is generally implicit in the routeCode, in the consumable participant, etc., the field is generally not used, and there is no defined value set.
Binding: ActSubstanceAdministrationCode (example)
... @negationInd 0..1bl
... text 0..1EDSHOULD reference the portion of section narrative text corresponding to this entry
.... @nullFlavor 0..1csBinding: CDANullFlavor (required)
.... @compression 0..1csBinding: CompressionAlgorithm (required)
.... @integrityCheck 0..1bin
.... @integrityCheckAlgorithm 0..1csBinding: IntegrityCheckAlgorithm (2.0.0) (required)
.... @language 0..1cs
.... @mediaType 0..1csBinding: MediaType (example)
.... @representation 0..1csBinding: Binary Data Encoding Value Set (required)
.... xmlText 0..1stAllows for mixed text content. If @representation='B64', this SHALL be a base64binary string.
.... reference C0..1TELvalue-starts-octothorpe: If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative
.... thumbnail 0..1ED
... statusCode 1..1CSBinding: ActStatus (required)
.... @nullFlavor 0..1csBinding: CDANullFlavor (required)
.... @code 1..1csThe substance administration effectiveTime field can repeat, in order to represent varying levels of complex dosing. effectiveTime can be used to represent the duration of administration (e.g., "10 days"), the frequency of administration (e.g., "every 8 hours"), and more. Here, we require that there SHALL be an effectiveTime documentation of the duration (or single-administration timestamp), and that there SHOULD be an effectiveTime documentation of the frequency. Other timing nuances, supported by the base CDA R2 standard, may also be included.
Binding: Medication Status (required)
.... @sdtcValueSet 0..1oidXML Namespace: urn:hl7-org:sdtc
XML: valueSet (urn:hl7-org:sdtc)
.... @sdtcValueSetVersion 0..1stXML Namespace: urn:hl7-org:sdtc
XML: valueSetVersion (urn:hl7-org:sdtc)
... Slices for effectiveTime 1..*Slice: Unordered, Open by type:$this
.... effectiveTimeSXCM_TS
.... effectiveTimeIVL_TS
.... effectiveTimeEIVL_TS
.... effectiveTimePIVL_TS
.... effectiveTimeSXPR_TS
.... effectiveTime:duration C1..1IVL_TSThe substance administration effectiveTime field can repeat, in order to represent varying levels of complex dosing. effectiveTime can be used to represent the duration of administration (e.g., "10 days"), the frequency of administration (e.g., "every 8 hours"), and more. Here, we require that there **SHALL** be an effectiveTime documentation of the duration (or single-administration timestamp), and that there **SHOULD** be an effectiveTime documentation of the frequency. Other timing nuances, supported by the base CDA R2 standard, may also be included. Note: This effectiveTime represents either the medication duration (i.e., the time the medication was started and stopped) or the single-administration timestamp.
1098-32890: This effectiveTime **SHALL** contain either a low or a @value but not both (CONF:1098-32890).
should-value-att: SHOULD contain @value
should-low: SHOULD contain low
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... @value 0..1tsindicates a single-administration timestamp
Date Format: YYYYMMDDHHMMSS.UUUU[+|-ZZzz]
..... @operator 0..1csBinding: SetOperator (required)
..... low 0..1IVXB_TSindicates when medication started
..... center 0..1TS
..... width 0..1PQ
..... high 0..1IVXB_TSindicates when medication stopped
.... effectiveTime:periodicFrequency 0..1EIVL_TSThis effectiveTime represents a periodic medication frequency (e.g., administration times per day).
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... @operator 1..1csBinding: SetOperator (required)
Required Pattern: A
..... event 0..1CE
..... offset 0..1IVL_PQ
.... effectiveTime:eventFrequency 0..1PIVL_TSThis effectiveTime represents an event-based medication frequency (e.g., administration at bedtime).
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... @operator 1..1csBinding: SetOperator (required)
Required Pattern: A
..... phase 0..1IVL_TS
..... period 0..1PQ
..... @alignment 0..1cs
..... @institutionSpecified 0..1bl
... priorityCode 0..1CEBinding: ActPriority (example)
... repeatNumber 0..1IVL_INTIn "INT" (intent) mood, the repeatNumber defines the number of allowed administrations. For example, a repeatNumber of "3" means that the substance can be administered up to 3 times. In "EVN" (event) mood, the repeatNumber is the number of occurrences. For example, a repeatNumber of "3" in a substance administration event means that the current administration is the 3rd in a series.
... routeCode C0..1CEBinding: SPL Drug Route of Administration Terminology (required)
should-translation: SHOULD contain translation
.... @nullFlavor 0..1csBinding: CDANullFlavor (required)
.... @code 0..1cs
.... @codeSystem 0..1oid, uuid, ruid
.... @codeSystemName 0..1st
.... @codeSystemVersion 0..1st
.... @displayName 0..1st
.... @sdtcValueSet 0..1oidXML Namespace: urn:hl7-org:sdtc
XML: valueSet (urn:hl7-org:sdtc)
.... @sdtcValueSetVersion 0..1stXML Namespace: urn:hl7-org:sdtc
XML: valueSetVersion (urn:hl7-org:sdtc)
.... originalText 0..1ED
.... translation 0..*CDBinding: Medication Route (required)
... approachSiteCode 0..1CDBinding: Body Site Value Set (required)
... doseQuantity C1..1IVL_PQ(USCDI) Dose Unit of Measure
should-unit: SHOULD contain @unit
.... @nullFlavor 0..1csBinding: CDANullFlavor (required)
.... @unit 0..1csNOTE: 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..1real
.... translation 0..*PQR
.... @operator 0..1csBinding: SetOperator (required)
.... low 0..1IVXB_PQ
.... center 0..1PQ
.... width 0..1PQ
.... high 0..1IVXB_PQ
... rateQuantity 0..1IVL_PQ
.... @nullFlavor 0..1csBinding: CDANullFlavor (required)
.... @unit 1..1csNOTE: 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..1real
.... translation 0..*PQR
.... @operator 0..1csBinding: SetOperator (required)
.... low 0..1IVXB_PQ
.... center 0..1PQ
.... width 0..1PQ
.... high 0..1IVXB_PQ
... maxDoseQuantity 0..1RTO_PQ_PQ
... administrationUnitCode 0..1CEadministrationUnitCode@code describes the units of medication administration for an item using a code that is pre-coordinated to include a physical unit form (ointment, powder, solution, etc.) which differs from the units used in administering the consumable (capful, spray, drop, etc.). For example when recording medication administrations, 'metric drop (C48491)'' would be appropriate to accompany the RxNorm code of 198283 (Timolol 0.25% Ophthalmic Solution) where the number of drops would be specified in doseQuantity@value.
Binding: AdministrationUnitDoseForm (required)
... consumable 1..1InfrastructureRoot(USCDI) Medications
.... @nullFlavor 0..1csBinding: CDANullFlavor (required)
.... realmCode 0..*CS
.... typeId 0..1II
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... @assigningAuthorityName 0..1st
..... @displayable 0..1bl
..... @root 1..1oid, uuid, ruidFixed Value: 2.16.840.1.113883.1.3
..... @extension 1..1st
.... templateId 0..*II
.... @typeCode 0..1csBinding: ParticipationType (required)
Fixed Value: CSM
.... manufacturedProduct C1..1MedicationInformationBase for all types and resources
... subject 0..1Subject
... specimen 0..*Specimen
... performer 0..1Performer2
... author 0..*AuthorParticipationBase for all types and resources
... informant 0..*Informant
... Slices for participant 0..*Participant2Slice: Unordered, Open by value:typeCode
.... participant:drugVehicle 0..*Participant2
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... realmCode 0..*CS
..... typeId 0..1II
...... @nullFlavor 0..1csBinding: CDANullFlavor (required)
...... @assigningAuthorityName 0..1st
...... @displayable 0..1bl
...... @root 1..1oid, uuid, ruidFixed Value: 2.16.840.1.113883.1.3
...... @extension 1..1st
..... templateId 0..*II
..... @typeCode 1..1csBinding: ParticipationType (required)
Fixed Value: CSM
..... @contextControlCode 0..1csBinding: ContextControl (required)
Fixed Value: OP
..... sdtcFunctionCode 0..1CEXML Namespace: urn:hl7-org:sdtc
XML: functionCode (urn:hl7-org:sdtc)
..... time 0..1IVL_TS
..... awarenessCode 0..1CE
..... participantRole C1..1DrugVehicleBase for all types and resources
... Slices for entryRelationship 0..*EntryRelationshipSlice: Unordered, Open by profile:substanceAdministration, profile:observation, profile:act, profile:supply
.... entryRelationship:indication 0..*EntryRelationship(USCDI) Indication
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... realmCode 0..*CS
..... typeId 0..1II
...... @nullFlavor 0..1csBinding: CDANullFlavor (required)
...... @assigningAuthorityName 0..1st
...... @displayable 0..1bl
...... @root 1..1oid, uuid, ruidFixed Value: 2.16.840.1.113883.1.3
...... @extension 1..1st
..... templateId 0..*II
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: RSON
..... @inversionInd 0..1bl
..... @contextConductionInd 0..1bl
..... @negationInd 0..1bl
..... sequenceNumber 0..1INT
..... seperatableInd 0..1BL
..... act 0..1Act
..... encounter 0..1Encounter
..... observation C1..1IndicationBase for all types and resources
..... observationMedia 0..1ObservationMedia
..... organizer 0..1Organizer
..... procedure 0..1Procedure
..... regionOfInterest 0..1RegionOfInterest
..... substanceAdministration 0..1SubstanceAdministration
..... supply 0..1Supply
.... entryRelationship:instruction 0..1EntryRelationship
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... realmCode 0..*CS
..... typeId 0..1II
...... @nullFlavor 0..1csBinding: CDANullFlavor (required)
...... @assigningAuthorityName 0..1st
...... @displayable 0..1bl
...... @root 1..1oid, uuid, ruidFixed Value: 2.16.840.1.113883.1.3
...... @extension 1..1st
..... templateId 0..*II
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: SUBJ
..... @inversionInd 1..1blFixed Value: true
..... @contextConductionInd 0..1bl
..... @negationInd 0..1bl
..... sequenceNumber 0..1INT
..... seperatableInd 0..1BL
..... act C1..1InstructionBase for all types and resources
..... encounter 0..1Encounter
..... observation 0..1Observation
..... observationMedia 0..1ObservationMedia
..... organizer 0..1Organizer
..... procedure 0..1Procedure
..... regionOfInterest 0..1RegionOfInterest
..... substanceAdministration 0..1SubstanceAdministration
..... supply 0..1Supply
.... entryRelationship:supplyOrder 0..1EntryRelationship
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... realmCode 0..*CS
..... typeId 0..1II
...... @nullFlavor 0..1csBinding: CDANullFlavor (required)
...... @assigningAuthorityName 0..1st
...... @displayable 0..1bl
...... @root 1..1oid, uuid, ruidFixed Value: 2.16.840.1.113883.1.3
...... @extension 1..1st
..... templateId 0..*II
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: REFR
..... @inversionInd 0..1bl
..... @contextConductionInd 0..1bl
..... @negationInd 0..1bl
..... sequenceNumber 0..1INT
..... seperatableInd 0..1BL
..... act 0..1Act
..... encounter 0..1Encounter
..... observation 0..1Observation
..... observationMedia 0..1ObservationMedia
..... organizer 0..1Organizer
..... procedure 0..1Procedure
..... regionOfInterest 0..1RegionOfInterest
..... substanceAdministration 0..1SubstanceAdministration
..... supply C1..1MedicationSupplyOrderBase for all types and resources
.... entryRelationship:medicationDispense 0..*EntryRelationship
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... realmCode 0..*CS
..... typeId 0..1II
...... @nullFlavor 0..1csBinding: CDANullFlavor (required)
...... @assigningAuthorityName 0..1st
...... @displayable 0..1bl
...... @root 1..1oid, uuid, ruidFixed Value: 2.16.840.1.113883.1.3
...... @extension 1..1st
..... templateId 0..*II
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: REFR
..... @inversionInd 0..1bl
..... @contextConductionInd 0..1bl
..... @negationInd 0..1bl
..... sequenceNumber 0..1INT
..... seperatableInd 0..1BL
..... act 0..1Act
..... encounter 0..1Encounter
..... observation 0..1Observation
..... observationMedia 0..1ObservationMedia
..... organizer 0..1Organizer
..... procedure 0..1Procedure
..... regionOfInterest 0..1RegionOfInterest
..... substanceAdministration 0..1SubstanceAdministration
..... supply C1..1MedicationDispenseBase for all types and resources
.... entryRelationship:reaction 0..*EntryRelationship
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... realmCode 0..*CS
..... typeId 0..1II
...... @nullFlavor 0..1csBinding: CDANullFlavor (required)
...... @assigningAuthorityName 0..1st
...... @displayable 0..1bl
...... @root 1..1oid, uuid, ruidFixed Value: 2.16.840.1.113883.1.3
...... @extension 1..1st
..... templateId 0..*II
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: CAUS
..... @inversionInd 0..1bl
..... @contextConductionInd 0..1bl
..... @negationInd 0..1bl
..... sequenceNumber 0..1INT
..... seperatableInd 0..1BL
..... act 0..1Act
..... encounter 0..1Encounter
..... observation C1..1ReactionObservationBase for all types and resources
..... observationMedia 0..1ObservationMedia
..... organizer 0..1Organizer
..... procedure 0..1Procedure
..... regionOfInterest 0..1RegionOfInterest
..... substanceAdministration 0..1SubstanceAdministration
..... supply 0..1Supply
.... entryRelationship:drugMonitoring 0..1EntryRelationship
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... realmCode 0..*CS
..... typeId 0..1II
...... @nullFlavor 0..1csBinding: CDANullFlavor (required)
...... @assigningAuthorityName 0..1st
...... @displayable 0..1bl
...... @root 1..1oid, uuid, ruidFixed Value: 2.16.840.1.113883.1.3
...... @extension 1..1st
..... templateId 0..*II
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: COMP
..... @inversionInd 0..1bl
..... @contextConductionInd 0..1bl
..... @negationInd 0..1bl
..... sequenceNumber 0..1INT
..... seperatableInd 0..1BL
..... act C1..1DrugMonitoringActBase for all types and resources
..... encounter 0..1Encounter
..... observation 0..1Observation
..... observationMedia 0..1ObservationMedia
..... organizer 0..1Organizer
..... procedure 0..1Procedure
..... regionOfInterest 0..1RegionOfInterest
..... substanceAdministration 0..1SubstanceAdministration
..... supply 0..1Supply
.... entryRelationship:substanceAdministered 0..*EntryRelationshipThe following entryRelationship is used to indicate a given medication's order in a series. The nested Substance Administered Act identifies an administration in the series. The entryRelationship/sequenceNumber shows the order of this particular administration in that series.
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... realmCode 0..*CS
..... typeId 0..1II
...... @nullFlavor 0..1csBinding: CDANullFlavor (required)
...... @assigningAuthorityName 0..1st
...... @displayable 0..1bl
...... @root 1..1oid, uuid, ruidFixed Value: 2.16.840.1.113883.1.3
...... @extension 1..1st
..... templateId 0..*II
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: COMP
..... @inversionInd 1..1blFixed Value: true
..... @contextConductionInd 0..1bl
..... @negationInd 0..1bl
..... sequenceNumber 0..1INT
..... seperatableInd 0..1BL
..... act C1..1SubstanceAdministeredActBase for all types and resources
..... encounter 0..1Encounter
..... observation 0..1Observation
..... observationMedia 0..1ObservationMedia
..... organizer 0..1Organizer
..... procedure 0..1Procedure
..... regionOfInterest 0..1RegionOfInterest
..... substanceAdministration 0..1SubstanceAdministration
..... supply 0..1Supply
.... entryRelationship:adherence 0..*EntryRelationship(USCDI) Medication Adherence
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... realmCode 0..*CS
..... typeId 0..1II
...... @nullFlavor 0..1csBinding: CDANullFlavor (required)
...... @assigningAuthorityName 0..1st
...... @displayable 0..1bl
...... @root 1..1oid, uuid, ruidFixed Value: 2.16.840.1.113883.1.3
...... @extension 1..1st
..... templateId 0..*II
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: COMP
..... @inversionInd 0..1bl
..... @contextConductionInd 0..1bl
..... @negationInd 0..1bl
..... sequenceNumber 0..1INT
..... seperatableInd 0..1BL
..... act 0..1Act
..... encounter 0..1Encounter
..... observation C1..1MedicationAdherenceBase for all types and resources
..... observationMedia 0..1ObservationMedia
..... organizer 0..1Organizer
..... procedure 0..1Procedure
..... regionOfInterest 0..1RegionOfInterest
..... substanceAdministration 0..1SubstanceAdministration
..... supply 0..1Supply
.... entryRelationship:signature 0..*EntryRelationship(USCDI) Medication Instructions
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... realmCode 0..*CS
..... typeId 0..1II
...... @nullFlavor 0..1csBinding: CDANullFlavor (required)
...... @assigningAuthorityName 0..1st
...... @displayable 0..1bl
...... @root 1..1oid, uuid, ruidFixed Value: 2.16.840.1.113883.1.3
...... @extension 1..1st
..... templateId 0..*II
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: COMP
..... @inversionInd 0..1bl
..... @contextConductionInd 0..1bl
..... @negationInd 0..1bl
..... sequenceNumber 0..1INT
..... seperatableInd 0..1BL
..... act 0..1Act
..... encounter 0..1Encounter
..... observation 0..1Observation
..... observationMedia 0..1ObservationMedia
..... organizer 0..1Organizer
..... procedure 0..1Procedure
..... regionOfInterest 0..1RegionOfInterest
..... substanceAdministration C1..1MedicationFreeTextSigBase for all types and resources
..... supply 0..1Supply
... reference 0..*Reference
... precondition 0..*Precondition
.... @nullFlavor 0..1csBinding: CDANullFlavor (required)
.... realmCode 0..*CS
.... typeId 0..1II
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... @assigningAuthorityName 0..1st
..... @displayable 0..1bl
..... @root 1..1oid, uuid, ruidFixed Value: 2.16.840.1.113883.1.3
..... @extension 1..1st
.... templateId 0..*II
.... @typeCode 1..1csBinding: ActRelationshipType (required)
Fixed Value: PRCN
.... criterion 1..1PreconditionforSubstanceAdministrationBase for all types and resources
... sdtcInFulfillmentOf1 0..*InFulfillmentOf1XML Namespace: urn:hl7-org:sdtc
XML: inFulfillmentOf1 (urn:hl7-org:sdtc)

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / Code
SubstanceAdministration.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.typeId.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.templateId:medication-activity.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.classCoderequiredFixed Value: SBADM
SubstanceAdministration.moodCoderequiredMoodCodeEvnInt
SubstanceAdministration.codeexampleActSubstanceAdministrationCode
SubstanceAdministration.text.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.text.compressionrequiredCDACompressionAlgorithm
SubstanceAdministration.text.integrityCheckAlgorithmrequiredIntegrityCheckAlgorithm
SubstanceAdministration.text.mediaTypeexampleMediaType
SubstanceAdministration.text.representationrequiredBinaryDataEncoding
SubstanceAdministration.statusCoderequiredActStatus
SubstanceAdministration.statusCode.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.statusCode.coderequiredMedicationStatus
SubstanceAdministration.effectiveTime:duration.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.effectiveTime:duration.operatorrequiredSetOperator
SubstanceAdministration.effectiveTime:periodicFrequency.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.effectiveTime:periodicFrequency.operatorrequiredPattern: A
SubstanceAdministration.effectiveTime:eventFrequency.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.effectiveTime:eventFrequency.operatorrequiredPattern: A
SubstanceAdministration.priorityCodeexampleActPriority
SubstanceAdministration.routeCoderequiredSPLDrugRouteOfAdministrationTerminology
SubstanceAdministration.routeCode.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.routeCode.translationrequiredMedicationRoute
SubstanceAdministration.approachSiteCoderequiredBodySiteValueSet
SubstanceAdministration.doseQuantity.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.doseQuantity.unitrequiredUnitsOfMeasureCaseSensitive (a valid code from UCUM)
SubstanceAdministration.doseQuantity.operatorrequiredSetOperator
SubstanceAdministration.rateQuantity.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.rateQuantity.unitrequiredUnitsOfMeasureCaseSensitive (a valid code from UCUM)
SubstanceAdministration.rateQuantity.operatorrequiredSetOperator
SubstanceAdministration.administrationUnitCoderequiredAdministrationUnitDoseForm
SubstanceAdministration.consumable.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.consumable.typeId.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.consumable.typeCoderequiredFixed Value: CSM
SubstanceAdministration.participant:drugVehicle.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.participant:drugVehicle.typeId.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.participant:drugVehicle.typeCoderequiredFixed Value: CSM
SubstanceAdministration.participant:drugVehicle.contextControlCoderequiredFixed Value: OP
SubstanceAdministration.entryRelationship:indication.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:indication.typeId.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:indication.typeCoderequiredFixed Value: RSON
SubstanceAdministration.entryRelationship:instruction.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:instruction.typeId.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:instruction.typeCoderequiredFixed Value: SUBJ
SubstanceAdministration.entryRelationship:supplyOrder.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:supplyOrder.typeId.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:supplyOrder.typeCoderequiredFixed Value: REFR
SubstanceAdministration.entryRelationship:medicationDispense.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:medicationDispense.typeId.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:medicationDispense.typeCoderequiredFixed Value: REFR
SubstanceAdministration.entryRelationship:reaction.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:reaction.typeId.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:reaction.typeCoderequiredFixed Value: CAUS
SubstanceAdministration.entryRelationship:drugMonitoring.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:drugMonitoring.typeId.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:drugMonitoring.typeCoderequiredFixed Value: COMP
SubstanceAdministration.entryRelationship:substanceAdministered.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:substanceAdministered.typeId.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:substanceAdministered.typeCoderequiredFixed Value: COMP
SubstanceAdministration.entryRelationship:adherence.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:adherence.typeId.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:adherence.typeCoderequiredFixed Value: COMP
SubstanceAdministration.entryRelationship:signature.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:signature.typeId.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:signature.typeCoderequiredFixed Value: COMP
SubstanceAdministration.precondition.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.precondition.typeId.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.precondition.typeCoderequiredFixed Value: PRCN

Constraints

IdGradePath(s)DetailsRequirements
1098-7513warningSubstanceAdministrationSHOULD contain zero or one [0..1] effectiveTime (CONF:1098-7513) such that it **SHALL** contain exactly one [1..1] @xsi:type="PIVL_TS" or "EIVL_TS" (CONF:1098-28499).
: effectiveTime.ofType(CDA.PIVL_TS).exists() or effectiveTime.ofType(CDA.EIVL_TS).exists()
1098-32890errorSubstanceAdministration.effectiveTime:durationThis 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-uniterrorSubstanceAdministrationIf doseQuantity/@unit is present, then administrationUnitCode SHALL NOT be present.
: doseQuantity.unit.exists() implies administrationUnitCode.empty()
product-choiceerrorSubstanceAdministration.consumable.manufacturedProductmanufacturedLabeledDrug and manufacturedMaterial are mutually exclusive (one must be present)
: (manufacturedLabeledDrug | manufacturedMaterial).count() = 1
role-choiceerrorSubstanceAdministration.participant:drugVehicle.participantRoleplayingDevice and playingEntity are mutually exclusive
: (playingDevice | playingEntity).count() <= 1
should-authorwarningSubstanceAdministrationSHOULD contain author
: author.exists()
should-effectiveTimewarningSubstanceAdministration.entryRelationship:indication.observation, SubstanceAdministration.entryRelationship:medicationDispense.supply, SubstanceAdministration.entryRelationship:reaction.observationSHOULD contain effectiveTime
: effectiveTime.exists()
should-informantwarningSubstanceAdministration.entryRelationship:adherence.observationSHOULD contain informant
: informant.exists()
should-lowwarningSubstanceAdministration.effectiveTime:durationSHOULD contain low
: low.exists()
should-quantitywarningSubstanceAdministration.entryRelationship:supplyOrder.supply, SubstanceAdministration.entryRelationship:medicationDispense.supplySHOULD contain quantity
: quantity.exists()
should-repeatNumberwarningSubstanceAdministration.entryRelationship:supplyOrder.supply, SubstanceAdministration.entryRelationship:medicationDispense.supplySHOULD contain repeatNumber
: repeatNumber.exists()
should-routeCodewarningSubstanceAdministrationSHOULD contain routeCode
: routeCode.exists()
should-text-ref-valuewarningSubstanceAdministrationSHOULD contain text/reference/@value
: text.reference.value.exists()
should-text-ref-valuewarningSubstanceAdministration.entryRelationship:indication.observation, SubstanceAdministration.entryRelationship:instruction.act, SubstanceAdministration.entryRelationship:supplyOrder.supply, SubstanceAdministration.entryRelationship:medicationDispense.supply, SubstanceAdministration.entryRelationship:reaction.observation, SubstanceAdministration.entryRelationship:drugMonitoring.act, SubstanceAdministration.entryRelationship:substanceAdministered.act, SubstanceAdministration.entryRelationship:adherence.observation, SubstanceAdministration.entryRelationship:signature.substanceAdministrationSHOULD contain text/reference/@value
: text.reference.value.exists()
should-translationwarningSubstanceAdministration.routeCodeSHOULD contain translation
: translation.exists()
should-unitwarningSubstanceAdministration.doseQuantitySHOULD contain @unit
: nullFlavor.exists() or unit.exists()
should-value-attwarningSubstanceAdministration.effectiveTime:durationSHOULD contain @value
: value.exists()
sig-closederrorSubstanceAdministration.entryRelationship:signature.substanceAdministrationThis is a closed template and shall not contain any elements besides code, text, and consumable
: (typeId | statusCode | effectiveTime | priorityCode | repeatNumber | routeCode | approachSiteCode | doseQuantity | rateQuantity | maxDoseQuantity | administrationUnitCode | subject | specimen | performer | informant | participant | entryRelationship | precondition).empty()
value-starts-octothorpeerrorSubstanceAdministration.text.referenceIf 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: 10 elements (15 nested mandatory elements)
Fixed Value: 12 elements

Structures

This structure refers to these other structures:

Slices

This structure defines the following Slices:

  • The element SubstanceAdministration.templateId is sliced based on the values of value:root, value:extension
  • The element SubstanceAdministration.effectiveTime is sliced based on the value of type:$this
  • The element SubstanceAdministration.participant is sliced based on the value of value:typeCode
  • The element SubstanceAdministration.entryRelationship is sliced based on the values of profile:substanceAdministration, profile:observation, profile:act, profile:supply

Differential View

This structure is derived from SubstanceAdministration

NameFlagsCard.TypeDescription & Constraintsdoco
.. SubstanceAdministration C1..1SubstanceAdministrationXML Namespace: urn:hl7-org:v3
Elements defined in Ancestors: @nullFlavor, realmCode, typeId, templateId, @classCode, @moodCode, id, code, @negationInd, text, statusCode, effectiveTime, priorityCode, repeatNumber, routeCode, approachSiteCode, doseQuantity, rateQuantity, maxDoseQuantity, administrationUnitCode, consumable, subject, specimen, performer, author, informant, participant, entryRelationship, reference, precondition, sdtcInFulfillmentOf1
Base for all types and resources
Instances of this type are validated by templateId
Logical Container: ClinicalDocument (CDA Class)
should-text-ref-value: SHOULD contain text/reference/@value
1098-7513: SHOULD contain zero or one [0..1] effectiveTime (CONF:1098-7513) such that it **SHALL** contain exactly one [1..1] @xsi:type="PIVL_TS" or "EIVL_TS" (CONF:1098-28499).
should-routeCode: SHOULD contain routeCode
dose-unit-or-admin-unit: If doseQuantity/@unit is present, then administrationUnitCode SHALL NOT be present.
should-author: SHOULD contain author
... Slices for templateId 1..*IISlice: Unordered, Open by value:root, value:extension
.... templateId:medication-activity 1..1II
..... @root 1..1oid, uuid, ruidRequired Pattern: 2.16.840.1.113883.10.20.22.4.16
..... @extension 1..1stRequired Pattern: 2014-06-09
... @classCode 1..1cs
... @moodCode 1..1csBinding: MoodCodeEvnInt (required)
... code 0..1CDSubstanceAdministration.code is an optional field. Per HL7 Pharmacy Committee, "this is intended to further specify the nature of the substance administration act. To date the committee has made no use of this attribute". Because the type of substance administration is generally implicit in the routeCode, in the consumable participant, etc., the field is generally not used, and there is no defined value set.
... text 0..1EDSHOULD reference the portion of section narrative text corresponding to this entry
.... reference C0..1TELvalue-starts-octothorpe: If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative
... statusCode 1..1CS
.... @code 1..1csThe substance administration effectiveTime field can repeat, in order to represent varying levels of complex dosing. effectiveTime can be used to represent the duration of administration (e.g., "10 days"), the frequency of administration (e.g., "every 8 hours"), and more. Here, we require that there SHALL be an effectiveTime documentation of the duration (or single-administration timestamp), and that there SHOULD be an effectiveTime documentation of the frequency. Other timing nuances, supported by the base CDA R2 standard, may also be included.
Binding: Medication Status (required)
... Slices for effectiveTime 1..*SXCM_TS, IVL_TS, EIVL_TS, PIVL_TS, SXPR_TSSlice: Unordered, Open by type:$this
.... effectiveTime:duration C1..1IVL_TSThe substance administration effectiveTime field can repeat, in order to represent varying levels of complex dosing. effectiveTime can be used to represent the duration of administration (e.g., "10 days"), the frequency of administration (e.g., "every 8 hours"), and more. Here, we require that there **SHALL** be an effectiveTime documentation of the duration (or single-administration timestamp), and that there **SHOULD** be an effectiveTime documentation of the frequency. Other timing nuances, supported by the base CDA R2 standard, may also be included. Note: This effectiveTime represents either the medication duration (i.e., the time the medication was started and stopped) or the single-administration timestamp.
1098-32890: This effectiveTime **SHALL** contain either a low or a @value but not both (CONF:1098-32890).
should-value-att: SHOULD contain @value
should-low: SHOULD contain low
..... @value 0..1tsindicates a single-administration timestamp
..... low 0..1IVXB_TSindicates when medication started
..... high 0..1IVXB_TSindicates when medication stopped
.... effectiveTime:periodicFrequency 0..1EIVL_TSThis effectiveTime represents a periodic medication frequency (e.g., administration times per day).
..... @operator 1..1csRequired Pattern: A
.... effectiveTime:eventFrequency 0..1PIVL_TSThis effectiveTime represents an event-based medication frequency (e.g., administration at bedtime).
..... @operator 1..1csRequired Pattern: A
... repeatNumber 0..1IVL_INTIn "INT" (intent) mood, the repeatNumber defines the number of allowed administrations. For example, a repeatNumber of "3" means that the substance can be administered up to 3 times. In "EVN" (event) mood, the repeatNumber is the number of occurrences. For example, a repeatNumber of "3" in a substance administration event means that the current administration is the 3rd in a series.
... routeCode C0..1CEBinding: SPL Drug Route of Administration Terminology (required)
should-translation: SHOULD contain translation
.... translation 0..*CDBinding: Medication Route (required)
... approachSiteCode 0..1CDBinding: Body Site Value Set (required)
... doseQuantity C1..1IVL_PQ(USCDI) Dose Unit of Measure
should-unit: SHOULD contain @unit
.... @unit 0..1csNOTE: 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)
... rateQuantity 0..1IVL_PQ
.... @unit 1..1csNOTE: 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..1RTO_PQ_PQ
... administrationUnitCode 0..1CEadministrationUnitCode@code describes the units of medication administration for an item using a code that is pre-coordinated to include a physical unit form (ointment, powder, solution, etc.) which differs from the units used in administering the consumable (capful, spray, drop, etc.). For example when recording medication administrations, 'metric drop (C48491)'' would be appropriate to accompany the RxNorm code of 198283 (Timolol 0.25% Ophthalmic Solution) where the number of drops would be specified in doseQuantity@value.
Binding: AdministrationUnitDoseForm (required)
... consumable 1..1InfrastructureRoot(USCDI) Medications
.... manufacturedProduct 1..1MedicationInformationBase for all types and resources
... performer 0..1Performer2
... author 0..*AuthorParticipationBase for all types and resources
... Slices for participant 0..*Participant2Slice: Unordered, Open by value:typeCode
.... participant:drugVehicle 0..*Participant2
..... @typeCode 1..1csFixed Value: CSM
..... participantRole 1..1DrugVehicleBase for all types and resources
... Slices for entryRelationship 0..*EntryRelationshipSlice: Unordered, Open by profile:substanceAdministration, profile:observation, profile:act, profile:supply
.... entryRelationship:indication 0..*EntryRelationship(USCDI) Indication
..... @typeCode 1..1csFixed Value: RSON
..... observation 1..1IndicationBase for all types and resources
.... entryRelationship:instruction 0..1EntryRelationship
..... @typeCode 1..1csFixed Value: SUBJ
..... @inversionInd 1..1blFixed Value: true
..... act 1..1InstructionBase for all types and resources
.... entryRelationship:supplyOrder 0..1EntryRelationship
..... @typeCode 1..1csFixed Value: REFR
..... supply 1..1MedicationSupplyOrderBase for all types and resources
.... entryRelationship:medicationDispense 0..*EntryRelationship
..... @typeCode 1..1csFixed Value: REFR
..... supply 1..1MedicationDispenseBase for all types and resources
.... entryRelationship:reaction 0..*EntryRelationship
..... @typeCode 1..1csFixed Value: CAUS
..... observation 1..1ReactionObservationBase for all types and resources
.... entryRelationship:drugMonitoring 0..1EntryRelationship
..... @typeCode 1..1csFixed Value: COMP
..... act 1..1DrugMonitoringActBase for all types and resources
.... entryRelationship:substanceAdministered 0..*EntryRelationshipThe following entryRelationship is used to indicate a given medication's order in a series. The nested Substance Administered Act identifies an administration in the series. The entryRelationship/sequenceNumber shows the order of this particular administration in that series.
..... @typeCode 1..1csFixed Value: COMP
..... @inversionInd 1..1blFixed Value: true
..... sequenceNumber 0..1INT
..... act 1..1SubstanceAdministeredActBase for all types and resources
.... entryRelationship:adherence 0..*EntryRelationship(USCDI) Medication Adherence
..... @typeCode 1..1csFixed Value: COMP
..... observation 1..1MedicationAdherenceBase for all types and resources
.... entryRelationship:signature 0..*EntryRelationship(USCDI) Medication Instructions
..... @typeCode 1..1csFixed Value: COMP
..... substanceAdministration 1..1MedicationFreeTextSigBase for all types and resources
... precondition 0..*Precondition
.... @typeCode 1..1cs
.... criterion 1..1PreconditionforSubstanceAdministrationBase for all types and resources

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSet
SubstanceAdministration.moodCoderequiredMoodCodeEvnInt
SubstanceAdministration.statusCode.coderequiredMedicationStatus
SubstanceAdministration.routeCoderequiredSPLDrugRouteOfAdministrationTerminology
SubstanceAdministration.routeCode.translationrequiredMedicationRoute
SubstanceAdministration.approachSiteCoderequiredBodySiteValueSet
SubstanceAdministration.doseQuantity.unitrequiredUnitsOfMeasureCaseSensitive (a valid code from UCUM)
SubstanceAdministration.rateQuantity.unitrequiredUnitsOfMeasureCaseSensitive (a valid code from UCUM)
SubstanceAdministration.administrationUnitCoderequiredAdministrationUnitDoseForm

Constraints

IdGradePath(s)DetailsRequirements
1098-7513warningSubstanceAdministrationSHOULD contain zero or one [0..1] effectiveTime (CONF:1098-7513) such that it **SHALL** contain exactly one [1..1] @xsi:type="PIVL_TS" or "EIVL_TS" (CONF:1098-28499).
: effectiveTime.ofType(CDA.PIVL_TS).exists() or effectiveTime.ofType(CDA.EIVL_TS).exists()
1098-32890errorSubstanceAdministration.effectiveTime:durationThis 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-uniterrorSubstanceAdministrationIf doseQuantity/@unit is present, then administrationUnitCode SHALL NOT be present.
: doseQuantity.unit.exists() implies administrationUnitCode.empty()
should-authorwarningSubstanceAdministrationSHOULD contain author
: author.exists()
should-lowwarningSubstanceAdministration.effectiveTime:durationSHOULD contain low
: low.exists()
should-routeCodewarningSubstanceAdministrationSHOULD contain routeCode
: routeCode.exists()
should-text-ref-valuewarningSubstanceAdministrationSHOULD contain text/reference/@value
: text.reference.value.exists()
should-translationwarningSubstanceAdministration.routeCodeSHOULD contain translation
: translation.exists()
should-unitwarningSubstanceAdministration.doseQuantitySHOULD contain @unit
: nullFlavor.exists() or unit.exists()
should-value-attwarningSubstanceAdministration.effectiveTime:durationSHOULD contain @value
: value.exists()
value-starts-octothorpeerrorSubstanceAdministration.text.referenceIf 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 & Constraintsdoco
.. SubstanceAdministration C1..1SubstanceAdministrationXML Namespace: urn:hl7-org:v3
Elements defined in Ancestors: @nullFlavor, realmCode, typeId, templateId, @classCode, @moodCode, id, code, @negationInd, text, statusCode, effectiveTime, priorityCode, repeatNumber, routeCode, approachSiteCode, doseQuantity, rateQuantity, maxDoseQuantity, administrationUnitCode, consumable, subject, specimen, performer, author, informant, participant, entryRelationship, reference, precondition, sdtcInFulfillmentOf1
Base for all types and resources
Instances of this type are validated by templateId
Logical Container: ClinicalDocument (CDA Class)
should-text-ref-value: SHOULD contain text/reference/@value
1098-7513: SHOULD contain zero or one [0..1] effectiveTime (CONF:1098-7513) such that it **SHALL** contain exactly one [1..1] @xsi:type="PIVL_TS" or "EIVL_TS" (CONF:1098-28499).
should-routeCode: SHOULD contain routeCode
dose-unit-or-admin-unit: If doseQuantity/@unit is present, then administrationUnitCode SHALL NOT be present.
should-author: SHOULD contain author
... Slices for templateId 1..*IISlice: Unordered, Open by value:root, value:extension
.... templateId:medication-activity 1..1II
..... @root 1..1oid, uuid, ruidRequired Pattern: 2.16.840.1.113883.10.20.22.4.16
..... @extension 1..1stRequired Pattern: 2014-06-09
... @classCode 1..1csBinding: ActClass (2.0.0) (required)
Fixed Value: SBADM
... @moodCode 1..1csBinding: MoodCodeEvnInt (required)
... code 0..1CDSubstanceAdministration.code is an optional field. Per HL7 Pharmacy Committee, "this is intended to further specify the nature of the substance administration act. To date the committee has made no use of this attribute". Because the type of substance administration is generally implicit in the routeCode, in the consumable participant, etc., the field is generally not used, and there is no defined value set.
Binding: ActSubstanceAdministrationCode (example)
... text 0..1EDSHOULD reference the portion of section narrative text corresponding to this entry
.... reference C0..1TELvalue-starts-octothorpe: If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative
... statusCode 1..1CSBinding: ActStatus (required)
.... @code 1..1csThe substance administration effectiveTime field can repeat, in order to represent varying levels of complex dosing. effectiveTime can be used to represent the duration of administration (e.g., "10 days"), the frequency of administration (e.g., "every 8 hours"), and more. Here, we require that there SHALL be an effectiveTime documentation of the duration (or single-administration timestamp), and that there SHOULD be an effectiveTime documentation of the frequency. Other timing nuances, supported by the base CDA R2 standard, may also be included.
Binding: Medication Status (required)
... Slices for effectiveTime 1..*Slice: Unordered, Open by type:$this
.... effectiveTimeSXCM_TS
.... effectiveTimeIVL_TS
.... effectiveTimeEIVL_TS
.... effectiveTimePIVL_TS
.... effectiveTimeSXPR_TS
.... effectiveTime:duration C1..1IVL_TSThe substance administration effectiveTime field can repeat, in order to represent varying levels of complex dosing. effectiveTime can be used to represent the duration of administration (e.g., "10 days"), the frequency of administration (e.g., "every 8 hours"), and more. Here, we require that there **SHALL** be an effectiveTime documentation of the duration (or single-administration timestamp), and that there **SHOULD** be an effectiveTime documentation of the frequency. Other timing nuances, supported by the base CDA R2 standard, may also be included. Note: This effectiveTime represents either the medication duration (i.e., the time the medication was started and stopped) or the single-administration timestamp.
1098-32890: This effectiveTime **SHALL** contain either a low or a @value but not both (CONF:1098-32890).
should-value-att: SHOULD contain @value
should-low: SHOULD contain low
..... @value 0..1tsindicates a single-administration timestamp
Date Format: YYYYMMDDHHMMSS.UUUU[+|-ZZzz]
..... low 0..1IVXB_TSindicates when medication started
..... high 0..1IVXB_TSindicates when medication stopped
.... effectiveTime:periodicFrequency 0..1EIVL_TSThis effectiveTime represents a periodic medication frequency (e.g., administration times per day).
..... @operator 1..1csBinding: SetOperator (required)
Required Pattern: A
.... effectiveTime:eventFrequency 0..1PIVL_TSThis effectiveTime represents an event-based medication frequency (e.g., administration at bedtime).
..... @operator 1..1csBinding: SetOperator (required)
Required Pattern: A
... repeatNumber 0..1IVL_INTIn "INT" (intent) mood, the repeatNumber defines the number of allowed administrations. For example, a repeatNumber of "3" means that the substance can be administered up to 3 times. In "EVN" (event) mood, the repeatNumber is the number of occurrences. For example, a repeatNumber of "3" in a substance administration event means that the current administration is the 3rd in a series.
... routeCode C0..1CEBinding: SPL Drug Route of Administration Terminology (required)
should-translation: SHOULD contain translation
.... translation 0..*CDBinding: Medication Route (required)
... approachSiteCode 0..1CDBinding: Body Site Value Set (required)
... doseQuantity C1..1IVL_PQ(USCDI) Dose Unit of Measure
should-unit: SHOULD contain @unit
.... @unit 0..1csNOTE: 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)
... rateQuantity 0..1IVL_PQ
.... @unit 1..1csNOTE: 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..1RTO_PQ_PQ
... administrationUnitCode 0..1CEadministrationUnitCode@code describes the units of medication administration for an item using a code that is pre-coordinated to include a physical unit form (ointment, powder, solution, etc.) which differs from the units used in administering the consumable (capful, spray, drop, etc.). For example when recording medication administrations, 'metric drop (C48491)'' would be appropriate to accompany the RxNorm code of 198283 (Timolol 0.25% Ophthalmic Solution) where the number of drops would be specified in doseQuantity@value.
Binding: AdministrationUnitDoseForm (required)
... consumable 1..1InfrastructureRoot(USCDI) Medications
.... manufacturedProduct C1..1MedicationInformationBase for all types and resources
... performer 0..1Performer2
... author 0..*AuthorParticipationBase for all types and resources
... Slices for participant 0..*Participant2Slice: Unordered, Open by value:typeCode
.... participant:drugVehicle 0..*Participant2
..... @typeCode 1..1csBinding: ParticipationType (required)
Fixed Value: CSM
..... participantRole C1..1DrugVehicleBase for all types and resources
... Slices for entryRelationship 0..*EntryRelationshipSlice: Unordered, Open by profile:substanceAdministration, profile:observation, profile:act, profile:supply
.... entryRelationship:indication 0..*EntryRelationship(USCDI) Indication
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: RSON
..... observation C1..1IndicationBase for all types and resources
.... entryRelationship:instruction 0..1EntryRelationship
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: SUBJ
..... @inversionInd 1..1blFixed Value: true
..... act C1..1InstructionBase for all types and resources
.... entryRelationship:supplyOrder 0..1EntryRelationship
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: REFR
..... supply C1..1MedicationSupplyOrderBase for all types and resources
.... entryRelationship:medicationDispense 0..*EntryRelationship
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: REFR
..... supply C1..1MedicationDispenseBase for all types and resources
.... entryRelationship:reaction 0..*EntryRelationship
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: CAUS
..... observation C1..1ReactionObservationBase for all types and resources
.... entryRelationship:drugMonitoring 0..1EntryRelationship
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: COMP
..... act C1..1DrugMonitoringActBase for all types and resources
.... entryRelationship:substanceAdministered 0..*EntryRelationshipThe following entryRelationship is used to indicate a given medication's order in a series. The nested Substance Administered Act identifies an administration in the series. The entryRelationship/sequenceNumber shows the order of this particular administration in that series.
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: COMP
..... @inversionInd 1..1blFixed Value: true
..... sequenceNumber 0..1INT
..... act C1..1SubstanceAdministeredActBase for all types and resources
.... entryRelationship:adherence 0..*EntryRelationship(USCDI) Medication Adherence
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: COMP
..... observation C1..1MedicationAdherenceBase for all types and resources
.... entryRelationship:signature 0..*EntryRelationship(USCDI) Medication Instructions
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: COMP
..... substanceAdministration C1..1MedicationFreeTextSigBase for all types and resources
... precondition 0..*Precondition
.... @typeCode 1..1csBinding: ActRelationshipType (required)
Fixed Value: PRCN
.... criterion 1..1PreconditionforSubstanceAdministrationBase for all types and resources

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / Code
SubstanceAdministration.classCoderequiredFixed Value: SBADM
SubstanceAdministration.moodCoderequiredMoodCodeEvnInt
SubstanceAdministration.codeexampleActSubstanceAdministrationCode
SubstanceAdministration.statusCoderequiredActStatus
SubstanceAdministration.statusCode.coderequiredMedicationStatus
SubstanceAdministration.effectiveTime:periodicFrequency.operatorrequiredPattern: A
SubstanceAdministration.effectiveTime:eventFrequency.operatorrequiredPattern: A
SubstanceAdministration.routeCoderequiredSPLDrugRouteOfAdministrationTerminology
SubstanceAdministration.routeCode.translationrequiredMedicationRoute
SubstanceAdministration.approachSiteCoderequiredBodySiteValueSet
SubstanceAdministration.doseQuantity.unitrequiredUnitsOfMeasureCaseSensitive (a valid code from UCUM)
SubstanceAdministration.rateQuantity.unitrequiredUnitsOfMeasureCaseSensitive (a valid code from UCUM)
SubstanceAdministration.administrationUnitCoderequiredAdministrationUnitDoseForm
SubstanceAdministration.participant:drugVehicle.typeCoderequiredFixed Value: CSM
SubstanceAdministration.entryRelationship:indication.typeCoderequiredFixed Value: RSON
SubstanceAdministration.entryRelationship:instruction.typeCoderequiredFixed Value: SUBJ
SubstanceAdministration.entryRelationship:supplyOrder.typeCoderequiredFixed Value: REFR
SubstanceAdministration.entryRelationship:medicationDispense.typeCoderequiredFixed Value: REFR
SubstanceAdministration.entryRelationship:reaction.typeCoderequiredFixed Value: CAUS
SubstanceAdministration.entryRelationship:drugMonitoring.typeCoderequiredFixed Value: COMP
SubstanceAdministration.entryRelationship:substanceAdministered.typeCoderequiredFixed Value: COMP
SubstanceAdministration.entryRelationship:adherence.typeCoderequiredFixed Value: COMP
SubstanceAdministration.entryRelationship:signature.typeCoderequiredFixed Value: COMP
SubstanceAdministration.precondition.typeCoderequiredFixed Value: PRCN

Constraints

IdGradePath(s)DetailsRequirements
1098-7513warningSubstanceAdministrationSHOULD contain zero or one [0..1] effectiveTime (CONF:1098-7513) such that it **SHALL** contain exactly one [1..1] @xsi:type="PIVL_TS" or "EIVL_TS" (CONF:1098-28499).
: effectiveTime.ofType(CDA.PIVL_TS).exists() or effectiveTime.ofType(CDA.EIVL_TS).exists()
1098-32890errorSubstanceAdministration.effectiveTime:durationThis 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-uniterrorSubstanceAdministrationIf doseQuantity/@unit is present, then administrationUnitCode SHALL NOT be present.
: doseQuantity.unit.exists() implies administrationUnitCode.empty()
product-choiceerrorSubstanceAdministration.consumable.manufacturedProductmanufacturedLabeledDrug and manufacturedMaterial are mutually exclusive (one must be present)
: (manufacturedLabeledDrug | manufacturedMaterial).count() = 1
role-choiceerrorSubstanceAdministration.participant:drugVehicle.participantRoleplayingDevice and playingEntity are mutually exclusive
: (playingDevice | playingEntity).count() <= 1
should-authorwarningSubstanceAdministrationSHOULD contain author
: author.exists()
should-effectiveTimewarningSubstanceAdministration.entryRelationship:indication.observation, SubstanceAdministration.entryRelationship:medicationDispense.supply, SubstanceAdministration.entryRelationship:reaction.observationSHOULD contain effectiveTime
: effectiveTime.exists()
should-informantwarningSubstanceAdministration.entryRelationship:adherence.observationSHOULD contain informant
: informant.exists()
should-lowwarningSubstanceAdministration.effectiveTime:durationSHOULD contain low
: low.exists()
should-quantitywarningSubstanceAdministration.entryRelationship:supplyOrder.supply, SubstanceAdministration.entryRelationship:medicationDispense.supplySHOULD contain quantity
: quantity.exists()
should-repeatNumberwarningSubstanceAdministration.entryRelationship:supplyOrder.supply, SubstanceAdministration.entryRelationship:medicationDispense.supplySHOULD contain repeatNumber
: repeatNumber.exists()
should-routeCodewarningSubstanceAdministrationSHOULD contain routeCode
: routeCode.exists()
should-text-ref-valuewarningSubstanceAdministrationSHOULD contain text/reference/@value
: text.reference.value.exists()
should-text-ref-valuewarningSubstanceAdministration.entryRelationship:indication.observation, SubstanceAdministration.entryRelationship:instruction.act, SubstanceAdministration.entryRelationship:supplyOrder.supply, SubstanceAdministration.entryRelationship:medicationDispense.supply, SubstanceAdministration.entryRelationship:reaction.observation, SubstanceAdministration.entryRelationship:drugMonitoring.act, SubstanceAdministration.entryRelationship:substanceAdministered.act, SubstanceAdministration.entryRelationship:adherence.observation, SubstanceAdministration.entryRelationship:signature.substanceAdministrationSHOULD contain text/reference/@value
: text.reference.value.exists()
should-translationwarningSubstanceAdministration.routeCodeSHOULD contain translation
: translation.exists()
should-unitwarningSubstanceAdministration.doseQuantitySHOULD contain @unit
: nullFlavor.exists() or unit.exists()
should-value-attwarningSubstanceAdministration.effectiveTime:durationSHOULD contain @value
: value.exists()
sig-closederrorSubstanceAdministration.entryRelationship:signature.substanceAdministrationThis is a closed template and shall not contain any elements besides code, text, and consumable
: (typeId | statusCode | effectiveTime | priorityCode | repeatNumber | routeCode | approachSiteCode | doseQuantity | rateQuantity | maxDoseQuantity | administrationUnitCode | subject | specimen | performer | informant | participant | entryRelationship | precondition).empty()
value-starts-octothorpeerrorSubstanceAdministration.text.referenceIf 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 & Constraintsdoco
.. SubstanceAdministration C1..1SubstanceAdministrationXML Namespace: urn:hl7-org:v3
Elements defined in Ancestors: @nullFlavor, realmCode, typeId, templateId, @classCode, @moodCode, id, code, @negationInd, text, statusCode, effectiveTime, priorityCode, repeatNumber, routeCode, approachSiteCode, doseQuantity, rateQuantity, maxDoseQuantity, administrationUnitCode, consumable, subject, specimen, performer, author, informant, participant, entryRelationship, reference, precondition, sdtcInFulfillmentOf1
Base for all types and resources
Instances of this type are validated by templateId
Logical Container: ClinicalDocument (CDA Class)
should-text-ref-value: SHOULD contain text/reference/@value
1098-7513: SHOULD contain zero or one [0..1] effectiveTime (CONF:1098-7513) such that it **SHALL** contain exactly one [1..1] @xsi:type="PIVL_TS" or "EIVL_TS" (CONF:1098-28499).
should-routeCode: SHOULD contain routeCode
dose-unit-or-admin-unit: If doseQuantity/@unit is present, then administrationUnitCode SHALL NOT be present.
should-author: SHOULD contain author
... @nullFlavor 0..1csBinding: CDANullFlavor (required)
... realmCode 0..*CS
... typeId 0..1II
.... @nullFlavor 0..1csBinding: CDANullFlavor (required)
.... @assigningAuthorityName 0..1st
.... @displayable 0..1bl
.... @root 1..1oid, uuid, ruidFixed Value: 2.16.840.1.113883.1.3
.... @extension 1..1st
... Slices for templateId 1..*IISlice: Unordered, Open by value:root, value:extension
.... templateId:medication-activity 1..1II
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... @assigningAuthorityName 0..1st
..... @displayable 0..1bl
..... @root 1..1oid, uuid, ruidRequired Pattern: 2.16.840.1.113883.10.20.22.4.16
..... @extension 1..1stRequired Pattern: 2014-06-09
... @classCode 1..1csBinding: ActClass (2.0.0) (required)
Fixed Value: SBADM
... @moodCode 1..1csBinding: MoodCodeEvnInt (required)
... id 1..*II
... code 0..1CDSubstanceAdministration.code is an optional field. Per HL7 Pharmacy Committee, "this is intended to further specify the nature of the substance administration act. To date the committee has made no use of this attribute". Because the type of substance administration is generally implicit in the routeCode, in the consumable participant, etc., the field is generally not used, and there is no defined value set.
Binding: ActSubstanceAdministrationCode (example)
... @negationInd 0..1bl
... text 0..1EDSHOULD reference the portion of section narrative text corresponding to this entry
.... @nullFlavor 0..1csBinding: CDANullFlavor (required)
.... @compression 0..1csBinding: CompressionAlgorithm (required)
.... @integrityCheck 0..1bin
.... @integrityCheckAlgorithm 0..1csBinding: IntegrityCheckAlgorithm (2.0.0) (required)
.... @language 0..1cs
.... @mediaType 0..1csBinding: MediaType (example)
.... @representation 0..1csBinding: Binary Data Encoding Value Set (required)
.... xmlText 0..1stAllows for mixed text content. If @representation='B64', this SHALL be a base64binary string.
.... reference C0..1TELvalue-starts-octothorpe: If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative
.... thumbnail 0..1ED
... statusCode 1..1CSBinding: ActStatus (required)
.... @nullFlavor 0..1csBinding: CDANullFlavor (required)
.... @code 1..1csThe substance administration effectiveTime field can repeat, in order to represent varying levels of complex dosing. effectiveTime can be used to represent the duration of administration (e.g., "10 days"), the frequency of administration (e.g., "every 8 hours"), and more. Here, we require that there SHALL be an effectiveTime documentation of the duration (or single-administration timestamp), and that there SHOULD be an effectiveTime documentation of the frequency. Other timing nuances, supported by the base CDA R2 standard, may also be included.
Binding: Medication Status (required)
.... @sdtcValueSet 0..1oidXML Namespace: urn:hl7-org:sdtc
XML: valueSet (urn:hl7-org:sdtc)
.... @sdtcValueSetVersion 0..1stXML Namespace: urn:hl7-org:sdtc
XML: valueSetVersion (urn:hl7-org:sdtc)
... Slices for effectiveTime 1..*Slice: Unordered, Open by type:$this
.... effectiveTimeSXCM_TS
.... effectiveTimeIVL_TS
.... effectiveTimeEIVL_TS
.... effectiveTimePIVL_TS
.... effectiveTimeSXPR_TS
.... effectiveTime:duration C1..1IVL_TSThe substance administration effectiveTime field can repeat, in order to represent varying levels of complex dosing. effectiveTime can be used to represent the duration of administration (e.g., "10 days"), the frequency of administration (e.g., "every 8 hours"), and more. Here, we require that there **SHALL** be an effectiveTime documentation of the duration (or single-administration timestamp), and that there **SHOULD** be an effectiveTime documentation of the frequency. Other timing nuances, supported by the base CDA R2 standard, may also be included. Note: This effectiveTime represents either the medication duration (i.e., the time the medication was started and stopped) or the single-administration timestamp.
1098-32890: This effectiveTime **SHALL** contain either a low or a @value but not both (CONF:1098-32890).
should-value-att: SHOULD contain @value
should-low: SHOULD contain low
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... @value 0..1tsindicates a single-administration timestamp
Date Format: YYYYMMDDHHMMSS.UUUU[+|-ZZzz]
..... @operator 0..1csBinding: SetOperator (required)
..... low 0..1IVXB_TSindicates when medication started
..... center 0..1TS
..... width 0..1PQ
..... high 0..1IVXB_TSindicates when medication stopped
.... effectiveTime:periodicFrequency 0..1EIVL_TSThis effectiveTime represents a periodic medication frequency (e.g., administration times per day).
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... @operator 1..1csBinding: SetOperator (required)
Required Pattern: A
..... event 0..1CE
..... offset 0..1IVL_PQ
.... effectiveTime:eventFrequency 0..1PIVL_TSThis effectiveTime represents an event-based medication frequency (e.g., administration at bedtime).
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... @operator 1..1csBinding: SetOperator (required)
Required Pattern: A
..... phase 0..1IVL_TS
..... period 0..1PQ
..... @alignment 0..1cs
..... @institutionSpecified 0..1bl
... priorityCode 0..1CEBinding: ActPriority (example)
... repeatNumber 0..1IVL_INTIn "INT" (intent) mood, the repeatNumber defines the number of allowed administrations. For example, a repeatNumber of "3" means that the substance can be administered up to 3 times. In "EVN" (event) mood, the repeatNumber is the number of occurrences. For example, a repeatNumber of "3" in a substance administration event means that the current administration is the 3rd in a series.
... routeCode C0..1CEBinding: SPL Drug Route of Administration Terminology (required)
should-translation: SHOULD contain translation
.... @nullFlavor 0..1csBinding: CDANullFlavor (required)
.... @code 0..1cs
.... @codeSystem 0..1oid, uuid, ruid
.... @codeSystemName 0..1st
.... @codeSystemVersion 0..1st
.... @displayName 0..1st
.... @sdtcValueSet 0..1oidXML Namespace: urn:hl7-org:sdtc
XML: valueSet (urn:hl7-org:sdtc)
.... @sdtcValueSetVersion 0..1stXML Namespace: urn:hl7-org:sdtc
XML: valueSetVersion (urn:hl7-org:sdtc)
.... originalText 0..1ED
.... translation 0..*CDBinding: Medication Route (required)
... approachSiteCode 0..1CDBinding: Body Site Value Set (required)
... doseQuantity C1..1IVL_PQ(USCDI) Dose Unit of Measure
should-unit: SHOULD contain @unit
.... @nullFlavor 0..1csBinding: CDANullFlavor (required)
.... @unit 0..1csNOTE: 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..1real
.... translation 0..*PQR
.... @operator 0..1csBinding: SetOperator (required)
.... low 0..1IVXB_PQ
.... center 0..1PQ
.... width 0..1PQ
.... high 0..1IVXB_PQ
... rateQuantity 0..1IVL_PQ
.... @nullFlavor 0..1csBinding: CDANullFlavor (required)
.... @unit 1..1csNOTE: 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..1real
.... translation 0..*PQR
.... @operator 0..1csBinding: SetOperator (required)
.... low 0..1IVXB_PQ
.... center 0..1PQ
.... width 0..1PQ
.... high 0..1IVXB_PQ
... maxDoseQuantity 0..1RTO_PQ_PQ
... administrationUnitCode 0..1CEadministrationUnitCode@code describes the units of medication administration for an item using a code that is pre-coordinated to include a physical unit form (ointment, powder, solution, etc.) which differs from the units used in administering the consumable (capful, spray, drop, etc.). For example when recording medication administrations, 'metric drop (C48491)'' would be appropriate to accompany the RxNorm code of 198283 (Timolol 0.25% Ophthalmic Solution) where the number of drops would be specified in doseQuantity@value.
Binding: AdministrationUnitDoseForm (required)
... consumable 1..1InfrastructureRoot(USCDI) Medications
.... @nullFlavor 0..1csBinding: CDANullFlavor (required)
.... realmCode 0..*CS
.... typeId 0..1II
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... @assigningAuthorityName 0..1st
..... @displayable 0..1bl
..... @root 1..1oid, uuid, ruidFixed Value: 2.16.840.1.113883.1.3
..... @extension 1..1st
.... templateId 0..*II
.... @typeCode 0..1csBinding: ParticipationType (required)
Fixed Value: CSM
.... manufacturedProduct C1..1MedicationInformationBase for all types and resources
... subject 0..1Subject
... specimen 0..*Specimen
... performer 0..1Performer2
... author 0..*AuthorParticipationBase for all types and resources
... informant 0..*Informant
... Slices for participant 0..*Participant2Slice: Unordered, Open by value:typeCode
.... participant:drugVehicle 0..*Participant2
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... realmCode 0..*CS
..... typeId 0..1II
...... @nullFlavor 0..1csBinding: CDANullFlavor (required)
...... @assigningAuthorityName 0..1st
...... @displayable 0..1bl
...... @root 1..1oid, uuid, ruidFixed Value: 2.16.840.1.113883.1.3
...... @extension 1..1st
..... templateId 0..*II
..... @typeCode 1..1csBinding: ParticipationType (required)
Fixed Value: CSM
..... @contextControlCode 0..1csBinding: ContextControl (required)
Fixed Value: OP
..... sdtcFunctionCode 0..1CEXML Namespace: urn:hl7-org:sdtc
XML: functionCode (urn:hl7-org:sdtc)
..... time 0..1IVL_TS
..... awarenessCode 0..1CE
..... participantRole C1..1DrugVehicleBase for all types and resources
... Slices for entryRelationship 0..*EntryRelationshipSlice: Unordered, Open by profile:substanceAdministration, profile:observation, profile:act, profile:supply
.... entryRelationship:indication 0..*EntryRelationship(USCDI) Indication
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... realmCode 0..*CS
..... typeId 0..1II
...... @nullFlavor 0..1csBinding: CDANullFlavor (required)
...... @assigningAuthorityName 0..1st
...... @displayable 0..1bl
...... @root 1..1oid, uuid, ruidFixed Value: 2.16.840.1.113883.1.3
...... @extension 1..1st
..... templateId 0..*II
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: RSON
..... @inversionInd 0..1bl
..... @contextConductionInd 0..1bl
..... @negationInd 0..1bl
..... sequenceNumber 0..1INT
..... seperatableInd 0..1BL
..... act 0..1Act
..... encounter 0..1Encounter
..... observation C1..1IndicationBase for all types and resources
..... observationMedia 0..1ObservationMedia
..... organizer 0..1Organizer
..... procedure 0..1Procedure
..... regionOfInterest 0..1RegionOfInterest
..... substanceAdministration 0..1SubstanceAdministration
..... supply 0..1Supply
.... entryRelationship:instruction 0..1EntryRelationship
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... realmCode 0..*CS
..... typeId 0..1II
...... @nullFlavor 0..1csBinding: CDANullFlavor (required)
...... @assigningAuthorityName 0..1st
...... @displayable 0..1bl
...... @root 1..1oid, uuid, ruidFixed Value: 2.16.840.1.113883.1.3
...... @extension 1..1st
..... templateId 0..*II
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: SUBJ
..... @inversionInd 1..1blFixed Value: true
..... @contextConductionInd 0..1bl
..... @negationInd 0..1bl
..... sequenceNumber 0..1INT
..... seperatableInd 0..1BL
..... act C1..1InstructionBase for all types and resources
..... encounter 0..1Encounter
..... observation 0..1Observation
..... observationMedia 0..1ObservationMedia
..... organizer 0..1Organizer
..... procedure 0..1Procedure
..... regionOfInterest 0..1RegionOfInterest
..... substanceAdministration 0..1SubstanceAdministration
..... supply 0..1Supply
.... entryRelationship:supplyOrder 0..1EntryRelationship
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... realmCode 0..*CS
..... typeId 0..1II
...... @nullFlavor 0..1csBinding: CDANullFlavor (required)
...... @assigningAuthorityName 0..1st
...... @displayable 0..1bl
...... @root 1..1oid, uuid, ruidFixed Value: 2.16.840.1.113883.1.3
...... @extension 1..1st
..... templateId 0..*II
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: REFR
..... @inversionInd 0..1bl
..... @contextConductionInd 0..1bl
..... @negationInd 0..1bl
..... sequenceNumber 0..1INT
..... seperatableInd 0..1BL
..... act 0..1Act
..... encounter 0..1Encounter
..... observation 0..1Observation
..... observationMedia 0..1ObservationMedia
..... organizer 0..1Organizer
..... procedure 0..1Procedure
..... regionOfInterest 0..1RegionOfInterest
..... substanceAdministration 0..1SubstanceAdministration
..... supply C1..1MedicationSupplyOrderBase for all types and resources
.... entryRelationship:medicationDispense 0..*EntryRelationship
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... realmCode 0..*CS
..... typeId 0..1II
...... @nullFlavor 0..1csBinding: CDANullFlavor (required)
...... @assigningAuthorityName 0..1st
...... @displayable 0..1bl
...... @root 1..1oid, uuid, ruidFixed Value: 2.16.840.1.113883.1.3
...... @extension 1..1st
..... templateId 0..*II
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: REFR
..... @inversionInd 0..1bl
..... @contextConductionInd 0..1bl
..... @negationInd 0..1bl
..... sequenceNumber 0..1INT
..... seperatableInd 0..1BL
..... act 0..1Act
..... encounter 0..1Encounter
..... observation 0..1Observation
..... observationMedia 0..1ObservationMedia
..... organizer 0..1Organizer
..... procedure 0..1Procedure
..... regionOfInterest 0..1RegionOfInterest
..... substanceAdministration 0..1SubstanceAdministration
..... supply C1..1MedicationDispenseBase for all types and resources
.... entryRelationship:reaction 0..*EntryRelationship
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... realmCode 0..*CS
..... typeId 0..1II
...... @nullFlavor 0..1csBinding: CDANullFlavor (required)
...... @assigningAuthorityName 0..1st
...... @displayable 0..1bl
...... @root 1..1oid, uuid, ruidFixed Value: 2.16.840.1.113883.1.3
...... @extension 1..1st
..... templateId 0..*II
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: CAUS
..... @inversionInd 0..1bl
..... @contextConductionInd 0..1bl
..... @negationInd 0..1bl
..... sequenceNumber 0..1INT
..... seperatableInd 0..1BL
..... act 0..1Act
..... encounter 0..1Encounter
..... observation C1..1ReactionObservationBase for all types and resources
..... observationMedia 0..1ObservationMedia
..... organizer 0..1Organizer
..... procedure 0..1Procedure
..... regionOfInterest 0..1RegionOfInterest
..... substanceAdministration 0..1SubstanceAdministration
..... supply 0..1Supply
.... entryRelationship:drugMonitoring 0..1EntryRelationship
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... realmCode 0..*CS
..... typeId 0..1II
...... @nullFlavor 0..1csBinding: CDANullFlavor (required)
...... @assigningAuthorityName 0..1st
...... @displayable 0..1bl
...... @root 1..1oid, uuid, ruidFixed Value: 2.16.840.1.113883.1.3
...... @extension 1..1st
..... templateId 0..*II
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: COMP
..... @inversionInd 0..1bl
..... @contextConductionInd 0..1bl
..... @negationInd 0..1bl
..... sequenceNumber 0..1INT
..... seperatableInd 0..1BL
..... act C1..1DrugMonitoringActBase for all types and resources
..... encounter 0..1Encounter
..... observation 0..1Observation
..... observationMedia 0..1ObservationMedia
..... organizer 0..1Organizer
..... procedure 0..1Procedure
..... regionOfInterest 0..1RegionOfInterest
..... substanceAdministration 0..1SubstanceAdministration
..... supply 0..1Supply
.... entryRelationship:substanceAdministered 0..*EntryRelationshipThe following entryRelationship is used to indicate a given medication's order in a series. The nested Substance Administered Act identifies an administration in the series. The entryRelationship/sequenceNumber shows the order of this particular administration in that series.
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... realmCode 0..*CS
..... typeId 0..1II
...... @nullFlavor 0..1csBinding: CDANullFlavor (required)
...... @assigningAuthorityName 0..1st
...... @displayable 0..1bl
...... @root 1..1oid, uuid, ruidFixed Value: 2.16.840.1.113883.1.3
...... @extension 1..1st
..... templateId 0..*II
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: COMP
..... @inversionInd 1..1blFixed Value: true
..... @contextConductionInd 0..1bl
..... @negationInd 0..1bl
..... sequenceNumber 0..1INT
..... seperatableInd 0..1BL
..... act C1..1SubstanceAdministeredActBase for all types and resources
..... encounter 0..1Encounter
..... observation 0..1Observation
..... observationMedia 0..1ObservationMedia
..... organizer 0..1Organizer
..... procedure 0..1Procedure
..... regionOfInterest 0..1RegionOfInterest
..... substanceAdministration 0..1SubstanceAdministration
..... supply 0..1Supply
.... entryRelationship:adherence 0..*EntryRelationship(USCDI) Medication Adherence
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... realmCode 0..*CS
..... typeId 0..1II
...... @nullFlavor 0..1csBinding: CDANullFlavor (required)
...... @assigningAuthorityName 0..1st
...... @displayable 0..1bl
...... @root 1..1oid, uuid, ruidFixed Value: 2.16.840.1.113883.1.3
...... @extension 1..1st
..... templateId 0..*II
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: COMP
..... @inversionInd 0..1bl
..... @contextConductionInd 0..1bl
..... @negationInd 0..1bl
..... sequenceNumber 0..1INT
..... seperatableInd 0..1BL
..... act 0..1Act
..... encounter 0..1Encounter
..... observation C1..1MedicationAdherenceBase for all types and resources
..... observationMedia 0..1ObservationMedia
..... organizer 0..1Organizer
..... procedure 0..1Procedure
..... regionOfInterest 0..1RegionOfInterest
..... substanceAdministration 0..1SubstanceAdministration
..... supply 0..1Supply
.... entryRelationship:signature 0..*EntryRelationship(USCDI) Medication Instructions
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... realmCode 0..*CS
..... typeId 0..1II
...... @nullFlavor 0..1csBinding: CDANullFlavor (required)
...... @assigningAuthorityName 0..1st
...... @displayable 0..1bl
...... @root 1..1oid, uuid, ruidFixed Value: 2.16.840.1.113883.1.3
...... @extension 1..1st
..... templateId 0..*II
..... @typeCode 1..1csBinding: x_ActRelationshipEntryRelationship (required)
Fixed Value: COMP
..... @inversionInd 0..1bl
..... @contextConductionInd 0..1bl
..... @negationInd 0..1bl
..... sequenceNumber 0..1INT
..... seperatableInd 0..1BL
..... act 0..1Act
..... encounter 0..1Encounter
..... observation 0..1Observation
..... observationMedia 0..1ObservationMedia
..... organizer 0..1Organizer
..... procedure 0..1Procedure
..... regionOfInterest 0..1RegionOfInterest
..... substanceAdministration C1..1MedicationFreeTextSigBase for all types and resources
..... supply 0..1Supply
... reference 0..*Reference
... precondition 0..*Precondition
.... @nullFlavor 0..1csBinding: CDANullFlavor (required)
.... realmCode 0..*CS
.... typeId 0..1II
..... @nullFlavor 0..1csBinding: CDANullFlavor (required)
..... @assigningAuthorityName 0..1st
..... @displayable 0..1bl
..... @root 1..1oid, uuid, ruidFixed Value: 2.16.840.1.113883.1.3
..... @extension 1..1st
.... templateId 0..*II
.... @typeCode 1..1csBinding: ActRelationshipType (required)
Fixed Value: PRCN
.... criterion 1..1PreconditionforSubstanceAdministrationBase for all types and resources
... sdtcInFulfillmentOf1 0..*InFulfillmentOf1XML Namespace: urn:hl7-org:sdtc
XML: inFulfillmentOf1 (urn:hl7-org:sdtc)

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / Code
SubstanceAdministration.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.typeId.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.templateId:medication-activity.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.classCoderequiredFixed Value: SBADM
SubstanceAdministration.moodCoderequiredMoodCodeEvnInt
SubstanceAdministration.codeexampleActSubstanceAdministrationCode
SubstanceAdministration.text.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.text.compressionrequiredCDACompressionAlgorithm
SubstanceAdministration.text.integrityCheckAlgorithmrequiredIntegrityCheckAlgorithm
SubstanceAdministration.text.mediaTypeexampleMediaType
SubstanceAdministration.text.representationrequiredBinaryDataEncoding
SubstanceAdministration.statusCoderequiredActStatus
SubstanceAdministration.statusCode.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.statusCode.coderequiredMedicationStatus
SubstanceAdministration.effectiveTime:duration.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.effectiveTime:duration.operatorrequiredSetOperator
SubstanceAdministration.effectiveTime:periodicFrequency.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.effectiveTime:periodicFrequency.operatorrequiredPattern: A
SubstanceAdministration.effectiveTime:eventFrequency.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.effectiveTime:eventFrequency.operatorrequiredPattern: A
SubstanceAdministration.priorityCodeexampleActPriority
SubstanceAdministration.routeCoderequiredSPLDrugRouteOfAdministrationTerminology
SubstanceAdministration.routeCode.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.routeCode.translationrequiredMedicationRoute
SubstanceAdministration.approachSiteCoderequiredBodySiteValueSet
SubstanceAdministration.doseQuantity.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.doseQuantity.unitrequiredUnitsOfMeasureCaseSensitive (a valid code from UCUM)
SubstanceAdministration.doseQuantity.operatorrequiredSetOperator
SubstanceAdministration.rateQuantity.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.rateQuantity.unitrequiredUnitsOfMeasureCaseSensitive (a valid code from UCUM)
SubstanceAdministration.rateQuantity.operatorrequiredSetOperator
SubstanceAdministration.administrationUnitCoderequiredAdministrationUnitDoseForm
SubstanceAdministration.consumable.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.consumable.typeId.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.consumable.typeCoderequiredFixed Value: CSM
SubstanceAdministration.participant:drugVehicle.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.participant:drugVehicle.typeId.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.participant:drugVehicle.typeCoderequiredFixed Value: CSM
SubstanceAdministration.participant:drugVehicle.contextControlCoderequiredFixed Value: OP
SubstanceAdministration.entryRelationship:indication.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:indication.typeId.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:indication.typeCoderequiredFixed Value: RSON
SubstanceAdministration.entryRelationship:instruction.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:instruction.typeId.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:instruction.typeCoderequiredFixed Value: SUBJ
SubstanceAdministration.entryRelationship:supplyOrder.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:supplyOrder.typeId.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:supplyOrder.typeCoderequiredFixed Value: REFR
SubstanceAdministration.entryRelationship:medicationDispense.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:medicationDispense.typeId.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:medicationDispense.typeCoderequiredFixed Value: REFR
SubstanceAdministration.entryRelationship:reaction.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:reaction.typeId.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:reaction.typeCoderequiredFixed Value: CAUS
SubstanceAdministration.entryRelationship:drugMonitoring.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:drugMonitoring.typeId.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:drugMonitoring.typeCoderequiredFixed Value: COMP
SubstanceAdministration.entryRelationship:substanceAdministered.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:substanceAdministered.typeId.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:substanceAdministered.typeCoderequiredFixed Value: COMP
SubstanceAdministration.entryRelationship:adherence.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:adherence.typeId.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:adherence.typeCoderequiredFixed Value: COMP
SubstanceAdministration.entryRelationship:signature.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:signature.typeId.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.entryRelationship:signature.typeCoderequiredFixed Value: COMP
SubstanceAdministration.precondition.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.precondition.typeId.nullFlavorrequiredCDANullFlavor
SubstanceAdministration.precondition.typeCoderequiredFixed Value: PRCN

Constraints

IdGradePath(s)DetailsRequirements
1098-7513warningSubstanceAdministrationSHOULD contain zero or one [0..1] effectiveTime (CONF:1098-7513) such that it **SHALL** contain exactly one [1..1] @xsi:type="PIVL_TS" or "EIVL_TS" (CONF:1098-28499).
: effectiveTime.ofType(CDA.PIVL_TS).exists() or effectiveTime.ofType(CDA.EIVL_TS).exists()
1098-32890errorSubstanceAdministration.effectiveTime:durationThis 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-uniterrorSubstanceAdministrationIf doseQuantity/@unit is present, then administrationUnitCode SHALL NOT be present.
: doseQuantity.unit.exists() implies administrationUnitCode.empty()
product-choiceerrorSubstanceAdministration.consumable.manufacturedProductmanufacturedLabeledDrug and manufacturedMaterial are mutually exclusive (one must be present)
: (manufacturedLabeledDrug | manufacturedMaterial).count() = 1
role-choiceerrorSubstanceAdministration.participant:drugVehicle.participantRoleplayingDevice and playingEntity are mutually exclusive
: (playingDevice | playingEntity).count() <= 1
should-authorwarningSubstanceAdministrationSHOULD contain author
: author.exists()
should-effectiveTimewarningSubstanceAdministration.entryRelationship:indication.observation, SubstanceAdministration.entryRelationship:medicationDispense.supply, SubstanceAdministration.entryRelationship:reaction.observationSHOULD contain effectiveTime
: effectiveTime.exists()
should-informantwarningSubstanceAdministration.entryRelationship:adherence.observationSHOULD contain informant
: informant.exists()
should-lowwarningSubstanceAdministration.effectiveTime:durationSHOULD contain low
: low.exists()
should-quantitywarningSubstanceAdministration.entryRelationship:supplyOrder.supply, SubstanceAdministration.entryRelationship:medicationDispense.supplySHOULD contain quantity
: quantity.exists()
should-repeatNumberwarningSubstanceAdministration.entryRelationship:supplyOrder.supply, SubstanceAdministration.entryRelationship:medicationDispense.supplySHOULD contain repeatNumber
: repeatNumber.exists()
should-routeCodewarningSubstanceAdministrationSHOULD contain routeCode
: routeCode.exists()
should-text-ref-valuewarningSubstanceAdministrationSHOULD contain text/reference/@value
: text.reference.value.exists()
should-text-ref-valuewarningSubstanceAdministration.entryRelationship:indication.observation, SubstanceAdministration.entryRelationship:instruction.act, SubstanceAdministration.entryRelationship:supplyOrder.supply, SubstanceAdministration.entryRelationship:medicationDispense.supply, SubstanceAdministration.entryRelationship:reaction.observation, SubstanceAdministration.entryRelationship:drugMonitoring.act, SubstanceAdministration.entryRelationship:substanceAdministered.act, SubstanceAdministration.entryRelationship:adherence.observation, SubstanceAdministration.entryRelationship:signature.substanceAdministrationSHOULD contain text/reference/@value
: text.reference.value.exists()
should-translationwarningSubstanceAdministration.routeCodeSHOULD contain translation
: translation.exists()
should-unitwarningSubstanceAdministration.doseQuantitySHOULD contain @unit
: nullFlavor.exists() or unit.exists()
should-value-attwarningSubstanceAdministration.effectiveTime:durationSHOULD contain @value
: value.exists()
sig-closederrorSubstanceAdministration.entryRelationship:signature.substanceAdministrationThis is a closed template and shall not contain any elements besides code, text, and consumable
: (typeId | statusCode | effectiveTime | priorityCode | repeatNumber | routeCode | approachSiteCode | doseQuantity | rateQuantity | maxDoseQuantity | administrationUnitCode | subject | specimen | performer | informant | participant | entryRelationship | precondition).empty()
value-starts-octothorpeerrorSubstanceAdministration.text.referenceIf 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: 10 elements (15 nested mandatory elements)
Fixed Value: 12 elements

Structures

This structure refers to these other structures:

Slices

This structure defines the following Slices:

  • The element SubstanceAdministration.templateId is sliced based on the values of value:root, value:extension
  • The element SubstanceAdministration.effectiveTime is sliced based on the value of type:$this
  • The element SubstanceAdministration.participant is sliced based on the value of value:typeCode
  • The element SubstanceAdministration.entryRelationship is sliced based on the values of profile:substanceAdministration, profile:observation, profile:act, profile:supply

 

Other representations of profile: CSV, Excel