SDOH Clinical Care
3.0.0-ballot - STU 3 Ballot United States of America flag

SDOH Clinical Care, published by HL7 International / Patient Care. This guide is not an authorized publication; it is the continuous build for version 3.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhir-sdoh-clinicalcare/ and changes regularly. See the Directory of published versions

Referral Workflow

Page standards status: Informative

The Gravity Project team has added text to the "Referral Use Care Overview" to provide guidance on how to include additional relevant information in a referral request, such as completed questionnaires, assessments, procedures, etc. We would encourage balloters to review this guidance and provide feedback.

This section describes the interactions between the actors in an SDOH referral starting both at a high-level and at the level of FHIR API calls. First, a high-level overview of the interactions is provided. This description abstracts technical details and should be accessible to the non-technical reader. For the sake of simplicity, only relationships critical to the Referral Workflow are provided. (For additional details on task status updates see Checking Task Status, and on relationships between profiles see Data Modeling Framework.)

The use cases here relate to the Gravity Use Cases. Implementers will benefit from looking at the detailed technical description of the exchange work flow for each use case, as well as the Capability Statements associated with each workflow and the conformance artifacts generally.

General Workflow

This IG supports the following general workflow:

  1. Assess the patient to determine social risk – this may be done by using an assessment instrument, via a conversation with the patient, or both. As part of the assessment, the patient and provider agree on the specific social risks that are to be labeled as verified health concerns or problems.
  2. The patient and provider may establish goals regarding the identified social risk.
  3. The patient and provider agree on referrals/interventions that should be undertaken to address the problems and goals. The patient's consent is obtained to share their specific information with the entity that will be performing the services. The provider then sends a task to the performing entity to initiate the electronic referral.

The figure below shows this high-level workflow, the actors involved in each step, and the FHIR resources that support each step.


Actors, Systems and Icons

The actors in the workflows are described in the table below. The graphical icons are used throughout the IG. For each use case, the assumptions regarding each type of actor are described.

Actor Description
providericon Provider Includes licensed providers and others that interact with the patient to assess social risk, set goals, and determine/recommend referrals.
cboicon Community Based Organization (CBO) An organization that provides specific services to the community or to a targeted population within the community.
cpicon Coordination Platform (CP) The technology platform an intermediary operates to relay data between a provider's and a CBO's systems, supporting the referral process and finding resources for at-risk individuals.
patienticon Patient A consumer, or client, who is the subject of the assessment, goals, referrals and services delivered. Use of the term in this IG does not necessarily imply a clinical context.
fhirserver FHIR Server A server that supports a FHIR API and can make FHIR API calls to other servers
fhirapplication FHIR-enabled Application An application that can make FHIR API calls to a FHIR server, but does not itself support a FHIR API
patientapp FHIR-enabled Patient Application A patient application that can connect to FHIR servers

Referral Use Cases

The functional use cases in the table below describe the referral process, initiated by a referral source (e.g., provider or other healthcare actor) to a referral target (e.g., a CBO), either directly or indirectly via an intermediary using a coordination platform (CP). For each use case, the capabilities or limitations of the actors are described. The table links to the functional use case and the associated detailed technical exchange workflow.

Functional Use Case Description Actors
Direct Referral A referral between a referral source (e.g., provider) and a referral target (e.g., CBO) where both entities have FHIR server APIs and an intermediary using a coordination platform (CP) is not involved in the referral. providericon, cboicon
Direct Referral Light A “light” version of the Direct Referral. A referral between a referral source (e.g., provider) and a referral target (e.g., CBO) where the referral source has a FHIR server API, the referral target does not have a FHIR server API but has an application that can access the referral source’s FHIR server API, and an intermediary using a coordination platform (CP) is not involved in the referral. providericon, cboicon
Indirect Referral A referral between a referral source (e.g., provider) and a referral target (e.g., a CBO) that involves an intermediary using a coordination platform (CP) and all entities have FHIR server APIs. providericon, cboicon. cpicon
Indirect Referral Light A “light” version of the Indirect Referral. A referral between a referral source (e.g., provider) and a referral target (e.g., CBO) that involves an intermediary using a coordination platform (CP) where the referral source and the coordination platform have FHIR server APIs and the referral target does not have a FHIR server API but has an application that can access the coordination platform’s FHIR server API. providericon, cboicon. cpicon

Indirect Referral requires making data instances (e.g., ServiceRequest, Condition, DocumentReference) from the referral source on the coordination platform’s server available for query by the referral target and making some data instances (e.g., Procedures) from the referral target available on the coordination platform’s server for query by the referral source. The coordination platform can make this happen by cloning the data from the original record creator, or by proxying access to the creating system. This IG does not specify how precisely this should be done and resolution of this issue should be a topic of implementer discussion.

Referral Use Case Overview

The direct and indirect referral use cases described below are all preceded by a provider interacting with a patient to assess their needs, establish goals, agree to a referral, and acquire consent. The referral is then initiated, its progress is tracked, and goals are updated as appropriate. The “direct” and “indirect” use cases are distinguished by the absence or presence of an intermediary and, in the “light” versions, the FHIR capabilities of the referral target.

Figure 1 and the Table below show the high-level context of the referral use cases that are described in the sections that follow. For the Table, the “Exchanged” column shows data that could be exchanged at that step, and the “Aligns With” column shows data that is not exchanged in FHIR form but whose content typically corresponds with the listed FHIR profile(s). This only specifies the data that is exchanged, so systems are free to use any internal representation.

The Patient Coordination Workflow shows some, but not all of the possible interactions with the patient. It provides a way for the provider, CP, or CBO to ask a patient to do something, and track whether they have done it and possibly the outcomes. In Figure 1 below, patient coordination is indicated by a red box on steps 9 and 12.

High Level Referral ContextReferral SourceReferral TargetPatient1Patient takes Assessment2Evaluate Assessment3Provider and Patient prioritize Goals, establish need for referral and Patient provides consent4Record Goal(s)Record Condition(s)Capture Consent5Patient app retrieves Goals and/or Referral and Referral Assignment6Initial Referral7Referral Accepted8Referral Progress Updated9Optional exchange with Patient10Referral Completed11Referral progress updated12Optional close loop exchange with Patient13Update Goal(s) and/or Condition(s) as appropriate


Step Details for Figure 1
Step Actors Description Exchanged Aligns With
1 Patient Patient takes standardized assessment tool to identify social risks and needs. This could be done via a SMART app that would post a QuestionnaireResponse or via the PatientTask mechanism, but could be manual none
2 Provider Provider evaluates assessment and identifies social risks none
3 Provider, Patient Provider and Patient:
  • agree on Conditions to add to Problem List
  • prioritize goals
  • agree on referral
  • obtain consent for sharing information
none none
4 Provider Provider promotes the health concern to the problem list, records goals, and captures patient consent none
5 (optional) Provider
  • Provider makes available information regarding the referral, goals and plan available to the patient’s application
  • This may include any information the provider thinks is necessary to support the patient’s social care needs including the clinical information needed to determine program eligibility. For example, a provider may share a gestational diabetes diagnosis, supporting glucose challenge test results and oral glucose tolerance test results to aid in establishing eligibility for a WIC (Women, Infants, and Children) food program.
  • none
    6 Provider, CBO or CP Provider1 initiates a referral to the CBO or CP. The provider may attach additional content relevant for the care of the individual through the SDOHCC Task resource. none
    7 CBO or CP CBO or CP retrieves information about the referral and any needed supporting information, then decides to accept or reject the referral. If the referral is rejected, the process ends or resumes at step #6 with a new task. none
    8 CBO or CP CBO or CP updates the status of their work (task) to reflect progress via notes or status. none
    9 (optional) CBO or CP, Patient CBO or CP communicates with the patient via their application to schedule appointments, collect additional information, etc. This IG doesn't highlight communication outside of electronic means, but such communication is possible. none none
    10 CBO or CP CBO or CP completes the requested action, updates the status of their work (task) to completed, and includes information on what was completed none
    11 Patient Provider receives the updated status and updates the status of the referral (service request) none
    12 (Optional) Patient Provider closes loop by gathering feedback/satisfaction via questionnaire none
    13 Patient Provider determines if the goals/plan have been satisfied and/or progress has been made on the goal/plan and updates the goal/plan appropriately none

    1Although this workflow references provider as the referral source, the requester element in the two profiles exchanged here allow other roles (e.g., care coordinator) and organizations (e.g., payer) to request a referral.

    Direct Referral

    In this use case, the patient is referred to a CBO for help addressing prioritized needs. The CBO accepts the referral, provides the requested support to the patient, and shares the updated information with the referring provider.

    The provider and the CBO have FHIR server APIs.

    The example assumes that the provider has an existing relationship with the CBO. The CBO may not accept the referral or may be unable to perform the requested service.

    The details of the FHIR-based exchanges are provided in the following section.

    Direct Referral Detailed View

    Figure 2 shows the FHIR exchanges between the referral source and referral target. For each numbered exchange, the details of the data elements exchanged, and the FHIR request and response are provided.

    Detailed Direct WorkflowRole: Referral SourceActor: ProviderRole: Referral TargetActor: Community-Based Organization1CreateSDOHCC ServiceRequest+SDOHCC Task for Referral Management2PostSDOHCC Task for Referral Management3GetSDOHCC ServiceRequest+ referenced resources4Evaluate ReferralUpdateSDOHCC Task for Referral ManagementStatus (accepted)5Subscription Notification (optional)6GetSDOHCC Task for Referral Management7EvaluateSDOHCC Task for Referral ManagementStatus (accepted)8Begin Work and updateSDOHCC Task for Referral ManagementStatus to In Progress9Subscription Notification (optional)10EvaluateSDOHCC Task for Referral ManagementStatus (in-progress)11Complete ServiceCreateSDOHCC Procedure(s)(s) todocument service(s) deliveredUpdateSDOHCC Task for Referral ManagementStatus to Completed12Subscription Notification (optional)13GetSDOHCC Task for Referral Management14EvaluateSDOHCC Task for Referral ManagementStatus (completed)15GetSDOHCC Procedure(s)16UpdateSDOHCC ServiceRequestto CompletedUpdateSDOHCC Goalas appropriate


    Direct Referral Light

    In this use case, a provider works with a patient using a standardized assessment instrument to identify and prioritize social risks and needs, and then refers the patient to a CBO for help addressing those needs. The CBO provides the requested support to the patient and the updated information is shared with the referring provider.

    The provider has a FHIR server API. Functionally, this differs from the Direct Referral in that the CBO does not have a FHIR server API but has an application that can access a FHIR server API. As a result, the provider can’t push information to the CBO, but rather the CBO needs to pull information from the provider. At the conclusion of the referral, the CBO POSTS necessary information (e.g., Procedures) to the provider’s FHIR server API and updates the status and the linked resources of the Task.

    The details of the FHIR-based exchanges are provided in the following section.

    Direct Referral Light - Detailed View

    This referral occurs between the provider (referral source) and the CBO (referral target) where the CBO does not have a FHIR server API. The CBO accesses and manipulates information either using its own software which has a conformant FHIR client or using a third-party application as a FHIR client.

    Figure 3 shows the FHIR exchanges between the referral source and referral target. For each numbered exchange, the details of the data elements exchanged, and the FHIR request and response are provided.

    Detailed Direct WorkflowRole: Referral SourceActor: ProviderRole: Referral TargetActor: Community-Based Organization (not FHIR-enabled)1CreateSDOHCC ServiceRequest+SDOHCC Task for Referral Management2Send email3GetSDOHCC Task for Referral Management4GetSDOHCC ServiceRequest+ referenced resources5Evaluate ReferralUpdateSDOHCC Task for Referral ManagementStatus (accepted)6UpdateSDOHCC Task for Referral ManagementStatus (accepted)7Begin Work and updateSDOHCC Task for Referral ManagementStatus to In Progress8UpdateSDOHCC Task for Referral ManagementStatus (in-progress)9Complete ServiceCreateSDOHCC Procedure(s)(s) todocument service(s) delivered10PostSDOHCC Procedure(s)(s)11UpdateSDOHCC Task for Referral ManagementStatus (completed)12UpdateSDOHCC ServiceRequestto CompletedUpdateSDOHCC Goalas appropriate


    Indirect Referral

    In this use case, a provider works with a patient using a standardized assessment instrument to identify and prioritize social risks and needs, and then refers the patient indirectly via a CP to a CBO for help addressing those needs. The CP relays the referral to the CBO. The CBO provides the requested support to the patient and the updated information is relayed back through the CP where it is shared with the referring provider.

    Functionally, this Indirect Referral is essentially two direct referrals (provider to CP, and CP to CBO) chained together. The provider, CP, and CBO all have FHIR server APIs.

    The provider has a relationship with the CP, but not with the CBO. The use case assumes that the CP and the CPO have an established relationship. The provider may request to have the service delivered by a specific CBO. The CP may not accept the referral, be unable to perform the requested service, or may need to split the request into multiple tasks to be performed by one or more CBOs.

    Indirect Referral - Detailed View

    The referral occurs in two separate interactions. The first is between the referral source and the intermediary and the second is between the intermediary and the referral target.

    In the Indirect Referral, this IG assumes that the referral source does not have the ability to communicate directly with the referral target. There may be multiple referral targets for responsibilities that will be determined and managed by the intermediary.

    The coordination platform SHALL support the following:

    1. Create a local copy of, or proxy, all relevant referenced resources from the referral source
    2. Create ServiceRequest(s) with ServiceRequest.intent value “filler-order” and ServiceRequest.basedOn references the original referral source ServiceRequest(s)
    3. Create Task(s) to be posted to the referral target(s) that reference the referral source Task(s) via Task.partOf
    4. If local copies of the referenced resources are maintained by the coordination platform, the coordination platform must subscribe or periodically query the referral source for updates to the referenced resources
    Detailed Indirect WorkflowRole: Referral SourceActor: ProviderRole: IntermediaryActor: Coordinating PlatformRole: Referral TargetActor: Community-Based Organization1CreateSDOHCC ServiceRequest+SDOHCC Task for Referral Management2PostSDOHCC Task for Referral Management3GetSDOHCC ServiceRequest+ referenced resources4Evaluate ReferralUpdateSDOHCC Task for Referral ManagementStatus5Subscription Notification (optional)6CreateSDOHCC ServiceRequest(based on Referral)Create CP Taskfor CBO and link toSDOHCC Task for Referral Management7EvaluateSDOHCC Task for Referral ManagementStatus (accepted)8POST CP Task to CBO9GetSDOHCC ServiceRequest+ referenced resources10Evaluate ReferralUpdate CP Task Status11Subscription Notification (optional)12Get CP Task13Evaluate CP Task StatusUpdateSDOHCC Task for Referral ManagementStatus to In Progress14Subscription Notification (optional)15Evaluate Status (in-progress)16Complete ServiceCreateSDOHCC Procedure(s)(s)Update CPTask Status to Completed17Subscription Notification (optional)18Evaluate Status (completed)19Complete ServiceCreateSDOHCC Procedure(s)(s)Update CP Task Status to Completed20GetSDOHCC Procedure(s)(s)21LinkSDOHCC Procedure(s)(s)UpdateSDOHCC Task for Referral ManagementStatus to Completed22Subscription Notification (optional)23GetSDOHCC Task for Referral Management24Evaluate Status (completed)25GetSDOHCC Procedure(s)(s)26UpdateSDOHCC ServiceRequestto CompletedUpdateSDOHCC Goalas appropriate


    Indirect Referral Light

    The patient is assessed by a provider and referred to a CP. The CP refers to a CBO to deliver the service. The provider and CP have FHIR server APIs. The CBO does not have a FHIR server API but has an application that can access a FHIR server API.

    This section differs from the Indirect Referral in that the interactions between the CP and CBO follow the Direct Light paradigm. The CBO will maintain data on the CP’s FHIR server API. CBOs without their own FHIR server API will modify tasks directly on the CP’s FHIR server API.

    The provider has a relationship with the CP, but not with the CBO. The use case assumes that the CP and the CBO have an established relationship. The provider may request to have the service delivered by a specific CBO. The CP may not accept the referral, be unable to perform the requested service, or may need to split the request into multiple tasks to be performed by one or more CBOs.

    Indirect Referral Light - Detailed View

    The referral occurs in two separate interactions. The first is between the referral source and the intermediary and the second is between the intermediary and the referral target.

    The coordination platform SHALL support the following:

    1. Create a local copy of, or proxy, all relevant referenced resources from the referral source
    2. Create ServiceRequest(s) with ServiceRequest.intent value “filler-order” and ServiceRequest.basedOn references the original referral source ServiceRequest(s)
    3. Create Task(s) to be queried by the referral target(s) that reference the referral source Task(s) via Task.partOf
    4. If local copies of the referenced resources are maintained by the coordination platform, the coordination platform must subscribe or periodically query the referral source for updates to the referenced resources
    Detailed Indirect Light WorkflowRole: Referral SourceActor: ProviderRole: IntermediaryActor: Coordinating PlatformRole: Referral TargetActor: Community-Based Organization (not-FHIR enabled)1CreateSDOHCC ServiceRequest+SDOHCC Task for Referral Management2PostSDOHCC Task for Referral Management3GetSDOHCC Task for Referral Managementbased on lastUpdated (polling or subscription notification)4GetSDOHCC ServiceRequest+ referenced resources5Evaluate ReferralUpdateSDOHCC Task for Referral ManagementStatus6Subscription Notification (optional)7GetSDOHCC Task for Referral Management8CreateSDOHCC ServiceRequest(based on Referral)Create CP Taskfor CBO and link toReferral Source Task9EvaluateSDOHCC Task for Referral ManagementStatus (accepted)10Get CP Task based on lastUpdated (polling or subscription notification)11GetSDOHCC ServiceRequest+ referenced resources12Evaluate ReferralUpdate CP Task Status13Put CP Task (update)14Evaluate CP Task StatusUpdateSDOHCC Task for Referral ManagementStatus to In Progress15Subscription Notification (optional)16GetSDOHCC Task for Referral Management17Evaluate Status (in-progress)18Complete ServiceCreateSDOHCC Procedure(s)(s)Update CP Task Status to Completed19Put CP Task (update)20PostSDOHCC Procedure(s)(s)21LinkSDOHCC Procedure(s)(s)UpdateSDOHCC Task for Referral ManagementStatus to Completed22Subscription Notification (optional)23GetSDOHCC Task for Referral Management24Evaluate Status (completed)25GetSDOHCC Procedure(s)(s)26UpdateSDOHCC ServiceRequestto CompletedUpdateSDOHCC Goalas appropriate


    Additional Guidance on Referrals

    1. Parties SHOULD use polling if one or both of the parties is unable to support the subscription model (see notes on the Checking Task Status page).
    2. The receiving party for the referral SHOULD use the batch query process to request periodic updates of referenced resources.
    3. The above system flows do not define the handling of all possible scenarios. Exchange scenarios may include refusing the referral, canceling the referral by either party, and error conditions that may occur when using RESTful exchanges. It is up to each party to follow the current best practice in managing the state of the referral.
    4. The referral source SHOULD set the Task.status to “requested”.
    5. The referral target SHOULD update Task.status as it moves through the workflow.