Release 5 Preview #1

This page is part of the FHIR Specification (v4.2.0: R5 Preview #1). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions

Codesystem-medication-usage-status.xml

Pharmacy Work GroupMaturity Level: N/AStandards Status: Informative

Raw XML (canonical form + also see XML Format Specification)

Definition for Code System MedicationUsage Status Codes

<?xml version="1.0" encoding="UTF-8"?>

<CodeSystem xmlns="http://hl7.org/fhir">
  <id value="medication-usage-status"/> 
  <meta> 
    <lastUpdated value="2019-12-31T21:03:40.621+11:00"/> 
    <profile value="http://hl7.org/fhir/StructureDefinition/shareablecodesystem"/> 
  </meta> 
  <text> 
    <status value="generated"/> 
    <div xmlns="http://www.w3.org/1999/xhtml">
      <h2> Medication usage  status  codes</h2> 
      <div> 
        <p> MedicationUsage Status Codes</p> 

      </div> 
      <p> This code system http://hl7.org/fhir/CodeSystem/medication-usage-status defines the following
         codes:</p> 
      <table class="codes">
        <tr> 
          <td style="white-space:nowrap">
            <b> Code</b> 
          </td> 
          <td> 
            <b> Display</b> 
          </td> 
          <td> 
            <b> Definition</b> 
          </td> 
        </tr> 
        <tr> 
          <td style="white-space:nowrap">active
            <a name="medication-usage-status-active"> </a> 
          </td> 
          <td> Active</td> 
          <td> The medication is still being taken.</td> 
        </tr> 
        <tr> 
          <td style="white-space:nowrap">completed
            <a name="medication-usage-status-completed"> </a> 
          </td> 
          <td> Completed</td> 
          <td> The medication is no longer being taken.</td> 
        </tr> 
        <tr> 
          <td style="white-space:nowrap">entered-in-error
            <a name="medication-usage-status-entered-in-error"> </a> 
          </td> 
          <td> Entered in Error</td> 
          <td> Some of the actions that are implied by the medication usage may have occurred.  For example,
             the patient may have taken some of the medication.  Clinical decision support systems
             should take this status into account.</td> 
        </tr> 
        <tr> 
          <td style="white-space:nowrap">intended
            <a name="medication-usage-status-intended"> </a> 
          </td> 
          <td> Intended</td> 
          <td> The medication may be taken at some time in the future.</td> 
        </tr> 
        <tr> 
          <td style="white-space:nowrap">stopped
            <a name="medication-usage-status-stopped"> </a> 
          </td> 
          <td> Stopped</td> 
          <td> Actions implied by the usage have been permanently halted, before all of them occurred.
             This should not be used if the statement was entered in error.</td> 
        </tr> 
        <tr> 
          <td style="white-space:nowrap">on-hold
            <a name="medication-usage-status-on-hold"> </a> 
          </td> 
          <td> On Hold</td> 
          <td> Actions implied by the usage have been temporarily halted, but are expected to continue
             later. May also be called 'suspended'.</td> 
        </tr> 
        <tr> 
          <td style="white-space:nowrap">unknown
            <a name="medication-usage-status-unknown"> </a> 
          </td> 
          <td> Unknown</td> 
          <td> The state of the medication use is not currently known.</td> 
        </tr> 
        <tr> 
          <td style="white-space:nowrap">not-taken
            <a name="medication-usage-status-not-taken"> </a> 
          </td> 
          <td> Not Taken</td> 
          <td> The medication was not consumed by the patient</td> 
        </tr> 
      </table> 
    </div> 
  </text> 
  <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-wg">
    <valueCode value="phx"/> 
  </extension> 
  <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status">
    <valueCode value="trial-use"/> 
  </extension> 
  <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm">
    <valueInteger value="3"/> 
  </extension> 
  <url value="http://hl7.org/fhir/CodeSystem/medication-usage-status"/> 
  <identifier> 
    <system value="urn:ietf:rfc:3986"/> 
    <value value="urn:oid:2.16.840.1.113883.4.642.1.1423"/> 
  </identifier> 
  <version value="4.2.0"/> 
  <name value="MedicationUsage Status Codes"/> 
  <title value="Medication usage  status  codes"/> 
  <status value="draft"/> 
  <experimental value="false"/> 
  <publisher value="FHIR Project team"/> 
  <contact> 
    <telecom> 
      <system value="url"/> 
      <value value="http://hl7.org/fhir"/> 
    </telecom> 
  </contact> 
  <description value="MedicationUsage Status Codes"/> 
  <caseSensitive value="true"/> 
  <valueSet value="http://hl7.org/fhir/ValueSet/medication-usage-status"/> 
  <content value="complete"/> 
  <concept> 
    <code value="active"/> 
    <display value="Active"/> 
    <definition value="The medication is still being taken."/> 
  </concept> 
  <concept> 
    <code value="completed"/> 
    <display value="Completed"/> 
    <definition value="The medication is no longer being taken."/> 
  </concept> 
  <concept> 
    <code value="entered-in-error"/> 
    <display value="Entered in Error"/> 
    <definition value="Some of the actions that are implied by the medication usage may have occurred.  For example,
     the patient may have taken some of the medication.  Clinical decision support systems
     should take this status into account."/> 
  </concept> 
  <concept> 
    <code value="intended"/> 
    <display value="Intended"/> 
    <definition value="The medication may be taken at some time in the future."/> 
  </concept> 
  <concept> 
    <code value="stopped"/> 
    <display value="Stopped"/> 
    <definition value="Actions implied by the usage have been permanently halted, before all of them occurred.
     This should not be used if the statement was entered in error."/> 
  </concept> 
  <concept> 
    <code value="on-hold"/> 
    <display value="On Hold"/> 
    <definition value="Actions implied by the usage have been temporarily halted, but are expected to continue
     later. May also be called 'suspended'."/> 
  </concept> 
  <concept> 
    <code value="unknown"/> 
    <display value="Unknown"/> 
    <definition value="The state of the medication use is not currently known."/> 
  </concept> 
  <concept> 
    <code value="not-taken"/> 
    <display value="Not Taken"/> 
    <definition value="The medication was not consumed by the patient"/> 
  </concept> 
</CodeSystem> 

Usage note: every effort has been made to ensure that the examples are correct and useful, but they are not a normative part of the specification.