2.16.840.1.113883.10.22.4.4

From HL7 IPS
Jump to: navigation, search
Comments on this page

Template IPSMedicationStatement

An IPS Medication entry describes a medication statement, that is a substance administration that has 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.The source of this information can be the patient, significant other (such as a family member or spouse), or a clinician. A common scenario where this information is captured is during the history taking process during a patient visit or stay, but it could be derived from the medications information recorded into a GP's EHR-system, in form of prescribed medication, or administration statements.The medication information may come from sources such as the patient's memory, from a prescription bottle, or from a list of medications the patient, clinician or other party maintains.A medication statement is usually less specific than an a prescription or a medication administration record.  This entry is composed by a main substanceAdministration act and a subordinate substanceAdministration act, unless it is asserted that there are no medications data. The first conveys information as the product, the period of administration and the route of administration; the latter is used to provide dosage information as the frequency of intakes or the amount of the medication given.

Actual version

Id2.16.840.1.113883.10.22.4.4Effective Date2021‑09‑02 12:17:54
Other versions this id:
  • Kblank.png IPSMedicationStatement as of 2016‑11‑11
StatusKyellow.png DraftVersion Label2021
NameIPSMedicationStatementDisplay NameIPS Medication Statement
Description
An IPS Medication entry describes a medication statement, that is a substance administration that has 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.
The source of this information can be the patient, significant other (such as a family member or spouse), or a clinician. A common scenario where this information is captured is during the history taking process during a patient visit or stay, but it could be derived from the medications information recorded into a GP's EHR-system, in form of prescribed medication, or administration statements.
The medication information may come from sources such as the patient's memory, from a prescription bottle, or from a list of medications the patient, clinician or other party maintains.
A medication statement is usually less specific than an a prescription or a medication administration record.  
This entry is composed by a main substanceAdministration act and a subordinate substanceAdministration act, unless it is asserted that there are no medications data. 
The first conveys information as the product, the period of administration and the route of administration; the latter is used to provide dosage information as the frequency of intakes or the amount of the medication given.
ContextParent nodes of template element with id 2.16.840.1.113883.10.22.4.4
ClassificationCDA Entry Level Template
Open/ClosedOpen (other than defined elements are allowed)
Associated with
Associated with 3 concepts
IdNameData Set
hl7ips-data​element-102Kyellow.png Route of administration Kyellow.png CEN/TC 251 prEN 17269
hl7ips-data​element-104Kyellow.png Medication Kyellow.png CEN/TC 251 prEN 17269
hl7ips-data​element-220Kyellow.png Medication Summary content status Kyellow.png CEN/TC 251 prEN 17269
Uses
Uses 4 templates
Uses as NameVersion
2.16.840.1.113883.10.21.9.1IncludeKyellow.png UV Use Period (2023)DYNAMIC
2.16.840.1.113883.10.22.4.2ContainmentKorange.png IPS Medication Information (detail) (STU1)DYNAMIC
2.16.840.1.113883.10.22.4.14ContainmentKorange.png IPS Body Author (STU1)DYNAMIC
2.16.840.1.113883.10.21.4.6ContainmentKyellow.png UV Subordinate Substance Administration (2023)DYNAMIC
RelationshipVersion: template 2.16.840.1.113883.10.22.4.4 IPS Medication Statement (2016‑11‑11)
Adaptation: template 1.3.6.1.4.1.12559.11.10.1.3.1.3.4 Medication Item (2013‑12‑20)
ref
epsos-

Specialization: template 2.16.840.1.113883.10.21.4.7 UV Medication Statement (DYNAMIC)
ref
pharmcda-
Example
Example
<substanceAdministration classCode="SBADM" moodCode="INT">
  <templateId root="2.16.840.1.113883.10.22.4.4"/>  <code code="DRUG" codeSystem="2.16.840.1.113883.5.4" displayName="Drug"/>  <statusCode code="active"/>  <effectiveTime>
    <width value="2" unit="wk"/>  </effectiveTime>
  <consumable typeCode="CSM">
    <!-- template 'IPS ManufacturedProduct' (dynamic) -->
  </consumable>
  <entryRelationship typeCode="COMP">
    <substanceAdministration classCode="SBADM" moodCode="EVN">
      <statusCode code="active"/>      <effectiveTime xsi:type="PIVL_TS" institutionSpecified="true">
        <period value="12" unit="h"/>      </effectiveTime>
      <doseQuantity value="2" unit="{puff}"/>      <consumable>
        <manufacturedProduct>
          <manufacturedMaterial nullFlavor="NA"/>        </manufacturedProduct>
      </consumable>
    </substanceAdministration>
  </entryRelationship>
</substanceAdministration>
Example
No medication infos
<substanceAdministration classCode="SBADM" moodCode="INT">
  <templateId root="2.16.840.1.113883.10.22.4.4"/>  <code code="no-medication-info" codeSystem="2.16.840.1.113883.5.1150.1" displayName="No information about medications"/>  <statusCode code="completed"/>  <effectiveTime nullFlavor="NA" xsi:type="IVL_TS"/>  <consumable>
    <manufacturedProduct>
      <manufacturedMaterial nullFlavor="NA"/>    </manufacturedProduct>
  </consumable>
</substanceAdministration>
ItemDTCardConfDescriptionLabel
hl7:substanceAdministration
R(IPS...ent)
 
Target.png
hl7ips-data​element-104Kyellow.png Medication Kyellow.png CEN/TC 251 prEN 17269
Treetree.png@classCode
cs1 … 1FSBADM
Treetree.png@moodCode
cs1 … 1RIf the statement refers to a prescribed medication then a <substanceAdministration> intent (moodCode='INT') is used; otherwise, to record medications which are stated to have taken, the moodCode shall be set to 'EVN'.</substanceAdministration>
 CONF
The value of @moodCode shall be drawn from value set 2.16.840.1.113883.11.20.9.18 MoodCodeEvnInt (DYNAMIC)
Treetree.pnghl7:templateId
II1 … 1M(IPS...ent)
Treeblank.pngTreetree.png@root
uid1 … 1F2.16.840.1.113883.10.22.4.4
Treetree.pnghl7:id
II0 … *R(IPS...ent)
Treetree.pnghl7:code
CD.IPS1 … 1R
The <code> element is valorized with the Substance Administration ACT code "DRUG" unless it is used for asserting the  known absence of medication treatments or no information about them.
(IPS...ent)
 
Target.png
hl7ips-data​element-220Kyellow.png Medication Summary content status Kyellow.png CEN/TC 251 prEN 17269
 CONF
The value of @code shall be drawn from value set 2.16.840.1.113883.11.22.14 DRUGActCode (DYNAMIC)
or
The value of @code shall be drawn from value set 2.16.840.1.113883.11.22.15 Absent or Unknown Medication (DYNAMIC)
Treetree.pnghl7:text
ED0 … 1R
The URI given in the value attribute of the <reference> element points to an element in the narrative content that contains the complete text describing the medication.
In a CDA document, the URI given in the value attribute of the <reference> element points to an element in the narrative content that contains the complete text describing the medication.
(IPS...ent)
Treeblank.pngTreetree.pnghl7:reference
TEL1 … 1M(IPS...ent)
Treeblank.pngTreeblank.pngTreetree.png@value
1 … 1RReference pointing to the narrative, typically #{label}-{generated-id}, e.g. #xxx-1
Treetree.pnghl7:statusCode
CS1 … 1M(IPS...ent)
 CONF
The value of @code shall be drawn from value set 2.16.840.1.113883.11.22.12 ActStatusActiveCompletedAbortedSuspended (DYNAMIC)
 Example<statusCode code="active"/>
Included1 … 1R from 2.16.840.1.113883.10.21.9.1 UV Use Period (DYNAMIC)
Choice1 … 1
The effectiveTime element encodes the use period of the medication, it is always expressed as an interval of time.
It may be expressed using the low and high OR with the width element.
The first is used to indicate a specified interval (e.g. from march 15th, 2017); the latter for indicating a 'floating' period (e.g. 2 weeks).
Elements to choose from:
  • hl7:effectiveTime[hl7:low | hl7:high][not(hl7:width)]
  • hl7:effectiveTime[hl7:width][not(hl7:low|hl7:high)]
  • hl7:effectiveTime[hl7:low | hl7:width][not(hl7:high)]
Treeblank.pngTreetree.pnghl7:effectiveTime
IVL_TS0 … 1CCase 1: specified interval


The low and high values of the first effectiveTime element represent the start and stop times for the medication. The low value represents the start time, and the high value represents the stop time. If either the low or the high value is unknown, this shall be recorded by setting the nullFlavor attribute to UNK.

In case of unbounded period (continuous therapy) the high element will be valued with the nullFlavor attribute to NA.


The high value records the end of the medication regime according to the information provided in the prescription or order. For example, if the prescription is for enough medication to last 30 days, then the high value should contain a date that is 30 days later then the low value. The rationale is that a provider, seeing a prescription that has not been refilled would normally assume that the medication is no longer being taken, even if the intent of the treatment plan is to continue the medication indefinitely.
(IPS...ent)
where [hl7:low or
[not(hl7:width)]
Treeblank.pngTreeblank.pngTreetree.png@nullFlavor
cs0 … 1 
 Example
Known Interval
<effectiveTime type="IVL_TS">
  <low value="20130321"/>  <high value="20140321"/></effectiveTime>
 Example
Information not available about the period
<effectiveTime type="IVL_TS" nullFlavor="NI"/>
 Example
Unknown end date
<effectiveTime type="IVL_TS">
  <low value="20130321"/>  <high nullFlavor="UNK"/></effectiveTime>
 Example
continous therapy
<effectiveTime type="IVL_TS">
  <low value="20130321"/>  <high nullFlavor="NA"/></effectiveTime>
Treeblank.pngTreeblank.pngTreetree.pnghl7:low
IVXB_TS1 … 1R(IPS...ent)
Treeblank.pngTreeblank.pngTreetree.pnghl7:high
IVXB_TS0 … 1R(IPS...ent)
Treeblank.pngTreetree.pnghl7:effectiveTime
IVL_TS0 … 1CCase 2: 'floating' period:
The width element is used to specify a period of (actual or intended) administration that is not anchored to any specific date (e.g. a two weeks therapy)
(IPS...ent)
where [hl7:width] [not(hl7:lowor
hl7:high)]
 Example
2 week period
<effectiveTime type="IVL_TS">
  <width value="2" unit="w"/></effectiveTime>
Treeblank.pngTreeblank.pngTreetree.pnghl7:low
NP(IPS...ent)
Treeblank.pngTreeblank.pngTreetree.pnghl7:high
NP(IPS...ent)
Treeblank.pngTreeblank.pngTreetree.pnghl7:center
NP(IPS...ent)
Treeblank.pngTreeblank.pngTreetree.pnghl7:width
PQ1 … 1R(IPS...ent)
Treeblank.pngTreeblank.pngTreeblank.pngTreetree.png@unit
cs1 … 1R
 CONF
The value of @unit shall be drawn from value set 2.16.840.1.113883.11.21.1 Medication Time Units (UCUM) (DYNAMIC)
Treeblank.pngTreetree.pnghl7:effectiveTime
IVL_TS0 … 1CCase 3: anchored period:
The width element is used to specify a period of (actual or intended) administration anchored to a specific date (e.g. a two weeks therapy starting today)
(IPS...ent)
where [hl7:low or
[not(hl7:high)]
 Example
2 week period starting on 2013-03-21
<effectiveTime type="IVL_TS">
  <low value="20130321"/>  <width value="2" unit="w"/></effectiveTime>
Treeblank.pngTreeblank.pngTreetree.pnghl7:low
IVXB_TS0 … 1C(IPS...ent)
Treeblank.pngTreeblank.pngTreetree.pnghl7:width
PQ1 … 1R(IPS...ent)
Treeblank.pngTreeblank.pngTreeblank.pngTreetree.png@unit
cs1 … 1R
 CONF
The value of @unit shall be drawn from value set 2.16.840.1.113883.11.21.1 Medication Time Units (UCUM) (DYNAMIC)
Treetree.pnghl7:routeCode
CE.IPS0 … 1R
The <routeCode> element specifies the route of administration using the EDQM route of administration vocabulary.
A code must be specified if the route is known. 
Since the EDQM Standards Terms, together with UCUM, is one of the IDMP terminologies actually available for usage, this code system has been selected  as referecne terminology for representing Pharmaceutical Dose forms; Packages and Route of Administration.
It is known that also alternative jurisdictional and international terminologies are also used for this concept domain, as NCI or SNOMED CT.
Official NCI and EDQM maps for the route of administration are available from the EDQM site.
(IPS...ent)
 
Target.png
hl7ips-data​element-102Kyellow.png Route of administration Kyellow.png CEN/TC 251 prEN 17269
 CONF
The value of @code shall be drawn from value set 2.16.840.1.113883.11.22.33 Medicine Route of Administration (DYNAMIC)
Treetree.pnghl7:doseQuantity
IVL_PQNP(IPS...ent)
Treetree.pnghl7:rateQuantity
IVL_PQNP(IPS...ent)
Treetree.pnghl7:administrationUnitCode
CENP(IPS...ent)
Treetree.pnghl7:consumable
1 … 1MContains 2.16.840.1.113883.10.22.4.2 IPS Medication Information (detail) (DYNAMIC)(IPS...ent)
Treeblank.pngTreetree.png@typeCode
cs1 … 1FCSM
Treetree.pnghl7:author
0 … *Contains 2.16.840.1.113883.10.22.4.14 IPS Body Author (DYNAMIC)(IPS...ent)
Treetree.pnghl7:entryRelationship
0 … *C
Subordinate Substance Administration Statement as a component of the overall medication statement.
Unless medications are unknown or known absent, at least one subordinated <substanceAdministration> has to be present to convey information about dosages (dose, frequency of intakes,..).
Subordinated <substanceAdministration> elements can be also used either to handle split dosing, or to support combination medications.

Contains 2.16.840.1.113883.10.21.4.6 UV Subordinate Substance Administration (DYNAMIC)
(IPS...ent)
Treeblank.pngTreetree.png@typeCode
cs1 … 1FCOMP
 ConstraintAt least one subordinate <substanceAdministration> element SHALL be present unless medications are unknown or known absent. </substanceAdministration>
 Example<hl7:entryRelationship typeCode="COMP">
  <!-- component: Subordinate Substance Administration Statement. -->
  <hl7:substanceAdministration classCode="SBADM" moodCode="EVN">
    <hl7:templateId root="2.16.840.1.113883.10.22.4.33"/>    <!-- .. -->
  </hl7:substanceAdministration>
  <hl7:sequenceNumber value="1"/></hl7:entryRelationship>
Treeblank.pngTreetree.pnghl7:sequenceNumber
INT0 … 1Sequence number of the Subordinate Substance Administration(IPS...ent)


List of all versions of this template