NHS England FHIR Implementation Guide (deprecated)

Important Announcement regarding this Implementation Guide
  • As of 04/10/2023, this implementation guide has been deprecated and all development on the legacy NHS England FHIR Implementation Guide assets has ceased.
  • Therefore, vendors looking to start new implementations or looking to update existing implementations should use the new NHS England Implementation Guide. Vendors continuing to implement legacy NHS England FHIR Implementation Guide based solutions do so at their own risk and on the understanding that no maintenance or support will be available.

MedicationRequest

MedicationRequest-Prescription-Example

Medication Request

{
"resourceType": "MedicationDispense",
"id": "MedicationDispense-PendingCancellation-Example",
"extension": [
{
"url": "https://fhir.nhs.uk/StructureDefinition/Extension-DM-PrescriptionNonDispensingReason",
"valueCoding": {
"system": "https://fhir.nhs.uk/CodeSystem/medicationdispense-status-reason",
"code": "0001",
"display": "Not required as instructed by the patient"
}
},
{
"url": "https://fhir.nhs.uk/StructureDefinition/Extension-EPS-TaskBusinessStatus",
"valueCoding": {
"system": "https://fhir.nhs.uk/CodeSystem/EPS-task-business-status",
"code": "0007",
"display": "Not Dispensed"
}
}
],
"status": "completed",
"medicationCodeableConcept": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "39720311000001101",
"display": "Paracetamol 500mg soluble tablets"
}
]
},
"subject": {
"reference": "Patient/Patient-StaceyTwitchett-Example",
"identifier": {
"system": "https://fhir.nhs.uk/Id/nhs-number",
"value": "5839945242"
}
},
"performer": [
{
"actor": {
"reference": "PractitionerRole/PractitionerRole-JanePittman-Example"
}
}
],
"authorizingPrescription": [
{
"reference": "MedicationRequest/MedicationRequest-RepeatPrescription-Example"
}
],
"type": {
"coding": [
{
"system": "https://fhir.nhs.uk/CodeSystem/medicationdispense-type",
"code": "0002",
"display": "Item not dispensed"
}
]
},
"quantity": {
"value": 32,
"unit": "dose",
"system": "http://snomed.info/sct",
"code": "3317411000001100"
}
}
<MedicationDispense xmlns="http://hl7.org/fhir">
<id value="MedicationDispense-PendingCancellation-Example" />
<extension url="https://fhir.nhs.uk/StructureDefinition/Extension-DM-PrescriptionNonDispensingReason">
<valueCoding>
<system value="https://fhir.nhs.uk/CodeSystem/medicationdispense-status-reason" />
<code value="0001" />
<display value="Not required as instructed by the patient" />
</valueCoding>
</extension>
<extension url="https://fhir.nhs.uk/StructureDefinition/Extension-EPS-TaskBusinessStatus">
<valueCoding>
<system value="https://fhir.nhs.uk/CodeSystem/EPS-task-business-status" />
<code value="0007" />
<display value="Not Dispensed" />
</valueCoding>
</extension>
<status value="completed" />
<medicationCodeableConcept>
<coding>
<system value="http://snomed.info/sct" />
<code value="39720311000001101" />
<display value="Paracetamol 500mg soluble tablets" />
</coding>
</medicationCodeableConcept>
<subject>
<reference value="Patient/Patient-StaceyTwitchett-Example" />
<identifier>
<system value="https://fhir.nhs.uk/Id/nhs-number" />
<value value="5839945242" />
</identifier>
</subject>
<performer>
<actor>
<reference value="PractitionerRole/PractitionerRole-JanePittman-Example" />
</actor>
</performer>
<authorizingPrescription>
<reference value="MedicationRequest/MedicationRequest-RepeatPrescription-Example" />
</authorizingPrescription>
<type>
<coding>
<system value="https://fhir.nhs.uk/CodeSystem/medicationdispense-type" />
<code value="0002" />
<display value="Item not dispensed" />
</coding>
</type>
<quantity>
<value value="32" />
<unit value="dose" />
<system value="http://snomed.info/sct" />
<code value="3317411000001100" />
</quantity>
</MedicationDispense>
MedicationDispense

MedicationRequest-RepeatPrescription-Example

Medication Request

{
"resourceType": "MedicationRequest",
"id": "MedicationRequest-RepeatPrescription-Example",
"meta": {
"versionId": "2",
"lastUpdated": "2025-01-30T13:28:17-05:00"
},
"extension": [
{
"url": "https://fhir.nhs.uk/StructureDefinition/Extension-DM-PrescriptionStatusHistory",
"extension": [
{
"url": "status",
"valueCoding": {
"system": "https://fhir.nhs.uk/CodeSystem/EPS-task-business-status",
"code": "9005",
"display": "Pending Cancellation"
}
}
]
},
{
"url": "https://fhir.nhs.uk/StructureDefinition/Extension-EPS-DispensingInformation",
"extension": [
{
"url": "dispenseStatus",
"valueCoding": {
"system": "https://fhir.nhs.uk/CodeSystem/medicationdispense-type",
"code": "0002",
"display": "Item not dispensed"
}
}
]
}
],
"identifier": [
{
"system": "https://fhir.nhs.uk/Id/prescription-order-item-number",
"value": "a54219b8-f741-4c47-b662-e4f8dfa49JHKG"
}
],
"status": "active",
"intent": "reflex-order",
"medicationCodeableConcept": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "39720311000001101",
"display": "Paracetamol 500mg soluble tablets"
}
]
},
"subject": {
"reference": "Patient/Patient-StaceyTwitchett-Example",
"identifier": {
"system": "https://fhir.nhs.uk/Id/nhs-number",
"value": "5839945242"
}
},
"groupIdentifier": {
"extension": [
{
"url": "https://fhir.nhs.uk/StructureDefinition/Extension-DM-PrescriptionId",
"valueIdentifier": {
"system": "https://fhir.nhs.uk/Id/prescription",
"value": "b2fc79f0-2793-4736-9b2d-0976c21e73a5"
}
}
],
"system": "https://fhir.nhs.uk/Id/prescription-order-number",
"value": "82D996-C81010-11DB12"
},
"courseOfTherapyType": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/medicationrequest-course-of-therapy",
"code": "acute",
"display": "Short course (acute) therapy"
}
]
},
"dosageInstruction": [
{
"text": "Take two tablets every four hours as needed"
}
],
"dispenseRequest": {
"extension": [
{
"url": "https://fhir.nhs.uk/StructureDefinition/Extension-DM-PerformerSiteType",
"valueCoding": {
"system": "https://fhir.nhs.uk/CodeSystem/dispensing-site-preference",
"code": "P1"
}
}
],
"quantity": {
"value": 30,
"unit": "dose",
"system": "http://snomed.info/sct",
"code": "3317411000001100"
}
},
"substitution": {
"allowedBoolean": false
},
"eventHistory": [
{
"reference": "Provenance/Provenace-RepeatPrescription-Example"
}
]
}
<MedicationRequest xmlns="http://hl7.org/fhir">
<id value="MedicationRequest-RepeatPrescription-Example" />
<meta>
<versionId value="2" />
<lastUpdated value="2025-01-30T13:28:17-05:00" />
</meta>
<extension url="https://fhir.nhs.uk/StructureDefinition/Extension-DM-PrescriptionStatusHistory">
<extension url="status">
<valueCoding>
<system value="https://fhir.nhs.uk/CodeSystem/EPS-task-business-status" />
<code value="9005" />
<display value="Pending Cancellation" />
</valueCoding>
</extension>
</extension>
<extension url="https://fhir.nhs.uk/StructureDefinition/Extension-EPS-DispensingInformation">
<extension url="dispenseStatus">
<valueCoding>
<system value="https://fhir.nhs.uk/CodeSystem/medicationdispense-type" />
<code value="0002" />
<display value="Item not dispensed" />
</valueCoding>
</extension>
</extension>
<identifier>
<system value="https://fhir.nhs.uk/Id/prescription-order-item-number" />
<value value="a54219b8-f741-4c47-b662-e4f8dfa49JHKG" />
</identifier>
<status value="active" />
<intent value="reflex-order" />
<medicationCodeableConcept>
<coding>
<system value="http://snomed.info/sct" />
<code value="39720311000001101" />
<display value="Paracetamol 500mg soluble tablets" />
</coding>
</medicationCodeableConcept>
<subject>
<reference value="Patient/Patient-StaceyTwitchett-Example" />
<identifier>
<system value="https://fhir.nhs.uk/Id/nhs-number" />
<value value="5839945242" />
</identifier>
</subject>
<groupIdentifier>
<extension url="https://fhir.nhs.uk/StructureDefinition/Extension-DM-PrescriptionId">
<valueIdentifier>
<system value="https://fhir.nhs.uk/Id/prescription" />
<value value="b2fc79f0-2793-4736-9b2d-0976c21e73a5" />
</valueIdentifier>
</extension>
<system value="https://fhir.nhs.uk/Id/prescription-order-number" />
<value value="82D996-C81010-11DB12" />
</groupIdentifier>
<courseOfTherapyType>
<coding>
<system value="http://terminology.hl7.org/CodeSystem/medicationrequest-course-of-therapy" />
<code value="acute" />
<display value="Short course (acute) therapy" />
</coding>
</courseOfTherapyType>
<dosageInstruction>
<text value="Take two tablets every four hours as needed" />
</dosageInstruction>
<dispenseRequest>
<extension url="https://fhir.nhs.uk/StructureDefinition/Extension-DM-PerformerSiteType">
<valueCoding>
<system value="https://fhir.nhs.uk/CodeSystem/dispensing-site-preference" />
<code value="P1" />
</valueCoding>
</extension>
<quantity>
<value value="30" />
<unit value="dose" />
<system value="http://snomed.info/sct" />
<code value="3317411000001100" />
</quantity>
</dispenseRequest>
<substitution>
<allowedBoolean value="false" />
</substitution>
<eventHistory>
<reference value="Provenance/Provenace-RepeatPrescription-Example" />
</eventHistory>
</MedicationRequest>
MedicationRequest
back to top