Back To Index  <<  Back To Templates

draft Template  Medication Activity (V2)

Id 2.16.840.1.113883.10.20.22.2.83 Effective Date 2019‑03‑31 19:39:08
Other versions this id:
Status draft Draft Version Label 2.1
Name MedicationActivityV2 Display Name Medication Activity (V2)
Description
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 to 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 (V2) template be used for moodCodes other than EVN if the document type contains a section that includes Planned Medication Activity (V2) (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" will have a dose of "25 mg".
Classification CDA Entry Level Template
Open/Closed Open (other than defined elements are allowed)
Used by / Uses
Used by 0 transactions and 6 templates, Uses 12 templates
Used by as Name Version
2.16.840.1.113883.10.20.22.2.82 Containment draft Discharge Medication (V2) (2.1) 2019‑03‑31 19:24:50
2.16.840.1.113883.10.20.22.2.11 link draft BC CDA Discharge Medications Section (entries optional) (V3) (2.1) 2019‑03‑15 14:34:42
2.16.840.1.113883.3.51.60.2.4.1 link draft BC CDA ClinicalDocumentDischargeSummary (V3) (2.1) 2019‑03‑19 14:15:51
2.16.840.1.113883.10.20.22.2.89 Containment draft Admission Medication (V2) (2.1) 2019‑04‑01 01:46:48
2.16.840.1.113883.10.20.22.2.43 link draft Admission Diagnosis Section (V3) (2.1) 2019‑03‑16 20:59:38
2.16.840.1.113883.10.20.22.2.44 link draft BC CDA Admission Medications Section (entries optional) (V3) (2.1) 2019‑03‑16 21:05:50
Uses as Name Version
2.16.840.1.113883.10.20.22.2.71 Containment draft Medication Information (V2) (2.1) DYNAMIC
2.16.840.1.113883.10.20.22.2.81 Containment draft BC CDA Author (Body) DYNAMIC
2.16.840.1.113883.10.20.22.2.65 Containment draft Drug Vehicle (2.1) DYNAMIC
2.16.840.1.113883.10.20.22.2.67 Containment draft Indication (V2) (2.1) DYNAMIC
2.16.840.1.113883.10.20.22.2.68 Containment draft Instruction (V2) (2.1) DYNAMIC
2.16.840.1.113883.10.20.22.2.72 Containment draft Medication Supply Order (V2) (2.1) DYNAMIC
2.16.840.1.113883.10.20.22.2.69 Containment draft Medication Dispense (V2) (2.1) DYNAMIC
2.16.840.1.113883.10.20.22.2.58 Containment draft Reaction Observation (V2) (2.1) DYNAMIC
2.16.840.1.113883.10.20.22.2.64 Containment draft Drug Monitoring Act (2.1) DYNAMIC
2.16.840.1.113883.10.20.22.2.76 Containment draft Substance Administered Act (2.1) DYNAMIC
2.16.840.1.113883.10.20.22.2.70 Containment draft Medication Free Text Sig (2.1) DYNAMIC
2.16.840.1.113883.10.20.22.2.85 Containment draft Precondition for Substance Administration (V2) (2.1) DYNAMIC
Relationship Specialization: template 2.16.840.1.113883.10.20.22.2.83 (2014‑06‑09)
ref
?

Specialization: template 2.16.840.1.113883.10.12.308 CDA SubstanceAdministration (2005‑09‑07)
ref
ad1bbr-

Version: template 2.16.840.1.113883.10.20.22.2.83 (2013‑01‑31)
ref
?
Item DT Card Conf Description Label
cda:substanceAdministration
(MeddotsyV2)
treetree @classCode
cs 1 … 1 F SBADM CONFdots7496
  SHALL contain exactly one [1..1] @classCode="SBADM" (CodeSystem: HL7ActClass urn:oid:2.16.840.1.113883.5.6 STATIC) (CONF:1098-7496).
treetree @moodCode
cs 1 … 1 R SHALL contain exactly one [1..1] @moodCode, which SHALL be selected from ValueSet MoodCodeEvnInt urn:oid:2.16.840.1.113883.11.20.9.18 STATIC 2011-04-03 (CONF:1098-7497). CONFdots7497
  CONF
The value of @moodCode shall be drawn from value set 2.16.840.1.113883.11.20.9.18 MoodCodeEvnInt (2011‑04‑03)
treetree hl7:templateId
II 1 … 1 M (MeddotsyV2)
treeblank treetree @root
uid 1 … 1 F 2.16.840.1.113883.10.20.22.2.83
treetree cda:templateId
II 1 … 1 M SHALL contain exactly one [1..1] templateId (CONF:1098-7499) such that it CONFdots7499
treeblank treetree @root
uid 1 … 1 F 2.16.840.1.113883.10.20.22.2.83 CONFdots0504
  SHALL contain exactly one [1..1] @root="2.16.840.1.113883.10.20.22.4.16" (CONF:1098-10504).
treeblank treetree @extension
st 1 … 1 F 2014-06-09 CONFdots2498
  SHALL contain exactly one [1..1] @extension="2014-06-09" (CONF:1098-32498).
treetree cda:id
II 1 … * SHALL contain at least one [1..*] id (CONF:1098-7500). CONFdots7500
treetree cda:code
0 … 1 SHOULD contain zero or one [0..1] code drawn from Code System Canadian Clinical Drug Dataset urn:oid 2.16.840.1.113883.2.20.6.1(CONF:1098-7506). CONFdots7506
treetree cda:statusCode
CS 1 … 1 R SHALL contain exactly one [1..1] statusCode (CONF:1098-7507). CONFdots7507
treetree cda:effectiveTime
IVL_TS 1 … 1 M The 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. CONFdots7508
treeblank where [not(@operator='A')]
treeblank treetree @value
0 … 1   SHOULD contain zero or one [0..1] @value (CONF:1098-32775). CONFdots2775
treeblank treetree cda:low
0 … 1 R SHOULD contain zero or one [0..1] low (CONF:1098-32776). CONFdots2776
treeblank treetree cda:high
0 … 1 MAY contain zero or one [0..1] high (CONF:1098-32777). CONFdots2777
  Schematron assert role red error  
  test (cda:low or @value) and not(cda:low and @value)  
  Message This effectiveTime *SHALL* contain either a low or a @value but not both.  
treetree cda:effectiveTime
0 … 1 R CONFdots7513
treeblank where [@operator='A']
treeblank treetree @operator
cs 1 … 1 F A
  Constraint *SHALL* contain exactly one [1..1] @xsi:type="PIVL_TS" or "EIVL_TS"
  Schematron assert role red error  
  test count(preceding-sibling::cda:effectiveTime) = 1 and .[@operator='A'][@xsi:type='PIVL_TS' or @xsi:type='EIVL_TS']  
  Message SHOULD contain zero or one [0..1] effectiveTime (CONF:1098-7513) such that it  
treetree cda:repeatNumber
0 … 1 MAY contain zero or one [0..1] repeatNumber (CONF:1098-7555).

In "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.

CONFdots7555
treetree cda:routeCode
0 … 1 R SHOULD contain zero or one [0..1] routeCode, which SHALL be selected from ValueSet Medication Route FDA urn:oid:2.16.840.1.113883.3.88.12.3221.8.7 DYNAMIC (CONF:1098-7514). CONFdots7514
  CONF
The value of @code shall be drawn from value set 2.16.840.1.113883.3.88.12.3221.8.7 Medication Route FDA (DYNAMIC)
treetree cda:approachSiteCode
CD 0 … 1 MAY contain zero or one [0..1] approachSiteCode, where the code SHALL be selected from ValueSet Body Site urn:oid:2.16.840.1.113883.3.88.12.3221.8.9 DYNAMIC (CONF:1098-7515). CONFdots7515
  CONF
The value of @code shall be drawn from value set 2.16.840.1.113883.3.88.12.3221.8.9 Body Site (DYNAMIC)
Choice 1 … 
nl-NL Medication Activity *SHOULD* include doseQuantity *OR* rateQuantity
Elements to choose from:
  • cda:doseQuantity[not(@nullFlavor)]
  • cda:rateQuantity
treeblank treetree cda:doseQuantity
1 … 1 M SHALL contain exactly one [1..1] doseQuantity (CONF:1098-7516). CONFdots7516
treeblank treeblank treetree @unit
cs 0 … 1   This doseQuantity SHOULD contain zero or one [0..1] @unit, which SHALL be selected from ValueSet UnitsOfMeasureCaseSensitive urn:oid:2.16.840.1.113883.1.11.12839 DYNAMIC (CONF:1098-7526). CONFdots7526
  CONF
The value of @unit shall be drawn from value set 2.16.840.1.113883.1.11.12839 UnitsOfMeasureCaseSensitive (DYNAMIC)
  Constraint Pre-coordinated consumable: If the consumable code is a pre-coordinated unit dose (e.g., "metoprolol 25mg tablet") then doseQuantity is a unitless number that indicates the number of products given per administration (e.g., "2", meaning 2 x "metoprolol 25mg tablet" per administration).
Not pre-coordinated consumable: If the consumable code is not pre-coordinated (e.g., is simply "metoprolol"), then doseQuantity must represent a physical quantity with @unit, e.g., "25" and "mg", specifying the amount of product given per administration.
treeblank treetree cda:rateQuantity
0 … 1 MAY contain zero or one [0..1] rateQuantity (CONF:1098-7517). CONFdots7517
treeblank treeblank treetree @unit
cs 1 … 1 R The rateQuantity, if present, SHALL contain exactly one [1..1] @unit, which SHALL be selected from ValueSet UnitsOfMeasureCaseSensitive urn:oid:2.16.840.1.113883.1.11.12839 DYNAMIC (CONF:1098-7525). CONFdots7525
  CONF
The value of @unit shall be drawn from value set 2.16.840.1.113883.1.11.12839 UnitsOfMeasureCaseSensitive (DYNAMIC)
treetree cda:maxDoseQuantity
RTO_PQ_PQ 0 … 1 MAY contain zero or one [0..1] maxDoseQuantity (CONF:1098-7518). CONFdots7518
treetree cda:administrationUnitCode
CE 0 … 1 MAY contain zero or one [0..1] administrationUnitCode, which SHALL be selected from ValueSet AdministrationUnitDoseForm urn:oid:2.16.840.1.113762.1.4.1021.30 DYNAMIC (CONF:1098-7519).

administrationUnitCode@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.

CONFdots7519
  CONF
The value of @code shall be drawn from value set 2.16.840.1.113762.1.4.1021.30 Administration Unit Dose Form (DYNAMIC)
treetree cda:consumable
1 … 1 M Contains 2.16.840.1.113883.10.20.22.2.71 Medication Information (V2) (DYNAMIC) CONFdots7520
treeblank where [cda:manufacturedProduct [hl7:templateId [@root = '2.16.840.1.113883.10.20.22.2.71'] and cda:templateId [@root = '2.16.840.1.113883.10.20.22.2.71'] [@extension = '2014-06-09']]]
treetree cda:performer
0 … 1 MAY contain zero or one [0..1] performer (CONF:1098-7522). CONFdots7522
treetree cda:author
0 … * R SHOULD contain zero or more [0..*] Author Participation (identifier: urn:oid:2.16.840.1.113883.10.20.22.4.119) (CONF:1098-31150).
Contains 2.16.840.1.113883.10.20.22.2.81 BC CDA Author (Body) (DYNAMIC)
CONFdots1150
treeblank where [hl7:assignedAuthor [@classCode = 'ASSIGNED']]
treetree cda:participant
0 … * Contains 2.16.840.1.113883.10.20.22.2.65 Drug Vehicle (DYNAMIC) CONFdots7523
treeblank where [cda:participantRole [hl7:templateId [@root = '2.16.840.1.113883.10.20.22.2.65'] and cda:templateId [@root = '2.16.840.1.113883.10.20.22.2.65']]]
treeblank treetree @typeCode
cs 1 … 1 F CSM CONFdots7524
  SHALL contain exactly one [1..1] @typeCode="CSM" (CodeSystem: HL7ParticipationType urn:oid:2.16.840.1.113883.5.90 STATIC) (CONF:1098-7524).
treetree cda:entryRelationship
0 … * Contains 2.16.840.1.113883.10.20.22.2.67 Indication (V2) (DYNAMIC) CONFdots7536
treeblank where [cda:observation [hl7:templateId [@root = '2.16.840.1.113883.10.20.22.2.67'] and cda:templateId [@root = '2.16.840.1.113883.10.20.22.2.67'] [@extension = '2014-06-09']]]
treeblank treetree @typeCode
cs 1 … 1 F RSON CONFdots7537
  SHALL contain exactly one [1..1] @typeCode="RSON" (CodeSystem: HL7ActRelationshipType urn:oid:2.16.840.1.113883.5.1002 STATIC) (CONF:1098-7537).
treetree cda:entryRelationship
0 … 1 Contains 2.16.840.1.113883.10.20.22.2.68 Instruction (V2) (DYNAMIC) CONFdots7539
treeblank where [cda:act [hl7:templateId [@root = '2.16.840.1.113883.10.20.22.2.68'] and cda:templateId [@root = '2.16.840.1.113883.10.20.22.2.68'] [@extension = '2014-06-09']]]
treeblank treetree @typeCode
cs 1 … 1 F SUBJ CONFdots7540
  SHALL contain exactly one [1..1] @typeCode="SUBJ" (CodeSystem: HL7ActRelationshipType urn:oid:2.16.840.1.113883.5.1002 STATIC) (CONF:1098-7540).
treeblank treetree @inversionInd
bl 1 … 1 F true CONFdots7542
  SHALL contain exactly one [1..1] @inversionInd="true" True (CONF:1098-7542).
treetree cda:entryRelationship
0 … 1 Contains 2.16.840.1.113883.10.20.22.2.72 Medication Supply Order (V2) (DYNAMIC) CONFdots7543
treeblank where [cda:supply [hl7:templateId [@root = '2.16.840.1.113883.10.20.22.2.72'] and cda:templateId [@root = '2.16.840.1.113883.10.20.22.2.72'] [@extension = '2014-06-09']]]
treeblank treetree @typeCode
cs 1 … 1 F REFR CONFdots7547
  SHALL contain exactly one [1..1] @typeCode="REFR" (CodeSystem: HL7ActRelationshipType urn:oid:2.16.840.1.113883.5.1002 STATIC) (CONF:1098-7547).
treetree cda:entryRelationship
0 … * Contains 2.16.840.1.113883.10.20.22.2.69 Medication Dispense (V2) (DYNAMIC) CONFdots7549
treeblank where [cda:supply [hl7:templateId [@root = '2.16.840.1.113883.10.20.22.2.69'] and cda:templateId [@root = '2.16.840.1.113883.10.20.22.2.69'] [@extension = '2014-06-09']]]
treeblank treetree @typeCode
cs 1 … 1 F REFR CONFdots7553
  SHALL contain exactly one [1..1] @typeCode="REFR" (CodeSystem: HL7ActRelationshipType urn:oid:2.16.840.1.113883.5.1002 STATIC) (CONF:1098-7553).
treetree cda:entryRelationship
0 … * Contains 2.16.840.1.113883.10.20.22.2.58 Reaction Observation (V2) (DYNAMIC) CONFdots7552
treeblank where [cda:observation [hl7:templateId [@root = '2.16.840.1.113883.10.20.22.2.58'] and cda:templateId [@root = '2.16.840.1.113883.10.20.22.2.58'] [@extension = '2014-06-09']]]
treeblank treetree @typeCode
cs 1 … 1 F CAUS CONFdots7544
  SHALL contain exactly one [1..1] @typeCode="CAUS" (CodeSystem: HL7ActRelationshipType urn:oid:2.16.840.1.113883.5.1002 STATIC) (CONF:1098-7544).
treetree cda:entryRelationship
0 … 1 Contains 2.16.840.1.113883.10.20.22.2.64 Drug Monitoring Act (DYNAMIC) CONFdots0820
treeblank where [cda:act [hl7:templateId [@root = '2.16.840.1.113883.10.20.22.2.64'] and cda:templateId [@root = '2.16.840.1.113883.10.20.22.2.64']]]
treeblank treetree @typeCode
cs 1 … 1 F COMP CONFdots0821
  SHALL contain exactly one [1..1] @typeCode="COMP" Has component (CONF:1098-30821).
treetree cda:entryRelationship
0 … * The 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.
Contains 2.16.840.1.113883.10.20.22.2.76 Substance Administered Act (DYNAMIC)
CONFdots1515
treeblank where [cda:act [hl7:templateId [@root = '2.16.840.1.113883.10.20.22.2.76'] and cda:templateId [@root = '2.16.840.1.113883.10.20.22.2.76']]]
treeblank treetree @typeCode
cs 1 … 1 F COMP CONFdots1516
  SHALL contain exactly one [1..1] @typeCode="COMP" Component (CodeSystem: HL7ActRelationshipType urn:oid:2.16.840.1.113883.5.1002) (CONF:1098-31516).
treeblank treetree @inversionInd
bl 1 … 1 F true CONFdots1517
  SHALL contain exactly one [1..1] @inversionInd="true" (CONF:1098-31517).
treeblank treetree cda:sequenceNumber
0 … 1 MAY contain zero or one [0..1] sequenceNumber (CONF:1098-31518). CONFdots1518
treetree cda:entryRelationship
0 … * Contains 2.16.840.1.113883.10.20.22.2.70 Medication Free Text Sig (DYNAMIC) CONFdots2907
treeblank where [cda:substanceAdministration [hl7:templateId [@root = '2.16.840.1.113883.10.20.22.2.70'] and cda:templateId [@root = '2.16.840.1.113883.10.20.22.2.70']]]
treeblank treetree @typeCode
cs 1 … 1 F COMP CONFdots2908
  SHALL contain exactly one [1..1] @typeCode="COMP" Has component (CodeSystem: HL7ActRelationshipType urn:oid:2.16.840.1.113883.5.1002) (CONF:1098-32908).
treetree cda:precondition
0 … * Contains 2.16.840.1.113883.10.20.22.2.85 Precondition for Substance Administration (V2) (DYNAMIC) CONFdots1520
treeblank where [cda:criterion [hl7:templateId [@root = '2.16.840.1.113883.10.20.22.2.85'] and cda:templateId [@root = '2.16.840.1.113883.10.20.22.2.85'] [@extension = '2014-06-09']]]
treeblank treetree @typeCode
cs 1 … 1 F PRCN CONFdots1882
  The precondition, if present, SHALL contain exactly one [1..1] @typeCode="PRCN" (CONF:1098-31882).