Note: This specification was originally titled "Digital Medicines (DigiMeds)" and maintained by the PODAC Programme.
How to populate Medications and medical devices
The Composition.section
element is used to convey both HTML and the structrued FHIR elements contained within the payload.
More information can be found on:
- Profile: CareConnect-ITK-DM-EmergencySupply-Composition-1
- Profile: CareConnect-ITK-MedicationDispense-List-1
- Profile: CareConnect-ITK-MedicationDispense-1
- Profile: CareConnect-ITK-Medication-1
The FHIR snippets below provides an example of how to populate the various medication-related FHIR resources, and the respective HTML.
FHIR snippet (HTML)
<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>Medication</th> <td>Humulin M3 100units/ml suspension for injection 3ml cartridges (CST Pharma Ltd)</td> </tr> <tr> <th>Dose directions</th> <td>As needed</td> </tr> <tr> <th>Quantity Supplied</th> <td>2 cartridge</td> </tr> <tr> <th>Days Supply</th> <td>14 days</td> </tr> <tr> <th>Medication</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>Dose directions</th> <td>As needed</td> </tr> <tr> <th>Quantity Supplied</th> <td>90 needle</td> </tr> <tr> <th>Days Supply</th> <td>14 days</td> </tr> </tbody> </table> </div> </text> <entry> <reference value="urn:uuid:4bc7faea-5974-407a-b658-d6ed1d4c9187"/> </entry> </section>
Example HTML render
Medications and medical devices
Medication | Humulin M3 100units/ml suspension for injection 3ml cartridges (CST Pharma Ltd) |
---|---|
Dose directions | As needed |
Quantity Supplied | 2 cartridge |
Days Supply | 14 days |
Medication | BD Viva hypodermic insulin needles for pre-filled / reusable pen injectors screw on 5mm/31gauge (Becton, Dickinson UK Ltd) |
Dose directions | As needed |
Quantity Supplied | 90 needle |
Days Supply | 14 days |
FHIR snippet (CareConnect-ITK-MedicationDispense-List-1)
WARNING: The code 163541000000107 | Dispensed medication is not valid in the "Care Connect List Code" value set and will result in a FHIR validation error.
<entry> <fullUrl value="urn:uuid:4bc7faea-5974-407a-b658-d6ed1d4c9187"/> <resource> <List> <id value="4bc7faea-5974-407a-b658-d6ed1d4c9187"/> <meta> <profile value="https://fhir.nhs.uk/STU3/StructureDefinition/CareConnect-ITK-MedicationDispense-List-1"/> </meta> <identifier> <system value="https://tools.ietf.org/html/rfc4122"/> <value value="197987da-97a7-49c2-9657-dac1aea2a461"/> </identifier> <status value="current"/> <mode value="snapshot"/> <code> <coding> <system value="http://snomed.info/sct"/> <code value="163541000000107"/> <display value="Dispensed Medication"/> </coding> </code> <subject> <reference value="urn:uuid:1e2b5223-1cd8-43ff-8a67-55dec3edb9b0"/> <display value="SMITH, William (Mr)"/> </subject> <encounter> <reference value="urn:uuid:adb353f9-0953-4fb4-a4ab-f0ab04a44dbc"/> </encounter> <date value="2018-05-09"/> <entry> <item> <reference value="urn:uuid:0885779a-82e7-11ea-bc55-0242ac130003"/> </item> </entry> <entry> <item> <reference value="urn:uuid:42ac049c-87ca-4e33-93ad-987167422b01"/> </item> </entry> </List> </resource> </entry>
FHIR snippet (CareConnect-ITK-MedicationDispense-1)
<!-- Dispensed medication #1 --> <entry> <fullUrl value="urn:uuid:0885779a-82e7-11ea-bc55-0242ac130003" /> <resource> <MedicationDispense> <id value="0885779a-82e7-11ea-bc55-0242ac130003" /> <meta> <profile value="https://fhir.nhs.uk/STU3/StructureDefinition/CareConnect-ITK-MedicationDispense-1" /> </meta> <status value="completed" /> <medicationReference> <reference value="urn:uuid:f315872e-82e6-11ea-bc55-0242ac130003" /> <display value="Humulin M3 100units/ml suspension for injection 3ml cartridges (CST Pharma Ltd)" /> </medicationReference> <subject> <reference value="urn:uuid:1e2b5223-1cd8-43ff-8a67-55dec3edb9b0" /> <display value="SMITH, William (Mr)" /> </subject> <context> <reference value="urn:uuid:adb353f9-0953-4fb4-a4ab-f0ab04a44dbc" /> </context> <performer> <actor> <reference value="urn:uuid:0e4c13d4-e61f-48f2-89ee-7cf8f5f3dbb3" /> </actor> <onBehalfOf> <reference value="urn:uuid:1226082b-315e-40be-83cf-5d21a964219e" /> </onBehalfOf> </performer> <type> <coding> <system value="http://snomed.info/sct" /> <code value="1218611000000102" /> <display value="Urgent supply of prescription items by community pharmacy" /> </coding> </type> <quantity> <extension url="https://fhir.hl7.org.uk/STU3/StructureDefinition/Extension-CareConnect-MedicationQuantityText-1"> <valueString value="2 cartridge" /> </extension> <value value="2" /> <unit value="cartridge" /> <system value="http://snomed.info/sct" /> <code value="732988008" /> </quantity> <daysSupply> <value value="14" /> <unit value="day" /> <system value="http://unitsofmeasure.org" /> <code value="d" /> </daysSupply> <whenPrepared value="2018-05-09" /> <whenHandedOver value="2018-05-09" /> <dosageInstruction> <asNeededBoolean value="true" /> </dosageInstruction> </MedicationDispense> </resource> </entry> <!-- Dispensed medication #2 --> <entry> <fullUrl value="urn:uuid:42ac049c-87ca-4e33-93ad-987167422b01" /> <resource> <MedicationDispense> <id value="42ac049c-87ca-4e33-93ad-987167422b01" /> <meta> <profile value="https://fhir.nhs.uk/STU3/StructureDefinition/CareConnect-ITK-MedicationDispense-1" /> </meta> <status value="completed" /> <medicationReference> <reference value="urn:uuid:9c7e61c3-5b92-4828-9ebc-21e74bcdbc96" /> <display value="BD Viva hypodermic insulin needles for pre-filled / reusable pen injectors screw on 5mm/31gauge (Becton, Dickinson UK Ltd)" /> </medicationReference> <subject> <reference value="urn:uuid:1e2b5223-1cd8-43ff-8a67-55dec3edb9b0" /> <display value="SMITH, William (Mr)" /> </subject> <context> <reference value="urn:uuid:adb353f9-0953-4fb4-a4ab-f0ab04a44dbc" /> </context> <performer> <actor> <reference value="urn:uuid:0e4c13d4-e61f-48f2-89ee-7cf8f5f3dbb3" /> </actor> <onBehalfOf> <reference value="urn:uuid:1226082b-315e-40be-83cf-5d21a964219e" /> </onBehalfOf> </performer> <type> <coding> <system value="http://snomed.info/sct" /> <code value="1218611000000102" /> <display value="Urgent supply of prescription items by community pharmacy" /> </coding> </type> <quantity> <extension url="https://fhir.hl7.org.uk/STU3/StructureDefinition/Extension-CareConnect-MedicationQuantityText-1"> <valueString value="90 needle" /> </extension> <value value="90" /> <unit value="needle" /> <system value="http://snomed.info/sct" /> <code value="3318111000001106" /> </quantity> <daysSupply> <value value="14" /> <unit value="day" /> <system value="http://unitsofmeasure.org" /> <code value="d" /> </daysSupply> <whenPrepared value="2018-05-09" /> <whenHandedOver value="2018-05-09" /> <dosageInstruction> <asNeededBoolean value="true" /> </dosageInstruction> </MedicationDispense> </resource> </entry>
FHIR snippet (CareConnect-ITK-Medication-1)
<!--Medication #1 --> <entry> <fullUrl value="urn:uuid:f315872e-82e6-11ea-bc55-0242ac130003" /> <resource> <Medication> <id value="f315872e-82e6-11ea-bc55-0242ac130003" /> <meta> <profile value="https://fhir.nhs.uk/STU3/StructureDefinition/CareConnect-ITK-Medication-1" /> </meta> <code> <coding> <system value="http://snomed.info/sct" /> <code value="37417211000001103" /> <display value="Humulin M3 100units/ml suspension for injection 3ml cartridges (CST Pharma Ltd)" /> </coding> </code> <status value="active" /> </Medication> </resource> </entry> <!-- Medication #2 --> <entry> <fullUrl value="urn:uuid:9c7e61c3-5b92-4828-9ebc-21e74bcdbc96" /> <resource> <Medication> <id value="9c7e61c3-5b92-4828-9ebc-21e74bcdbc96" /> <meta> <profile value="https://fhir.nhs.uk/STU3/StructureDefinition/CareConnect-ITK-Medication-1" /> </meta> <code> <coding> <system value="http://snomed.info/sct" /> <code value="31771611000001107" /> <display value="BD Viva hypodermic insulin needles for pre-filled / reusable pen injectors screw on 5mm/31gauge (Becton, Dickinson UK Ltd)" /> </coding> </code> <status value="active" /> </Medication> </resource> </entry>