Electronic Prescription Service (EPS) Implementation Guide

dispense-notification

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

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

MessageHeader.eventCoding

System Code
Message Events dispense-notification
"eventCoding": {
    "system": "https://fhir.nhs.uk/CodeSystem/message-event",
    "code": "dispense-notification",
    "display": "Dispense Notification"
}

MessageHeader.response

Mandatory UUID from the prescription release response Parameters.id that contained the prescription being dispensed.

"response": {
    "identifier": "a5d77265-8ba5-4c74-b8ce-ea0dbaafbdb8",
    "code": "ok"
}

MessageHeader.focus

Profile Min Max Notes
NHSDigital-MedicationDispense
See note below
1 * Multiple instances of this resource are used when more than one product have been dispensed for the single prescribed medication. For example different brands (AMP/AMPP) of the same generic drug (VMP).
Response Required
always
Allowed Responses
NHSDigital-OperationOutcome
<MessageDefinition xmlns="http://hl7.org/fhir">
<id value="bf729ea8-280b-4109-b2f5-02ce8e51d870" />
<url value="https://fhir.nhs.uk/MessageDefinition/dispense-notification" />
<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" />
<system value="https://fhir.nhs.uk/CodeSystem/message-event" />
<code value="dispense-notification" />
<display value="Dispense Notification" />
</eventCoding>
<category value="notification" />
<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",
{
"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",
"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": "*"
}
]
}

Note

The underlying conformance profile for the NHSDigital-MedicationDispense is https://fhir.nhs.uk/StructureDefinition/NHSDigital-MedicationDispense-Message. This profile mandates the use of a contained resource for authorizingPrescription.

image-message-dispense-notification

back to top