description: Indicates that a device is to be or has been dispensed for a named person/patient.  This includes a description of the product (supply) provided and the instructions for using the device.
package_name: hl7.fhir.uv.oo-incubator
derivation: specialization
name: DeviceDispense
type: DeviceDispense
elements:
  category: {short: Type of device dispense, type: CodeableConcept, array: true, index: 5}
  whenHandedOver: {short: When product was given out, type: dateTime, index: 18}
  usageInstruction: {type: markdown, short: Full representation of the usage instructions, index: 21}
  relevantHistory:
    short: A list of relevant lifecycle events
    refers: ['http://hl7.org/fhir/StructureDefinition/Provenance']
    type: Reference
    array: true
    index: 22
  encounter:
    short: Encounter associated with event
    refers: ['http://hl7.org/fhir/StructureDefinition/Encounter']
    type: Reference
    index: 9
  preparedDate: {short: When product was packaged and reviewed, type: dateTime, isSummary: true, index: 17}
  type: {type: CodeableConcept, short: 'Trial fill, partial fill, emergency fill, etc', index: 15}
  statusReason:
    short: Why a dispense was or was not performed
    type: CodeableReference
    binding: {strength: example, valueSet: 'http://hl7.org/fhir/uv/oo-incubator/ValueSet/devicedispense-status-reason'}
    index: 4
  note: {type: Annotation, short: Information about the dispense, array: true, index: 20}
  supportingInformation:
    short: Information that supports the dispensing of the device
    refers: ['http://hl7.org/fhir/StructureDefinition/Resource']
    type: Reference
    array: true
    index: 10
  status:
    isModifier: true
    short: preparation | in-progress | cancelled | on-hold | completed | entered-in-error | stopped | declined | unknown
    type: code
    binding: {strength: required, valueSet: 'http://hl7.org/fhir/uv/oo-incubator/ValueSet/devicedispense-status'}
    isModifierReason: This element is labelled as a modifier because it is a status element that contains status entered-in-error which means that the resource should not be treated as valid
    isSummary: true
    index: 3
  identifier: {short: Business identifier for this dispensation, type: Identifier, array: true, isSummary: true, index: 0}
  device: {short: What device was supplied, type: CodeableReference, isSummary: true, index: 6}
  basedOn:
    short: The order or request that this dispense is fulfilling
    refers: ['http://hl7.org/fhir/StructureDefinition/CarePlan', 'http://hl7.org/fhir/StructureDefinition/DeviceRequest']
    type: Reference
    array: true
    index: 1
  quantity: {type: Quantity, short: Amount dispensed, index: 16}
  partOf:
    short: The bigger event that this dispense is a part of
    refers: ['http://hl7.org/fhir/StructureDefinition/Procedure']
    type: Reference
    array: true
    index: 2
  location:
    short: Where the dispense occurred
    refers: ['http://hl7.org/fhir/StructureDefinition/Location']
    type: Reference
    index: 14
  receiver:
    short: Who collected the device or where the medication was delivered
    refers: ['http://hl7.org/fhir/StructureDefinition/Group', 'http://hl7.org/fhir/StructureDefinition/Location', 'http://hl7.org/fhir/StructureDefinition/Patient', 'http://hl7.org/fhir/StructureDefinition/Practitioner', 'http://hl7.org/fhir/StructureDefinition/PractitionerRole', 'http://hl7.org/fhir/StructureDefinition/RelatedPerson']
    type: Reference
    index: 8
  subject:
    short: Who the dispense is for
    refers: ['http://hl7.org/fhir/StructureDefinition/Group', 'http://hl7.org/fhir/StructureDefinition/Patient', 'http://hl7.org/fhir/StructureDefinition/Practitioner']
    type: Reference
    isSummary: true
    index: 7
  destination:
    short: Where the device was sent or should be sent
    refers: ['http://hl7.org/fhir/StructureDefinition/Location']
    type: Reference
    index: 19
  performer:
    type: BackboneElement
    short: Who performed event
    array: true
    index: 11
    elements:
      function: {short: Who performed the dispense and what they did, type: CodeableConcept, index: 12}
      actor:
        short: Individual who was performing
        refers: ['http://hl7.org/fhir/StructureDefinition/CareTeam', 'http://hl7.org/fhir/StructureDefinition/Device', 'http://hl7.org/fhir/StructureDefinition/Group', 'http://hl7.org/fhir/StructureDefinition/Organization', 'http://hl7.org/fhir/StructureDefinition/Patient', 'http://hl7.org/fhir/StructureDefinition/Practitioner', 'http://hl7.org/fhir/StructureDefinition/PractitionerRole', 'http://hl7.org/fhir/StructureDefinition/RelatedPerson']
        type: Reference
        index: 13
    required: [actor]
package_version: 0.1.0-snapshot
class: resource
kind: resource
url: http://hl7.org/fhir/StructureDefinition/DeviceDispense
base: http://hl7.org/fhir/StructureDefinition/DomainResource
version: 0.1.0-snapshot
required: [device, status, subject]