Transfer of Care R4 Hackathon Implementation Guide

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

GP practice

The GP practice section contains details of the patients GP practice. PRSB Elements should be formatted as subheadings in any HTML sent.

Section Description Card. MRO* FHIR Target and Guidance
GP practice Details of the GP practice where the patient is registered. 1 only M Carried in the CodeableConcept of Composition.section.code FHIR element. ValueSet UKCoreCompositionSectionCode
PRSB Element Description Card. MRO* FHIR Target and Guidance
GP practice identifier The identifier of the registered GP Practice. Note: this heading is defined as mandatory however the heading does not appear in the text but it is mandatory to populate the identifier in the Practitioner Resource. 1 only M This should be the Organisation Data Services (ODS) identifier for the practice which MUST NOT be in text but carried in the FHIR element Organization.identifier. This includes codes to use where there is no registered GP practice which should follow the NHS Data Dictionary default codes.
GP name Where the patient or patient's representative offers the name of a GP as their usual GP. 0 to 1 R Patients are registered with GP Practices, so their usual GP name will be something volunteered by the patient or their representative. Text and carried in the FHIR element Practitioner.name.
GP practice details Name and address of the patient's registered GP Practice. 0 to 1 R Registered GP Practice details are available from the Patient Demographics Service (PDS), or volunteered from the patient or their representative or provided by referral contact. Include details of the Practice name and address in text and carried in the FHIR elements Organization.name and Organization.address.

Example GP Practice Section

{
    "resourceType": "Composition",
    "meta": {
        "profile":  [
            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Composition"
        ]
    },
    "status": "final",
    "type": {
        "coding":  [
            {
                "system": "http://snomed.info/sct",
                "code": "373942005",
                "display": "Discharge summary"
            }
        ]
    },
    "subject": {
        "reference": "urn:uuid:2c0bca60-1873-46f7-a462-5733feaf32c9"
    },
    "encounter": {
        "reference": "urn:uuid:5a9f67fa-9343-40cc-8fde-0dd91822b7fd"
    },
    "date": "2023-01-28T10:00:00+00:00",
    "author":  [
        {
            "reference": "urn:uuid:2a32666e-84a2-4f90-a6a6-d5451ae2e32f"
        }
    ],
    "title": "Cardiology Service Discharge Summary",
    "section":  [
        {
            "title": "GP practice",
            "code": {
                "coding":  [
                    {
                        "system": "https://fhir.hl7.org.uk/CodeSystem/UKCore-RecordStandardHeadings",
                        "code": "general-practitioner-practice",
                        "display": "GP practice"
                    }
                ]
            },
            "text": {
                "status": "additional",
                "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><table width=\"100%\"><tbody><tr><th>GP name</th><td><p>Prefix: Dr</p><p>Given Name: John</p><p>Family Name: Lorenzo</p></td></tr><tr><th>GP practice details</th><td><p>Name: MGP Medical Centre</p><p>Address:</p><p>Address Line: 1 MGP House, Overtown</p><p>City: Leeds</p><p>Post Code: LS21 7PA</p></td></tr></tbody></table></div>"
            },
            "entry":  [
                {
                    "reference": "urn:uuid:bd0b7423-6c10-40a0-b829-8e52afea92d3"
                }
            ]
        }
    ]
}
<Composition xmlns="http://hl7.org/fhir">
    <!--   optional elements removed for readability   -->
    <meta>
        <profile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Composition" />
    </meta>
    <status value="final" />
    <type>
        <coding>
            <system value="http://snomed.info/sct" />
            <code value="373942005" />
            <display value="Discharge summary" />
        </coding>
    </type>
    <subject>
        <reference value="urn:uuid:2c0bca60-1873-46f7-a462-5733feaf32c9" />
    </subject>
    <encounter>
        <reference value="urn:uuid:5a9f67fa-9343-40cc-8fde-0dd91822b7fd" />
    </encounter>
    <date value="2023-01-28T10:00:00+00:00" />
    <author>
        <reference value="urn:uuid:2a32666e-84a2-4f90-a6a6-d5451ae2e32f" />
    </author>
    <title value="Cardiology Service Discharge Summary" />
    <section>
        <title value="GP practice" />
        <code>
            <coding>
                <system value="https://fhir.hl7.org.uk/CodeSystem/UKCore-RecordStandardHeadings" />
                <code value="general-practitioner-practice" />
                <display value="GP practice" />
            </coding>
        </code>
        <text>
            <status value="additional" />
            <div xmlns="http://www.w3.org/1999/xhtml"><table width="100%"><tbody><tr><th>GP name</th><td><p>Prefix: Dr</p><p>Given Name: John</p><p>Family Name: Lorenzo</p></td></tr><tr><th>GP practice details</th><td><p>Name: MGP Medical Centre</p><p>Address:</p><p>Address Line: 1 MGP House, Overtown</p><p>City: Leeds</p><p>Post Code: LS21 7PA</p></td></tr></tbody></table></div>
        </text>
        <entry>
            <reference value="urn:uuid:bd0b7423-6c10-40a0-b829-8e52afea92d3" />
        </entry>
    </section>
    <!--   other sections removed for readability   -->
</Composition>

Example Coded Resources

This text section should be linked to a UKCore-Organization profiled resource.

{
    "resourceType": "Organization",
    "meta": {
        "profile":  [
            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization"
        ]
    },
    "identifier":  [
        {
            "system": "https://fhir.nhs.uk/Id/ods-organization-code",
            "value": "GP123456"
        }
    ],
    "name": "MGP Medical Centre",
    "address":  [
        {
            "line":  [
                "1 MGP House, Overtown"
            ],
            "city": "Leeds",
            "postalCode": "LS21 7PA"
        }
    ]
}
<Organization xmlns="http://hl7.org/fhir">
    <meta>
        <profile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization" />
    </meta>
    <identifier>
        <system value="https://fhir.nhs.uk/Id/ods-organization-code" />
        <value value="GP123456" />
    </identifier>
    <name value="MGP Medical Centre" />
    <address>
        <line value="1 MGP House, Overtown" />
        <city value="Leeds" />
        <postalCode value="LS21 7PA" />
    </address>
</Organization>
back to top