This page is part of the FHIR Specification (v4.0.1: R4 - Mixed Normative and STU) in it's permanent home (it will always be available at this URL). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2
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 and itself
Structure
UML Diagram (Legend)
XML Template
<SupplyDelivery xmlns="http://hl7.org/fhir"> <!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..* Identifier External identifier --></identifier> <basedOn><!-- 0..* Reference(SupplyRequest) Fulfills plan, proposal or order --></basedOn> <partOf><!-- 0..* Reference(SupplyDelivery|Contract) 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]><!-- 0..1 CodeableConcept|Reference(Medication|Substance|Device) Medication, Substance, or Device supplied --></item[x]> </suppliedItem> <occurrence[x]><!-- 0..1 dateTime|Period|Timing When event occurred --></occurrence[x]> <supplier><!-- 0..1 Reference(Practitioner|PractitionerRole|Organization) Dispenser --></supplier> <destination><!-- 0..1 Reference(Location) Where the Supply was sent --></destination> <receiver><!-- 0..* Reference(Practitioner|PractitionerRole) Who collected the Supply --></receiver> </SupplyDelivery>
JSON Template
{ "resourceType" : "SupplyDelivery", // from Resource: id, meta, implicitRules, and language // from DomainResource: text, contained, extension, and modifierExtension "identifier" : [{ Identifier }], // External identifier "basedOn" : [{ Reference(SupplyRequest) }], // Fulfills plan, proposal or order "partOf" : [{ Reference(SupplyDelivery|Contract) }], // Part of referenced event "status" : "<code>", // in-progress | completed | abandoned | entered-in-error "patient" : { Reference(Patient) }, // Patient for whom the item is supplied "type" : { CodeableConcept }, // Category of dispense event "suppliedItem" : { // The item that is delivered or supplied "quantity" : { Quantity(SimpleQuantity) }, // Amount dispensed // item[x]: Medication, Substance, or Device supplied. One of these 2: "itemCodeableConcept" : { CodeableConcept } "itemReference" : { Reference(Medication|Substance|Device) } }, // occurrence[x]: When event occurred. One of these 3: "occurrenceDateTime" : "<dateTime>", "occurrencePeriod" : { Period }, "occurrenceTiming" : { Timing }, "supplier" : { Reference(Practitioner|PractitionerRole|Organization) }, // Dispenser "destination" : { Reference(Location) }, // Where the Supply was sent "receiver" : [{ Reference(Practitioner|PractitionerRole) }] // Who collected the Supply }
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> . [ 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:SupplyDelivery.identifier [ Identifier ], ... ; # 0..* External identifier fhir:SupplyDelivery.basedOn [ Reference(SupplyRequest) ], ... ; # 0..* Fulfills plan, proposal or order fhir:SupplyDelivery.partOf [ Reference(SupplyDelivery|Contract) ], ... ; # 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:SupplyDelivery.suppliedItem.itemReference [ Reference(Medication|Substance|Device) ] ]; # 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:SupplyDelivery.supplier [ Reference(Practitioner|PractitionerRole|Organization) ]; # 0..1 Dispenser fhir:SupplyDelivery.destination [ Reference(Location) ]; # 0..1 Where the Supply was sent fhir:SupplyDelivery.receiver [ Reference(Practitioner|PractitionerRole) ], ... ; # 0..* Who collected the Supply ]
Changes since R3
SupplyDelivery | |
SupplyDelivery.identifier |
|
SupplyDelivery.status |
|
SupplyDelivery.type |
|
SupplyDelivery.supplier |
|
SupplyDelivery.receiver |
|
See the Full Difference for further information
This analysis is available as XML or JSON.
See R3 <--> R4 Conversion Maps (status = 2 tests that all execute ok. All tests pass round-trip testing and all r3 resources are valid.)
Structure
XML Template
<SupplyDelivery xmlns="http://hl7.org/fhir"> <!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..* Identifier External identifier --></identifier> <basedOn><!-- 0..* Reference(SupplyRequest) Fulfills plan, proposal or order --></basedOn> <partOf><!-- 0..* Reference(SupplyDelivery|Contract) 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]><!-- 0..1 CodeableConcept|Reference(Medication|Substance|Device) Medication, Substance, or Device supplied --></item[x]> </suppliedItem> <occurrence[x]><!-- 0..1 dateTime|Period|Timing When event occurred --></occurrence[x]> <supplier><!-- 0..1 Reference(Practitioner|PractitionerRole|Organization) Dispenser --></supplier> <destination><!-- 0..1 Reference(Location) Where the Supply was sent --></destination> <receiver><!-- 0..* Reference(Practitioner|PractitionerRole) Who collected the Supply --></receiver> </SupplyDelivery>
JSON Template
{ "resourceType" : "SupplyDelivery", // from Resource: id, meta, implicitRules, and language // from DomainResource: text, contained, extension, and modifierExtension "identifier" : [{ Identifier }], // External identifier "basedOn" : [{ Reference(SupplyRequest) }], // Fulfills plan, proposal or order "partOf" : [{ Reference(SupplyDelivery|Contract) }], // Part of referenced event "status" : "<code>", // in-progress | completed | abandoned | entered-in-error "patient" : { Reference(Patient) }, // Patient for whom the item is supplied "type" : { CodeableConcept }, // Category of dispense event "suppliedItem" : { // The item that is delivered or supplied "quantity" : { Quantity(SimpleQuantity) }, // Amount dispensed // item[x]: Medication, Substance, or Device supplied. One of these 2: "itemCodeableConcept" : { CodeableConcept } "itemReference" : { Reference(Medication|Substance|Device) } }, // occurrence[x]: When event occurred. One of these 3: "occurrenceDateTime" : "<dateTime>", "occurrencePeriod" : { Period }, "occurrenceTiming" : { Timing }, "supplier" : { Reference(Practitioner|PractitionerRole|Organization) }, // Dispenser "destination" : { Reference(Location) }, // Where the Supply was sent "receiver" : [{ Reference(Practitioner|PractitionerRole) }] // Who collected the Supply }
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> . [ 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:SupplyDelivery.identifier [ Identifier ], ... ; # 0..* External identifier fhir:SupplyDelivery.basedOn [ Reference(SupplyRequest) ], ... ; # 0..* Fulfills plan, proposal or order fhir:SupplyDelivery.partOf [ Reference(SupplyDelivery|Contract) ], ... ; # 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:SupplyDelivery.suppliedItem.itemReference [ Reference(Medication|Substance|Device) ] ]; # 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:SupplyDelivery.supplier [ Reference(Practitioner|PractitionerRole|Organization) ]; # 0..1 Dispenser fhir:SupplyDelivery.destination [ Reference(Location) ]; # 0..1 Where the Supply was sent fhir:SupplyDelivery.receiver [ Reference(Practitioner|PractitionerRole) ], ... ; # 0..* Who collected the Supply ]
Changes since Release 3
SupplyDelivery | |
SupplyDelivery.identifier |
|
SupplyDelivery.status |
|
SupplyDelivery.type |
|
SupplyDelivery.supplier |
|
SupplyDelivery.receiver |
|
See the Full Difference for further information
This analysis is available as XML or JSON.
See R3 <--> R4 Conversion Maps (status = 2 tests that all execute ok. All tests pass round-trip testing and all r3 resources are valid.)
See the Profiles & Extensions and the alternate definitions: Master Definition XML + JSON, XML Schema/Schematron + JSON Schema, ShEx (for Turtle) + see the extensions & the dependency analysis
Path | Definition | Type | Reference |
---|---|---|---|
SupplyDelivery.status | Status of the supply delivery. | Required | SupplyDeliveryStatus |
SupplyDelivery.type | The type of supply dispense. | Required | SupplyItemType |
SupplyDelivery.suppliedItem.item[x] | The item that was delivered. | Example | 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 | 30 Resources |
patient | reference | Patient for whom the item is supplied | SupplyDelivery.patient (Patient) | 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) |