UK Core Implementation Guide STU3 Sequence

Please note:

This version of the UK Core is a development copy.
This contains BREAKING CHANGES as a result of the C&TA Sprint 7 Review, and STU2 Sequence ballot reconciliation.
This version is not yet reviewed for implementation. Other versions are available on the UK Core Version History Guide
Please follow the guidance on the Contact Us page if you need any assistance.
A summary of changes is available on the STU3 Sequence Change Log

An example to illustrate a medication statement for Amoxicillin

Table View

MedicationStatement.id[0]	UKCore-MedicationStatement-Amoxicillin-Example
MedicationStatement.text[0].status[0]	additional
MedicationStatement.text[0].div[0]	<div xmlns="http://www.w3.org/1999/xhtml">An example to illustrate a medication statement for Amoxicillin</div>
MedicationStatement.identifier[0].system[0]	https://tools.ietf.org/html/rfc4122
MedicationStatement.identifier[0].value[0]	ac0ffbdf-3289-41d5-84d9-068a1f5937db
MedicationStatement.status[0]	active
MedicationStatement.category[0].coding[0].system[0]	http://terminology.hl7.org/CodeSystem/medication-statement-category
MedicationStatement.category[0].coding[0].code[0]	outpatient
MedicationStatement.category[0].coding[0].display[0]	Outpatient
MedicationStatement.medication[0].coding[0].system[0]	https://dmd.nhs.uk
MedicationStatement.medication[0].coding[0].code[0]	39732311000001104
MedicationStatement.medication[0].coding[0].display[0]	Amoxicillin 250mg capsules
MedicationStatement.subject[0].reference[0]	Patient/UKCore-Patient-RichardSmith-Example
MedicationStatement.effective[0].start[0]	2021-02-15T13:50:00+00:00
MedicationStatement.effective[0].end[0]	2021-05-15T13:50:00+00:00
MedicationStatement.dateAsserted[0]	2017-02-22
MedicationStatement.reasonCode[0].coding[0].system[0]	http://snomed.info/sct
MedicationStatement.reasonCode[0].coding[0].code[0]	65363002
MedicationStatement.reasonCode[0].coding[0].display[0]	Otitis media
MedicationStatement.dosage[0].text[0]	2 capsules 4 times a day.
MedicationStatement.dosage[0].timing[0].repeat[0].frequency[0]	4
MedicationStatement.dosage[0].timing[0].repeat[0].period[0]	1
MedicationStatement.dosage[0].timing[0].repeat[0].periodUnit[0]	d
MedicationStatement.dosage[0].asNeeded[0].coding[0].system[0]	http://snomed.info/sct
MedicationStatement.dosage[0].asNeeded[0].coding[0].code[0]	301354004
MedicationStatement.dosage[0].asNeeded[0].coding[0].display[0]	Pain of ear
MedicationStatement.dosage[0].site[0].coding[0].system[0]	http://snomed.info/sct
MedicationStatement.dosage[0].site[0].coding[0].code[0]	123851003
MedicationStatement.dosage[0].site[0].coding[0].display[0]	Mouth region structure
MedicationStatement.dosage[0].route[0].coding[0].system[0]	http://snomed.info/sct
MedicationStatement.dosage[0].route[0].coding[0].code[0]	26643006
MedicationStatement.dosage[0].route[0].coding[0].display[0]	Oral
MedicationStatement.dosage[0].method[0].coding[0].system[0]	http://snomed.info/sct
MedicationStatement.dosage[0].method[0].coding[0].code[0]	421984009
MedicationStatement.dosage[0].method[0].coding[0].display[0]	Until finished
MedicationStatement.dosage[0].doseAndRate[0].dose[0].value[0]	500
MedicationStatement.dosage[0].doseAndRate[0].dose[0].unit[0]	milligram
MedicationStatement.dosage[0].doseAndRate[0].dose[0].system[0]	http://unitsofmeasure.org
MedicationStatement.dosage[0].doseAndRate[0].dose[0].code[0]	mg

Tree View

MedicationStatement

id : UKCore-MedicationStatement-Amoxicillin-Example

text

status : additional

identifier

system : https://tools.ietf.org/html/rfc4122

value : ac0ffbdf-3289-41d5-84d9-068a1f5937db

status : active

category

coding

system : http://terminology.hl7.org/CodeSystem/medication-statement-category

code : outpatient

display : Outpatient

medication

coding

system : https://dmd.nhs.uk

code : 39732311000001104

display : Amoxicillin 250mg capsules

subject

reference : Patient/UKCore-Patient-RichardSmith-Example

effective

start : 2021-02-15T13:50:00+00:00

end : 2021-05-15T13:50:00+00:00

dateAsserted : 2017-02-22

reasonCode

coding

system : http://snomed.info/sct

code : 65363002

display : Otitis media

dosage

text : 2 capsules 4 times a day.

timing

repeat

frequency : 4

period : 1

periodUnit : d

asNeeded

coding

system : http://snomed.info/sct

code : 301354004

display : Pain of ear

site

coding

system : http://snomed.info/sct

code : 123851003

display : Mouth region structure

route

coding

system : http://snomed.info/sct

code : 26643006

display : Oral

method

coding

system : http://snomed.info/sct

code : 421984009

display : Until finished

doseAndRate

dose

value : 500

unit : milligram

system : http://unitsofmeasure.org

code : mg

XML View

<MedicationStatement xmlns="http://hl7.org/fhir">
    <id value="UKCore-MedicationStatement-Amoxicillin-Example" />
    <text>
        <status value="additional" />
        --- We have skipped the narrative for better readability of the resource ---
    </text>
    <identifier>
        <system value="https://tools.ietf.org/html/rfc4122" />
        <value value="ac0ffbdf-3289-41d5-84d9-068a1f5937db" />
    </identifier>
    <status value="active" />
    <category>
        <coding>
            <system value="http://terminology.hl7.org/CodeSystem/medication-statement-category" />
            <code value="outpatient" />
            <display value="Outpatient" />
        </coding>
    </category>
    <medicationCodeableConcept>
        <coding>
            <system value="https://dmd.nhs.uk" />
            <code value="39732311000001104" />
            <display value="Amoxicillin 250mg capsules" />
        </coding>
    </medicationCodeableConcept>
    <subject>
        <reference value="Patient/UKCore-Patient-RichardSmith-Example" />
    </subject>
    <effectivePeriod>
        <start value="2021-02-15T13:50:00+00:00" />
        <end value="2021-05-15T13:50:00+00:00" />
    </effectivePeriod>
    <dateAsserted value="2017-02-22" />
    <reasonCode>
        <coding>
            <system value="http://snomed.info/sct" />
            <code value="65363002" />
            <display value="Otitis media" />
        </coding>
    </reasonCode>
    <dosage>
        <text value="2 capsules 4 times a day." />
        <timing>
            <repeat>
                <frequency value="4" />
                <period value="1" />
                <periodUnit value="d" />
            </repeat>
        </timing>
        <asNeededCodeableConcept>
            <coding>
                <system value="http://snomed.info/sct" />
                <code value="301354004" />
                <display value="Pain of ear" />
            </coding>
        </asNeededCodeableConcept>
        <site>
            <coding>
                <system value="http://snomed.info/sct" />
                <code value="123851003" />
                <display value="Mouth region structure" />
            </coding>
        </site>
        <route>
            <coding>
                <system value="http://snomed.info/sct" />
                <code value="26643006" />
                <display value="Oral" />
            </coding>
        </route>
        <method>
            <coding>
                <system value="http://snomed.info/sct" />
                <code value="421984009" />
                <display value="Until finished" />
            </coding>
        </method>
        <doseAndRate>
            <doseQuantity>
                <value value="500" />
                <unit value="milligram" />
                <system value="http://unitsofmeasure.org" />
                <code value="mg" />
            </doseQuantity>
        </doseAndRate>
    </dosage>
</MedicationStatement>

JSON View

{
    "resourceType": "MedicationStatement",
    "id": "UKCore-MedicationStatement-Amoxicillin-Example",
    "text": {
        "status": "additional",
        --- We have skipped the narrative for better readability of the resource ---
    },
    "identifier":  [
        {
            "system": "https://tools.ietf.org/html/rfc4122",
            "value": "ac0ffbdf-3289-41d5-84d9-068a1f5937db"
        }
    ],
    "status": "active",
    "category": {
        "coding":  [
            {
                "system": "http://terminology.hl7.org/CodeSystem/medication-statement-category",
                "code": "outpatient",
                "display": "Outpatient"
            }
        ]
    },
    "medicationCodeableConcept": {
        "coding":  [
            {
                "system": "https://dmd.nhs.uk",
                "code": "39732311000001104",
                "display": "Amoxicillin 250mg capsules"
            }
        ]
    },
    "subject": {
        "reference": "Patient/UKCore-Patient-RichardSmith-Example"
    },
    "effectivePeriod": {
        "start": "2021-02-15T13:50:00+00:00",
        "end": "2021-05-15T13:50:00+00:00"
    },
    "dateAsserted": "2017-02-22",
    "reasonCode":  [
        {
            "coding":  [
                {
                    "system": "http://snomed.info/sct",
                    "code": "65363002",
                    "display": "Otitis media"
                }
            ]
        }
    ],
    "dosage":  [
        {
            "text": "2 capsules 4 times a day.",
            "timing": {
                "repeat": {
                    "frequency": 4,
                    "period": 1,
                    "periodUnit": "d"
                }
            },
            "asNeededCodeableConcept": {
                "coding":  [
                    {
                        "system": "http://snomed.info/sct",
                        "code": "301354004",
                        "display": "Pain of ear"
                    }
                ]
            },
            "site": {
                "coding":  [
                    {
                        "system": "http://snomed.info/sct",
                        "code": "123851003",
                        "display": "Mouth region structure"
                    }
                ]
            },
            "route": {
                "coding":  [
                    {
                        "system": "http://snomed.info/sct",
                        "code": "26643006",
                        "display": "Oral"
                    }
                ]
            },
            "method": {
                "coding":  [
                    {
                        "system": "http://snomed.info/sct",
                        "code": "421984009",
                        "display": "Until finished"
                    }
                ]
            },
            "doseAndRate":  [
                {
                    "doseQuantity": {
                        "value": 500,
                        "unit": "milligram",
                        "system": "http://unitsofmeasure.org",
                        "code": "mg"
                    }
                }
            ]
        }
    ]
}