Implementation guide for digital medicines

This guidance is under active development by NHS Digital and content may be added or updated on a regular basis.

Message broker acts as the FHIR server and events server

In this example, the Message Broker system is akin to a Shared Record platform an also acts as an events notification system.


(1) The prescribing system creates the MedicationRequest with a valid externally referencable identifer and POSTs this to the Message Broker. The MedicationRequest is triggered when the MedicationRequest.status = active. The message broker adds the logical id on receipt.

(2) The message broker triggers an event, to notify subscribing systems of the new MedicationRequest; the dispensing system must be a subscriber for this event.

(3) The dispensing system GETs the MedicationRequest from the shared record system using the identifer.

(4) The dispensing system creates the MedicationDispense with a valid externally referencable identifer and POSTs this to the shared record system. The MedicationDispense is triggered when the MedicationDispense.status = completed. The message broker adds the logical id on receipt.

(5) The message broker triggers an event notification to notify subscribing systems of the new MedicationDispense; the prescribing system must be a subscriber for this event.

(6) The prescribing system GETs the MedicationDispense from the message broker using the identifer.

(7) On receipt, the prescribing system can set the MedicationRequest.status = completed.


back to top