---
type: "codesystem"
title: "Medication Dispense Status Codes"
codesystem: "medicationdispense-status"
---
# Medication Dispense Status Codes

- **Official URL**: http://hl7.org/fhir/CodeSystem/medicationdispense-status
- **Status**: active
- **Name**: MedicationDispenseStatusCodes
- **Title**: Medication Dispense Status Codes
- **Description**: Medication Dispense Status Codes
- **Case Sensitive**: true
- **Content**: complete

## Concepts

| Code | Display | Definition |
| --- | --- | --- |
| preparation | Preparation | The core event has not started yet, but some staging activities have begun (e.g. initial compounding or packaging of medication). Preparation stages may be tracked for billing purposes. |
| in-progress | In Progress | The dispensed product is ready for pickup. |
| cancelled | Cancelled | The dispensed product was not and will never be picked up by the patient. |
| on-hold | On Hold | The dispense process is paused while waiting for an external event to reactivate the dispense.  For example, new stock has arrived or the prescriber has called. |
| completed | Completed | The dispensed product has been picked up. |
| entered-in-error | Entered in Error | The dispense was entered in error and therefore nullified. |
| unfulfilled | Unfulfilled | Actions implied by the dispense have been permanently halted, before all of them occurred. |
| declined | Declined | The dispense was declined and not performed. |
| unknown | Unknown | The authoring system does not know which of the status values applies for this medication dispense.  Note: this concept is not to be used for other - one of the listed statuses is presumed to apply, it's just now known which one. |

## CodeSystem XML



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

<CodeSystem xmlns="http://hl7.org/fhir">
  <id value="medicationdispense-status"/>
  <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="normative"/>
  </extension>
  <url value="http://hl7.org/fhir/CodeSystem/medicationdispense-status"/>
  <identifier>
    <system value="urn:ietf:rfc:3986"/>
    <value value="urn:oid:2.16.840.1.113883.4.642.4.1971"/>
  </identifier>
  <name value="MedicationDispenseStatusCodes"/>
  <title value="Medication Dispense Status Codes"/>
  <status value="active"/>
  <experimental value="false"/>
  <description value="Medication Dispense Status Codes"/>
  <caseSensitive value="true"/>
  <valueSet value="http://hl7.org/fhir/ValueSet/medicationDispense-status"/>
  <content value="complete"/>
  <concept>
    <code value="preparation"/>
    <display value="Preparation"/>
    <definition value="The core event has not started yet, but some staging activities have begun (e.g. initial compounding or packaging of medication). Preparation stages may be tracked for billing purposes."/>
  </concept>
  <concept>
    <code value="in-progress"/>
    <display value="In Progress"/>
    <definition value="The dispensed product is ready for pickup."/>
  </concept>
  <concept>
    <code value="cancelled"/>
    <display value="Cancelled"/>
    <definition value="The dispensed product was not and will never be picked up by the patient."/>
  </concept>
  <concept>
    <code value="on-hold"/>
    <display value="On Hold"/>
    <definition value="The dispense process is paused while waiting for an external event to reactivate the dispense.  For example, new stock has arrived or the prescriber has called."/>
  </concept>
  <concept>
    <code value="completed"/>
    <display value="Completed"/>
    <definition value="The dispensed product has been picked up."/>
  </concept>
  <concept>
    <code value="entered-in-error"/>
    <display value="Entered in Error"/>
    <definition value="The dispense was entered in error and therefore nullified."/>
  </concept>
  <concept>
    <code value="unfulfilled"/>
    <display value="Unfulfilled"/>
    <definition value="Actions implied by the dispense have been permanently halted, before all of them occurred."/>
  </concept>
  <concept>
    <code value="declined"/>
    <display value="Declined"/>
    <definition value="The dispense was declined and not performed."/>
  </concept>
  <concept>
    <code value="unknown"/>
    <display value="Unknown"/>
    <definition value="The authoring system does not know which of the status values applies for this medication dispense.  Note: this concept is not to be used for other - one of the listed statuses is presumed to apply, it's just now known which one."/>
  </concept>
</CodeSystem>
```