Description of use case on Spine via the FHIR® Reasonable Adjustments API

1 Add Adjustment, Add Impairment

Trigger:

Pre-operative appointment with Learning Disability Nurse N.

System Scope:

ClientSystem includes GPSystem client, SCRa, 1-click etc.
ServerSystem includes Spine, PDS, SDS, FlagServer etc.

Summary:

During appointment Nurse discusses RA Record, Patient requests recording of ‘Easy Read’ Adjustment, addition of ‘Mental Health Disability w supporting text’ Impairment.

Pre

  • Practitioner logged into ClientSystem, traces & verifies demographic info
  • Practitioner opens Patient’s RARecord
    • System retrieves and displays RARecord for Patient’s NHS Number
  • Practitioner discusses RARecord and RA with Patient
  • Patient agrees to add Adjustment ‘Easy Read’
  • Patient agrees to add Impairment ‘Mental Health Disability w supporting text’

Main

  • Patient agrees to add Adjustment ‘Easy Read’
    • Practitioner adds Adjustment from coded picklist
      • ClientSystem captures and structures as new RARecord-Flag-1 resource
  • Patient agrees to add Impairment ‘Mental Health Disability’ with supporting text
    • Practitioner adds Impairment from coded picklist (elaborates w separate freetext)
      • ClientSystem captures and structures Impairment information as new Impairment (CareConnect-RARecord-Condition-1) resource (xml) (json)
  • Practitioner commits RARecord
    • ClientSystem submits Create Flag request (xml) (json)
      • ServerSystem submits Create Flag response (xml) (json)
    • ClientSystem captures and structures Provenance information as new Provenance (RARecord-Provenance-1) resource (xml) (json)
      • ClientSystem contains new Impairment resource within CareConnect-RARecord-List-1 resource
      • ClientSystem contains new Provenance resource within CareConnect-RARecord-List-1 resource (xml) (json)
      • ClientSystem submits Update List Condition request (xml) (json)
        • ServerSystem submits Update List Condition response (xml) (json)

2 Interaction Examples

Examples of resources, http requests, responses and payloads

2.1 Create Condition Resource - xml example

resource

Create Condition Resource XML Example

<!-- xml example file 
AddExample-CreateConditionRequest.xml -->
<Condition xmlns="http://hl7.org/fhir">
    <meta>
        <profile value="https://fhir.nhs.uk/STU3/StructureDefinition/CareConnect-RARecord-Condition-1" />
    </meta>
    <clinicalStatus value="active"/>
    <category>
        <coding>
            <system value="https://fhir.hl7.org.uk/STU3/CodeSystem/CareConnect-ConditionCategory-1"/>
            <code value="issue"/>
            <display value="Issue"/>
        </coding>
    </category>
    <code>
        <coding>
            <system value="https://fhir.nhs.uk/STU3/CodeSystem/CodeSystem-RARecord-ConditionCode-1"/>
            <code value="720821000000105"/>
            <display value="Mental health condition(s)"/>
        </coding>
        <text value="Patient diagnosed with Stranger anxiety (disorder). Consider home-visit"/>
    </code>
    <subject>
        <reference value="demographics.spineservices.nhs.uk/STU3/Patient/999999998"/>
    </subject>
</Condition>

2.2 Create Condition Resource - json example

resource

Create Condition Resource JSON Example

{
  "resourceType": "Condition",
  "fhir_comments": [
    " xml example fileAddExample-CreateConditionRequest.xml "
  ],
  "meta": {
    "profile": [
      "https://fhir.nhs.uk/STU3/StructureDefinition/CareConnect-RARecord-Condition-1"
    ]
  },
  "clinicalStatus": "active",
  "category": [
    {
      "coding": [
        {
          "system": "https://fhir.hl7.org.uk/STU3/CodeSystem/CareConnect-ConditionCategory-1",
          "code": "issue",
          "display": "Issue"
        }
      ]
    }
  ],
  "code": {
    "coding": [
      {
        "system": "https://fhir.nhs.uk/STU3/CodeSystem/CodeSystem-RARecord-ConditionCode-1",
        "code": "720821000000105",
        "display": "Mental health condition(s)"
      }
    ],
    "text": "Patient diagnosed with Stranger anxiety (disorder). Consider home-visit"
  },
  "subject": {
    "reference": "demographics.spineservices.nhs.uk/STU3/Patient/999999998"
  }
}

2.3 Create Flag Request - xml example

http request & headers

POST https://clinicals.spineservices.nhs.uk/STU3/Flag HTTP/1.1
Authorization: Bearer [jwt_token_string]
FromASID: 654321123456
ToASID: 987654456789
Content-Type: application/fhir+xml
Prefer: return=representation
InteractionID: urn:nhs:names:services:raflags:Flag.write:1

http body

Create Flag Request XML Example

<!-- xml example file 
AddExample-CreateFlagRequest.xml -->
<Flag xmlns="http://hl7.org/fhir">
    <meta>
        <profile value="https://fhir.nhs.uk/STU3/StructureDefinition/RARecord-Flag-1"/>
    </meta>
    <extension url="https://fhir.nhs.uk/STU3/StructureDefinition/Extension-RARecord-AdjustmentCategory-1">
        <valueCodeableConcept>
            <coding>
                <system value="https://fhir.nhs.uk/STU3/CodeSystem/CodeSystem-RARecord-AdjustmentCategories-1"/>
                <code value="comms"/>
                <display value="Communication"/>
            </coding>
        </valueCodeableConcept>
    </extension>
    <status value="active"/>
    <category>
        <coding>
            <system value="https://fhir.nhs.uk/STU3/CodeSystem/CodeSystem-RARecord-FlagCategory-1"/>
            <code value="reasonable adjustments flag"/>
            <display value="Reasonable Adjustments Flag"/>
        </coding>
    </category>
    <code>
        <coding>
            <system value="https://fhir.nhs.uk/STU3/CodeSystem/CodeSystem-RARecord-AccessibleInformationAdjustments-1"/>
            <code value="requiresinformationineasyread"/>
            <display value="Requires information in Easyread"/>
        </coding>
    </code>
    <subject>
            <reference value="demographics.spineservices.nhs.uk/STU3/Patient/999999998"/>
    </subject>
</Flag>

2.4 Create Flag Request - json example

http request & headers

POST https://clinicals.spineservices.nhs.uk/STU3/Flag HTTP/1.1
Authorization: Bearer [jwt_token_string]
FromASID: 654321123456
ToASID: 987654456789
Content-Type: application/fhir+json
Prefer: return=representation
InteractionID: urn:nhs:names:services:raflags:Flag.write:1

http body

Create Flag Request JSON Example

{
  "resourceType": "Flag",
  "fhir_comments": [
    " xml example fileAddExample-CreateFlagRequest.xml "
  ],
  "meta": {
    "profile": [
      "https://fhir.nhs.uk/STU3/StructureDefinition/RARecord-Flag-1"
    ]
  },
  "extension": [
    {
      "url": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-RARecord-AdjustmentCategory-1",
      "valueCodeableConcept": {
        "coding": [
          {
            "system": "https://fhir.nhs.uk/STU3/CodeSystem/CodeSystem-RARecord-AdjustmentCategories-1",
            "code": "comms",
            "display": "Communication"
          }
        ]
      }
    }
  ],
  "status": "active",
  "category": {
    "coding": [
      {
        "system": "https://fhir.nhs.uk/STU3/CodeSystem/CodeSystem-RARecord-FlagCategory-1",
        "code": "reasonable adjustments flag",
        "display": "Reasonable Adjustments Flag"
      }
    ]
  },
  "code": {
    "coding": [
      {
        "system": "https://fhir.nhs.uk/STU3/CodeSystem/CodeSystem-RARecord-AccessibleInformationAdjustments-1",
        "code": "requiresinformationineasyread",
        "display": "Requires information in Easyread"
      }
    ]
  },
  "subject": {
    "reference": "demographics.spineservices.nhs.uk/STU3/Patient/999999998"
  }
}

2.5 Create Flag Response - xml example

http request & headers

HTTP/1.1 201 Created
Date: Wed, 24 Jul 2018 10:01:00 GMT
Last-Modified:2018-07-24T10:01:00+00:00
Location: https://clinicals.spineservices.nhs.uk/STU3/Flag/2acb0536-0a8f-48c9-8a2f-6ee82860f186/_history/aa755bd6-2be9-4971-972a-6724879c5cb1
ETag: W/"aa755bd6-2be9-4971-972a-6724879c5cb1”
Content-Type: application/fhir+xml

http body

Create Flag Response XML Example

<!-- xml example file 
AddExample-CreateFlagResponse.xml -->
<Flag xmlns="http://hl7.org/fhir">
    <id value="2acb0536-0a8f-48c9-8a2f-6ee82860f186"/>
    <meta>
        <versionId value="aa755bd6-2be9-4971-972a-6724879c5cb1"/>
        <lastUpdated value="2018-07-24T10:01:00+00:00"/>
        <profile value="https://fhir.nhs.uk/STU3/StructureDefinition/RARecord-Flag-1"/>
    </meta>
    <contained>
        <Provenance>
            <id value="43124f67-b09d-453d-b889-a5e2e8780b9e"/>
            <meta>
                <profile value="https://fhir.nhs.uk/STU3/StructureDefinition/RARecord-Provenance-1"/>
            </meta>
            <target>
                <reference value="Flag/2acb0536-0a8f-48c9-8a2f-6ee82860f186"/>
            </target>
            <recorded value="2018-07-24T10:05:33+00:00"/>
            <agent>
                <role>
                    <coding>
                        <system value="https://fhir.nhs.uk/STU3/CodeSystem/CareConnect-SDSJobRoleName-1"/>
                        <code value="R1974"/>
                        <display value="Community Learning Disabilities Nurse"/>
                    </coding>
                </role>
                <whoReference>
                    <reference value="https://sds.spineservices.nhs.uk/STU3/Practitioner/4tr6ee6a9"/>
                    <display value="Nurse N"/>
                </whoReference>
                <onBehalfOfReference>
                    <reference value="https://directory.spineservices.nhs.uk/STU3/Organization/a3e5i7"/>
                    <display value="Some Hospital Learning Disability Support Department"/>
                </onBehalfOfReference>
            </agent>
        </Provenance>
    </contained>
    <extension url="https://fhir.nhs.uk/STU3/StructureDefinition/Extension-RARecord-Provenance-1">
        <extension url="created">
            <valueReference>
                <reference value="#43124f67-b09d-453d-b889-a5e2e8780b9e"/>
            </valueReference>
        </extension>
    </extension>
    <extension url="https://fhir.nhs.uk/STU3/StructureDefinition/Extension-RARecord-AdjustmentCategory-1">
        <valueCodeableConcept>
            <coding>
                <system value="https://fhir.nhs.uk/STU3/CodeSystem/CodeSystem-RARecord-AdjustmentCategories-1"/>
                <code value="comms"/>
                <display value="Communication"/>
            </coding>
        </valueCodeableConcept>
    </extension>
    <status value="active"/>
    <category>
        <coding>
            <system value="https://fhir.nhs.uk/STU3/CodeSystem/CodeSystem-RARecord-FlagCategory-1"/>
            <code value="reasonable adjustments flag"/>
            <display value="Reasonable Adjustments Flag"/>
        </coding>
    </category>
    <code>
        <coding>
            <system value="https://fhir.nhs.uk/STU3/CodeSystem/CodeSystem-RARecord-AccessibleInformationAdjustments-1"/>
            <code value="requiresinformationineasyread"/>
            <display value="Requires information in Easyread"/>
        </coding>
    </code>
    <subject>
            <reference value="demographics.spineservices.nhs.uk/STU3/Patient/999999998"/>
    </subject>
</Flag>

2.6 Create Flag Response - json example

http request & headers

HTTP/1.1 201 Created
Date: Wed, 24 Jul 2018 10:01:00 GMT
Last-Modified:2018-07-24T10:01:00+00:00
Location: https://clinicals.spineservices.nhs.uk/STU3/Flag/2acb0536-0a8f-48c9-8a2f-6ee82860f186/_history/aa755bd6-2be9-4971-972a-6724879c5cb1
ETag: W/"aa755bd6-2be9-4971-972a-6724879c5cb1”
Content-Type: application/fhir+json

http body

Create Flag Response JSON Example

{
  "resourceType": "Flag",
  "id": "2acb0536-0a8f-48c9-8a2f-6ee82860f186",
  "fhir_comments": [
    " xml example fileAddExample-CreateFlagResponse.xml "
  ],
  "meta": {
    "versionId": "aa755bd6-2be9-4971-972a-6724879c5cb1",
    "lastUpdated": "2018-07-24T10:01:00+00:00",
    "profile": [
      "https://fhir.nhs.uk/STU3/StructureDefinition/RARecord-Flag-1"
    ]
  },
  "contained": [
    {
      "resourceType": "Provenance",
      "id": "43124f67-b09d-453d-b889-a5e2e8780b9e",
      "meta": {
        "profile": [
          "https://fhir.nhs.uk/STU3/StructureDefinition/RARecord-Provenance-1"
        ]
      },
      "target": [
        {
          "reference": "Flag/2acb0536-0a8f-48c9-8a2f-6ee82860f186"
        }
      ],
      "recorded": "2018-07-24T10:05:33+00:00",
      "agent": [
        {
          "role": [
            {
              "coding": [
                {
                  "system": "https://fhir.nhs.uk/STU3/CodeSystem/CareConnect-SDSJobRoleName-1",
                  "code": "R1974",
                  "display": "Community Learning Disabilities Nurse"
                }
              ]
            }
          ],
          "whoReference": {
            "reference": "https://sds.spineservices.nhs.uk/STU3/Practitioner/4tr6ee6a9",
            "display": "Nurse N"
          },
          "onBehalfOfReference": {
            "reference": "https://directory.spineservices.nhs.uk/STU3/Organization/a3e5i7",
            "display": "Some Hospital Learning Disability Support Department"
          }
        }
      ]
    }
  ],
  "extension": [
    {
      "url": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-RARecord-Provenance-1",
      "extension": [
        {
          "url": "created",
          "valueReference": {
            "reference": "#43124f67-b09d-453d-b889-a5e2e8780b9e"
          }
        }
      ]
    },
    {
      "url": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-RARecord-AdjustmentCategory-1",
      "valueCodeableConcept": {
        "coding": [
          {
            "system": "https://fhir.nhs.uk/STU3/CodeSystem/CodeSystem-RARecord-AdjustmentCategories-1",
            "code": "comms",
            "display": "Communication"
          }
        ]
      }
    }
  ],
  "status": "active",
  "category": {
    "coding": [
      {
        "system": "https://fhir.nhs.uk/STU3/CodeSystem/CodeSystem-RARecord-FlagCategory-1",
        "code": "reasonable adjustments flag",
        "display": "Reasonable Adjustments Flag"
      }
    ]
  },
  "code": {
    "coding": [
      {
        "system": "https://fhir.nhs.uk/STU3/CodeSystem/CodeSystem-RARecord-AccessibleInformationAdjustments-1",
        "code": "requiresinformationineasyread",
        "display": "Requires information in Easyread"
      }
    ]
  },
  "subject": {
    "reference": "demographics.spineservices.nhs.uk/STU3/Patient/999999998"
  }
}

2.7 Create Provenance Resource - xml example

resource

Create Provenance Resource XML Example

<!-- AddExample-CreateProvenanceResource.xml -->
<Provenance>
    <id value="fe71140b-3a30-45a3-b492-695b5f5e3717"/>
    <meta>
        <profile value="https://fhir.nhs.uk/STU3/StructureDefinition/RARecord-Provenance-1"/>
    </meta>
    <target>
        <reference value="Condition/6be8bee9-e727-4564-a904-49507576f8be"/>
    </target>
    <recorded value="2018-07-24T10:05:33+00:00"/>
    <agent>
        <role>
            <coding>
                <system value="https://fhir.nhs.uk/STU3/CodeSystem/CareConnect-SDSJobRoleName-1"/>
                <code value="R1974"/>
                <display value="Community Learning Disabilities Nurse"/>
            </coding>
        </role>
        <whoReference>
            <reference value="https://sds.spineservices.nhs.uk/STU3/Practitioner/4tr6ee6a9"/>
            <display value="Nurse N"/>
        </whoReference>
        <onBehalfOfReference>
            <reference value="https://directory.spineservices.nhs.uk/STU3/Organization/a3e5i7"/>
            <display value="Some Hospital Learning Disability Support Department"/>
        </onBehalfOfReference>
    </agent>
</Provenance>

2.8 Create Provenance Resource - json example

resource

Create Provenance Resource JSON Example

{
  "resourceType": "Condition",
  "fhir_comments": [
    " json example AAJSONPlaceholder.json "
  ]
}

2.9 Add to List Condition Resource - xml example

resource

Create List Condition Resource XML Example

<!-- AddExample-ListConditionResource.xml -->
<List xmlns="http://hl7.org/fhir">
    <id value="130f416a-055d-4a5d-a453-2b7c2de3b57b"/>
    <meta>
        <versionId value="f2fef5e5-c38a-408c-a9bc-2d49923928f8"/>
        <profile value="https://fhir.nhs.uk/STU3/StructureDefinition/CareConnect-RARecord-List-1"/>
    </meta>
    <contained>
        <Condition xmlns="http://hl7.org/fhir">
            <id value="57f04652-6dd0-4135-a560-f9091b1b26fa"/>
            <meta>
                <versionId value="557ccfc3-0c78-48bf-aedd-70cc08af2ba1"/>
                <lastUpdated value="2018-07-23T11:00:00+00:00"/>
                <profile value="https://fhir.nhs.uk/STU3/StructureDefinition/CareConnect-RARecord-Condition-1" />
            </meta>
            <extension url="https://fhir.nhs.uk/STU3/StructureDefinition/Extension-RARecord-Provenance-1">
                <extension url="created">
                    <valueReference>
                        <reference value="urn:uuid:8ce7de6b-1307-432d-8e96-ae6a613ca3e4"/>
                    </valueReference>
                </extension>
            </extension>
            <clinicalStatus value="active"/>
            <category>
                <coding>
                    <system value="https://fhir.hl7.org.uk/STU3/CodeSystem/CareConnect-ConditionCategory-1"/>
                    <code value="issue"/>
                    <display value="Issue"/>
                </coding>
            </category>
            <code>
                <coding>
                    <system value="https://fhir.nhs.uk/STU3/CodeSystem/CodeSystem-RARecord-ConditionCode-1"/>
                    <code value="1855002"/>
                    <display value="Learning Disability(s)"/>
                </coding>
            </code>
            <subject>
                <reference value="demographics.spineservices.nhs.uk/STU3/Patient/999999998"/>
            </subject>
        </Condition>
    </contained>
    <contained>
        <Provenance>
            <id value="8ce7de6b-1307-432d-8e96-ae6a613ca3e4"/>
            <meta>
                <profile value="https://fhir.nhs.uk/STU3/StructureDefinition/RARecord-Provenance-1"/>
            </meta>
            <target>
                <reference value="Condition/57f04652-6dd0-4135-a560-f9091b1b26fa"/>
            </target>
            <recorded value="2018-07-23T11:00:00+00:00"/>
            <agent>
                <role>
                    <coding>
                        <system value="https://fhir.nhs.uk/STU3/CodeSystem/CareConnect-SDSJobRoleName-1"/>
                        <code value="R0260"/>
                        <display value="General Medical Practitioner"/>
                    </coding>
                </role>
                <whoReference>
                    <reference value="https://sds.spineservices.nhs.uk/STU3/Practitioner/2ee4tr6a9"/>
                    <display value="Dr.D"/>
                </whoReference>
                <onBehalfOfReference>
                    <reference value="https://directory.spineservices.nhs.uk/STU3/Organization/a3e5i7"/>
                    <display value="Some GP Clinic"/>
                </onBehalfOfReference>
            </agent>
        </Provenance>
    </contained>
    <contained>
        <Condition xmlns="http://hl7.org/fhir">
            <id value="6be8bee9-e727-4564-a904-49507576f8be"/>
            <meta>
                <versionId value="a9b91e41-30ad-43a4-a2da-79b9be622169"/>
                <lastUpdated value="2018-07-24T10:01:00+00:00"/>
                <profile value="https://fhir.nhs.uk/STU3/StructureDefinition/CareConnect-RARecord-Condition-1" />
            </meta>
            <extension url="https://fhir.nhs.uk/STU3/StructureDefinition/Extension-RARecord-Provenance-1">
                <extension url="created">
                    <valueReference>
                        <reference value="urn:uuid:fe71140b-3a30-45a3-b492-695b5f5e3717"/>
                    </valueReference>
                </extension>
            </extension>
            <clinicalStatus value="active"/>
            <category>
                <coding>
                    <system value="https://fhir.hl7.org.uk/STU3/CodeSystem/CareConnect-ConditionCategory-1"/>
                    <code value="issue"/>
                    <display value="Issue"/>
                </coding>
            </category>
            <code>
                <coding>
                    <system value="https://fhir.nhs.uk/STU3/CodeSystem/CodeSystem-RARecord-ConditionCode-1"/>
                    <code value="720821000000105"/>
                    <display value="Mental health condition(s)"/>
                </coding>
                <text value="Patient diagnosed with Stranger anxiety (disorder). Consider home-visit"/>
            </code>
            <subject>
                <reference value="demographics.spineservices.nhs.uk/STU3/Patient/999999998"/>
            </subject>
        </Condition>
    </contained>
    <contained>
        <Provenance>
            <id value="fe71140b-3a30-45a3-b492-695b5f5e3717"/>
            <meta>
                <profile value="https://fhir.nhs.uk/STU3/StructureDefinition/RARecord-Provenance-1"/>
            </meta>
            <target>
                <reference value="Condition/6be8bee9-e727-4564-a904-49507576f8be"/>
            </target>
            <recorded value="2018-07-24T10:01:00+00:00"/>
            <agent>
                <role>
                    <coding>
                        <system value="https://fhir.nhs.uk/STU3/CodeSystem/CareConnect-SDSJobRoleName-1"/>
                        <code value="R1974"/>
                        <display value="Community Learning Disabilities Nurse"/>
                    </coding>
                </role>
                <whoReference>
                    <reference value="https://sds.spineservices.nhs.uk/STU3/Practitioner/4tr6ee6a9"/>
                    <display value="Nurse N"/>
                </whoReference>
                <onBehalfOfReference>
                    <reference value="https://directory.spineservices.nhs.uk/STU3/Organization/a3e5i7"/>
                    <display value="Some Hospital Learning Disability Support Department"/>
                </onBehalfOfReference>
            </agent>
        </Provenance>
    </contained>
    
    <status value="current"/>
    <mode value="changes"/>
    <title value="Reasonable Adjustment List"/>
    <code>
        <coding>
            <system value="http://snomed.info/sct"/>
            <code value="1094391000000102"/>
            <display value="Reasonable adjustments for health and care access"/>
        </coding>
    </code>
    <subject>
        <reference value="demographics.spineservices.nhs.uk/STU3/Patient/999999998"/>
    </subject>
    <date value="2018-07-23T11:00:00+00:00"/>
    <entry>
        <deleted value="false"/>
        <date value="2018-07-23T11:00:00+00:00"/>
        <item>
            <reference value="urn:uuid:557ccfc3-0c78-48bf-aedd-70cc08af2ba1"/>
        </item>
    </entry>
    <entry>
        <deleted value="false"/>
        <date value="2018-07-23T11:00:00+00:00"/>
        <item>
            <reference value="urn:uuid:8ce7de6b-1307-432d-8e96-ae6a613ca3e4"/>
        </item>
    </entry>
    <entry>
        <deleted value="false"/>
        <date value="2018-07-24T10:01:00+00:00"/>
        <item>
            <reference value="urn:uuid:557ccfc3-0c78-48bf-aedd-70cc08af2ba1"/>
        </item>
    </entry>
    <entry>
        <deleted value="false"/>
        <date value="2018-07-24T10:01:00+00:00"/>
        <item>
            <reference value="urn:uuid:8ce7de6b-1307-432d-8e96-ae6a613ca3e4"/>
        </item>
    </entry>
</List>

2.10 Add to List Condition Resource - json example

resource

Create List Condition Resource JSON Example

{
  "resourceType": "Condition",
  "fhir_comments": [
    " json example AAJSONPlaceholder.json "
  ]
}

2.11 Update List Condition Request - xml example

http request & headers

POST https://clinicals.spineservices.nhs.uk/STU3/List HTTP/1.1
Authorization: Bearer [jwt_token_string]
FromASID: 123456123456
ToASID: 987654456789
Content-Type: application/fhir+xml
Prefer: return=representation
InteractionID: urn:nhs:names:services:raflags:List.write:1

http body

Create List Condition Request XML Example

<!-- AddExample-ListConditionResource.xml -->
<List xmlns="http://hl7.org/fhir">
    <id value="130f416a-055d-4a5d-a453-2b7c2de3b57b"/>
    <meta>
        <versionId value="f2fef5e5-c38a-408c-a9bc-2d49923928f8"/>
        <profile value="https://fhir.nhs.uk/STU3/StructureDefinition/CareConnect-RARecord-List-1"/>
    </meta>
    <contained>
        <Condition xmlns="http://hl7.org/fhir">
            <id value="57f04652-6dd0-4135-a560-f9091b1b26fa"/>
            <meta>
                <versionId value="557ccfc3-0c78-48bf-aedd-70cc08af2ba1"/>
                <lastUpdated value="2018-07-23T11:00:00+00:00"/>
                <profile value="https://fhir.nhs.uk/STU3/StructureDefinition/CareConnect-RARecord-Condition-1" />
            </meta>
            <extension url="https://fhir.nhs.uk/STU3/StructureDefinition/Extension-RARecord-Provenance-1">
                <extension url="created">
                    <valueReference>
                        <reference value="urn:uuid:8ce7de6b-1307-432d-8e96-ae6a613ca3e4"/>
                    </valueReference>
                </extension>
            </extension>
            <clinicalStatus value="active"/>
            <category>
                <coding>
                    <system value="https://fhir.hl7.org.uk/STU3/CodeSystem/CareConnect-ConditionCategory-1"/>
                    <code value="issue"/>
                    <display value="Issue"/>
                </coding>
            </category>
            <code>
                <coding>
                    <system value="https://fhir.nhs.uk/STU3/CodeSystem/CodeSystem-RARecord-ConditionCode-1"/>
                    <code value="1855002"/>
                    <display value="Learning Disability(s)"/>
                </coding>
            </code>
            <subject>
                <reference value="demographics.spineservices.nhs.uk/STU3/Patient/999999998"/>
            </subject>
        </Condition>
    </contained>
    <contained>
        <Provenance>
            <id value="8ce7de6b-1307-432d-8e96-ae6a613ca3e4"/>
            <meta>
                <profile value="https://fhir.nhs.uk/STU3/StructureDefinition/RARecord-Provenance-1"/>
            </meta>
            <target>
                <reference value="Condition/57f04652-6dd0-4135-a560-f9091b1b26fa"/>
            </target>
            <recorded value="2018-07-23T11:00:00+00:00"/>
            <agent>
                <role>
                    <coding>
                        <system value="https://fhir.nhs.uk/STU3/CodeSystem/CareConnect-SDSJobRoleName-1"/>
                        <code value="R0260"/>
                        <display value="General Medical Practitioner"/>
                    </coding>
                </role>
                <whoReference>
                    <reference value="https://sds.spineservices.nhs.uk/STU3/Practitioner/2ee4tr6a9"/>
                    <display value="Dr.D"/>
                </whoReference>
                <onBehalfOfReference>
                    <reference value="https://directory.spineservices.nhs.uk/STU3/Organization/a3e5i7"/>
                    <display value="Some GP Clinic"/>
                </onBehalfOfReference>
            </agent>
        </Provenance>
    </contained>
    <contained>
        <Condition xmlns="http://hl7.org/fhir">
            <id value="6be8bee9-e727-4564-a904-49507576f8be"/>
            <meta>
                <versionId value="a9b91e41-30ad-43a4-a2da-79b9be622169"/>
                <lastUpdated value="2018-07-24T10:01:00+00:00"/>
                <profile value="https://fhir.nhs.uk/STU3/StructureDefinition/CareConnect-RARecord-Condition-1" />
            </meta>
            <extension url="https://fhir.nhs.uk/STU3/StructureDefinition/Extension-RARecord-Provenance-1">
                <extension url="created">
                    <valueReference>
                        <reference value="urn:uuid:fe71140b-3a30-45a3-b492-695b5f5e3717"/>
                    </valueReference>
                </extension>
            </extension>
            <clinicalStatus value="active"/>
            <category>
                <coding>
                    <system value="https://fhir.hl7.org.uk/STU3/CodeSystem/CareConnect-ConditionCategory-1"/>
                    <code value="issue"/>
                    <display value="Issue"/>
                </coding>
            </category>
            <code>
                <coding>
                    <system value="https://fhir.nhs.uk/STU3/CodeSystem/CodeSystem-RARecord-ConditionCode-1"/>
                    <code value="720821000000105"/>
                    <display value="Mental health condition(s)"/>
                </coding>
                <text value="Patient diagnosed with Stranger anxiety (disorder). Consider home-visit"/>
            </code>
            <subject>
                <reference value="demographics.spineservices.nhs.uk/STU3/Patient/999999998"/>
            </subject>
        </Condition>
    </contained>
    <contained>
        <Provenance>
            <id value="fe71140b-3a30-45a3-b492-695b5f5e3717"/>
            <meta>
                <profile value="https://fhir.nhs.uk/STU3/StructureDefinition/RARecord-Provenance-1"/>
            </meta>
            <target>
                <reference value="Condition/6be8bee9-e727-4564-a904-49507576f8be"/>
            </target>
            <recorded value="2018-07-24T10:01:00+00:00"/>
            <agent>
                <role>
                    <coding>
                        <system value="https://fhir.nhs.uk/STU3/CodeSystem/CareConnect-SDSJobRoleName-1"/>
                        <code value="R1974"/>
                        <display value="Community Learning Disabilities Nurse"/>
                    </coding>
                </role>
                <whoReference>
                    <reference value="https://sds.spineservices.nhs.uk/STU3/Practitioner/4tr6ee6a9"/>
                    <display value="Nurse N"/>
                </whoReference>
                <onBehalfOfReference>
                    <reference value="https://directory.spineservices.nhs.uk/STU3/Organization/a3e5i7"/>
                    <display value="Some Hospital Learning Disability Support Department"/>
                </onBehalfOfReference>
            </agent>
        </Provenance>
    </contained>
    
    <status value="current"/>
    <mode value="changes"/>
    <title value="Reasonable Adjustment List"/>
    <code>
        <coding>
            <system value="http://snomed.info/sct"/>
            <code value="1094391000000102"/>
            <display value="Reasonable adjustments for health and care access"/>
        </coding>
    </code>
    <subject>
        <reference value="demographics.spineservices.nhs.uk/STU3/Patient/999999998"/>
    </subject>
    <date value="2018-07-23T11:00:00+00:00"/>
    <entry>
        <deleted value="false"/>
        <date value="2018-07-23T11:00:00+00:00"/>
        <item>
            <reference value="urn:uuid:557ccfc3-0c78-48bf-aedd-70cc08af2ba1"/>
        </item>
    </entry>
    <entry>
        <deleted value="false"/>
        <date value="2018-07-23T11:00:00+00:00"/>
        <item>
            <reference value="urn:uuid:8ce7de6b-1307-432d-8e96-ae6a613ca3e4"/>
        </item>
    </entry>
    <entry>
        <deleted value="false"/>
        <date value="2018-07-24T10:01:00+00:00"/>
        <item>
            <reference value="urn:uuid:557ccfc3-0c78-48bf-aedd-70cc08af2ba1"/>
        </item>
    </entry>
    <entry>
        <deleted value="false"/>
        <date value="2018-07-24T10:01:00+00:00"/>
        <item>
            <reference value="urn:uuid:8ce7de6b-1307-432d-8e96-ae6a613ca3e4"/>
        </item>
    </entry>
</List>

2.12 Update List Condition Request - json example

http request & headers

POST https://clinicals.spineservices.nhs.uk/STU3/List HTTP/1.1
Authorization: Bearer [jwt_token_string]
FromASID: 123456123456
ToASID: 987654456789
Content-Type: application/fhir+json
Prefer: return=representation
InteractionID: urn:nhs:names:services:raflags:List.write:1

http body

Create List Condition Request JSON Example

{
  "resourceType": "Condition",
  "fhir_comments": [
    " json example AAJSONPlaceholder.json "
  ]
}

2.13 Update List Condition Response - xml example

http response & headers

HTTP/1.1 201 Created
Date: Tue, 23 Jul 2018 11:00:00 GMT
Last-Modified:2018-07-23T11:00:00+00:00
Location: https://clinicals.spineservices.nhs.uk/STU3/List/130f416a-055d-4a5d-a453-2b7c2de3b57b/_history/9554c538-1661-43b1-921b-efcbd2991c90
ETag: W/"9554c538-1661-43b1-921b-efcbd2991c90”
Content-Type: application/fhir+xml

http body

Create List Condition Response XML Example

<!-- AddExample-ListConditionResponse.xml -->
<List xmlns="http://hl7.org/fhir">
    <id value="130f416a-055d-4a5d-a453-2b7c2de3b57b"/>
    <meta>
        <versionId value="9554c538-1661-43b1-921b-efcbd2991c90"/>
        <profile value="https://fhir.nhs.uk/STU3/StructureDefinition/CareConnect-RARecord-List-1"/>
    </meta>
    <contained>
        <Condition xmlns="http://hl7.org/fhir">
            <id value="57f04652-6dd0-4135-a560-f9091b1b26fa"/>
            <meta>
                <versionId value="557ccfc3-0c78-48bf-aedd-70cc08af2ba1"/>
                <lastUpdated value="2018-07-23T11:00:00+00:00"/>
                <profile value="https://fhir.nhs.uk/STU3/StructureDefinition/CareConnect-RARecord-Condition-1" />
            </meta>
            <extension url="https://fhir.nhs.uk/STU3/StructureDefinition/Extension-RARecord-Provenance-1">
                <extension url="created">
                    <valueReference>
                        <reference value="urn:uuid:8ce7de6b-1307-432d-8e96-ae6a613ca3e4"/>
                    </valueReference>
                </extension>
            </extension>
            <clinicalStatus value="active"/>
            <category>
                <coding>
                    <system value="https://fhir.hl7.org.uk/STU3/CodeSystem/CareConnect-ConditionCategory-1"/>
                    <code value="issue"/>
                    <display value="Issue"/>
                </coding>
            </category>
            <code>
                <coding>
                    <system value="https://fhir.nhs.uk/STU3/CodeSystem/CodeSystem-RARecord-ConditionCode-1"/>
                    <code value="1855002"/>
                    <display value="Learning Disability(s)"/>
                </coding>
            </code>
            <subject>
                <reference value="demographics.spineservices.nhs.uk/STU3/Patient/999999998"/>
            </subject>
        </Condition>
    </contained>
    <contained>
        <Provenance>
            <id value="8ce7de6b-1307-432d-8e96-ae6a613ca3e4"/>
            <meta>
                <profile value="https://fhir.nhs.uk/STU3/StructureDefinition/RARecord-Provenance-1"/>
            </meta>
            <target>
                <reference value="Condition/57f04652-6dd0-4135-a560-f9091b1b26fa"/>
            </target>
            <recorded value="2018-07-23T11:00:00+00:00"/>
            <agent>
                <role>
                    <coding>
                        <system value="https://fhir.nhs.uk/STU3/CodeSystem/CareConnect-SDSJobRoleName-1"/>
                        <code value="R0260"/>
                        <display value="General Medical Practitioner"/>
                    </coding>
                </role>
                <whoReference>
                    <reference value="https://sds.spineservices.nhs.uk/STU3/Practitioner/2ee4tr6a9"/>
                    <display value="Dr.D"/>
                </whoReference>
                <onBehalfOfReference>
                    <reference value="https://directory.spineservices.nhs.uk/STU3/Organization/a3e5i7"/>
                    <display value="Some GP Clinic"/>
                </onBehalfOfReference>
            </agent>
        </Provenance>
    </contained>
    <contained>
        <Condition xmlns="http://hl7.org/fhir">
            <id value="6be8bee9-e727-4564-a904-49507576f8be"/>
            <meta>
                <versionId value="a9b91e41-30ad-43a4-a2da-79b9be622169"/>
                <lastUpdated value="2018-07-24T10:01:00+00:00"/>
                <profile value="https://fhir.nhs.uk/STU3/StructureDefinition/CareConnect-RARecord-Condition-1" />
            </meta>
            <extension url="https://fhir.nhs.uk/STU3/StructureDefinition/Extension-RARecord-Provenance-1">
                <extension url="created">
                    <valueReference>
                        <reference value="urn:uuid:fe71140b-3a30-45a3-b492-695b5f5e3717"/>
                    </valueReference>
                </extension>
            </extension>
            <clinicalStatus value="active"/>
            <category>
                <coding>
                    <system value="https://fhir.hl7.org.uk/STU3/CodeSystem/CareConnect-ConditionCategory-1"/>
                    <code value="issue"/>
                    <display value="Issue"/>
                </coding>
            </category>
            <code>
                <coding>
                    <system value="https://fhir.nhs.uk/STU3/CodeSystem/CodeSystem-RARecord-ConditionCode-1"/>
                    <code value="720821000000105"/>
                    <display value="Mental health condition(s)"/>
                </coding>
                <text value="Patient diagnosed with Stranger anxiety (disorder). Consider home-visit"/>
            </code>
            <subject>
                <reference value="demographics.spineservices.nhs.uk/STU3/Patient/999999998"/>
            </subject>
        </Condition>
    </contained>
    <contained>
        <Provenance>
            <id value="fe71140b-3a30-45a3-b492-695b5f5e3717"/>
            <meta>
                <profile value="https://fhir.nhs.uk/STU3/StructureDefinition/RARecord-Provenance-1"/>
            </meta>
            <target>
                <reference value="Condition/6be8bee9-e727-4564-a904-49507576f8be"/>
            </target>
            <recorded value="2018-07-24T10:01:00+00:00"/>
            <agent>
                <role>
                    <coding>
                        <system value="https://fhir.nhs.uk/STU3/CodeSystem/CareConnect-SDSJobRoleName-1"/>
                        <code value="R1974"/>
                        <display value="Community Learning Disabilities Nurse"/>
                    </coding>
                </role>
                <whoReference>
                    <reference value="https://sds.spineservices.nhs.uk/STU3/Practitioner/4tr6ee6a9"/>
                    <display value="Nurse N"/>
                </whoReference>
                <onBehalfOfReference>
                    <reference value="https://directory.spineservices.nhs.uk/STU3/Organization/a3e5i7"/>
                    <display value="Some Hospital Learning Disability Support Department"/>
                </onBehalfOfReference>
            </agent>
        </Provenance>
    </contained>
    <status value="current"/>
    <mode value="changes"/>
    <title value="Reasonable Adjustment List"/>
    <code>
        <coding>
            <system value="http://snomed.info/sct"/>
            <code value="1094391000000102"/>
            <display value="Reasonable adjustments for health and care access"/>
        </coding>
    </code>
    <subject>
        <reference value="demographics.spineservices.nhs.uk/STU3/Patient/999999998"/>
    </subject>
    <date value="2018-07-23T11:00:00+00:00"/>
    <entry>
        <deleted value="false"/>
        <date value="2018-07-23T11:00:00+00:00"/>
        <item>
            <reference value="urn:uuid:57f04652-6dd0-4135-a560-f9091b1b26fa"/>
        </item>
    </entry>
    <entry>
        <deleted value="false"/>
        <date value="2018-07-23T11:00:00+00:00"/>
        <item>
            <reference value="urn:uuid:8ce7de6b-1307-432d-8e96-ae6a613ca3e4"/>
        </item>
    </entry>
    <entry>
        <deleted value="false"/>
        <date value="2018-07-24T10:01:00+00:00"/>
        <item>
            <reference value="urn:uuid:6be8bee9-e727-4564-a904-49507576f8be"/>
        </item>
    </entry>
    <entry>
        <deleted value="false"/>
        <date value="2018-07-24T10:01:00+00:00"/>
        <item>
            <reference value="urn:uuid:fe71140b-3a30-45a3-b492-695b5f5e3717"/>
        </item>
    </entry>
</List>

2.14 Update List Condition Response - json example

http response & headers

HTTP/1.1 201 Created
Date: Tue, 23 Jul 2018 11:00:00 GMT
Last-Modified:2018-07-23T11:00:00+00:00
Location: https://clinicals.spineservices.nhs.uk/STU3/List/130f416a-055d-4a5d-a453-2b7c2de3b57b/_history/9554c538-1661-43b1-921b-efcbd2991c90
ETag: W/"9554c538-1661-43b1-921b-efcbd2991c90”
Content-Type: application/fhir+json

http body

Create List Condition Response JSON Example

{
  "resourceType": "Condition",
  "fhir_comments": [
    " json example AAJSONPlaceholder.json "
  ]
}