FHIR Service Request

The following is a description of a Service Request that can be submitted to the Community of Information Exchange. For detailed information please visit the HL7 FHIR page https://hl7.org/fhir/us/sdoh-clinicalcare/2022jan/StructureDefinition-SDOHCC-ServiceRequest-definitions.html

Operations

The following are operations that can be performed

Submit a new FHIR service request

API
GET https://{cie-hub-base-url}/FHIR/ServiceRequest/{id}	This will get
POST https://{cie-hub-base-url}/FHIR/ServiceRequest/
PUT https://{cie-hub-base-url}/FHIR/ServiceRequest/{id}

Sample Object

{
    resourceType: 'ServiceRequest',
    requisition: {
        use: 'official',
        system: 'https://mi211.org',
        value: '1234567',
    },
    status: 'active',
    intent: 'original-order',
    category: [
        {
            coding: [
                {
                    system: 'http://hl7.org/fhir/us/sdoh-clinicalcare/CodeSystem/SDOHCC-CodeSystemTemporaryCodes',
                    code: 'home-visiting',
                    display: 'Home Visiting',
                },
            ],
        },
    ],
    code: {
        coding: [
            {
                system: 'https://211taxonomy.org/',
                code: 'PH-6100.3300',
                display: 'HOME BASED PARENTING EDUCATION',
            },
        ],
    },
    requester: {
        reference: 'Patient/8',
        display: 'Requester Name',
    },
    subject: {
        reference: 'Patient/8',
        display: 'Subject Name',
    },
    reasonReference: [
        {
            reference: 'Observation/2',
            type: 'Observation',
        },
        {
            reference: 'Observation/3',
            type: 'Observation',
        },
        {
            reference: 'Observation/4',
            type: 'Observation',
        },
    ],
    supportingInfo: [
        {
            reference: 'Consent/9',
            type: 'Consent',
        },
    ],
    performer: [
        {
            reference: 'HealthcareService/10',
            type: 'HealthcareService',
        },
        {
            reference: 'HealthcareService/11',
            type: 'HealthcareService',
        },
    ] };

Field Descriptions

The following are descriptions of the fields that must be passed into the service request object.

Field	Description	References
requisition	This will allow multiple for FHIR Service Requests to be grouped together if they where made
category	This is the category of the request being made.
code	This is a code for the service request that is being requested. This code can be one of the following codes LA211 Taxonomy SNOMED Codes LOINC
requester	This will be a reference to a FHIR patient record id or FHIR organization record id that submitted the FHIR Service Request to the CIE-HUB.
subject	This will be a reference to a FHIR patient record id that Service Request is being requested for to the CIE-HUB.
reasonReference	This is the reason references of the service request. This a list of FHIR observation ids for this service request.
supportingInfo	This will be supporting information about the service request. This will be a reference to a FHIR consent id.
performer	This will a reference to FHIR HealthCareService. Please note that the id passed in matches the id that is in the social services directory.