NHS Digital FHIR Medicines

Dispense - Owings and Partial Dispensing


dispense-notification

This message definition describes the rules for a Dispense Notification interactions used in a FHIR Messaging exchange.


Event Coding

System Code
Message Events dispense-notification
Category
notification

MessageHeader

The FHIR Message Bundle MUST contain one MessageHeader resource conforming to NHSDigital-MessageHeader


Focus

Profile Min Max Notes
NHSDigital-MedicationDispense 1 *
NHSDigital-Patient 0 1 A traced NHS Number identifier MUST be present, untraced NHS Numbers are not permitted. This can be conveyed in two ways, as identifier reference in the subject element of the MedicationDispense resource or as an identifier in a Patient resource. If a NHS Number identifier is referenced in the MedicationDispense resources then a Patient resource SHOULD NOT be present in the Bundle.
<MessageDefinition xmlns="http://hl7.org/fhir">
<id value="bf729ea8-280b-4109-b2f5-02ce8e51d870" />
<url value="https://fhir.nhs.uk/MessageDefinition/dispense-notification" />
<identifier>
<system value="https://tools.ietf.org/html/rfc4122" />
<value value="bf729ea8-280b-4109-b2f5-02ce8e51d870" />
</identifier>
<version value="1.0.0" />
<name value="NHSDigitalDispenseNotification" />
<title value="Pharmacy/Treatment Dispense" />
<status value="active" />
<date value="2020-10-02" />
<description value="Notification of dispensed medication" />
<eventCoding>
<system value="https://fhir.nhs.uk/CodeSystem/message-event" />
<code value="dispense-notification" />
<display value="Dispense Notification" />
</eventCoding>
<category value="notification" />
<focus>
<code value="MedicationDispense" />
<profile value="https://fhir.nhs.uk/StructureDefinition/NHSDigital-MedicationDispense-Message" />
<min value="1" />
<max value="*" />
</focus>
</MessageDefinition>
{
"resourceType": "MessageDefinition",
"id": "bf729ea8-280b-4109-b2f5-02ce8e51d870",
"url": "https://fhir.nhs.uk/MessageDefinition/dispense-notification",
"identifier": [
{
"system": "https://tools.ietf.org/html/rfc4122",
"value": "bf729ea8-280b-4109-b2f5-02ce8e51d870"
}
],
"version": "1.0.0",
"name": "NHSDigitalDispenseNotification",
"title": "Pharmacy/Treatment Dispense",
"status": "active",
"date": "2020-10-02",
"description": "Notification of dispensed medication",
"eventCoding": {
"system": "https://fhir.nhs.uk/CodeSystem/message-event",
"code": "dispense-notification",
"display": "Dispense Notification"
},
"category": "notification",
"focus": [
{
"code": "MedicationDispense",
"profile": "https://fhir.nhs.uk/StructureDefinition/NHSDigital-MedicationDispense-Message",
"min": 1,
"max": "*"
}
]
}

1st Dispensing Event – Prescription Status: “With Dispenser – Active”

This is the first dispense notification sent by the dispenser using the FHIR Operation process-message (POST /$process-message)

1st dispense event - partial

Medication ID (SNOMED) Medication Name Dispensed Quantity Item Status
1858411000001101 Paracetamol 500mg soluble tablets (Unichem Plc) 60 t ablets 60 0003 (Partial)
3416211000001106 Salbutamol 100micrograms/dose inhaler (Sandoz Ltd) 200 dose 200 0001 (Dispensed)

2nd Dispensing Event – Prescription Status: “With Dispenser – Active”

This is the second dispense notification sent by the dispenser using the FHIR Operation process-message

The second drug has not been dispensed but it currently a requirement that empty MedicationDispense is included in the dispense-notification message. This empty uses the prescribed drug dm+d code and the following elements are not present

  • performer
  • quantity
  • daysSupply
  • whenPrepared
  • dosageInstruction

2nd dispense event - partial

Medication ID (SNOMED) Medication Name Dispensed Quantity Item Status
915611000001105 Paracetamol 500mg soluble tablets (AAH Pharmaceuticals Ltd) 24 tablets 24 0003 (Partial)
35936511000001108 Salbutamol 100micrograms/dose inhaler 0 0001 (Dispensed)

3rd Dispensing Event – Prescription Status: “Dispensed”

This is the final dispense notification sent by the dispenser using the FHIR Operation process-message

3rd dispense event - completed

Medication ID (SNOMED) Medication Name Dispensed Quantity Item Status
2274211000001101 Paracetamol 500mg soluble tablets (Kent Pharmaceuticals) 16 tablets 16 0001 (Dispensed)
35936511000001108 Salbutamol 100micrograms/dose inhaler 0 0001 (Dispensed)
back to top