Search loading...

API Hub

Explore and Make use of Nationally Defined Messaging APIs

 

Medications and Medical Devices Section

Gives information about the Medications and Medical Devices section

Medications and Medical Devices Section Content

The Medications and medical devices section carries information about the patient’s medication. PRSB Elements should be formatted as subheadings in any HTML sent. For more information on constructing medication lists see constructing clinical coded structures.

Section Description Card. MRO* FHIR Target and Guidance
Medications and Medical Devices The details of and instructions for medications and medical equipment the patient is using. 0 to 1 O Carried in the CodeableConcept of Composition.section.code FHIR element.
PRSB Element Description Card. MRO* FHIR Target and Guidance
Medications
Supply type A description of the type of medication being supplied (e.g. emergency supply, over the counter medication, patient group direction etc.). 0 to 1 R Emergency supply
​Minor ailments scheme
​Over the counter
​Patient group direction
​Prescription dispensing
​Private prescription dispensing
​Self declared

Carried in the CodeableConcept of MedicationDispense.type FHIR element. See medicationDispense.type for further guidance.
Medication name May be generic name or brand name (as appropriate). 1 only M Choice of
• Text
• Coded text (needs to be GS1 code mapped to DM+D)– constraint: MedicationName. Any AMP/VMP/VTM/AMPP/VMPP subsets from the dm+d terminology. NHS dm+d AMP ::352201000001139 NHS dm+d AMPP ::352401000001135 NHS dm+d VMP ::352701000001133 NHS dm+d VMPP ::352601000001138. Constraint binding: [dm+d]subset=NHS_dm+d

Text and a SNOMED CT concept carried in the CodeableConcept of the FHIR element MedicationDispense.medication[x].
medicationReference.Medication.Name
. See medication.code for further guidance.
Form Eg capsule, drops, tablet, lotion etc. 0 to 1 O Choice of
• Text
• Coded text – constraint: DrugDoseForm. SNOMED CT CfH DoseForm termset. Any descendant of 421967003 | drug dose form. Constraint binding: [SNOMED CT]subset=CfH DoseForm

Text and a SNOMED CT concept carried in the CodeableConcept of the FHIR element MedicationDispense.medication[x].
medicationReference.Medication.form
. See medication.form for further guidance.
Site The anatomical site at which the medication is to be administered.  Comment: e.g. "Left eye". 0 to 1 O Choice of
• Text
• Coded text – constraint: SiteOfMedicationAdministration. Any valid site for the administration of a medication. Constraint binding: [SNOMED-CT]subset= SiteOfMedicationAdministration

Text and a SNOMED CT concept carried in the CodeableConcept of the FHIR element MedicationDispense.dosageInstruction.site.
Indication Reason for medication being prescribed, where known. 0 to 1 R This will be free text or SNOMED CT subset
Total amount of medication supplied A description of the total amount of medication supplied e.g 30 tablets, 100ml etc. 1 only M Recorded in a structured format i.e. a unit (eg ml, tablet, etc.) and a value (eg 100, 1, 0.5 etc.). Carried in the MedicationDispense.quantity FHIR element. See medicationDispense.quantity for further guidance.
Dose directions description A single plain text phrase describing the entire medication dosage and administration directions, including dose quantity and medication frequency.  Comment: e.g. "I tablet at night" or "20mg at 10pm" This is the form of dosage direction text normally available from UK GP systems. 0 to 1 O This will be free text. Text within the section.narrative.text and text repeated in the FHIR element MedicationDispense.dosageInstruction.text.
Additional instructions Allows for:
- requirements for adherence support, e.g., compliance aids, prompts and packaging requirements
- additional information about specific person requirements, e.g., unable to swallow tablets.medicines, e.g., where specific brand required
0 to many O Free text. Carried in the MedicationDispense.dosageInstruction.additionalInstruction.text FHIR element.
Date/time The date/time on which the medication was supplied to the patient. 0 to 1 R The date/time as recorded by the pharmacy system. Carried in the MedicationDispense.whenHandedOver FHIR element.
Appliances
Appliance name May be generic name or brand name (as appropriate). 1 only M As per dm+d (AMP)
Size The size of the appliance. 0 to 1 R As per dm+d (AMP) appliance product information (where applicable)
Weight The weight of the appliance. 0 to 1 R As per dm+d (AMP) appliance product information (where applicable)
Colour The colour of the appliance. 0 to 1 R As per dm+d (AMP) appliance product information (where applicable)
Route Appliance administration description (IM, IV, etc.): may include method of administration, (e.g., by infusion). 0 to 1 R E.g. catheter may have been introduced suprapubically or urethrally.

The following value set may be applicable, but would need validating for appliances:

• Coded text – constraint: NHS e-prescribing route of administration subset ID: 413001000001136 Original Id : 30201000001137 This is an extract from the SUBSET -BiAnnual-Drug-15.0.1-20130401: SnomedCT_GB1000001_20130401/Subsets/EPrescribing/NHS e-Prescribing route of administration subset. Constraint binding: [SNOMED-CT]subset=NHS e-Prescribing route of administration subset
Site The anatomical site at which the appliance is to be used, including laterality. 0 to 1 R The following value set may be applicable, but would need validating for appliances:
• Coded text – constraint: SiteOfMedicationAdministration. Any valid site for the administration of a medication. Constraint binding: [SNOMED-CT]subset= SiteOfMedicationAdministration
Quantity The quantity of the appliance (including the units). 0 to 1 R Recorded in a structured format i.e. a unit and a value.
Indication Reason for appliance being prescribed, where known. 0 to 1 R Free text
Date/time The date/time on which the appliance was supplied to the patient. 0 to 1 R The date/time as recorded by the pharmacy system.
* M=Mandatory R=Required O=Optional

Example Medications and Medical Devices Section

<xml>
	<section>
		<title value="Medications and medical devices"/>
		<code>
			<coding>
				<system value="http://snomed.info/sct"/>
				<code value="933361000000108"/>
				<display value="Medications and medical devices"/>
			</coding>
		</code>
		<text>
		<status value="additional"/>
		<div xmlns="http://www.w3.org/1999/xhtml">
		<table width="100%">
			<tbody>
		<tr>
			<th>Supply type</th>
			<td>A description of the type of medication being supplied (e.g. emergency supply, over the counter medication, patient group direction etc.).</td>
		</tr>
		<tr>
			<th>Medication name</th>
			<td>BD Viva hypodermic insulin needles for pre-filled / reusable pen injectors screw on 5mm/31gauge (Becton, Dickinson UK Ltd)</td>
		</tr>
		<tr>
			<th>Form</th>
			<td>Eg capsule, drops, tablet, lotion etc.</td>
		</tr>
		<tr>
			<th>Site</th>
			<td>The anatomical site at which the medication is to be administered.  Comment: e.g. "Left eye".</td>
		</tr>
		<tr>
			<th>Indication</th>
			<td>Reason for medication being prescribed, where known.</td>
		</tr>
		<tr>
			<th>Total amount of medication supplied</th>
			<td>A description of the total amount of medication supplied e.g 30 tablets, 100ml etc.</td>
		</tr>
		<tr>
			<th>Dose directions description</th>
			<td>A single plain text phrase describing the entire medication dosage and administration directions, including dose quantity and medication frequency.  Comment: e.g. "I tablet at night" or "20mg at 10pm" This is the form of dosage direction text normally available from UK GP systems.</td>
		</tr>
		<tr>
			<th>Additional instructions</th>
			<td>Allows for: <br> - requirements for adherence support, e.g., compliance aids, prompts and packaging requirements <br> - additional information about specific person requirements, e.g., unable to swallow tablets.medicines, e.g., where specific brand required</td>
		</tr>
		<tr>
			<th>Date/time</th>
			<td>The date/time on which the medication was supplied to the patient.</td>
		</tr>
		<tr>
			<td colspan="5"><b>Appliances</b></td>
		</tr>
		<tr>
			<th>Appliance name</th>
			<td>May be generic name or brand name (as appropriate).</td>
		</tr>
		<tr>
			<th>Size</th>
			<td>The size of the appliance.</td>
		</tr>
		<tr>
			<th>Weight</th>
			<td>The weight of the appliance.</td>
		</tr>
		<tr>
			<th>Colour</th>
			<td>The colour of the appliance.</td>
		</tr>
		<tr>
			<th>Route</th>
			<td>Appliance administration description (IM, IV, etc.): may include method of administration, (e.g., by infusion).</td>
		</tr>
		<tr>
			<th>Site</th>
			<td>The anatomical site at which the appliance is to be used, including laterality.</td>
		</tr>
		<tr>
			<th>Quantity</th>
			<td>The quantity of the appliance (including the units).</td>
		</tr>
		<tr>
			<th>Indication</th>
			<td>Reason for appliance being prescribed, where known.</td>
		</tr>
		<tr>
			<th>Date/time</th>
			<td>The date/time on which the appliance was supplied to the patient.</td>
		</tr>
			</tbody>
		</table>
		</div>
		</text>
		<!--reference to further information carried in the medication dispense list resource-->
		<entry>
			<reference value="urn:uuid:4bc7faea-5974-407a-b658-d6ed1d4c9187"/>
		</entry>
	</section>
</xml>

Coded Resources

This text section should be linked to the following FHIR Resources to provide the textual information in a coded format.

  • List
  • MedicationDispense
  • Medication

See constructing clinical coded structures - Medication Dispense List

Tags: fhir

All content is available under the Open Government Licence v3.0, except where otherwise stated