Release 5

This page is part of the FHIR Specification (v5.0.0: R5 - STU). This is the current published version. For a full list of available versions, see the Directory of published versions

12.25 Resource DeviceDispense - Content

Orders and Observations icon Work GroupMaturity Level: 0 Trial UseSecurity Category: Business Compartments: No defined compartments

A record of dispensation of a device - i.e., assigning a device to a patient, or to a professional for their use.

12.25.1 Scope and Usage

The DeviceDispense resource is used to capture the assignment of a Device to a patient or practitioner for the purpose of care. The dispense may include a description of the device and the instructions for using the device. The request to initiate a DeviceDispense may be via a DeviceRequest resource but may be implicitly triggered by for example a ServiceRequest, or without any request. The details of the clinical application of the dispensed device may be captured in a Procedure resource.

12.25.2 Boundaries and Relationships

To determine the purchase date, a search of DeviceRequest, SupplyRequest, DeviceDispense, or SupplyDelivery as defined in an implementation guide can be done , as the context of the use case actually determines which date of either resource is considered the purchase date.

12.25.3 References to this Resource

12.25.4 Resource Content

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. DeviceDispense TUDomainResourceA record of dispensation of a device

Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... identifier Σ0..*IdentifierBusiness identifier for this dispensation

... basedOn 0..*Reference(CarePlan | DeviceRequest)The order or request that this dispense is fulfilling

... partOf 0..*Reference(Procedure)The bigger event that this dispense is a part of

... statusReason 0..1CodeableReference(DetectedIssue)Why a dispense was or was not performed
Binding: DeviceDispense Status Reason Codes (Example)
... category 0..*CodeableConceptType of device dispense

... device Σ1..1CodeableReference(Device | DeviceDefinition)What device was supplied
... subject Σ1..1Reference(Patient | Practitioner)Who the dispense is for
... receiver 0..1Reference(Patient | Practitioner | RelatedPerson | Location | PractitionerRole)Who collected the device or where the medication was delivered
... encounter 0..1Reference(Encounter)Encounter associated with event
... supportingInformation 0..*Reference(Any)Information that supports the dispensing of the device

... performer 0..*BackboneElementWho performed event

.... function 0..1CodeableConceptWho performed the dispense and what they did
.... actor 1..1Reference(Practitioner | PractitionerRole | Organization | Patient | Device | RelatedPerson | CareTeam)Individual who was performing
... location 0..1Reference(Location)Where the dispense occurred
... type 0..1CodeableConceptTrial fill, partial fill, emergency fill, etc
... quantity 0..1SimpleQuantityAmount dispensed
... preparedDate Σ0..1dateTimeWhen product was packaged and reviewed
... whenHandedOver 0..1dateTimeWhen product was given out
... destination 0..1Reference(Location)Where the device was sent or should be sent
... note 0..*AnnotationInformation about the dispense

... usageInstruction 0..1markdownFull representation of the usage instructions
... eventHistory 0..*Reference(Provenance)A list of relevant lifecycle events


doco Documentation for this format icon

See the Extensions for this resource

UML Diagram (Legend)

DeviceDispense (DomainResource)Business identifier for this dispensationidentifier : Identifier [0..*]The order or request that this dispense is fulfillingbasedOn : Reference [0..*] « CarePlan|DeviceRequest »The bigger event that this dispense is a part ofpartOf : Reference [0..*] « Procedure »A code specifying the state of the set of dispense events (this element modifies the meaning of other elements)status : code [1..1] « A coded concept specifying the state of the dispense event. (Strength=Required)DeviceDispenseStatusCodes! »Indicates the reason why a dispense was or was not performedstatusReason : CodeableReference [0..1] « DetectedIssue; A code describing why a dispense was or was not performed. (Strength=Example) DeviceDispenseStatusReasonCod...?? »Indicates the type of device dispensecategory : CodeableConcept [0..*]Identifies the device being dispensed. This is either a link to a resource representing the details of the device or a simple attribute carrying a code that identifies the device from a known list of devicesdevice : CodeableReference [1..1] « Device|DeviceDefinition »A link to a resource representing the person to whom the device is intendedsubject : Reference [1..1] « Patient|Practitioner »Identifies the person who picked up the device or the person or location where the device was delivered. This may be a patient or their caregiver, but some cases exist where it can be a healthcare professional or a locationreceiver : Reference [0..1] « Patient|Practitioner|RelatedPerson| Location|PractitionerRole »The encounter that establishes the context for this eventencounter : Reference [0..1] « Encounter »Additional information that supports the device being dispensedsupportingInformation : Reference [0..*] « Any »The principal physical location where the dispense was performedlocation : Reference [0..1] « Location »Indicates the type of dispensing event that is performedtype : CodeableConcept [0..1]The number of devices that have been dispensedquantity : Quantity(SimpleQuantity) [0..1]The time when the dispensed product was packaged and reviewedpreparedDate : dateTime [0..1]The time the dispensed product was made available to the patient or their representativewhenHandedOver : dateTime [0..1]Identification of the facility/location where the device was /should be shipped to, as part of the dispense processdestination : Reference [0..1] « Location »Extra information about the dispense that could not be conveyed in the other attributesnote : Annotation [0..*]The full representation of the instructionsusageInstruction : markdown [0..1]A summary of the events of interest that have occurred, such as when the dispense was verifiedeventHistory : Reference [0..*] « Provenance »PerformerDistinguishes the type of performer in the dispense. For example, date enterer, packager, final checkerfunction : CodeableConcept [0..1]The device, practitioner, etc. who performed the action. It should be assumed that the actor is the dispenser of the deviceactor : Reference [1..1] « Practitioner|PractitionerRole| Organization|Patient|Device|RelatedPerson|CareTeam »Indicates who or what performed the eventperformer[0..*]

XML Template

<DeviceDispense xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- 0..* Identifier Business identifier for this dispensation --></identifier>
 <basedOn><!-- 0..* Reference(CarePlan|DeviceRequest) The order or request that this dispense is fulfilling --></basedOn>
 <partOf><!-- 0..* Reference(Procedure) The bigger event that this dispense is a part of --></partOf>
 <status value="[code]"/><!-- 1..1 preparation | in-progress | cancelled | on-hold | completed | entered-in-error | stopped | declined | unknown -->
 <statusReason><!-- 0..1 CodeableReference(DetectedIssue) Why a dispense was or was not performed --></statusReason>
 <category><!-- 0..* CodeableConcept Type of device dispense --></category>
 <device><!-- 1..1 CodeableReference(Device|DeviceDefinition) What device was supplied --></device>
 <subject><!-- 1..1 Reference(Patient|Practitioner) Who the dispense is for --></subject>
 <receiver><!-- 0..1 Reference(Location|Patient|Practitioner|PractitionerRole|
   RelatedPerson) Who collected the device or where the medication was delivered --></receiver>
 <encounter><!-- 0..1 Reference(Encounter) Encounter associated with event --></encounter>
 <supportingInformation><!-- 0..* Reference(Any) Information that supports the dispensing of the device --></supportingInformation>
 <performer>  <!-- 0..* Who performed event -->
  <function><!-- 0..1 CodeableConcept Who performed the dispense and what they did --></function>
  <actor><!-- 1..1 Reference(CareTeam|Device|Organization|Patient|Practitioner|
    PractitionerRole|RelatedPerson) Individual who was performing --></actor>
 </performer>
 <location><!-- 0..1 Reference(Location) Where the dispense occurred --></location>
 <type><!-- 0..1 CodeableConcept Trial fill, partial fill, emergency fill, etc --></type>
 <quantity><!-- 0..1 Quantity(SimpleQuantity) Amount dispensed --></quantity>
 <preparedDate value="[dateTime]"/><!-- 0..1 When product was packaged and reviewed -->
 <whenHandedOver value="[dateTime]"/><!-- 0..1 When product was given out -->
 <destination><!-- 0..1 Reference(Location) Where the device was sent or should be sent --></destination>
 <note><!-- 0..* Annotation Information about the dispense --></note>
 <usageInstruction value="[markdown]"/><!-- 0..1 Full representation of the usage instructions -->
 <eventHistory><!-- 0..* Reference(Provenance) A list of relevant lifecycle events --></eventHistory>
</DeviceDispense>

JSON Template

{doco
  "resourceType" : "DeviceDispense",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // Business identifier for this dispensation
  "basedOn" : [{ Reference(CarePlan|DeviceRequest) }], // The order or request that this dispense is fulfilling
  "partOf" : [{ Reference(Procedure) }], // The bigger event that this dispense is a part of
  "status" : "<code>", // R!  preparation | in-progress | cancelled | on-hold | completed | entered-in-error | stopped | declined | unknown
  "statusReason" : { CodeableReference(DetectedIssue) }, // Why a dispense was or was not performed
  "category" : [{ CodeableConcept }], // Type of device dispense
  "device" : { CodeableReference(Device|DeviceDefinition) }, // R!  What device was supplied
  "subject" : { Reference(Patient|Practitioner) }, // R!  Who the dispense is for
  "receiver" : { Reference(Location|Patient|Practitioner|PractitionerRole|
   RelatedPerson) }, // Who collected the device or where the medication was delivered
  "encounter" : { Reference(Encounter) }, // Encounter associated with event
  "supportingInformation" : [{ Reference(Any) }], // Information that supports the dispensing of the device
  "performer" : [{ // Who performed event
    "function" : { CodeableConcept }, // Who performed the dispense and what they did
    "actor" : { Reference(CareTeam|Device|Organization|Patient|Practitioner|
    PractitionerRole|RelatedPerson) } // R!  Individual who was performing
  }],
  "location" : { Reference(Location) }, // Where the dispense occurred
  "type" : { CodeableConcept }, // Trial fill, partial fill, emergency fill, etc
  "quantity" : { Quantity(SimpleQuantity) }, // Amount dispensed
  "preparedDate" : "<dateTime>", // When product was packaged and reviewed
  "whenHandedOver" : "<dateTime>", // When product was given out
  "destination" : { Reference(Location) }, // Where the device was sent or should be sent
  "note" : [{ Annotation }], // Information about the dispense
  "usageInstruction" : "<markdown>", // Full representation of the usage instructions
  "eventHistory" : [{ Reference(Provenance) }] // A list of relevant lifecycle events
}

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:DeviceDispense;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:identifier  ( [ Identifier ] ... ) ; # 0..* Business identifier for this dispensation
  fhir:basedOn  ( [ Reference(CarePlan|DeviceRequest) ] ... ) ; # 0..* The order or request that this dispense is fulfilling
  fhir:partOf  ( [ Reference(Procedure) ] ... ) ; # 0..* The bigger event that this dispense is a part of
  fhir:status [ code ] ; # 1..1 preparation | in-progress | cancelled | on-hold | completed | entered-in-error | stopped | declined | unknown
  fhir:statusReason [ CodeableReference(DetectedIssue) ] ; # 0..1 Why a dispense was or was not performed
  fhir:category  ( [ CodeableConcept ] ... ) ; # 0..* Type of device dispense
  fhir:device [ CodeableReference(Device|DeviceDefinition) ] ; # 1..1 What device was supplied
  fhir:subject [ Reference(Patient|Practitioner) ] ; # 1..1 Who the dispense is for
  fhir:receiver [ Reference(Location|Patient|Practitioner|PractitionerRole|RelatedPerson) ] ; # 0..1 Who collected the device or where the medication was delivered
  fhir:encounter [ Reference(Encounter) ] ; # 0..1 Encounter associated with event
  fhir:supportingInformation  ( [ Reference(Any) ] ... ) ; # 0..* Information that supports the dispensing of the device
  fhir:performer ( [ # 0..* Who performed event
    fhir:function [ CodeableConcept ] ; # 0..1 Who performed the dispense and what they did
    fhir:actor [ Reference(CareTeam|Device|Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) ] ; # 1..1 Individual who was performing
  ] ... ) ;
  fhir:location [ Reference(Location) ] ; # 0..1 Where the dispense occurred
  fhir:type [ CodeableConcept ] ; # 0..1 Trial fill, partial fill, emergency fill, etc
  fhir:quantity [ Quantity(SimpleQuantity) ] ; # 0..1 Amount dispensed
  fhir:preparedDate [ dateTime ] ; # 0..1 When product was packaged and reviewed
  fhir:whenHandedOver [ dateTime ] ; # 0..1 When product was given out
  fhir:destination [ Reference(Location) ] ; # 0..1 Where the device was sent or should be sent
  fhir:note  ( [ Annotation ] ... ) ; # 0..* Information about the dispense
  fhir:usageInstruction [ markdown ] ; # 0..1 Full representation of the usage instructions
  fhir:eventHistory  ( [ Reference(Provenance) ] ... ) ; # 0..* A list of relevant lifecycle events
]

Changes from both R4 and R4B

This resource did not exist in Release R4

See the Full Difference for further information

This analysis is available for R4 as XML or JSON and for R4B as XML or JSON.

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. DeviceDispense TUDomainResourceA record of dispensation of a device

Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... identifier Σ0..*IdentifierBusiness identifier for this dispensation

... basedOn 0..*Reference(CarePlan | DeviceRequest)The order or request that this dispense is fulfilling

... partOf 0..*Reference(Procedure)The bigger event that this dispense is a part of

... statusReason 0..1CodeableReference(DetectedIssue)Why a dispense was or was not performed
Binding: DeviceDispense Status Reason Codes (Example)
... category 0..*CodeableConceptType of device dispense

... device Σ1..1CodeableReference(Device | DeviceDefinition)What device was supplied
... subject Σ1..1Reference(Patient | Practitioner)Who the dispense is for
... receiver 0..1Reference(Patient | Practitioner | RelatedPerson | Location | PractitionerRole)Who collected the device or where the medication was delivered
... encounter 0..1Reference(Encounter)Encounter associated with event
... supportingInformation 0..*Reference(Any)Information that supports the dispensing of the device

... performer 0..*BackboneElementWho performed event

.... function 0..1CodeableConceptWho performed the dispense and what they did
.... actor 1..1Reference(Practitioner | PractitionerRole | Organization | Patient | Device | RelatedPerson | CareTeam)Individual who was performing
... location 0..1Reference(Location)Where the dispense occurred
... type 0..1CodeableConceptTrial fill, partial fill, emergency fill, etc
... quantity 0..1SimpleQuantityAmount dispensed
... preparedDate Σ0..1dateTimeWhen product was packaged and reviewed
... whenHandedOver 0..1dateTimeWhen product was given out
... destination 0..1Reference(Location)Where the device was sent or should be sent
... note 0..*AnnotationInformation about the dispense

... usageInstruction 0..1markdownFull representation of the usage instructions
... eventHistory 0..*Reference(Provenance)A list of relevant lifecycle events


doco Documentation for this format icon

See the Extensions for this resource

UML Diagram (Legend)

DeviceDispense (DomainResource)Business identifier for this dispensationidentifier : Identifier [0..*]The order or request that this dispense is fulfillingbasedOn : Reference [0..*] « CarePlan|DeviceRequest »The bigger event that this dispense is a part ofpartOf : Reference [0..*] « Procedure »A code specifying the state of the set of dispense events (this element modifies the meaning of other elements)status : code [1..1] « A coded concept specifying the state of the dispense event. (Strength=Required)DeviceDispenseStatusCodes! »Indicates the reason why a dispense was or was not performedstatusReason : CodeableReference [0..1] « DetectedIssue; A code describing why a dispense was or was not performed. (Strength=Example) DeviceDispenseStatusReasonCod...?? »Indicates the type of device dispensecategory : CodeableConcept [0..*]Identifies the device being dispensed. This is either a link to a resource representing the details of the device or a simple attribute carrying a code that identifies the device from a known list of devicesdevice : CodeableReference [1..1] « Device|DeviceDefinition »A link to a resource representing the person to whom the device is intendedsubject : Reference [1..1] « Patient|Practitioner »Identifies the person who picked up the device or the person or location where the device was delivered. This may be a patient or their caregiver, but some cases exist where it can be a healthcare professional or a locationreceiver : Reference [0..1] « Patient|Practitioner|RelatedPerson| Location|PractitionerRole »The encounter that establishes the context for this eventencounter : Reference [0..1] « Encounter »Additional information that supports the device being dispensedsupportingInformation : Reference [0..*] « Any »The principal physical location where the dispense was performedlocation : Reference [0..1] « Location »Indicates the type of dispensing event that is performedtype : CodeableConcept [0..1]The number of devices that have been dispensedquantity : Quantity(SimpleQuantity) [0..1]The time when the dispensed product was packaged and reviewedpreparedDate : dateTime [0..1]The time the dispensed product was made available to the patient or their representativewhenHandedOver : dateTime [0..1]Identification of the facility/location where the device was /should be shipped to, as part of the dispense processdestination : Reference [0..1] « Location »Extra information about the dispense that could not be conveyed in the other attributesnote : Annotation [0..*]The full representation of the instructionsusageInstruction : markdown [0..1]A summary of the events of interest that have occurred, such as when the dispense was verifiedeventHistory : Reference [0..*] « Provenance »PerformerDistinguishes the type of performer in the dispense. For example, date enterer, packager, final checkerfunction : CodeableConcept [0..1]The device, practitioner, etc. who performed the action. It should be assumed that the actor is the dispenser of the deviceactor : Reference [1..1] « Practitioner|PractitionerRole| Organization|Patient|Device|RelatedPerson|CareTeam »Indicates who or what performed the eventperformer[0..*]

XML Template

<DeviceDispense xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- 0..* Identifier Business identifier for this dispensation --></identifier>
 <basedOn><!-- 0..* Reference(CarePlan|DeviceRequest) The order or request that this dispense is fulfilling --></basedOn>
 <partOf><!-- 0..* Reference(Procedure) The bigger event that this dispense is a part of --></partOf>
 <status value="[code]"/><!-- 1..1 preparation | in-progress | cancelled | on-hold | completed | entered-in-error | stopped | declined | unknown -->
 <statusReason><!-- 0..1 CodeableReference(DetectedIssue) Why a dispense was or was not performed --></statusReason>
 <category><!-- 0..* CodeableConcept Type of device dispense --></category>
 <device><!-- 1..1 CodeableReference(Device|DeviceDefinition) What device was supplied --></device>
 <subject><!-- 1..1 Reference(Patient|Practitioner) Who the dispense is for --></subject>
 <receiver><!-- 0..1 Reference(Location|Patient|Practitioner|PractitionerRole|
   RelatedPerson) Who collected the device or where the medication was delivered --></receiver>
 <encounter><!-- 0..1 Reference(Encounter) Encounter associated with event --></encounter>
 <supportingInformation><!-- 0..* Reference(Any) Information that supports the dispensing of the device --></supportingInformation>
 <performer>  <!-- 0..* Who performed event -->
  <function><!-- 0..1 CodeableConcept Who performed the dispense and what they did --></function>
  <actor><!-- 1..1 Reference(CareTeam|Device|Organization|Patient|Practitioner|
    PractitionerRole|RelatedPerson) Individual who was performing --></actor>
 </performer>
 <location><!-- 0..1 Reference(Location) Where the dispense occurred --></location>
 <type><!-- 0..1 CodeableConcept Trial fill, partial fill, emergency fill, etc --></type>
 <quantity><!-- 0..1 Quantity(SimpleQuantity) Amount dispensed --></quantity>
 <preparedDate value="[dateTime]"/><!-- 0..1 When product was packaged and reviewed -->
 <whenHandedOver value="[dateTime]"/><!-- 0..1 When product was given out -->
 <destination><!-- 0..1 Reference(Location) Where the device was sent or should be sent --></destination>
 <note><!-- 0..* Annotation Information about the dispense --></note>
 <usageInstruction value="[markdown]"/><!-- 0..1 Full representation of the usage instructions -->
 <eventHistory><!-- 0..* Reference(Provenance) A list of relevant lifecycle events --></eventHistory>
</DeviceDispense>

JSON Template

{doco
  "resourceType" : "DeviceDispense",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // Business identifier for this dispensation
  "basedOn" : [{ Reference(CarePlan|DeviceRequest) }], // The order or request that this dispense is fulfilling
  "partOf" : [{ Reference(Procedure) }], // The bigger event that this dispense is a part of
  "status" : "<code>", // R!  preparation | in-progress | cancelled | on-hold | completed | entered-in-error | stopped | declined | unknown
  "statusReason" : { CodeableReference(DetectedIssue) }, // Why a dispense was or was not performed
  "category" : [{ CodeableConcept }], // Type of device dispense
  "device" : { CodeableReference(Device|DeviceDefinition) }, // R!  What device was supplied
  "subject" : { Reference(Patient|Practitioner) }, // R!  Who the dispense is for
  "receiver" : { Reference(Location|Patient|Practitioner|PractitionerRole|
   RelatedPerson) }, // Who collected the device or where the medication was delivered
  "encounter" : { Reference(Encounter) }, // Encounter associated with event
  "supportingInformation" : [{ Reference(Any) }], // Information that supports the dispensing of the device
  "performer" : [{ // Who performed event
    "function" : { CodeableConcept }, // Who performed the dispense and what they did
    "actor" : { Reference(CareTeam|Device|Organization|Patient|Practitioner|
    PractitionerRole|RelatedPerson) } // R!  Individual who was performing
  }],
  "location" : { Reference(Location) }, // Where the dispense occurred
  "type" : { CodeableConcept }, // Trial fill, partial fill, emergency fill, etc
  "quantity" : { Quantity(SimpleQuantity) }, // Amount dispensed
  "preparedDate" : "<dateTime>", // When product was packaged and reviewed
  "whenHandedOver" : "<dateTime>", // When product was given out
  "destination" : { Reference(Location) }, // Where the device was sent or should be sent
  "note" : [{ Annotation }], // Information about the dispense
  "usageInstruction" : "<markdown>", // Full representation of the usage instructions
  "eventHistory" : [{ Reference(Provenance) }] // A list of relevant lifecycle events
}

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:DeviceDispense;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:identifier  ( [ Identifier ] ... ) ; # 0..* Business identifier for this dispensation
  fhir:basedOn  ( [ Reference(CarePlan|DeviceRequest) ] ... ) ; # 0..* The order or request that this dispense is fulfilling
  fhir:partOf  ( [ Reference(Procedure) ] ... ) ; # 0..* The bigger event that this dispense is a part of
  fhir:status [ code ] ; # 1..1 preparation | in-progress | cancelled | on-hold | completed | entered-in-error | stopped | declined | unknown
  fhir:statusReason [ CodeableReference(DetectedIssue) ] ; # 0..1 Why a dispense was or was not performed
  fhir:category  ( [ CodeableConcept ] ... ) ; # 0..* Type of device dispense
  fhir:device [ CodeableReference(Device|DeviceDefinition) ] ; # 1..1 What device was supplied
  fhir:subject [ Reference(Patient|Practitioner) ] ; # 1..1 Who the dispense is for
  fhir:receiver [ Reference(Location|Patient|Practitioner|PractitionerRole|RelatedPerson) ] ; # 0..1 Who collected the device or where the medication was delivered
  fhir:encounter [ Reference(Encounter) ] ; # 0..1 Encounter associated with event
  fhir:supportingInformation  ( [ Reference(Any) ] ... ) ; # 0..* Information that supports the dispensing of the device
  fhir:performer ( [ # 0..* Who performed event
    fhir:function [ CodeableConcept ] ; # 0..1 Who performed the dispense and what they did
    fhir:actor [ Reference(CareTeam|Device|Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) ] ; # 1..1 Individual who was performing
  ] ... ) ;
  fhir:location [ Reference(Location) ] ; # 0..1 Where the dispense occurred
  fhir:type [ CodeableConcept ] ; # 0..1 Trial fill, partial fill, emergency fill, etc
  fhir:quantity [ Quantity(SimpleQuantity) ] ; # 0..1 Amount dispensed
  fhir:preparedDate [ dateTime ] ; # 0..1 When product was packaged and reviewed
  fhir:whenHandedOver [ dateTime ] ; # 0..1 When product was given out
  fhir:destination [ Reference(Location) ] ; # 0..1 Where the device was sent or should be sent
  fhir:note  ( [ Annotation ] ... ) ; # 0..* Information about the dispense
  fhir:usageInstruction [ markdown ] ; # 0..1 Full representation of the usage instructions
  fhir:eventHistory  ( [ Reference(Provenance) ] ... ) ; # 0..* A list of relevant lifecycle events
]

Changes from both R4 and R4B

This resource did not exist in Release R4

See the Full Difference for further information

This analysis is available for R4 as XML or JSON and for R4B as XML or JSON.

 

Additional definitions: Master Definition XML + JSON, XML Schema/Schematron + JSON Schema, ShEx (for Turtle) + see the extensions, the spreadsheet version & the dependency analysis

12.25.4.1 Terminology Bindings

PathValueSetTypeDocumentation
DeviceDispense.status DeviceDispenseStatusCodes Required

DeviceDispense Status Codes
DeviceDispense.statusReason DeviceDispenseStatusReasonCodes Example

DeviceDispense Status Reason Codes

12.25.5 Search Parameters

Search parameters for this resource. See also the full list of search parameters for this resource, and check the Extensions registry for search parameters on extensions related to this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.

NameTypeDescriptionExpressionIn Common
codetokenSearch for devices that match this codeDeviceDispense.device.concept
identifiertokenThe identifier of the dispenseDeviceDispense.identifier
patientreferenceReturns device dispenses for a specific patientDeviceDispense.subject.where(resolve() is Patient)
(Patient)
statustokenThe status of the dispenseDeviceDispense.status
subjectreferenceThe identity of a patient for whom to list dispensesDeviceDispense.subject
(Practitioner, Patient)