Issue Assessment Notice

The Assessment Notice will often be sent with the ReferralRequest, however it is not uncommon for the Social Care Practitioners to get involved early in the discharge process, e.g. to help triage pathway and/or have visibility that one of their service users has been admitted to hospital and may need an early review. By enabling the referral to be sent separately to the Assessment Notice allows Social Care Teams to undertake any Primary care duties, before the patient has formally consented to an assessment.

HTTPS Request

Method:

POST

Request URL:

The request URL will consist of 'https://'+'{Host}'+'{BaseURL}'+'?'+'{QueryString}'

Host Environments:

The Host URLs will determined by the service provider, for example the host URLs for the Nottinghamshire County Council Social Care Data Service are:

Environment Host
Test health-interoperability-test.nottscc.gov.uk
Live health-interoperability.nottscc.gov.uk

Base URL:

/ReferralService/v3/QuestionnaireResponse

Query String /Parameters:

None

Example Request Url:

https://health-interoperability-test.nottscc.gov.uk/ReferralService/v3/QuestionnaireResponse



Request Body:

The Request body should be in either json or xml format

The primary base FHIR resource is a SHD-QuestionnaireResponse-AssessmentNotice

See Examples for an illustration of the Request body of a typical Referral to Social Care for a Supported Hospital Discharge.

Response

Success

SHALL return a HTTP status code 201 Created on successful execution of the request

Error

An Error SHALL return one of the following HTTP Status Codes and an OperationOutcome with details of the issue:

HTTP Code Display Description
400 Bad Request Poor Syntax or breaks a core FHIR constraint
401 Unauthorized User is not authorised to perform the request.
403 Forbidden The request is forbidden, authorization will not help.
409 Conflict User has requested to create a resource that already exists.
422 Unprocessable Entity The syntax is valid, but cannot be processed, e.g. breaks a business rule.
500 Internal Error The server encountered an unexpected condition which prevented it from fulfilling the request.

JSON example of an OperationOutcome for a 422 Unprocessable Entity

{
    "resourceType": "OperationOutcome",
    "issue":  [
        {
            "severity": "fatal",
            "code": "processing",
            "diagnostics": "Create operation is invalid when there is an existing QuestionnaireResponse instance",
            "location":  [
                "QuestionnaireResponse.basedOn[0]"
            ]
        }
    ]
}


XML example of an OperationOutcome for a 422 Unprocessable Entity

<OperationOutcome xmlns="http://hl7.org/fhir">
    <issue>
        <severity value="fatal" />
        <code value="processing" />
        <diagnostics value="Create operation is invalid when there is an existing QuestionnaireResponse instance" />
        <location value="QuestionnaireResponse.basedOn[0]" />
    </issue>
</OperationOutcome>


Rules and Mappings

The generic business context data mappings for the 'Madatory' and 'Must Support' elements are detailed in the Profiles section, however the section below deatils any specific rules or contrains that apply to this use case.

Pre-requisites

The patient MUST have an Active Referral Request
The patient MUST NOT already have been issued an Assessment Notice for the referral

Data Mappings

SHD-QuestionnaireResponse-AssessmentNotice

FHIR Element Card. Type Description/Business Context
QuestionnaireResponse.basedOn 1..1 Reference (CareConnect-SHD-ReferralRequest-1) Reference to the ReferralRequest the Assessment Notice relates to SHALL be provided when sent after the ReferralRequest.

Note: Absolute or Relative referencing is supported

Examples

Request Body

JSON example of a SHD-QuestionnaireResponse-AssessmentNotice

{
    "resourceType": "QuestionnaireResponse",
    "meta": {
        "profile":  [
            "https://fhir.nottinghamshire.gov.uk/STU3/StructureDefinition/SHD-QuestionnaireResponse-AssessmentNotice"
        ]
    },
    "basedOn":  [
        {
            "reference": "ReferralRequest/123456"
        }
    ],
    "questionnaire": {
        "reference": "https://fhir.nottinghamshire.gov.uk/STU3/Questionnaire/SHD-Questionnaire-AssessmentNotice"
    },
    "status": "completed",
    "authored": "2019-02-01T08:04:00+00:00",
    "item":  [
        {
            "linkId": "1.1",
            "text": "Name of person who completed the Assessment Notice",
            "answer":  [
                {
                    "valueString": "AN Nurse"
                }
            ]
        },
        {
            "linkId": "2.1",
            "text": "Has the patient been consulted regarding this Assessment Notice?",
            "answer":  [
                {
                    "valueBoolean": true
                }
            ]
        },
        {
            "linkId": "2.2",
            "text": "Has the patient's carer (if applicable) been consulted regarding the Assessment Notice?",
            "answer":  [
                {
                    "valueCoding": {
                        "system": "https://fhir.nottinghamshire.gov.uk/STU3/codesystem/SHD-CarerConsultation",
                        "code": "Y",
                        "display": "Yes"
                    }
                }
            ]
        },
        {
            "linkId": "3.1",
            "text": "Has the patient consented to this Assessment Notice?",
            "answer":  [
                {
                    "valueCoding": {
                        "system": "https://fhir.nottinghamshire.gov.uk/STU3/codesystem/SHD-PatientConsent",
                        "code": "L",
                        "display": "Lacks Mental Capacity"
                    }
                }
            ]
        },
        {
            "linkId": "3.2",
            "text": "What is the source of the third party consent for this assessment notice?",
            "answer":  [
                {
                    "valueCoding": {
                        "system": "https://fhir.nottinghamshire.gov.uk/STU3/codesystem/SHD-ThirdPartyConsentSource",
                        "code": "C",
                        "display": "Legal Representative (Carer)"
                    }
                }
            ]
        },
        {
            "linkId": "4.1",
            "text": "Has the provision of NHS Continuing Health Care been considered?",
            "answer":  [
                {
                    "valueBoolean": true
                }
            ]
        }
    ]
}


XML example of a SHD-QuestionnaireResponse-AssessmentNotice

<QuestionnaireResponse xmlns="http://hl7.org/fhir">
    <meta>
        <profile value="https://fhir.nottinghamshire.gov.uk/STU3/StructureDefinition/SHD-QuestionnaireResponse-AssessmentNotice" />
    </meta>
    <basedOn>
        <reference value="ReferralRequest/123456" />
    </basedOn>
    <questionnaire>
        <reference value="https://fhir.nottinghamshire.gov.uk/STU3/Questionnaire/SHD-Questionnaire-AssessmentNotice" />
    </questionnaire>
    <status value="completed" />
    <authored value="2019-02-01T08:04:00+00:00" />
    <item>
        <linkId value="1.1" />
        <text value="Name of person who completed the Assessment Notice" />
        <answer>
            <valueString value="AN Nurse" />
        </answer>
    </item>
    <item>
        <linkId value="2.1" />
        <text value="Has the patient been consulted regarding this Assessment Notice?" />
        <answer>
            <valueBoolean value="true" />
        </answer>
    </item>
    <item>
        <linkId value="2.2" />
        <text value="Has the patient&#39;s carer (if applicable) been consulted regarding the Assessment Notice?" />
        <answer>
            <valueCoding>
                <system value="https://fhir.nottinghamshire.gov.uk/STU3/codesystem/SHD-CarerConsultation" />
                <code value="Y" />
                <display value="Yes" />
            </valueCoding>
        </answer>
    </item>
    <item>
        <linkId value="3.1" />
        <text value="Has the patient consented to this Assessment Notice?" />
        <answer>
            <valueCoding>
                <system value="https://fhir.nottinghamshire.gov.uk/STU3/codesystem/SHD-PatientConsent" />
                <code value="L" />
                <display value="Lacks Mental Capacity" />
            </valueCoding>
        </answer>
    </item>
    <item>
        <linkId value="3.2" />
        <text value="What is the source of the third party consent for this assessment notice?" />
        <answer>
            <valueCoding>
                <system value="https://fhir.nottinghamshire.gov.uk/STU3/codesystem/SHD-ThirdPartyConsentSource" />
                <code value="C" />
                <display value="Legal Representative (Carer)" />
            </valueCoding>
        </answer>
    </item>
    <item>
        <linkId value="4.1" />
        <text value="Has the provision of NHS Continuing Health Care been considered?" />
        <answer>
            <valueBoolean value="true" />
        </answer>
    </item>
</QuestionnaireResponse>