FHIR Release 3 (STU) Current Build
This page is part of FHIR STU 3 (v3.0.1) in it's permanent home (it will always be available at this URL). It has been superceded by R4 . For a full list of available versions, see the Directory of published versions .

12.25 Resource SupplyDelivery - Content

Orders and Observations Work Group Maturity Level : 1   Trial Use Security Category : Patient Compartments : Patient , Practitioner

Record of delivery of what is supplied.

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 scope of the supply resource is for supplies used in the healthcare process. 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.

This resource overlaps with others such as Device and Medication . The Supply resource may be used to describe medications and devices when handling them generically (as any other supply). For example, when processing bulk orders, etc. However, when the medication, device or other aspects of the resource are important, (e.g. in a MedicationRequest or when identifying a device as a performer), the more detailed resource must be used.

This resource is referenced by chargeitem ChargeItem and itself.

This resource implements the Event pattern.

Structure

Name Flags Card. Type Description & Constraints doco
. . SupplyDelivery TU DomainResource Delivery of bulk Supplies
Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension
. . . identifier 0..1 0..* Identifier External identifier
. . . basedOn Σ 0..* Reference ( SupplyRequest ) Fulfills plan, proposal or order
. . . partOf Σ 0..* Reference ( SupplyDelivery | Contract ) Part of referenced event
. . . status ?! Σ 0..1 code in-progress | completed | abandoned | entered-in-error
SupplyDeliveryStatus ( Required )
. . . patient 0..1 Reference ( Patient ) Patient for whom the item is supplied
. . . type 0..1 CodeableConcept Category of dispense event
Supply Item Type ( Required )
. . . suppliedItem 0..1 BackboneElement The item that is delivered or supplied
. . . . quantity 0..1 SimpleQuantity Amount dispensed
. . . . item[x] 0..1 Medication, Substance, or Device supplied
SNOMED CT Supply Item ( Example )
. . . . . itemCodeableConcept CodeableConcept
. . . . . itemReference Reference ( Medication | Substance | Device )
. . . occurrence[x] Σ 0..1 When event occurred
. . . . occurrenceDateTime dateTime
. . . . occurrencePeriod Period
. . . . occurrenceTiming Timing
. . . supplier 0..1 Reference ( Practitioner | PractitionerRole | Organization ) Dispenser
. . . destination 0..1 Reference ( Location ) Where the Supply was sent
. . . receiver 0..* Reference ( Practitioner | PractitionerRole ) Who collected the Supply

doco Documentation for this format

UML Diagram ( Legend )

SupplyDelivery ( DomainResource ) Identifier assigned by the dispensing facility when for the item(s) supply delivery event that is dispensed used to identify it across multiple disparate systems identifier : Identifier [0..1] [0..*] A plan, proposal or order that is fulfilled in whole or in part by this event basedOn : Reference [0..*] « SupplyRequest » A larger event of which this particular event is a component or step partOf : Reference [0..*] « SupplyDelivery | Contract » A code specifying the state of the dispense event (this element modifies the meaning of other elements) status : code [0..1] « Status of the supply delivery. (Strength=Required) SupplyDeliveryStatus ! » A link to a resource representing the person whom the delivered item is for patient : Reference [0..1] « Patient » Indicates the type of dispensing event that is performed. Examples include: Trial Fill, Completion of Trial, Partial Fill, Emergency Fill, Samples, etc type : CodeableConcept [0..1] « The type of supply dispense. (Strength=Required) Supply Item Type SupplyItemType ! » The date or time(s) the activity occurred occurrence[x] : Type [0..1] « dateTime | Period | Timing » The individual responsible for dispensing the medication, supplier or device supplier : Reference [0..1] « Practitioner | PractitionerRole | Organization » Identification of the facility/location where the Supply was shipped to, as part of the dispense event destination : Reference [0..1] « Location » Identifies the person who picked up the Supply receiver : Reference [0..*] « Practitioner | PractitionerRole » SuppliedItem The amount of supply that has been dispensed. Includes unit of measure quantity : Quantity ( SimpleQuantity ) [0..1] Identifies the medication, substance or device being dispensed. This is either a link to a resource representing the details of the item or a code that identifies the item from a known list item[x] : Type [0..1] « CodeableConcept | Reference ( Medication | Substance | Device ); The item that was delivered. (Strength=Example) SNOMED CT Supply Item SNOMEDCTSupplyItem ?? » The item that is being delivered or has been supplied suppliedItem [0..1]

XML Template

<SupplyDelivery xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <</identifier>

 <identifier><!-- 0..* Identifier External identifier --></identifier>

 <basedOn><!-- 0..* Reference(SupplyRequest) Fulfills plan, proposal or order --></basedOn>
 <</partOf>

 <partOf><!-- 0..* Reference(Contract|SupplyDelivery) Part of referenced event --></partOf>

 <status value="[code]"/><!-- 0..1 in-progress | completed | abandoned | entered-in-error -->
 <patient><!-- 0..1 Reference(Patient) Patient for whom the item is supplied --></patient>
 <type><!-- 0..1 CodeableConcept Category of dispense event --></type>
 <suppliedItem>  <!-- 0..1 The item that is delivered or supplied -->
  <quantity><!-- 0..1 Quantity(SimpleQuantity) Amount dispensed --></quantity>
  <</item[x]>

  <item[x]><!-- 0..1 CodeableConcept|Reference(Device|Medication|Substance) Medication, Substance, or Device supplied --></item[x]>

 </suppliedItem>
 <occurrence[x]><!-- 0..1 dateTime|Period|Timing When event occurred --></occurrence[x]>
 <</supplier>

 <supplier><!-- 0..1 Reference(Organization|Practitioner|PractitionerRole) Dispenser --></supplier>

 <destination><!-- 0..1 Reference(Location) Where the Supply was sent --></destination>
 <</receiver>

 <receiver><!-- 0..* Reference(Practitioner|PractitionerRole) Who collected the Supply --></receiver>

</SupplyDelivery>

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .doco
[ a fhir:SupplyDelivery;
  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:

  fhir:SupplyDelivery.identifier [ Identifier ], ... ; # 0..* External identifier

  fhir:SupplyDelivery.basedOn [ Reference(SupplyRequest) ], ... ; # 0..* Fulfills plan, proposal or order
  fhir:

  fhir:SupplyDelivery.partOf [ Reference(Contract|SupplyDelivery) ], ... ; # 0..* Part of referenced event

  fhir:SupplyDelivery.status [ code ]; # 0..1 in-progress | completed | abandoned | entered-in-error
  fhir:SupplyDelivery.patient [ Reference(Patient) ]; # 0..1 Patient for whom the item is supplied
  fhir:SupplyDelivery.type [ CodeableConcept ]; # 0..1 Category of dispense event
  fhir:SupplyDelivery.suppliedItem [ # 0..1 The item that is delivered or supplied
    fhir:SupplyDelivery.suppliedItem.quantity [ Quantity(SimpleQuantity) ]; # 0..1 Amount dispensed
    # SupplyDelivery.suppliedItem.item[x] : 0..1 Medication, Substance, or Device supplied. One of these 2
      fhir:SupplyDelivery.suppliedItem.itemCodeableConcept [ CodeableConcept ]
      fhir:) ]

      fhir:SupplyDelivery.suppliedItem.itemReference [ Reference(Device|Medication|Substance) ]

  ];
  # SupplyDelivery.occurrence[x] : 0..1 When event occurred. One of these 3
    fhir:SupplyDelivery.occurrenceDateTime [ dateTime ]
    fhir:SupplyDelivery.occurrencePeriod [ Period ]
    fhir:SupplyDelivery.occurrenceTiming [ Timing ]
  fhir:

  fhir:SupplyDelivery.supplier [ Reference(Organization|Practitioner|PractitionerRole) ]; # 0..1 Dispenser

  fhir:SupplyDelivery.destination [ Reference(Location) ]; # 0..1 Where the Supply was sent
  fhir:

  fhir:SupplyDelivery.receiver [ Reference(Practitioner|PractitionerRole) ], ... ; # 0..* Who collected the Supply

]

Changes since DSTU2 R3

SupplyDelivery SupplyDelivery.basedOn Added Element SupplyDelivery.partOf Added Element
SupplyDelivery.suppliedItem Remove Reference(Medication), Remove Reference(Substance), Remove Reference(Device) SupplyDelivery.suppliedItem.quantity Added Element SupplyDelivery.suppliedItem.item[x] Added Element SupplyDelivery.occurrence[x] SupplyDelivery.status
  • Added Element Change value set from http://hl7.org/fhir/ValueSet/supplydelivery-status|4.0.0 to http://hl7.org/fhir/ValueSet/supplydelivery-status|4.1.0
SupplyDelivery.supplier Add Reference(Organization) SupplyDelivery.quantity deleted SupplyDelivery.whenPrepared deleted SupplyDelivery.time SupplyDelivery.type
  • deleted Change value set from http://hl7.org/fhir/ValueSet/supplydelivery-type|4.0.0 to http://hl7.org/fhir/ValueSet/supplydelivery-type|4.1.0

See the Full Difference for further information

This analysis is available as XML or JSON .

See R2 <--> R3 <--> R4 Conversion Maps (status = 1 test 2 tests that all execute ok. All tests pass round-trip testing and all r3 resources are valid.). valid.)

Structure

Name Flags Card. Type Description & Constraints doco
. . SupplyDelivery TU DomainResource Delivery of bulk Supplies
Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension
. . . identifier 0..1 0..* Identifier External identifier
. . . basedOn Σ 0..* Reference ( SupplyRequest ) Fulfills plan, proposal or order
. . . partOf Σ 0..* Reference ( SupplyDelivery | Contract ) Part of referenced event
. . . status ?! Σ 0..1 code in-progress | completed | abandoned | entered-in-error
SupplyDeliveryStatus ( Required )
. . . patient 0..1 Reference ( Patient ) Patient for whom the item is supplied
. . . type 0..1 CodeableConcept Category of dispense event
Supply Item Type ( Required )
. . . suppliedItem 0..1 BackboneElement The item that is delivered or supplied
. . . . quantity 0..1 SimpleQuantity Amount dispensed
. . . . item[x] 0..1 Medication, Substance, or Device supplied
SNOMED CT Supply Item ( Example )
. . . . . itemCodeableConcept CodeableConcept
. . . . . itemReference Reference ( Medication | Substance | Device )
. . . occurrence[x] Σ 0..1 When event occurred
. . . . occurrenceDateTime dateTime
. . . . occurrencePeriod Period
. . . . occurrenceTiming Timing
. . . supplier 0..1 Reference ( Practitioner | PractitionerRole | Organization ) Dispenser
. . . destination 0..1 Reference ( Location ) Where the Supply was sent
. . . receiver 0..* Reference ( Practitioner | PractitionerRole ) Who collected the Supply

doco Documentation for this format

UML Diagram ( Legend )

SupplyDelivery ( DomainResource ) Identifier assigned by the dispensing facility when for the item(s) supply delivery event that is dispensed used to identify it across multiple disparate systems identifier : Identifier [0..1] [0..*] A plan, proposal or order that is fulfilled in whole or in part by this event basedOn : Reference [0..*] « SupplyRequest » A larger event of which this particular event is a component or step partOf : Reference [0..*] « SupplyDelivery | Contract » A code specifying the state of the dispense event (this element modifies the meaning of other elements) status : code [0..1] « Status of the supply delivery. (Strength=Required) SupplyDeliveryStatus ! » A link to a resource representing the person whom the delivered item is for patient : Reference [0..1] « Patient » Indicates the type of dispensing event that is performed. Examples include: Trial Fill, Completion of Trial, Partial Fill, Emergency Fill, Samples, etc type : CodeableConcept [0..1] « The type of supply dispense. (Strength=Required) Supply Item Type SupplyItemType ! » The date or time(s) the activity occurred occurrence[x] : Type [0..1] « dateTime | Period | Timing » The individual responsible for dispensing the medication, supplier or device supplier : Reference [0..1] « Practitioner | PractitionerRole | Organization » Identification of the facility/location where the Supply was shipped to, as part of the dispense event destination : Reference [0..1] « Location » Identifies the person who picked up the Supply receiver : Reference [0..*] « Practitioner | PractitionerRole » SuppliedItem The amount of supply that has been dispensed. Includes unit of measure quantity : Quantity ( SimpleQuantity ) [0..1] Identifies the medication, substance or device being dispensed. This is either a link to a resource representing the details of the item or a code that identifies the item from a known list item[x] : Type [0..1] « CodeableConcept | Reference ( Medication | Substance | Device ); The item that was delivered. (Strength=Example) SNOMED CT Supply Item SNOMEDCTSupplyItem ?? » The item that is being delivered or has been supplied suppliedItem [0..1]

XML Template

<SupplyDelivery xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <</identifier>

 <identifier><!-- 0..* Identifier External identifier --></identifier>

 <basedOn><!-- 0..* Reference(SupplyRequest) Fulfills plan, proposal or order --></basedOn>
 <</partOf>

 <partOf><!-- 0..* Reference(Contract|SupplyDelivery) Part of referenced event --></partOf>

 <status value="[code]"/><!-- 0..1 in-progress | completed | abandoned | entered-in-error -->
 <patient><!-- 0..1 Reference(Patient) Patient for whom the item is supplied --></patient>
 <type><!-- 0..1 CodeableConcept Category of dispense event --></type>
 <suppliedItem>  <!-- 0..1 The item that is delivered or supplied -->
  <quantity><!-- 0..1 Quantity(SimpleQuantity) Amount dispensed --></quantity>
  <</item[x]>

  <item[x]><!-- 0..1 CodeableConcept|Reference(Device|Medication|Substance) Medication, Substance, or Device supplied --></item[x]>

 </suppliedItem>
 <occurrence[x]><!-- 0..1 dateTime|Period|Timing When event occurred --></occurrence[x]>
 <</supplier>

 <supplier><!-- 0..1 Reference(Organization|Practitioner|PractitionerRole) Dispenser --></supplier>

 <destination><!-- 0..1 Reference(Location) Where the Supply was sent --></destination>
 <</receiver>

 <receiver><!-- 0..* Reference(Practitioner|PractitionerRole) Who collected the Supply --></receiver>

</SupplyDelivery>

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .doco
[ a fhir:SupplyDelivery;
  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:

  fhir:SupplyDelivery.identifier [ Identifier ], ... ; # 0..* External identifier

  fhir:SupplyDelivery.basedOn [ Reference(SupplyRequest) ], ... ; # 0..* Fulfills plan, proposal or order
  fhir:

  fhir:SupplyDelivery.partOf [ Reference(Contract|SupplyDelivery) ], ... ; # 0..* Part of referenced event

  fhir:SupplyDelivery.status [ code ]; # 0..1 in-progress | completed | abandoned | entered-in-error
  fhir:SupplyDelivery.patient [ Reference(Patient) ]; # 0..1 Patient for whom the item is supplied
  fhir:SupplyDelivery.type [ CodeableConcept ]; # 0..1 Category of dispense event
  fhir:SupplyDelivery.suppliedItem [ # 0..1 The item that is delivered or supplied
    fhir:SupplyDelivery.suppliedItem.quantity [ Quantity(SimpleQuantity) ]; # 0..1 Amount dispensed
    # SupplyDelivery.suppliedItem.item[x] : 0..1 Medication, Substance, or Device supplied. One of these 2
      fhir:SupplyDelivery.suppliedItem.itemCodeableConcept [ CodeableConcept ]
      fhir:) ]

      fhir:SupplyDelivery.suppliedItem.itemReference [ Reference(Device|Medication|Substance) ]

  ];
  # SupplyDelivery.occurrence[x] : 0..1 When event occurred. One of these 3
    fhir:SupplyDelivery.occurrenceDateTime [ dateTime ]
    fhir:SupplyDelivery.occurrencePeriod [ Period ]
    fhir:SupplyDelivery.occurrenceTiming [ Timing ]
  fhir:

  fhir:SupplyDelivery.supplier [ Reference(Organization|Practitioner|PractitionerRole) ]; # 0..1 Dispenser

  fhir:SupplyDelivery.destination [ Reference(Location) ]; # 0..1 Where the Supply was sent
  fhir:

  fhir:SupplyDelivery.receiver [ Reference(Practitioner|PractitionerRole) ], ... ; # 0..* Who collected the Supply

]

Changes since DSTU2 Release 3

SupplyDelivery SupplyDelivery.basedOn Added Element SupplyDelivery.partOf Added Element
SupplyDelivery.suppliedItem Remove Reference(Medication), Remove Reference(Substance), Remove Reference(Device) SupplyDelivery.suppliedItem.quantity Added Element SupplyDelivery.suppliedItem.item[x] Added Element SupplyDelivery.occurrence[x] SupplyDelivery.status
  • Added Element Change value set from http://hl7.org/fhir/ValueSet/supplydelivery-status|4.0.0 to http://hl7.org/fhir/ValueSet/supplydelivery-status|4.1.0
SupplyDelivery.supplier Add Reference(Organization) SupplyDelivery.quantity deleted SupplyDelivery.whenPrepared deleted SupplyDelivery.time SupplyDelivery.type
  • deleted Change value set from http://hl7.org/fhir/ValueSet/supplydelivery-type|4.0.0 to http://hl7.org/fhir/ValueSet/supplydelivery-type|4.1.0

See the Full Difference for further information

This analysis is available as XML or JSON .

See R2 <--> R3 <--> R4 Conversion Maps (status = 1 test 2 tests that all execute ok. All tests pass round-trip testing and all r3 resources are valid.). valid.)

 

Alternate See the Profiles & Extensions and the alternate definitions: Master Definition ( XML , + JSON ), , XML Schema / Schematron (for ) + JSON Schema , ShEx (for Turtle ) + see the extensions , the spreadsheet version & the dependency analysis a

Path Definition Type Reference
SupplyDelivery.status Status of the supply delivery. Required SupplyDeliveryStatus
SupplyDelivery.type The type of supply dispense. Required Supply Item Type SupplyItemType
SupplyDelivery.suppliedItem.item[x] The item that was delivered. Example SNOMED CT Supply Item SNOMEDCTSupplyItem

Search parameters for 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 26 30 Resources
patient reference Patient for whom the item is supplied SupplyDelivery.patient
( Patient )
31 33 Resources
receiver reference Who collected the Supply SupplyDelivery.receiver
( Practitioner , PractitionerRole )
status token in-progress | completed | abandoned | entered-in-error SupplyDelivery.status
supplier reference Dispenser SupplyDelivery.supplier
( Practitioner , Organization , PractitionerRole )