FHIR CI-Build

This is the Continuous Integration Build of FHIR (will be incorrect/inconsistent at times).
See the Directory of published versions icon

12.28 Resource SupplyDelivery - Content

Orders and Observations icon Work GroupMaturity Level: 1 Trial UseSecurity Category: Patient Compartments: Patient, Practitioner

Record of movement of supplies from one location to another.

12.28.1 Scope and Usage

Note to Implementers: This resource can represent different stages of supply delivery. After a request to create two separate resources to address dispatch vs. reception, current discussion concluded that one resource with multiple, extensible stages provided a better approach to support the variety of needs to document the different steps. HL7 seeks specific feedback on the implementability of one resource type with multiple stages (likely represented in a future IG with specific profiles to determine specific attributes/value sets applicable to each stage - see valueset-supplydelivery-stage), or whether two (or more) resource types would be more adequate.

This resource is an event resource from a FHIR workflow perspective - see Workflow. It is the intent of the Orders and Observation Workgroup to align this resource with the workflow pattern for event resources.

The SupplyDelivery is used to document actual movement of supplies (e.g., medications, devices, substances, biologically derived products) from one location to another, where the intended patient or person (e.g., doctor) may also be known. This includes supplies specifically used in the treatment of patients as well as supply movement within an institution (transport a set of supplies from materials management to a service unit (nurse station). This resource does not include the provisioning of transportation services. The SupplyDelivery does not imply that this supply has already been dispensed to the that patient or person, while it could be reserved for that patient or person. Those associations are done in dedicated resources such as the MedicationDispense and DeviceDispense.

Sample use cases include:

  • Movement of bulk supplies between locations
  • Receipt of bulk supplies
  • Rejection of a delivery due to item condition
  • Noting the loss of a delivery due to transportation failure

The SupplyDelivery enables the documentation of the one or more relevant stages, such as dispatch of and reception of a shipment. One may opt to document multiple stages given a particular use case, e.g., shipments of biologically derived products in a tightly controlled process, or only use a singular stage to summarize the shipment. Examples would include the dispatch and reception stages that in certain use cases need to be documented separately using two or more instances.

12.28.2 Boundaries and Relationships

This resource has a boundary with DeviceDispense and Medicationdispense: The DeviceDispense and MedicationDispense resources are used to associate the device or medication with the specific patient for their use, while SupplyDelivery is solely focused on location and movement where the targeted patient or other person (e.g., devices used by a clinician), if included, are for delivery context only.

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.28.3 References to this Resource

12.28.4 Resource Content

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. SupplyDelivery TU DomainResource Record of movement of supplies from one location to another

Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... identifier 0..* Identifier External identifier

... basedOn Σ 0..* Reference(SupplyRequest) Fulfills plan, proposal or order

... partOf Σ 0..* Reference(SupplyDelivery | Contract) Part of referenced event

... patient 0..1 Reference(Patient) Patient for whom the item is supplied
... type 0..1 CodeableConcept Category of supply event
Binding: Supply Delivery Supply Item Type (Extensible)
... stage Σ 1..1 CodeableConcept Stage or event of delivery
Binding: Supply Delivery Stage (Extensible)
... suppliedItem 0..* BackboneElement The item that is delivered or supplied

.... quantity 0..1 SimpleQuantity Amount supplied
.... condition 0..1 CodeableConcept A description of the supplied item's condition (e.g., box is damaged)
Binding: Supply Delivery Supply Item Condition (Example)
.... item[x] 0..1 Medication, Substance, Device or Biologically Derived Product supplied
Binding: Supply Delivery Supply Item Type (Example)
..... itemCodeableConcept CodeableConcept
..... itemReference Reference(Medication | Substance | Device | BiologicallyDerivedProduct | NutritionProduct | InventoryItem)
... occurrence[x] Σ 0..1 When event occurred
.... occurrenceDateTime dateTime
.... occurrencePeriod Period
.... occurrenceTiming Timing
... supplier 0..1 Reference(Practitioner | PractitionerRole | Organization) The item supplier
... destination 0..1 Reference(Location | Practitioner | PractitionerRole | Organization) Where the delivery was sent
... receiver 0..* Reference(Practitioner | PractitionerRole | Organization) Who received the delivery


doco Documentation for this format icon

See the Extensions for this resource

 

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

12.28.4.1 Terminology Bindings

Path ValueSet Type Documentation
SupplyDelivery.status SupplyDeliveryStatus Required

Status of the supply delivery.
SupplyDelivery.type SupplyDeliverySupplyItemType Extensible

This value sets refers to a specific supply item.
SupplyDelivery.stage SupplyDeliveryStage Extensible

Stage of the supply delivery.
SupplyDelivery.suppliedItem.condition SupplyDeliverySupplyItemCondition Example

This value sets refers to the condition of a specific supply item.
SupplyDelivery.suppliedItem.item[x] SupplyDeliverySupplyItemType Example

This value sets refers to a specific supply item.

12.28.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.

Name Type Description Expression In Common
identifier token External identifier SupplyDelivery.identifier 65 Resources
patient reference Patient for whom the item is supplied SupplyDelivery.patient
(Patient)		 65 Resources
receiver reference Who collected the Supply SupplyDelivery.receiver
(Practitioner, Organization, PractitionerRole)
status token in-progress | completed | abandoned | entered-in-error SupplyDelivery.status
supplier reference Dispenser SupplyDelivery.supplier
(Practitioner, Organization, PractitionerRole)