Difference between revisions of "PHARM Templates Implementationguide"

From HL7 IPS
Jump to: navigation, search
Line 9: Line 9:
 
|Date      = July 29, 2017
 
|Date      = July 29, 2017
 
|Status    = Draft
 
|Status    = Draft
|Period    = Draft
+
|Period    = Ballot
 
|OID      = n.n.
 
|OID      = n.n.
 
|Realm    = Universal
 
|Realm    = Universal
 
|Custodian = HL7
 
|Custodian = HL7
 
|Copyrighttext = © 2016-2017 Health Level Seven International ® ALL RIGHTS RESERVED.<br>The reproduction of this material in any form is strictly forbidden without the written permission of the publisher. HL7 and Health Level Seven are registered trademarks of Health Level Seven International.
 
|Copyrighttext = © 2016-2017 Health Level Seven International ® ALL RIGHTS RESERVED.<br>The reproduction of this material in any form is strictly forbidden without the written permission of the publisher. HL7 and Health Level Seven are registered trademarks of Health Level Seven International.
 +
|Topright  = CDAR2_IG_PHARM_TEMPLATES_R1_O1_2017SEP
 
}}
 
}}
  
Line 123: Line 124:
 
<br>
 
<br>
 
{{:2.16.840.1.113883.10.21.4.7/dynamic}}
 
{{:2.16.840.1.113883.10.21.4.7/dynamic}}
 
+
<!--
 
==Entry Level Templates==
 
==Entry Level Templates==
 
===UV ClinicalStatement Encounter===
 
===UV ClinicalStatement Encounter===
Line 152: Line 153:
 
{{:2.16.840.1.113883.10.20.22.4.19/dynamic}}
 
{{:2.16.840.1.113883.10.20.22.4.19/dynamic}}
 
</div>
 
</div>
 
+
-->
 
=Appendix (Informative) =
 
=Appendix (Informative) =
 
==Acronyms and abbreviations ==
 
==Acronyms and abbreviations ==

Revision as of 08:34, 31 July 2017

Document Information

This document contains: Implementation Guide Pharmacy Templates (0.95). The text materials belong to category cdapharm.



Important Notes

HL7 licenses its standards and select IP free of charge. If you did not acquire a free license from HL7 for this document, you are not authorized to access or make any use of it. To obtain a free license, please visit http://www.HL7.org/implement/standards/index.cfm.

If you are the individual that obtained the license for this HL7 Standard, specification or other freely licensed work (in each and every instance "Specified Material"), the following describes the permitted uses of the Material.

A. HL7 INDIVIDUAL, STUDENT AND HEALTH PROFESSIONAL MEMBERS, who register and agree to the terms of HL7’s license, are authorized, without additional charge, to read, and to use Specified Material to develop and sell products and services that implement, but do not directly incorporate, the Specified Material in whole or in part without paying license fees to HL7.

INDIVIDUAL, STUDENT AND HEALTH PROFESSIONAL MEMBERS wishing to incorporate additional items of Special Material in whole or part, into products and services, or to enjoy additional authorizations granted to HL7 ORGANIZATIONAL MEMBERS as noted below, must become ORGANIZATIONAL MEMBERS of HL7.

B. HL7 ORGANIZATION MEMBERS, who register and agree to the terms of HL7's License, are authorized, without additional charge, on a perpetual (except as provided for in the full license terms governing the Material), non-exclusive and worldwide basis, the right to (a) download, copy (for internal purposes only) and share this Material with your employees and consultants for study purposes, and (b) utilize the Material for the purpose of developing, making, having made, using, marketing, importing, offering to sell or license, and selling or licensing, and to otherwise distribute, Compliant Products, in all cases subject to the conditions set forth in this Agreement and any relevant patent and other intellectual property rights of third parties (which may include members of HL7). No other license, sublicense, or other rights of any kind are granted under this Agreement.

C. NON-MEMBERS, who register and agree to the terms of HL7’s IP policy for Specified Material, are authorized, without additional charge, to read and use the Specified Material for evaluating whether to implement, or in implementing, the Specified Material, and to use Specified Material to develop and sell products and services that implement, but do not directly incorporate, the Specified Material in whole or in part. NON-MEMBERS wishing to incorporate additional items of Specified Material in whole or part, into products and services, or to enjoy the additional authorizations granted to HL7 ORGANIZATIONAL MEMBERS, as noted above, must become ORGANIZATIONAL MEMBERS of HL7. Please see http://www.HL7.org/legal/ippolicy.cfm for the full license terms governing the Material.

Ownership. Licensee agrees and acknowledges that HL7 owns all right, title, and interest, in and to the Materials. Licensee shall take no action contrary to, or inconsistent with, the foregoing.

Licensee agrees and acknowledges that HL7 may not own all right, title, and interest, in and to the Materials and that the Materials may contain and/or reference intellectual property owned by third parties (“Third Party IP”). Acceptance of these License Terms does not grant Licensee any rights with respect to Third Party IP. Licensee alone is responsible for identifying and obtaining any necessary licenses or authorizations to utilize Third Party IP in connection with the Materials or otherwise. Any actions, claims or suits brought by a third party resulting from a breach of any Third Party IP right by the Licensee remains the Licensee’s liability.

Following is a non-exhaustive list of third-party terminologies that may require a separate license:

TerminologyOwner/Contact
Current Procedures Terminology (CPT) code setAmerican Medical Association https://www.ama-assn.org/practice-management/cpt-licensing
SNOMED CT©SNOMED CT® International http://www.snomed.org/snomed-ct/get-snomed-ct or info@ihtsdo.org
Logical Observation Identifiers Names & Codes (LOINC©)Regenstrief Institute, Inc.
International Classification of Diseases (ICD) codesWorld Health Organization (WHO)
NUCC Health Care Provider Taxonomy code setAmerican Medical Association. Please see www.nucc.org. AMA licensing contact: 312-464-5022 (AMA IP services)

Obtaining a CPT Sublicense from HL7

Contact hq@hl7.org about how to obtain a sublicense from HL7 for non-production use of CPT for (i) the development and publication of value sets, profiles, and other artifacts as part of the HL7 Implementation Guides, (ii) as part of defined VSAC value sets, and (iii) to support HL7's terminology services within the Territory.

Flow Down Clauses for CPT Sublicense from HL7

CPT content is copyrighted by the American Medical Association and CPT is a registered trademark of the AMA.

HL7, as a party to a license agreement with the AMA, is authorized to grant user a limited, non-exclusive, non-transferable, non-sublicensable license for user to use CPT content for (i) the development and publication of value sets, profiles, and other artifacts as part of the HL7 Implementation Guides, (ii) as part of defined VSAC value sets, and (iii) to support HL7's terminology services within the Territory, each of which shall be considered a non-production use. The sublicense granted hereunder shall automatically terminate upon termination of the agreement between HL7 and AMA, unless prior written consent of AMA is obtained.

The provision of updated CPT content is dependent on a continuing contractual relationship between HL7 and the AMA.

User acknowledge a separate license agreement shall be required, and shall govern any proposed use, including any distribution of CPT content for any other purposes not expressly permitted under this Agreement, and the terms of such agreement will govern such use (e.g., a separate license agreement shall govern production use and commercial purposes). AMA reserves the right to accept or reject licenses based on AMA's evaluation of the proposed use of the CPT content.

User acknowledge that User's development and commercialization of CPT-informed works developed with reference to Licensed Products may only be implemented in the Territory.

User is prohibited from making CPT content publicly available, creating derivative works (including translating), transferring, selling, leasing, licensing, or otherwise making available to any unauthorized party the CPT content, or a copy or portion of CPT content to any unauthorized party, including a subsidiary, affiliate, or other legal entity, however designated, for any purpose whatsoever except as expressly permitted under a separate agreement.

User expressly acknowledges and agrees to the extent permitted by applicable law, use of CPT content is at User's sole risk and CPT content is provided "as is" without warranty of any kind. The AMA does not directly or indirectly practice medicine or dispense medical services. Fee schedules, relative value units, conversion factors and/or related components are not assigned by the AMA, are not part of CPT, and the AMA is not recommending their use. CPT content herein does not replace the AMA's Current Procedural Terminology book or other appropriate coding authority. The coding information contained in CPT content should be used only as a guide.

U.S. Government End Users. CPT is commercial technical data, which was developed exclusively at private expense by the American Medical Association (AMA), 330 North Wabash Avenue, Chicago, Illinois 60611. This agreement does not grant the Federal Government a direct license to use CPT based on FAR 52.227- 14 (Data Rights - General) and DFARS 252.227-7015 (Technical Data - Commercial Items).

User expressly consents to the release of its name to the AMA.

Co-Chair, Primary Editor Melva Peters
Jenaker Consulting
melva@jenakerconsulting.com
Co-Chair, Primary Editor John Hatem
jnhatem@hotmail.com
Co-Chair Scott Robertson PharmD
scott.m.robertson@kp.org
Co-Chair Jean Duteau
jean@duteaudesign.com
Contributor Dr Kai U. Heitmann
Heitmann Consulting and Services, ART-DECOR Open Tools GmbH, HL7 Germany
info@kheitmann.de
Contributor Giorgio Cangioli, PhD
Consultant, HL7 Italy
giorgio.cangioli@gmail.com
Contributor Tom de Jong
VZVZ, HL7 The Netherlands
tom@nova-pro.nl
Contributor Dr Christof Geßner
Gematik GmbH, HL7 Germany
christof.gessner@gematik.de

Introduction

This Implementation Guide provides templates for Medication Order and Medication Statement that can be used by HL7 standards developers and external projects to develop models for pharmacy related content. The implementation guide is intended to provide consistency of pharmacy related models across all uses regardless of the method of transport by:

  • creating a library of Universal pharmacy templates that can be used by other Work Groups to derive constrained versions.

Purpose

Background

Historically multiple HL7 Work Groups have developed specifications for pharmacy related content and as a result, there is inconsistency in the models that exist in HL7 V2, V3, CDA and FHIR. The Pharmacy Work Group often receives questions as to how to model pharmacy related content but in some cases, the use case cannot be met with the existing models.

This Implementation Guide provides a library of pharmacy templates that can be used by HL7 Work Groups or external projects to derive constrained versions of models for pharmacy related content.

Scope

The scope of the Implementation Guide is limited to Medication Order and Medication Statement. The content was developed by aligning and harmonizing the existing specifications for Consolidated CDA (C-CDA Release 2.1[1]).

Future releases of the Implementation Guide will include Medication Dispense and Medication Administration.

Ballot Status of the Document

The Implementation Guide is being balloted as Informative with the intention to go to Standard for Trial Use (STU) and then to Normative.

Audience

  • Clinical and Public Health laboratories
  • Immunization Registries
  • Pharmaceutical Vendors
  • EHR/PHR vendors
  • Clinical Decision Support Systems
  • HIS Vendors
  • Emergency Services Providers
  • Healthcare Institutions
  • Pharmacists
  • Physicians and other Clinicians

Relationships with other projects and guides

  • Consolidated CDA (C-CDA)
  • HL7 Version 3 Pharmacy Models
  • HL7 FHIR® Pharmacy Resources

Principles and background

The Pharmacy Work Group has a set of rich set of existing models that were used as the basis for the implementation guide including HL7 V3 models and FHIR resources. 

This implementation guide was created by the Pharmacy Work Group using the following approach:

  • Review of Consolidated CDA (C-CDA[1]) to identify templates that include pharmacy related content
  • Compare C-CDA templates to existing Pharmacy HL7 V3 models and Pharmacy FHIR resources to identify differences and gaps
  • Create universal templates to that can be constrained for use for new templates

The template rules are formalized using the computable format defined by the HL7 Templates Standard: Specification and Use of Reusable Information Constraint Templates, Release 1[2] in order to facilitate also the automatic generation of consistent testing and validation capabilities.

Technical Background

What is a CDA

CDA R2 is "… a document markup standard that specifies the structure and semantics of clinical documents for the purpose of exchange” [CDA R2, Section 1.1]. Clinical documents, according to CDA, have the following characteristics:

  • Persistence
  • Stewardship
  • Potential for authentication
  • Context
  • Wholeness
  • Human readability

CDA defines a header for classification and management and a document body that carries the clinical record. While the header metadata are prescriptive and designed for consistency across all instances, the body is highly generic, leaving the designation of semantic requirements to implementation.

Templated CDA

CDA R2 can be constrained by mechanisms defined in the “Refinement and Localization” section of the HL7 Version 3 Interoperability Standards. The mechanism most commonly used to constrain CDA is referred to as “templated CDA”. This specification created a set of artifacts containing modular CDA templates (and associated value sets) for the purpose of the International Patient Summary, and the templates can be reused across any number of CDA document types.

There are different kinds of templates that might be created. Among them, the most common ones are:

  • CDA Document Level Templates constrain fields in the Clinical Document Architecture (CDA) header, and define containment relationships to CDA sections.
    For example, a History-and-Physical document-level template might require that the patient’s name be present, and that the document contain a Physical Exam section.
  • CDA Header Level Templates constrain fields for parts of the CDA header, like the patient (record target), the author, participations or the service event.
  • CDA Section Level Templates constrain fields in the CDA section, and define containment relationships to CDA entries.
    For example, a Physical-exam section-level template might require that the section/code be fixed to a particular LOINC code, and that the section contain a Systolic Blood Pressure observation.
  • CDA Entry Level Templates constrain the CDA clinical statement model in accordance with real world observations and acts.
    For example, a Systolic-blood-pressure entry-level template defines how the CDA Observation class is constrained (how to populate observation/code, how to populate observation/value, etc.) to represent the notion of a systolic blood pressure.

Open and Closed Templates

Open templates permit anything to be done in the underlying standard that is not explicitly prohibited. This allows templates to be built up over time that extend and go beyond the original use cases for which they were originally designed.

Closed templates only permit what has been defined in the template, and do not permit anything beyond that. There are good reasons to use closed templates, sometimes having to do with local policy. For example, in communicating information from a healthcare provider to an insurance company, some information may need to be omitted to ensure patient privacy laws are followed. Most templates developed for CDA are of the open sort.

Template versioning

Template versioning is needed to enable template designs to evolve over time.

Template versioning enables template designers to control and shape the conformance statements that make up a template’s design over time tailoring the design to fit the template’s intended purpose.

Each template version is associated with a particular template. The template – as a whole – has a mandatory globally unique, non-semantic, identifier. The identifier serves as the identifier of the original intent of the template and as the identifier of the set of versions that represent the template over time.

Template versions have a mandatory timestamp (date and optional time), called the “effective date”. The date can be seen as the point in time when the template version “came into being”, i.e. was recognized as existent by the governance group. Use of the template prior to this date would be considered an invalid use of the template.

For further information on Templates, Template Versions and related topics refer to the HL7 Templates Standard[2].

Identifiers for Templates and Value Sets

This specification specifies CDA Entry Level Templates only. They can be re-used in any appropriate context, such as an Entry of a medication section.

Two "root" Entry Templates are provided as entry points for the two described use cases:

  • UV Medication Order (2.16.840.1.113883.10.21.4.1)
  • UV Medication Statement (2.16.840.1.113883.10.21.4.7)

These templates use other Entry Level Templates that are all listed in a subsequent section of this document.

This specification uses the following OIDs for the artefacts that are registered at the HL7 OID registry.

  • The root OID for templates is 2.16.840.1.113883.10.21
    • Entry Level templates are summarized under 2.16.840.1.113883.10.21.4, e.g. 2.16.840.1.113883.10.21.4.5 UV Substitution Permission
    • “other” assistance templates are summarized under 2.16.840.1.113883.10.21.9, e.g. 2.16.840.1.113883.10.22.9.1 UV Use Period
  • The root OID for Value Sets is 2.16.840.1.113883.11

The sub branches for templates follow the recommendations of HL7 International and ISO 13582[3].

How to read this document

All artifacts (templates, value sets etc.) listed with the status Kyellow.png Draft or Korange.png Pending are subject to ballot comments.

Artifacts with other status information, especially Kgreen.png Final or Active are not (directly) part of the ballot and some artifacts actually even come from external sources. Reference artifacts are indicated by the symbol

ref

. These reference artifacts are also not subject to the ballot, as they might be balloted elsewhere already.

The PDF version contains a ruler on the left side of the pages. A ruler has the page number on top of it and allows locating a line at the page by simply specifying the number at the scale tick. This is more precise and allows also commenting on graphics and pictures.

For example if you have a comment on page 29 because of a typo (see figure), you simply specify the error with its location p0029-04.

Of course you can also refer by classical chapter and section numbers. The use of the ruler has the ballot team's preference, though.

IPS ballotruler.jpg

IPS ballotruler.jpg

[Figure 1] To locate a typo on page 29 as a ballot comment, simply specify the location p0029-04.

Reading Publication Artefacts

A reading guide is available that explains the formalisms used to express the publication artefacts, i.e. template meta data and template design. For convenience the guide is included in the appendix.

Functional requirements and high-level use cases

The following use cases are relevant to the pharmacy domain for both community and institutional settings:

  • Prescribing a medication (aka Prescription or Order or Request)
  • Dispensing a medication
  • Recording the administration of a medication
  • Recording the use of a medication (in the past, current or future)

The following definitions are relevant to this Implementation Guide:

  • “Prescribing” is an activity that can be performed by a variety of healthcare professionals and involves a variety of orderable items (see glossary entry). For the purposes of the following Implementation Guide, prescribing is defined as the act of prescribing a medication in either an ambulatory or an institutional setting. This could include initiating a new medication order or making all kinds of modifications to existing orders.
  • “Dispensing” is an activity undertaken to fulfill the logistical requirements of a prescription. It supplies the materials needed to perform the prescribed actions by those who will perform them. Examples of dispensing include eyeglasses, contact lenses and medications. For the purposes of the following ballot material, dispensing is defined as supplying a medication in fulfillment of a prescription or medication order. While dispensing in these circumstances would usually be performed by a pharmacist, other health care providers such as nurses or physicians might also dispense medications.
  • “Administration” is an activity undertaken to give medication to the patient. In the community, this process is usually not recorded, since the majority occurs in the patient's home; only administrations undertaken by a healthcare professional, such as vaccination, tend to be formally documented. Administration of medication in the institutional setting is usually recorded on a dose-by-dose basis, and may be messaged on that basis, or a summary of all the administrations occurring during an inpatient stay may be described.

Templates

Root Entry Level Templates

As mentioned before, this specification defines two "root" Entry Level Templates, one for each of the covered use cases.

UV Medication Order

The following graph gives an overview of the high-level template components of this template, followed by the actual definition.

  1. Entry
     UV Medication Order (2.16.840.1.113883.10.21.4.1)
    1. Entry
       UV Use Period (2.16.840.1.113883.10.21.9.1)
    2. Entry
       CDA Subject (Body) (2.16.840.1.113883.10.12.320)
    3. Entry
       UV Medication Information (simple) (2.16.840.1.113883.10.21.4.10)
      1. *
         CDA Organization (2.16.840.1.113883.10.12.151)
    4. Entry
       UV Medication Information (detail) (2.16.840.1.113883.10.21.4.11)
      1. Entry
         UV Content (2.16.840.1.113883.10.21.4.17)
      2. Entry
         UV Generalized Medicine Class (2.16.840.1.113883.10.21.4.19)
      3. Entry
         UV Content (2.16.840.1.113883.10.21.4.17)
      4. Entry
         UV Generalized Medicine Class (2.16.840.1.113883.10.21.4.19)
      5. Entry
         UV Content (2.16.840.1.113883.10.21.4.17)
      6. Entry
         UV Generalized Medicine Class (2.16.840.1.113883.10.21.4.19)
      7. Entry
         UV Content (2.16.840.1.113883.10.21.4.17)
      8. Entry
         UV Generalized Medicine Class (2.16.840.1.113883.10.21.4.19)
      9. Entry
         UV Ingredient (2.16.840.1.113883.10.21.4.18)
      10. Entry
         UV Ingredient (2.16.840.1.113883.10.21.4.18)
      11. Entry
         UV Ingredient (2.16.840.1.113883.10.21.4.18)
      12. Entry
         UV Ingredient (2.16.840.1.113883.10.21.4.18)
      13. *
         CDA Organization (2.16.840.1.113883.10.12.151)
    5. Entry
       CDA Author (Body) (2.16.840.1.113883.10.12.318)
      1. *
         CDA Person (2.16.840.1.113883.10.12.152)
      2. Entry
         CDA Device (2.16.840.1.113883.10.12.315)
      3. *
         CDA Organization (2.16.840.1.113883.10.12.151)
    6. Entry
       CDA Participant (Body) (2.16.840.1.113883.10.12.321)
      1. Entry
         CDA Device (2.16.840.1.113883.10.12.315)
      2. Entry
         CDA PlayingEntity (2.16.840.1.113883.10.12.313)
    7. Entry
       CDA Participant (Body) (2.16.840.1.113883.10.12.321)
      1. Entry
         CDA Device (2.16.840.1.113883.10.12.315)
      2. Entry
         CDA PlayingEntity (2.16.840.1.113883.10.12.313)
    8. Entry
       UV Subordinate Substance Administration (2.16.840.1.113883.10.21.4.6)
    9. Entry
       UV Dispense Request (2.16.840.1.113883.10.21.4.2)
      1. Entry
         CDA Subject (Body) (2.16.840.1.113883.10.12.320)
      2. Entry
         CDA ManufacturedProduct (2.16.840.1.113883.10.12.312)
        1. Entry
           CDA LabeledDrug (2.16.840.1.113883.10.12.310)
        2. Entry
           CDA Material (2.16.840.1.113883.10.12.311)
        3. *
           CDA Organization (2.16.840.1.113883.10.12.151)
      3. Entry
         CDA Performer (Body) (2.16.840.1.113883.10.12.323)
        1. *
           CDA AssignedEntity (2.16.840.1.113883.10.12.153)
          1. *
             CDA Person (2.16.840.1.113883.10.12.152)
          2. *
             CDA Organization (2.16.840.1.113883.10.12.151)
      4. Entry
         CDA Participant (Body) (2.16.840.1.113883.10.12.321)
        1. Entry
           CDA Device (2.16.840.1.113883.10.12.315)
        2. Entry
           CDA PlayingEntity (2.16.840.1.113883.10.12.313)
      5. Entry
         CDA Participant (Body) (2.16.840.1.113883.10.12.321)
        1. Entry
           CDA Device (2.16.840.1.113883.10.12.315)
        2. Entry
           CDA PlayingEntity (2.16.840.1.113883.10.12.313)
      6. Entry
         CDA Participant (Body) (2.16.840.1.113883.10.12.321)
        1. Entry
           CDA Device (2.16.840.1.113883.10.12.315)
        2. Entry
           CDA PlayingEntity (2.16.840.1.113883.10.12.313)
      7. Entry
         CDA Participant (Body) (2.16.840.1.113883.10.12.321)
        1. Entry
           CDA Device (2.16.840.1.113883.10.12.315)
        2. Entry
           CDA PlayingEntity (2.16.840.1.113883.10.12.313)
    10. Entry
       UV ClinicalStatement Observation (2.16.840.1.113883.10.21.4.3)
      1. Entry
         CDA Subject (Body) (2.16.840.1.113883.10.12.320)
      2. Entry
         CDA Specimen (2.16.840.1.113883.10.12.322)
      3. Entry
         CDA Performer (Body) (2.16.840.1.113883.10.12.323)
        1. *
           CDA AssignedEntity (2.16.840.1.113883.10.12.153)
          1. *
             CDA Person (2.16.840.1.113883.10.12.152)
          2. *
             CDA Organization (2.16.840.1.113883.10.12.151)
      4. Entry
         CDA Author (Body) (2.16.840.1.113883.10.12.318)
        1. *
           CDA Person (2.16.840.1.113883.10.12.152)
        2. Entry
           CDA Device (2.16.840.1.113883.10.12.315)
        3. *
           CDA Organization (2.16.840.1.113883.10.12.151)
      5. Entry
         CDA Informant (Body) (2.16.840.1.113883.10.12.319)
        1. *
           CDA AssignedEntity (2.16.840.1.113883.10.12.153)
          1. *
             CDA Person (2.16.840.1.113883.10.12.152)
          2. *
             CDA Organization (2.16.840.1.113883.10.12.151)
        2. Entry
           CDA RelatedEntity (2.16.840.1.113883.10.12.316)
          1. *
             CDA Person (2.16.840.1.113883.10.12.152)
      6. Entry
         CDA Participant (Body) (2.16.840.1.113883.10.12.321)
        1. Entry
           CDA Device (2.16.840.1.113883.10.12.315)
        2. Entry
           CDA PlayingEntity (2.16.840.1.113883.10.12.313)
      7. Entry
         CDA Reference (2.16.840.1.113883.10.12.324)
        1. Entry
           CDA ExternalAct (2.16.840.1.113883.10.12.325)
        2. Entry
           CDA ExternalObservation (2.16.840.1.113883.10.12.326)
        3. Entry
           CDA ExternalProcedure (2.16.840.1.113883.10.12.327)
        4. Entry
           CDA ExternalDocument (2.16.840.1.113883.10.12.328)
      8. Entry
         CDA Precondition (2.16.840.1.113883.10.12.329)
    11. Entry
       IPS Internal Reference (2.16.840.1.113883.10.22.4.31)
    12. Entry
       UV ClinicalStatement Observation (2.16.840.1.113883.10.21.4.3)
      1. Entry
         CDA Subject (Body) (2.16.840.1.113883.10.12.320)
      2. Entry
         CDA Specimen (2.16.840.1.113883.10.12.322)
      3. Entry
         CDA Performer (Body) (2.16.840.1.113883.10.12.323)
        1. *
           CDA AssignedEntity (2.16.840.1.113883.10.12.153)
          1. *
             CDA Person (2.16.840.1.113883.10.12.152)
          2. *
             CDA Organization (2.16.840.1.113883.10.12.151)
      4. Entry
         CDA Author (Body) (2.16.840.1.113883.10.12.318)
        1. *
           CDA Person (2.16.840.1.113883.10.12.152)
        2. Entry
           CDA Device (2.16.840.1.113883.10.12.315)
        3. *
           CDA Organization (2.16.840.1.113883.10.12.151)
      5. Entry
         CDA Informant (Body) (2.16.840.1.113883.10.12.319)
        1. *
           CDA AssignedEntity (2.16.840.1.113883.10.12.153)
          1. *
             CDA Person (2.16.840.1.113883.10.12.152)
          2. *
             CDA Organization (2.16.840.1.113883.10.12.151)
        2. Entry
           CDA RelatedEntity (2.16.840.1.113883.10.12.316)
          1. *
             CDA Person (2.16.840.1.113883.10.12.152)
      6. Entry
         CDA Participant (Body) (2.16.840.1.113883.10.12.321)
        1. Entry
           CDA Device (2.16.840.1.113883.10.12.315)
        2. Entry
           CDA PlayingEntity (2.16.840.1.113883.10.12.313)
      7. Entry
         CDA Reference (2.16.840.1.113883.10.12.324)
        1. Entry
           CDA ExternalAct (2.16.840.1.113883.10.12.325)
        2. Entry
           CDA ExternalObservation (2.16.840.1.113883.10.12.326)
        3. Entry
           CDA ExternalProcedure (2.16.840.1.113883.10.12.327)
        4. Entry
           CDA ExternalDocument (2.16.840.1.113883.10.12.328)
      8. Entry
         CDA Precondition (2.16.840.1.113883.10.12.329)
    13. Entry
       UV Substitution Permission (2.16.840.1.113883.10.21.4.5)
    14. Entry
       UV ClinicalStatement Encounter (2.16.840.1.113883.10.21.4.4)
    15. Entry
       UV Comment Activity (2.16.840.1.113883.10.21.4.12)
      1. Entry
         CDA Author (Body) (2.16.840.1.113883.10.12.318)
        1. *
           CDA Person (2.16.840.1.113883.10.12.152)
        2. Entry
           CDA Device (2.16.840.1.113883.10.12.315)
        3. *
           CDA Organization (2.16.840.1.113883.10.12.151)
    16. Entry
       CDA Precondition (2.16.840.1.113883.10.12.329)


Symbols: * denotes templates with more than one classification, @ indicates a recursion in the definition

Id2.16.840.1.113883.10.21.4.1Effective Date2023‑01‑31 11:29:28
Other versions this id:
  • Kblank.png UVSubstanceadministrationrequest as of 2023‑01‑31 10:52:39
  • Kblank.png UVSubstanceadministrationrequest as of 2023‑01‑30 08:30:30
  • Kblank.png UVSubstanceadministrationrequest as of 2021‑08‑04 17:03:38
  • Kblank.png UVSubstanceadministrationrequest as of 2015‑10‑07
StatusKyellow.png DraftVersion Label2023
NameUVSubstanceadministrationrequestDisplay NameUV Medication Order
DescriptionUniversal Medication Order (Substance Administration Request)
ContextParent nodes of template element with id 2.16.840.1.113883.10.21.4.1
LabelMedicationOrder
ClassificationCDA Entry Level Template
Open/ClosedOpen (other than defined elements are allowed)
Uses
Uses 14 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.12.320ContainmentKgreen.png CDA Subject (Body)DYNAMIC
2.16.840.1.113883.10.21.4.10ContainmentKorange.png UV Medication Information (simple) (R1-STU2-ballot)DYNAMIC
2.16.840.1.113883.10.21.4.11ContainmentKyellow.png UV Medication Information (detail) (2023)DYNAMIC
2.16.840.1.113883.10.12.318ContainmentKgreen.png CDA Author (Body)DYNAMIC
2.16.840.1.113883.10.12.321ContainmentKgreen.png CDA Participant (Body)DYNAMIC
2.16.840.1.113883.10.21.4.6ContainmentKyellow.png UV Subordinate Substance Administration (2023)DYNAMIC
2.16.840.1.113883.10.21.4.2ContainmentKorange.png UV Dispense Request (R1-STU2-ballot)DYNAMIC
2.16.840.1.113883.10.21.4.3ContainmentKorange.png UV ClinicalStatement Observation (R1-STU2-ballot)DYNAMIC
2.16.840.1.113883.10.22.4.31ContainmentKorange.png IPS Internal Reference (STU1)DYNAMIC
2.16.840.1.113883.10.21.4.5ContainmentKorange.png UV Substitution Permission (R1-STU2-ballot)DYNAMIC
2.16.840.1.113883.10.21.4.4ContainmentKorange.png UV ClinicalStatement Encounter (R1-STU2-ballot)DYNAMIC
2.16.840.1.113883.10.21.4.12ContainmentKorange.png UV Comment Activity (R1-STU2-ballot)DYNAMIC
2.16.840.1.113883.10.12.329ContainmentKgreen.png CDA PreconditionDYNAMIC
RelationshipVersion: template 2.16.840.1.113883.10.21.4.1 UV Medication Order (2015‑10‑07)
Specialization: template 2.16.840.1.113883.10.12.308 CDA SubstanceAdministration (2005‑09‑07)
ref
ad1bbr-
Example
Example
<substanceAdministration classCode="SBADM" moodCode="RQO">
  <templateId root="2.16.840.1.113883.10.21.4.1"/>  <id root="1.2.3.99.99.99" extension="58768437489739"/>  <code code="..." codeSystem="..."/>  <text>...</text>  <statusCode code="active"/>  <effectiveTime value="..."/>  <repeatNumber value="..."/>  <routeCode code="IPINHL" codeSystem="2.16.840.1.113883.5.112" displayName="Inhalation, respiratory Inhalation, intrapulmonary Inhalation, oral"/>  <approachSiteCode code="..." codeSystem="2.16.840.1.113883.5.1052"/>  <administrationUnitCode code="PUFF" codeSystem="2.16.840.1.113883.5.85" displayName="Puff"/>  <consumable typeCode="CSM">
    <!-- Consumable -->
  </consumable>
  <participant typeCode="DEV">
    <!-- Device -->
  </participant>
  <participant typeCode="LOC">
    <!-- Location -->
  </participant>
  <entryRelationship typeCode="COMP">
    <!-- Subordinate Substance Administrations -->
  </entryRelationship>
  <entryRelationship typeCode="COMP">
    <!-- Annotations -->
  </entryRelationship>
  <precondition>
    <!-- Precondition -->
  </precondition>
</substanceAdministration>
ItemDTCardConfDescriptionLabel
hl7:substanceAdministration
Medi...rder
Treetree.png@classCode
cs1 … 1FSBADM
Treetree.png@moodCode
cs1 … 1FRQO
Treetree.pnghl7:templateId
II1 … 1MMedi...rder
Treeblank.pngTreetree.png@root
uid1 … 1F2.16.840.1.113883.10.21.4.1
Treetree.pnghl7:id
II1 … *RMedi...rder
Treetree.pnghl7:code
CD (extensible)0 … 1RMedi...rder
 CONF
The value of @code should be drawn from value set 2.16.840.1.113883.1.11.19708 ActSubstanceAdministrationCode (DYNAMIC)
Treetree.pnghl7:text
ED0 … 1Medi...rder
Treetree.pnghl7:statusCode
CS (required)1 … 1MMedi...rder
 CONF
The value of @code shall be drawn from value set 2.16.840.1.113883.11.21.2 ActStatusActiveCompletedAbortedSuspended (DYNAMIC)
Included 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.
Medi...rder
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 … 1RMedi...rder
Treeblank.pngTreeblank.pngTreetree.pnghl7:high
IVXB_TS0 … 1RMedi...rder
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)
Medi...rder
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
NPMedi...rder
Treeblank.pngTreeblank.pngTreetree.pnghl7:high
NPMedi...rder
Treeblank.pngTreeblank.pngTreetree.pnghl7:center
NPMedi...rder
Treeblank.pngTreeblank.pngTreetree.pnghl7:width
PQ1 … 1RMedi...rder
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)
Medi...rder
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 … 1CMedi...rder
Treeblank.pngTreeblank.pngTreetree.pnghl7:width
PQ1 … 1RMedi...rder
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:repeatNumber
IVL_INT0 … 1Medi...rder
Treetree.pnghl7:routeCode
CE (example)0 … 1Medi...rder
 CONF
Examples of the value of @code are in the value set 2.16.840.1.113883.1.11.14581 RouteOfAdministration (DYNAMIC)
Treetree.pnghl7:approachSiteCode
CD (example)0 … *Medi...rder
 CONF
Examples of the value of @code are in the value set 2.16.840.1.113883.1.11.19724 HumanSubstanceAdministrationSite (DYNAMIC)
Treetree.pnghl7:doseQuantity
IVL_PQNPMedi...rder
Treetree.pnghl7:rateQuantity
IVL_PQNPMedi...rder
Treetree.pnghl7:maxDoseQuantity
RTO_PQ_PQ0 … 1Medi...rder
Treetree.pnghl7:administrationUnitCode
CENPMedi...rder
Treetree.pnghl7:subject
0 … 1CThe patient, subject to requested dispenses or subject to substances being administered to.
Contains 2.16.840.1.113883.10.12.320 CDA Subject (Body) (DYNAMIC)
Medi...rder
 ConstraintCondition: This can be omitted if the patient context that is provided in the CDA header is identical to the subject
Choice1 … 1Elements to choose from:
  • hl7:consumable containing template 2.16.840.1.113883.10.21.4.10 UV Medication Information (simple) (DYNAMIC)
  • hl7:consumable containing template 2.16.840.1.113883.10.21.4.11 UV Medication Information (detail) (DYNAMIC)
Treeblank.pngTreetree.pnghl7:consumable
0 … 1RConsumable: The medication that is administered (simple)
Contains 2.16.840.1.113883.10.21.4.10 UV Medication Information (simple) (DYNAMIC)
Medi...rder
Treeblank.pngTreeblank.pngTreetree.png@typeCode
cs1 … 1FCSM
Treeblank.pngTreetree.pnghl7:consumable
0 … 1RConsumable: The medication that is administered (detail)
Contains 2.16.840.1.113883.10.21.4.11 UV Medication Information (detail) (DYNAMIC)
Medi...rder
Treeblank.pngTreeblank.pngTreetree.png@typeCode
cs1 … 1FCSM
Treetree.pnghl7:author
0 … *Prescriber: A party that originates the order and therefore has responsibility for the information given in the order.
Contains 2.16.840.1.113883.10.12.318 CDA Author (Body) (DYNAMIC)
Medi...rder
Treetree.pnghl7:participant
0 … 1Record Target: indicates the person who's medical record holds the documentation of this medication statement. This element is only populated when the document is placed in a medical record of someone other than the patient (subject).
Contains 2.16.840.1.113883.10.12.321 CDA Participant (Body) (DYNAMIC)
Medi...rder
where [@typeCode='RCT']
Treeblank.pngTreetree.png@typeCode
cs1 … 1FRCT
Treetree.pnghl7:participant
0 … 1Verifier: The person or organization that has primary responsibility for the order. The responsible party is not necessarily present in an action, but is accountable for the action through the power to delegate.
Contains 2.16.840.1.113883.10.12.321 CDA Participant (Body) (DYNAMIC)
Medi...rder
where [@typeCode='VRF']
Treeblank.pngTreetree.png@typeCode
cs1 … 1FVRF
Treetree.pnghl7:entryRelationship
0 … *CSubordinate Substance Administration Request as a component of the overall order.
At least one subordinated Substance Administration should be present to convey information about dosages (dose, frequency of intakes,..) unless dosage is unknown.
Subordinated Substance Administration 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)
Medi...rder
where [hl7:substanceAdministration]
Treeblank.pngTreetree.png@typeCode
cs1 … 1FCOMP
 ConstraintAt least one subordinate element SHALL be present.
 Example<entryRelationship typeCode="COMP">
  <!-- component: Subordinate Substance Administration Request. -->
  <substanceAdministration classCode="SBADM" moodCode="RQO">
    <templateId root="2.16.840.1.113883.10.21.4.6"/>    <!-- .. -->
  </substanceAdministration>
</entryRelationship>
Treeblank.pngTreetree.pnghl7:sequenceNumber
INT0 … 1Sequence number of the Subordinate Substance Administration.Medi...rder
Treetree.pnghl7:entryRelationship
0 … 1RDispense Request as a component of the overall order. This element is used in the medication order when the dispense request information contains additional information to support a fully specified medication prescription. For example, to include the validity period of the dispense or the organization to dispense the medication.
Contains 2.16.840.1.113883.10.21.4.2 UV Dispense Request (DYNAMIC)
Medi...rder
where [hl7:supply]
Treeblank.pngTreetree.png@typeCode
cs1 … 1FCOMP
 Example<entryRelationship typeCode="COMP">
  <!-- component: The Dispense Request is a component of the overall order. -->
  <supply classCode="SPLY" moodCode="RQO">
    <templateId root="2.16.840.1.113883.10.21.4.2"/>    <!-- .. -->
  </supply>
</entryRelationship>
Choice0 … *Elements to choose from:
  • hl7:entryRelationship containing template 2.16.840.1.113883.10.21.4.3 UV ClinicalStatement Observation (DYNAMIC)
  • hl7:entryRelationship containing template 2.16.840.1.113883.10.22.4.31 IPS Internal Reference (DYNAMIC)
Treeblank.pngTreetree.pnghl7:entryRelationship
0 … *RReason: Specifies the reason (indication) for authoring the order.
Contains 2.16.840.1.113883.10.21.4.3 UV ClinicalStatement Observation (DYNAMIC)
Medi...rder
Treeblank.pngTreeblank.pngTreetree.png@typeCode
cs1 … 1FRSON
 Example<hl7:entryRelationship typeCode="RSON">
  <priorityNumber value="1"/>  <!-- template 2.16.840.1.113883.10.21.4.3 'UV ClinicalStatement Observation' (2016-05-01T00:00:00) -->
</hl7:entryRelationship>
Treeblank.pngTreeblank.pngTreetree.pngpharm:priorityNumber
INT.​NONNEG0 … 1RIndicates the priority of this reason for the order in relation to its sibling reasons.Medi...rder
Treeblank.pngTreetree.pnghl7:entryRelationship
0 … *RReason: Specifies the reason (indication) for authoring the order.
Contains 2.16.840.1.113883.10.22.4.31 IPS Internal Reference (DYNAMIC)
Medi...rder
Treeblank.pngTreeblank.pngTreetree.png@typeCode
cs1 … 1FRSON
 Example<entryRelationship typeCode="RSON">
  <priorityNumber value="1"/>  <act>
    <!-- Clinical Statement Minimal -->
  </act>
</entryRelationship>
Treeblank.pngTreeblank.pngTreetree.pngpharm:priorityNumber
INT.​NONNEG0 … 1RIndicates the priority of this reason for the order in relation to its sibling reasons.Medi...rder
Treetree.pnghl7:entryRelationship
0 … *RPertinent Information: Specifies any pertinent information (observation) relevant to the order.
Contains 2.16.840.1.113883.10.21.4.3 UV ClinicalStatement Observation (DYNAMIC)
Medi...rder
Treeblank.pngTreetree.png@typeCode
cs1 … 1FPERT
 Example<entryRelationship typeCode="PERT">
  <observation>
    <!-- Clinical Statement Observation -->
  </observation>
</entryRelationship>
Treetree.pnghl7:entryRelationship
0 … 1RPermission: The order can be the subject of the permissions related to substitution.
Contains 2.16.840.1.113883.10.21.4.5 UV Substitution Permission (DYNAMIC)
Medi...rder
where [hl7:act]
Treeblank.pngTreetree.png@typeCode
cs1 … 1FCOMP
Treetree.pnghl7:entryRelationship
0 … 1REncounter: Used to link an order to a specific encounter.
Contains 2.16.840.1.113883.10.21.4.4 UV ClinicalStatement Encounter (DYNAMIC)
Medi...rder
where [hl7:encounter]
Treeblank.pngTreetree.png@typeCode
cs1 … 1FCOMP
 Example<encounter classCode="ENC" moodCode="EVN">
  <id/>  <code code="..."/></encounter>
Treetree.pnghl7:entryRelationship
0 … *Annotations: The Medication Order can be the subject of annotations.
Contains 2.16.840.1.113883.10.21.4.12 UV Comment Activity (DYNAMIC)
Medi...rder
Treeblank.pngTreetree.png@typeCode
cs1 … 1FCOMP
Treetree.pnghl7:precondition
0 … *Precondition: A requirement to be true before the SubstanceAdministration is performed.
Contains 2.16.840.1.113883.10.12.329 CDA Precondition (DYNAMIC)
Medi...rder


UV Medication Statement

The following graph gives an overview of the high-level template components of this template, followed by the actual definition.

  1. Entry
     UV Medication Statement (2.16.840.1.113883.10.21.4.7)
    1. Entry
       UV Use Period (2.16.840.1.113883.10.21.9.1)
    2. Entry
       CDA Subject (Body) (2.16.840.1.113883.10.12.320)
    3. Entry
       UV Medication Information (simple) (2.16.840.1.113883.10.21.4.10)
      1. *
         CDA Organization (2.16.840.1.113883.10.12.151)
    4. Entry
       UV Medication Information (detail) (2.16.840.1.113883.10.21.4.11)
      1. Entry
         UV Content (2.16.840.1.113883.10.21.4.17)
      2. Entry
         UV Generalized Medicine Class (2.16.840.1.113883.10.21.4.19)
      3. Entry
         UV Content (2.16.840.1.113883.10.21.4.17)
      4. Entry
         UV Generalized Medicine Class (2.16.840.1.113883.10.21.4.19)
      5. Entry
         UV Content (2.16.840.1.113883.10.21.4.17)
      6. Entry
         UV Generalized Medicine Class (2.16.840.1.113883.10.21.4.19)
      7. Entry
         UV Content (2.16.840.1.113883.10.21.4.17)
      8. Entry
         UV Generalized Medicine Class (2.16.840.1.113883.10.21.4.19)
      9. Entry
         UV Ingredient (2.16.840.1.113883.10.21.4.18)
      10. Entry
         UV Ingredient (2.16.840.1.113883.10.21.4.18)
      11. Entry
         UV Ingredient (2.16.840.1.113883.10.21.4.18)
      12. Entry
         UV Ingredient (2.16.840.1.113883.10.21.4.18)
      13. *
         CDA Organization (2.16.840.1.113883.10.12.151)
    5. Entry
       CDA Author (Body) (2.16.840.1.113883.10.12.318)
      1. *
         CDA Person (2.16.840.1.113883.10.12.152)
      2. Entry
         CDA Device (2.16.840.1.113883.10.12.315)
      3. *
         CDA Organization (2.16.840.1.113883.10.12.151)
    6. *
       CDA AssignedEntity (2.16.840.1.113883.10.12.153)
      1. *
         CDA Person (2.16.840.1.113883.10.12.152)
      2. *
         CDA Organization (2.16.840.1.113883.10.12.151)
    7. Entry
       CDA RelatedEntity (2.16.840.1.113883.10.12.316)
      1. *
         CDA Person (2.16.840.1.113883.10.12.152)
    8. Entry
       CDA Participant (Body) (2.16.840.1.113883.10.12.321)
      1. Entry
         CDA Device (2.16.840.1.113883.10.12.315)
      2. Entry
         CDA PlayingEntity (2.16.840.1.113883.10.12.313)
    9. Entry
       CDA Participant (Body) (2.16.840.1.113883.10.12.321)
      1. Entry
         CDA Device (2.16.840.1.113883.10.12.315)
      2. Entry
         CDA PlayingEntity (2.16.840.1.113883.10.12.313)
    10. Entry
       UV Subordinate Substance Administration (2.16.840.1.113883.10.21.4.6)
    11. Entry
       UV Medication Order Reference (2.16.840.1.113883.10.21.4.8)
      1. Entry
         CDA Author (Body) (2.16.840.1.113883.10.12.318)
        1. *
           CDA Person (2.16.840.1.113883.10.12.152)
        2. Entry
           CDA Device (2.16.840.1.113883.10.12.315)
        3. *
           CDA Organization (2.16.840.1.113883.10.12.151)
    12. Entry
       UV Dispense Event Reference (2.16.840.1.113883.10.21.4.9)
    13. Entry
       UV ClinicalStatement Observation (2.16.840.1.113883.10.21.4.3)
      1. Entry
         CDA Subject (Body) (2.16.840.1.113883.10.12.320)
      2. Entry
         CDA Specimen (2.16.840.1.113883.10.12.322)
      3. Entry
         CDA Performer (Body) (2.16.840.1.113883.10.12.323)
        1. *
           CDA AssignedEntity (2.16.840.1.113883.10.12.153)
          1. *
             CDA Person (2.16.840.1.113883.10.12.152)
          2. *
             CDA Organization (2.16.840.1.113883.10.12.151)
      4. Entry
         CDA Author (Body) (2.16.840.1.113883.10.12.318)
        1. *
           CDA Person (2.16.840.1.113883.10.12.152)
        2. Entry
           CDA Device (2.16.840.1.113883.10.12.315)
        3. *
           CDA Organization (2.16.840.1.113883.10.12.151)
      5. Entry
         CDA Informant (Body) (2.16.840.1.113883.10.12.319)
        1. *
           CDA AssignedEntity (2.16.840.1.113883.10.12.153)
          1. *
             CDA Person (2.16.840.1.113883.10.12.152)
          2. *
             CDA Organization (2.16.840.1.113883.10.12.151)
        2. Entry
           CDA RelatedEntity (2.16.840.1.113883.10.12.316)
          1. *
             CDA Person (2.16.840.1.113883.10.12.152)
      6. Entry
         CDA Participant (Body) (2.16.840.1.113883.10.12.321)
        1. Entry
           CDA Device (2.16.840.1.113883.10.12.315)
        2. Entry
           CDA PlayingEntity (2.16.840.1.113883.10.12.313)
      7. Entry
         CDA Reference (2.16.840.1.113883.10.12.324)
        1. Entry
           CDA ExternalAct (2.16.840.1.113883.10.12.325)
        2. Entry
           CDA ExternalObservation (2.16.840.1.113883.10.12.326)
        3. Entry
           CDA ExternalProcedure (2.16.840.1.113883.10.12.327)
        4. Entry
           CDA ExternalDocument (2.16.840.1.113883.10.12.328)
      8. Entry
         CDA Precondition (2.16.840.1.113883.10.12.329)
    14. Entry
       IPS Internal Reference (2.16.840.1.113883.10.22.4.31)


Id2.16.840.1.113883.10.21.4.7Effective Date2023‑01‑30 08:32:34
Other versions this id:
  • Kblank.png UVMedicationstatement as of 2021‑08‑04 14:09:15
  • Kblank.png UVMedicationstatement as of 2017‑05‑01
StatusKyellow.png DraftVersion Label2023
NameUVMedicationstatementDisplay NameUV Medication Statement
Description
Universal Medication Statement: Recording a "medication statement" is an activity that can be performed by a variety of healthcare professionals, or the patient, or non-healthcare professionals. Examples of recording medication statements include taking a patient's medication history, recording reported use of medications where the source of the patient information is from a third party and not the patient e.g. a family member when the patient is unable to communicate their medication history.
ContextParent nodes of template element with id 2.16.840.1.113883.10.21.4.7
LabelMedicationStatement
ClassificationCDA Entry Level Template
Open/ClosedOpen (other than defined elements are allowed)
Uses
Uses 13 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.12.320ContainmentKgreen.png CDA Subject (Body)DYNAMIC
2.16.840.1.113883.10.21.4.10ContainmentKorange.png UV Medication Information (simple) (R1-STU2-ballot)DYNAMIC
2.16.840.1.113883.10.21.4.11ContainmentKyellow.png UV Medication Information (detail) (2023)DYNAMIC
2.16.840.1.113883.10.12.318ContainmentKgreen.png CDA Author (Body)DYNAMIC
2.16.840.1.113883.10.12.153ContainmentKgreen.png CDA AssignedEntityDYNAMIC
2.16.840.1.113883.10.12.316ContainmentKgreen.png CDA RelatedEntityDYNAMIC
2.16.840.1.113883.10.12.321ContainmentKgreen.png CDA Participant (Body)DYNAMIC
2.16.840.1.113883.10.21.4.6ContainmentKyellow.png UV Subordinate Substance Administration (2023)DYNAMIC
2.16.840.1.113883.10.21.4.8ContainmentKorange.png UV Medication Order Reference (R1-STU2-ballot)DYNAMIC
2.16.840.1.113883.10.21.4.9ContainmentKorange.png UV Dispense Event Reference (R1-STU2-ballot)DYNAMIC
2.16.840.1.113883.10.21.4.3ContainmentKorange.png UV ClinicalStatement Observation (R1-STU2-ballot)DYNAMIC
2.16.840.1.113883.10.22.4.31ContainmentKorange.png IPS Internal Reference (STU1)DYNAMIC
RelationshipVersion: template 2.16.840.1.113883.10.21.4.7 UV Medication Statement (2021‑08‑04 14:09:15)
Version: template 2.16.840.1.113883.10.21.4.7 UV Medication Statement (2017‑05‑01)
Specialization: template 2.16.840.1.113883.10.12.308 CDA SubstanceAdministration (2005‑09‑07)
ref
ad1bbr-
Example
Example
<substanceAdministration classCode="SBADM" moodCode="EVN">
  <templateId root="2.16.840.1.113883.10.21.4.7"/>  <id root="1.2.3.99.99.99" extension="988437489739"/>  <code code="..." codeSystem="..."/>  <text>...</text>  <statusCode code="active"/>  <effectiveTime value="..."/>  <repeatNumber value="..."/>  <routeCode code="SOAK" codeSystem="2.16.840.1.113883.5.112" displayName="Immersion (soak)"/>  <approachSiteCode code="..." codeSystem="2.16.840.1.113883.5.1052"/>  <administrationUnitCode code="PUFF" displayName="Puff" codeSystem="2.16.840.1.113883.5.85"/>  <consumable typeCode="CSM">
    <!-- Consumable -->
  </consumable>
  <participant typeCode="DEV">
    <!-- Device -->
  </participant>
  <participant typeCode="LOC">
    <!-- Location -->
  </participant>
  <entryRelationship typeCode="COMP">
    <!-- Subordinate Substance Administrations -->
  </entryRelationship>
  <entryRelationship typeCode="COMP">
    <!-- Annotations -->
  </entryRelationship>
  <precondition>
    <!-- Precondition -->
  </precondition>
</substanceAdministration>
Example
Example
<substanceAdministration classCode="SBADM" moodCode="EVN">
  <templateId root="2.16.840.1.113883.10.21.4.7"/>  <id root="1.2.3.999" extension="--example only--"/>  <code code="DRUG" displayName="Drug therapy" codeSystem="2.16.840.1.113883.5.4"/>  <text/>  <statusCode code="active"/>  <!-- include template 'UV Use Period' (dynamic) .. O -->
  <repeatNumber/>  <routeCode code="SOAK" displayName="Immersion (soak)" codeSystem="2.16.840.1.113883.5.112"/>  <approachSiteCode code="--code--" codeSystem="2.16.840.1.113883.5.1052"/>  <administrationUnitCode code="APPFUL" displayName="Applicatorful" codeSystem="2.16.840.1.113883.5.85"/>  <subject>
    <!-- template 'CDA Subject (Body)' (dynamic) -->
  </subject>
  <consumable typeCode="CSM">
    <!-- template 2.16.840.1.113883.10.12.312 'CDA ManufacturedProduct' (dynamic) -->
  </consumable>
  <!-- choice: 1..1
element hl7:author
element hl7:participant[@typeCode='AUT']
-->
  <!-- choice: 0..1
element hl7:informant[exists(hl7:assignedEntity)]
element hl7:participant[@typeCode='INF']
element hl7:informant[exists(hl7:relatedEntity)]
-->
  <participant typeCode="RCT">
    <!-- template 2.16.840.1.113883.10.12.321 'CDA Participant (Body)' (dynamic) -->
  </participant>
  <participant typeCode="VRF">
    <!-- template 2.16.840.1.113883.10.12.321 'CDA Participant (Body)' (dynamic) -->
  </participant>
  <entryRelationship typeCode="COMP">
    <sequenceNumber value="1"/>    <!-- template 2.16.840.1.113883.10.21.4.6 'Subordinate Substance Administration' (dynamic) -->
  </entryRelationship>
  <entryRelationship typeCode="REFR">
    <!-- template 2.16.840.1.113883.10.21.4.8 'UV Medication Order Reference' (dynamic) -->
  </entryRelationship>
  <entryRelationship typeCode="REFR">
    <!-- template 2.16.840.1.113883.10.21.4.9 'UV Dispense Event Reference' (dynamic) -->
  </entryRelationship>
</substanceAdministration>
Example
Example
<substanceAdministration classCode="SBADM" moodCode="EVN">
  <templateId root="2.16.840.1.113883.10.21.4.7"/>  <id root="1.2.3.99.99.99" extension="988437489739"/>  <code code="..." codeSystem="..."/>  <text>...</text>  <statusCode code="active"/>  <effectiveTime value="..."/>  <repeatNumber value="..."/>  <routeCode code="SOAK" codeSystem="2.16.840.1.113883.5.112" displayName="Immersion (soak)"/>  <approachSiteCode code="..." codeSystem="2.16.840.1.113883.5.1052"/>  <administrationUnitCode code="PUFF" displayName="Puff" codeSystem="2.16.840.1.113883.5.85"/>  <consumable typeCode="CSM">
    <!-- Consumable -->
  </consumable>
  <participant typeCode="DEV">
    <!-- Device -->
  </participant>
  <participant typeCode="LOC">
    <!-- Location -->
  </participant>
  <entryRelationship typeCode="COMP">
    <!-- Subordinate Substance Administrations -->
  </entryRelationship>
  <entryRelationship typeCode="COMP">
    <!-- Annotations -->
  </entryRelationship>
  <precondition>
    <!-- Precondition -->
  </precondition>
</substanceAdministration>
ItemDTCardConfDescriptionLabel
hl7:substanceAdministration
Medi...ment
Treetree.png@classCode
cs1 … 1FSBADM
Treetree.png@moodCode
cs1 … 1REVN will be used to record a medication statement where the patient is currently taking or has taken the medication in the past.
INT will be used to record a medication statement where the patient plans to take the medication or be administered the medication in the future.
 CONF
@moodCode shall be "EVN"
or
@moodCode shall be "INT"
Treetree.pnghl7:templateId
II1 … 1MMedi...ment
Treeblank.pngTreetree.png@root
uid1 … 1F2.16.840.1.113883.10.21.4.7
Treetree.pnghl7:id
II0 … *RMedi...ment
Treetree.pnghl7:code
CD (preferred)0 … 1RThe code element is valorized with the ACT code DRUG; FD or IMMUNIZ unless it is used for asserting the known absence of medication treatments or no information about them.Medi...ment
 CONF
The value of @code comes preferably from value set 2.16.840.1.113883.1.11.19708 ActSubstanceAdministrationCode (DYNAMIC)
or
The value of @code comes preferably from value set 2.16.840.1.113883.11.21.5 Unknown or absent medication (DYNAMIC)
Treetree.pnghl7:text
ED0 … 1Medi...ment
Treetree.pnghl7:statusCode
CS (required)1 … 1MMedi...ment
 CONF
The value of @code shall be drawn from value set 2.16.840.1.113883.1.11.15933 ActStatus (DYNAMIC)
Included 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.
Medi...ment
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 … 1RMedi...ment
Treeblank.pngTreeblank.pngTreetree.pnghl7:high
IVXB_TS0 … 1RMedi...ment
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)
Medi...ment
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
NPMedi...ment
Treeblank.pngTreeblank.pngTreetree.pnghl7:high
NPMedi...ment
Treeblank.pngTreeblank.pngTreetree.pnghl7:center
NPMedi...ment
Treeblank.pngTreeblank.pngTreetree.pnghl7:width
PQ1 … 1RMedi...ment
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)
Medi...ment
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 … 1CMedi...ment
Treeblank.pngTreeblank.pngTreetree.pnghl7:width
PQ1 … 1RMedi...ment
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:repeatNumber
IVL_INT0 … 1Medi...ment
Treetree.pnghl7:routeCode
CE (example)0 … 1Medi...ment
 CONF
Examples of the value of @code are in the value set 2.16.840.1.113883.1.11.14581 RouteOfAdministration (DYNAMIC)
Treetree.pnghl7:approachSiteCode
CD (example)0 … *Medi...ment
 CONF
Examples of the value of @code are in the value set 2.16.840.1.113883.1.11.19724 HumanSubstanceAdministrationSite (DYNAMIC)
Treetree.pnghl7:doseQuantity
IVL_PQNPMedi...ment
Treetree.pnghl7:rateQuantity
IVL_PQNPMedi...ment
Treetree.pnghl7:maxDoseQuantity
RTO_PQ_PQ0 … 1Medi...ment
Treetree.pnghl7:administrationUnitCode
CENPMedi...ment
Treetree.pnghl7:subject
0 … 1CPatient: The patient that takes the medicine.
Contains 2.16.840.1.113883.10.12.320 CDA Subject (Body) (DYNAMIC)
Medi...ment
 ConstraintCondition: This can be omitted if the patient context that is provided in the CDA header is identical to the subject
ChoiceElements to choose from:
  • hl7:consumable containing template 2.16.840.1.113883.10.21.4.10 UV Medication Information (simple) (DYNAMIC)
  • hl7:consumable containing template 2.16.840.1.113883.10.21.4.11 UV Medication Information (detail) (DYNAMIC)
Treeblank.pngTreetree.pnghl7:consumable
0 … 1RConsumable: The medication that is administered (simple)
Contains 2.16.840.1.113883.10.21.4.10 UV Medication Information (simple) (DYNAMIC)
Medi...ment
Treeblank.pngTreeblank.pngTreetree.png@typeCode
cs1 … 1FCSM
Treeblank.pngTreetree.pnghl7:consumable
0 … 1RConsumable: The medication that is administered (detail)
Contains 2.16.840.1.113883.10.21.4.11 UV Medication Information (detail) (DYNAMIC)
Medi...ment
Treeblank.pngTreeblank.pngTreetree.png@typeCode
cs1 … 1FCSM
Choice
Required author of the medication statement: healthcare professional or patient
Elements to choose from:
  • hl7:author containing template 2.16.840.1.113883.10.12.318 CDA Author (Body) (DYNAMIC)
  • hl7:participant[@typeCode='AUT']
Treeblank.pngTreetree.pnghl7:author
Use this if the author of the medication statement is a healthcare professional
Contains 2.16.840.1.113883.10.12.318 CDA Author (Body) (DYNAMIC)
Medi...ment
 Example
Author of the medication statement is a healthcare professional
<author>
  <time value="20170221"/>  <assignedAuthor>
    <id root="1.2.3.99.99.99" extension="75487435893498"/>    <assignedPerson>
      <name>
        <given qualifier="IN">Ampu</given>        <prefix qualifier="VV">L.</prefix>        <family>Lee</family>      </name>
    </assignedPerson>
  </assignedAuthor>
</author>
Treeblank.pngTreetree.pnghl7:participant
Use this if the author of the medication statement is the patientMedi...ment
where [@typeCode='AUT']
Treeblank.pngTreeblank.pngTreetree.png@typeCode
cs1 … 1FAUT
 Example
Author of the medication statement is the patient
<participant typeCode="AUT">
  <time value="20170121091548"/>  <participantRole classCode="PAT"/></participant>
Treeblank.pngTreeblank.pngTreetree.pnghl7:time
TS1 … 1RMedi...ment
Treeblank.pngTreeblank.pngTreetree.pnghl7:participantRole
1 … 1MMedi...ment
Treeblank.pngTreeblank.pngTreeblank.pngTreetree.png@classCode
cs1 … 1FPAT
Choice
Optional informants of the medication statement: healthcare professional or patient contact party (related party)
Elements to choose from:
  • hl7:informant[exists(hl7:assignedEntity)]
  • hl7:participant[@typeCode='INF']
  • hl7:informant[exists(hl7:relatedEntity)]
Treeblank.pngTreetree.pnghl7:informant
Use this if the informant of the medication statement is a healthcare professionalMedi...ment
where [exists(hl7:assignedEntity)]
Treeblank.pngTreeblank.pngTreetree.png@typeCode
cs0 … 1FINF
Treeblank.pngTreeblank.pngTreetree.png@context​Control​Code
cs0 … 1FOP
 Example
Informant of the medication statement is a healthcare professional
<informant>
  <assignedEntity>
    <id root="1.2.3.99.99.99" extension="75487435893498"/>    <assignedPerson>
      <name>
        <given qualifier="IN">Ampu</given>        <prefix qualifier="VV">L.</prefix>        <family>Lee</family>      </name>
    </assignedPerson>
  </assignedEntity>
</informant>
Treeblank.pngTreeblank.pngTreetree.pnghl7:assignedEntity
1 … 1Contains 2.16.840.1.113883.10.12.153 CDA AssignedEntity (DYNAMIC)Medi...ment
Treeblank.pngTreetree.pnghl7:participant
Use this if the informant of the medication statement is the patientMedi...ment
where [@typeCode='INF']
Treeblank.pngTreeblank.pngTreetree.png@typeCode
cs1 … 1FINF
 Example
Informant of the medication statement is the patient
<participant typeCode="INF">
  <time value="20170121091548"/>  <participantRole classCode="PAT"/></participant>
Treeblank.pngTreeblank.pngTreetree.pnghl7:time
TS1 … 1RMedi...ment
Treeblank.pngTreeblank.pngTreetree.pnghl7:participantRole
1 … 1MMedi...ment
Treeblank.pngTreeblank.pngTreeblank.pngTreetree.png@classCode
cs1 … 1FPAT
Treeblank.pngTreetree.pnghl7:informant
Use this if the informant of the medication statement is a contact party (related party)Medi...ment
where [exists(hl7:relatedEntity)]
Treeblank.pngTreeblank.pngTreetree.png@typeCode
cs0 … 1FINF
Treeblank.pngTreeblank.pngTreetree.png@context​Control​Code
cs0 … 1FOP
 Example
Informant of the medication statement is a contact party (related party)
<informant>
  <relatedEntity classCode="AGNT">
    <relatedPerson classCode="PSN" determinerCode="INSTANCE">
      <name>
        <!-- .. -->
      </name>
    </relatedPerson>
  </relatedEntity>
</informant>
Treeblank.pngTreeblank.pngTreetree.pnghl7:relatedEntity
1 … 1Contains 2.16.840.1.113883.10.12.316 CDA RelatedEntity (DYNAMIC)Medi...ment
Treetree.pnghl7:participant
0 … 1Record Target: indicates the person who's medical record holds the documentation of this medication statement. This element is only populated when the document is placed in a medical record of someone other than the patient (subject).
Contains 2.16.840.1.113883.10.12.321 CDA Participant (Body) (DYNAMIC)
Medi...ment
where [@typeCode='RCT']
Treeblank.pngTreetree.png@typeCode
cs1 … 1FRCT
Treetree.pnghl7:participant
0 … 1Verifier: The person or organization that has primary responsibility for the medication statement. The responsible party is not necessarily present in an action, but is accountable for the action through the power to delegate.
Contains 2.16.840.1.113883.10.12.321 CDA Participant (Body) (DYNAMIC)
Medi...ment
where [@typeCode='VRF']
Treeblank.pngTreetree.png@typeCode
cs1 … 1FVRF
Treetree.pnghl7:entryRelationship
0 … *CSubordinate Substance Administration Statament as a component of the overall medication statement.
At least one subordinated <substanceAdministration> has to be present to convey information about dosages (dose, frequency of intakes,..) unless medications are unknown or known absent.
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)
Medi...ment
where [exists(hl7:substanceAdministration)]
Treeblank.pngTreetree.png@typeCode
cs1 … 1FCOMP
 ConstraintAt least one subordinate <substanceAdministration> element SHALL be present unless medications are unknown or known absent.</substanceAdministration>
 Example<entryRelationship typeCode="COMP">
  <!-- component: Subordinate Substance Administration Statement. -->
  <substanceAdministration classCode="SBADM" moodCode="EVN">
    <templateId root="2.16.840.1.113883.10.21.4.6"/>    <!-- .. -->
  </substanceAdministration>
</entryRelationship>
Treeblank.pngTreetree.pnghl7:sequenceNumber
INT0 … 1Sequence number of the Subordinate Substance Administration.Medi...ment
Treetree.pnghl7:entryRelationship
0 … *RMedication Order Reference.
Contains 2.16.840.1.113883.10.21.4.8 UV Medication Order Reference (DYNAMIC)
Medi...ment
where [@typeCode='REFR' and exists(hl7:substanceAdministration)]
Treeblank.pngTreetree.png@typeCode
cs1 … 1FREFR
 Example<entryRelationship typeCode="REFR">
  <substanceAdministration classCode="SBADM" moodCode="RQO">
    <templateId root="2.16.840.1.113883.10.21.4.8"/>    <!-- .. -->
  </substanceAdministration>
</entryRelationship>
Treetree.pnghl7:entryRelationship
0 … *RDispense Event Reference.
Contains 2.16.840.1.113883.10.21.4.9 UV Dispense Event Reference (DYNAMIC)
Medi...ment
where [@typeCode='REFR' and exists(hl7:supply)]
Treeblank.pngTreetree.png@typeCode
cs1 … 1FREFR
 Example<entryRelationship typeCode="REFR">
  <supply classCode="SPLY" moodCode="EVN">
    <templateId root="2.16.840.1.113883.10.21.4.9"/>    <!-- .. -->
  </supply>
</entryRelationship>
ChoiceElements to choose from:
  • hl7:entryRelationship[@typeCode='RSON' and exists(hl7:observation)] containing template 2.16.840.1.113883.10.21.4.3 UV ClinicalStatement Observation (DYNAMIC)
  • hl7:entryRelationship[@typeCode='RSON' and exists(hl7:act)] containing template 2.16.840.1.113883.10.22.4.31 IPS Internal Reference (DYNAMIC)
Treeblank.pngTreetree.pnghl7:entryRelationship
0 … *RReason: Specifies the reason (indication) for authoring the order.
Contains 2.16.840.1.113883.10.21.4.3 UV ClinicalStatement Observation (DYNAMIC)
Medi...ment
where [@typeCode='RSON' and exists(hl7:observation)]
Treeblank.pngTreeblank.pngTreetree.png@typeCode
cs1 … 1FRSON
 Example<cda:entryRelationship typeCode="RSON">
  <priorityNumber value="1"/>  <!-- template 2.16.840.1.113883.10.21.4.3 'UV ClinicalStatement Observation' (2016-05-01T00:00:00) -->
</cda:entryRelationship>
Treeblank.pngTreeblank.pngTreetree.pngpharm:priorityNumber
INT.​NONNEG0 … 1RIndicates the priority of this reason for the order in relation to its sibling reasons.Medi...ment
Treeblank.pngTreetree.pnghl7:entryRelationship
0 … *RReason: Specifies the reason (indication) for authoring the order.
Contains 2.16.840.1.113883.10.22.4.31 IPS Internal Reference (DYNAMIC)
Medi...ment
where [@typeCode='RSON' and exists(hl7:act)]
Treeblank.pngTreeblank.pngTreetree.png@typeCode
cs1 … 1FRSON
 Example<entryRelationship typeCode="RSON">
  <priorityNumber value="1"/>  <act>
    <!-- Clinical Statement Minimal -->
  </act>
</entryRelationship>
Treeblank.pngTreeblank.pngTreetree.pngpharm:priorityNumber
INT.​NONNEG0 … 1RIndicates the priority of this reason for the order in relation to its sibling reasons.Medi...ment

Appendix (Informative)

Acronyms and abbreviations

  • C-CDA: Consolidated CDA
  • CDA: Clinical Document Architecture
  • DSTU: Draft Standard for Trial Use
  • EDQM: European Directorate for the Quality of Medicines & Healthcare
  • EHR: Electronic Healthcare Record
  • HL7: Health Level Seven
  • HP: Healthcare Professional
  • IDMP: IDentification of Medicinal Products (ISO Standard)
  • IHE: Integrating the Healthcare Enterprise
  • ISO: International Organization for Standardization
  • JIC: Joint Initiative Council on SDO Global Health Informatics Standardization
  • LOINC: Logical Observation Identifiers Names & Codes
  • MPID: Medicinal Product Identifier
  • PCID : Medicinal Product Package Identifier
  • PhPID(s): Pharmaceutical Product Identifier(s)
  • SDO: Standard Developing Organization
  • STU: Standard for Trial Use
  • UCUM: Unified Code for Units of Measure

Glossary

  • Prescribing is an activity that can be performed by a variety of healthcare professionals and involves a variety of orderable items (see glossary entry). For the purposes of the following Implementation Guide, prescribing is defined as the act of prescribing a medication in either an ambulatory or an institutional setting. This could include initiating a new medication order or making all kinds of modifications to existing orders.
  • Dispensing is an activity undertaken to fulfill the logistical requirements of a prescription. It supplies the materials needed to perform the prescribed actions by those who will perform them. Examples of dispensing include eyeglasses, contact lenses and medications. For the purposes of the following ballot material, dispensing is defined as supplying a medication in fulfillment of a prescription or medication order. While dispensing in these circumstances would usually be performed by a pharmacist, other health care providers such as nurses or physicians might also dispense medications.
  • Administration is an activity undertaken to give medication to the patient. In the community, this process is usually not recorded, since the majority occurs in the patient's home; only administrations undertaken by a healthcare professional, such as vaccination, tend to be formally documented. Administration of medication in the institutional setting is usually recorded on a dose-by-dose basis, and may be messaged on that basis, or a summary of all the administrations occurring during an inpatient stay may be described.

Integrated examples

The Medication on CDA specification releases are published at the Pharmacy Templates Project Publication Page[4]. The actual release has a link to the XML materials as which the W3C schemas are part of; it also includes example CDA document instances. A set of use cases have been defined and represented in Medication on CDA format.

It is likely that the publication site will move to hl7.org permanently, we will inform about that process.

Validation artifacts

You can test your implementation (instances) against the Medication on CDA specification. To download materials to your computer for local testing and validation consider...

  • ...the W3C schemas (actually valid for any CDA specification) located at the Publication Page[4]. The actual release has a link to the XML materials as which the W3C schemas are part of; it also includes example CDA document instances.
  • ..the ISO schematron, automatically generated by the tool. These are files to do validation locally by associating IPS CDA instances with the main schematron using an XML editor or to use the derived XSLT conversions and apply the according XSLT derivation to your local IPS CDA instance.

For further information you can follow the documentation.

Operational information

  • The original specification is hosted on the logical ART-DECOR main server art-decor.org under the Governance Group HL7 International, the project is reachable at the Project Live Landing Page[5].
  • Any Medication on CDA specification release in HTML format resides at the Publication Page[4]. It is likely that the publication site will move to hl7.org permanently, we will inform about that process.

Licenses

Following is a non-exhaustive list of third-party terminologies that may require a separate license:

  • SNOMED CT: SNOMED International (formerly know as International Healthcare Terminology Standards Development Organization IHTSDO)[6] or info@ihtsdo.org
  • Logical Observation Identifiers Names & Codes (LOINC): The Regenstrief Institute, Inc.
  • Unified Code for Units of Measure (UCUM) : Regenstrief Institute, Inc. and the UCUM Organization

List of all artifacts used in this guide

CDA Templates

References (re-used) from current C-CDA

Unconstrained Templates from the original CDA specification

Value Sets

Medication Time Units (UCUM)

This terminology is a snapshot as of . Terminologies may evolve over time. If you need recent (dynamic) versions of this terminology, please retrieve it from the source.
Id2.16.840.1.113883.11.21.1Effective Date2023‑02‑01 11:12:08
StatusKgreen.png FinalVersion Label3.0
NameMedicationTimeUnitsDisplay NameMedication Time Units (UCUM)
DescriptionMedication Time Units, expressed in UCUM
Usage: 4
IdNameType
Template
2.16.840.1.113883.10.21.9.1UV Use Period DYNAMIC
2.16.840.1.113883.10.21.9.1UV Use Period (R1-STU2-ballot) DYNAMIC
2.16.840.1.113883.10.21.9.1UV Use Period (2023) DYNAMIC
2.16.840.1.113883.10.21.9.1UV Use Period (2023) DYNAMIC
Source Code System
2.16.840.1.113883.6.8 - Unified Code for Units of Measure - FHIR: http://unitsofmeasure.org - HL7 V2: UCUM
Level/ TypeCodeDisplay NameCode System
0‑L
a
Year
Unified Code for Units of Measure
0‑L
d
Day
Unified Code for Units of Measure
0‑L
h
Hour
Unified Code for Units of Measure
0‑L
min
Minute
Unified Code for Units of Measure
0‑L
mo
Month
Unified Code for Units of Measure
0‑L
s
Second
Unified Code for Units of Measure
0‑L
wk
Week
Unified Code for Units of Measure

Legenda: Type L=leaf, S=specializable, A=abstract, D=deprecated. NullFlavor OTH (other) suggests text in originalText. HL7 V3: NullFlavors to appear in @nullFlavor attribute instead of @code.

ActStatusActiveCompletedAbortedSuspended

This terminology is a snapshot as of . Terminologies may evolve over time. If you need recent (dynamic) versions of this terminology, please retrieve it from the source.
Id2.16.840.1.113883.11.21.2Effective Date2017‑03‑06
StatusKyellow.png DraftVersion Label
NameActStatusCodeActiveCompletedAbortedSuspendedDisplay NameActStatusActiveCompletedAbortedSuspended
Usage: 6
IdNameType
Template
2.16.840.1.113883.10.21.4.1UV Medication Order (R1-STU2-ballot) DYNAMIC
2.16.840.1.113883.10.21.4.6UV Subordinate Substance Administration (R1-STU2-ballot) DYNAMIC
2.16.840.1.113883.10.21.4.1UV Medication Order (2023) DYNAMIC
2.16.840.1.113883.10.21.4.1UV Medication Order (STU1) DYNAMIC
2.16.840.1.113883.10.21.4.1UV Medication Order (2023) DYNAMIC
2.16.840.1.113883.10.21.4.6UV Subordinate Substance Administration (2023) DYNAMIC
Source Code System
2.16.840.1.113883.5.14 - ActStatus - FHIR: http://terminology.hl7.org/CodeSystem/v3-ActStatus
Level/ TypeCodeDisplay NameCode System
0‑L
completed
Completed
ActStatus
0‑L
aborted
Aborted
ActStatus
0‑L
active
Active
ActStatus
0‑L
suspended
Suspended
ActStatus

Legenda: Type L=leaf, S=specializable, A=abstract, D=deprecated. NullFlavor OTH (other) suggests text in originalText. HL7 V3: NullFlavors to appear in @nullFlavor attribute instead of @code.


Referenced HL7 Version 3 Value Sets

  • 2.16.840.1.113883.1.11.13955 ActEncounterCode
  • 2.16.840.1.113883.1.11.16208 ActPharmacySupplyType
  • 2.16.840.1.113883.1.11.16866 ActPriority
  • 2.16.840.1.113883.1.11.15933 ActStatus
  • 2.16.840.1.113883.1.11.19708 ActSubstanceAdministrationCode
  • 2.16.840.1.113883.1.11.14570 AdministrableDrugForm
  • 2.16.840.1.113883.1.11.11526 HumanLanguage
  • 2.16.840.1.113883.11.20.9.18 MoodCodeEvnInt
  • 2.16.840.1.113883.1.11.78 Observation Interpretation
  • 2.16.840.1.113883.1.11.14079 ObservationMethod
  • 2.16.840.1.113883.1.11.14581 RouteOfAdministration
  • 2.16.840.1.113883.1.11.19719 SubstanceAdminSubstitutionNotAllowedReason
  • 2.16.840.1.113883.1.11.10706 TimingEvent
  • 2.16.840.1.113883.1.11.19447 x_ActRelationshipEntryRelationship
  • 2.16.840.1.113883.1.11.19890 x_ActStatusActiveComplete

Datatypes

Datatypes for element definitions used

  • ANY – ANY
  • BL – Boolean
  • CD – Concept Descriptor
  • CE – Coded with Equivalents
  • CS – Coded Simple Value
  • ED – Encapsulated Data
  • EN – Entity Name
  • II – Instance Identifier
  • INT – Integer
  • INT.NONNEG – Interval of Integer, non-negative
  • IVL_INT – Interval of Integer
  • IVL_PQ – Interval of Physical Quantity
  • IVL_TS – Interval of Time Stamp
  • IVXB_TS – Interval Boundary of Time Stamp
  • PIVL_TS – Periodic Interval of Timezone
  • PQ – Physical Quantity
  • RTO_PQ_PQ – Ratio Physical Quantity / Physical Quantity
  • ST – Character String
  • TEL – Telecommunication Address
  • TS – Time Stamp

Datatypes for attributes used

  • bl – boolean code
  • cs – code
  • uid – identifier

How to read the table view for templates

The template definitions are shown in a table view. It is comprised of Template Meta data and the Template Design. For further information please refer to the HL7 Templates Standard: Specification and Use of Reusable Information Constraint Templates, Release 1[2].

Templates may also be included in the hierarchical graph view (often used for CDA), see below.

Template Meta data

TemplatePublication1.png
TemplatePublication1.png

The upper right part of the template table contains the template meta data. Template id, status and the template name are shown (1). Furthermore the Version (effective date), a possible version label and the display name are shown (2).

The description area (plain or an accordion) contains the template descriptions/purpose (3), followed by classifications and whether the template is defined as open or closed (4).

The usage part (5) may list templates that uses this template or what templates this templates uses. A relationship list (6) may show all relationships to other templates or models.

Examples may show the correct use of the template by an XML fragment (7).

TemplatePublication5a.png
TemplatePublication5a.png

The relationship list shows all relationships to other templates or models for this template. It is divided in the "Used by" part listing templates that make use of this template, and a "Uses" listing all templates that are used by this templates, either as inclusion or containment. Indirect relationships like the parent Document Level Template for a Section Level Template are marked with a chain symbol.

The PDF version is rendered in the same way, but maybe with different fonts etc. to fit customized publication requirements.

TemplatePublication2.png
TemplatePublication2.png

Table view of Template Design

TemplatePublication3.png
TemplatePublication3.png

The headings of the table view of a template design are:

Item (1) contains the XML document tree view of all elements and attributes specified in the template design. Elements are denoted by a preceding triangle and attributes by a preceding "@".

DT (2) data types, contains the data type of the item, for more information on valid data types for element and attributes (see [2]).

Card / Conf (3) cardinality (Card) and conformance (Conf) of the item. Cardinality is the usual notion of min and max occurrences of the element. For attributes 0..1 denotes optionality, 1..1 say that the attribute is required and NP denotes prohibited attributes. Conformance may display values as shown in the following table.

Values of the conformance column
Conf Short Description
O optional Data is truly optional
R required If data is present and not masked (e.g. for privacy reasons), it must be provided, otherwise it may be omitted or explicitly null flavored.
Sender and receiver must support this element.
M mandatory The data must be populated with a valid value from the associated value domain, otherwise the instance is not valid and may not be communicated.
Sender and receiver must support this element.
C conditional There are conditions when data has to be provided (e.g. co-constraints like "information about pregnancy IF the patient is "female".
Sender and receiver must support this element.
F fixed The data has a fixed value.
NP not permitted Data shall not be present

Description (4) contains a textual description of the item, may also contain constraints and values for fixed attributes.

Label (5) is a human readable label that is displayed upon errors, warnings or notes during validation.

Details of the table view

TemplatePublication4.png
TemplatePublication4.png

The actual template design shows the XML structure in a hierarchical list of elements (items) that are typically prefixed by the namespace "hl7:" or "cda:" (1).

Elements are denoted with a triangle, attributes with an @ sign (2).

Data types are specified according to the list of supported data types (3). They may be simple data types (lowercase), regular data types (uppercase) or flavors thereof. In case of coded elements, the coding strength (Required/CNE, Extensible/CWE, Preferred or Example) can be highlighted near the datatype (e.g. “CD.IPS (Extensible/CWE)”) ; the absence of indications about the strength (e.g. “CE.IPS”) shall be interpreted as “Required/CNE”.

Values of the coding strength column
Strength Displayed as Description
Required Required/CNE Coded with no exceptions; this element SHALL be from the specified value set
Extensible Extensible/CWE Coded with Exceptions; this element SHALL be from the specified value set if any of the codes within the value set can apply to the concept being communicated. If the value set does not cover the concept (based on human review), alternate codings (or, data type allowing, text) may be included instead.
Preferred Preferred Instances are encouraged to draw from the specified codes for interoperability purposes but are not required to do so to be considered conformant.
Example Example Instances are not expected or even encouraged to draw from the specified value set. The value set merely provides examples of the types of concepts intended to be included.

The cardinality and conformance column is explained above (4).

Fixed values for e.g. attributes are also shown in the "description" column (5), preceded by a "F" in the Conf column.

Conformance statements are shown together with a CONF box, e.g. a @code and a @codeSystem with fixed and required values (6).

An optional label is displayed at the rightmost column (7).

Inclusion or containments of other templates, e.g. an entry within a section, are shown accordingly (8) along with their template id, display name and flexibility/stability indication, i.e. "DYNAMIC" (the most recent version) or a STATIC binding together with a version date.

TemplatePublication5b.png
TemplatePublication5b.png

Choices of elements are shown as a choice list with the elements in questions summarised in a bullet point list.

TemplatePublication6b.png
TemplatePublication6b.png

A typical Conformance Statement is the binding of a coded element to a value set. This is expressed in the way shown. The value set is represented with the id, display name and the flexibility/stability of the binding.

TemplatePublication6c.png
TemplatePublication6c.png

In case a constraint is expressed in words, a box "Constraint" accompanies the textual expression of the constraint.

TemplatePublication6a.png
TemplatePublication6a.png

In cases where constraints are expressed by formalised rules in ISO Schematron, the rule along with the role (error, warning), the test and the assertion message is shown.

How to read the Templates hierarchical graph view

TemplatePublication8a.png
TemplatePublication8a.png

Templates are often included in the hierarchical graph view (often used for CDA). It gives an overview of e.g. section and entries and their nesting/relationships.

TemplatePublication8b.png
TemplatePublication8b.png

In case a template has more that one type (CDA Person for header, section and entry templates), it is denoted with a *, if a recursive definition is detected, this is shown with the symbol @.

How to read the where criteria

Templates sometimes include criteria for identifying distinct elements from a list (e.g. in a choice).

The criteria used to identify the items are shown in square brackets using the assertion where [ criteria ]

Criteria can be:

  1. an xpath expression as in the example : where [hl7:low or hl7:high]
  2. or an integer indexing the items of the list: e.g. where [1]; where [2]

References

Literature

  • Boone KW: The CDA Book. Springer 2011, ISBN 978-0-85729-336-7

Links

  1. 1.0 1.1 http://www.hl7.org/implement/standards/product_brief.cfm?product_id=379
  2. 2.0 2.1 2.2 2.3 HL7 Templates Standard: Specification and Use of Reusable Information Constraint Templates, Release 1 http://www.hl7.org/implement/standards/product_brief.cfm?product_id=377
  3. ISO/TS 13582:2013 Health informatics -- Sharing of OID registry information
  4. 4.0 4.1 4.2 Pharmacy Templates Project Publication Page http://hl7intl.art-decor.org/index.php?prefix=pharmcda-
  5. Pharmacy Templates Project Live Landing Page http://art-decor.org/art-decor/decor-project--pharmcda-
  6. Get SNOMED CT http://www.ihtsdo.org/snomed-ct/get-snomed-ct

Figures

  1. Locating ballot comments