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
| Page standards status: Informative |
The Gravity Project team has created a new narrative page providing guidance on the Self-Referral use case. We would encourage balloters to review this guidance and provide feedback.
This use case describes the scenario where an individual independently identifies a health-related social need and uses a public-facing community resource directory or platform to find and request services from a Community-Based Organization (CBO).
The primary distinction from the provider-centric workflows described in this guide is that the Individual/Patient is the initiating actor. The system they use to make the request, a Community Resource Platform, acts as the technical Referral Source system. Consequently, the "closed loop" involves communicating referral disposition and outcomes back to this platform for the individual’s benefit, rather than to a clinical healthcare provider.
This use case exactly follows the exchange patterns defined in the Direct Referral workflow. The key difference is the nature of the actors.
GET) the Task on the CBO's server to check for status changes.Task.status and the outcome resources, thereby "closing the loop" and making this information available to the individual.This workflow may operate within various ecosystem models. Implementers should consult the guidance on Closed, Open, and Hybrid Intermediation Networks to determine how referrals are routed and how participants discover each other’s endpoints and capabilities.
The self-referral use case reuses the profiles and exchange patterns defined in the Direct Referral workflow without modification. The key distinction lies in the population of specific elements to reflect the patient-initiated nature of the request.
The Community Resource Platform initiates the referral by POSTing a Task resource to the CBO's FHIR server.
Task.status: SHALL be requested.Task.requester: This SHALL reference the Organization resource representing the Community Resource Platform.Task.owner: This SHALL reference the Organization resource representing the receiving CBO.Task.for: This SHALL reference the Patient resource for the individual.Task.input: This SHALL contain references to the ServiceRequest and the SDOHCC QuestionnaireResponse from the screening.ServiceRequest.requester: This SHOULD reference the Organization resource for the organization providing the Community Resource Platform, a Related Person resource, or the Patient resource.ServiceRequest.subject: This SHALL reference the Patient resource for the individual.ServiceRequest.category: Sliced to include a code from the SDOHCC Category value set (e.g., food-insecurity).ServiceRequest.code: Specifies the service being requested from a value set such as SDOHCC ProcedureCode.
NOTE: Task.requester represents the system managing the referral workflow whereas ServiceRequest.requester represents the individual or entity asking for the service.The loop is closed by the CBO updating the original Task on its own server and the Community Resource Platform polling for those updates.
Task.status: The CBO updates the status from requested to 'accepted', 'rejected', 'in-progress', and finally to a terminal state like 'completed' or 'cancelled'.Task.output: When Task.status is moved to 'completed', the CBO SHALL add one or more output elements referencing resources that describe the outcome of the referral, such as an SDOHCC Procedure for services rendered.GET on the Task resource at the CBO's server to retrieve the current status and, upon completion, the final outcome information referenced in Task.output.The figure below shows a self-referral workflow. This workflow is nearly identical to the Direct Referral workflow described in this implementation guide. The primary difference is the Individual/Patient or an authorized representative of the individual is initiating the referral. It is also possible to implement the self-referral use case as a variation of the direct referral light workflow described in this guide. In the direct referral light scenario, the referral target (CBO) does not have a FHIR server and instead interacts with the FHIR server of the referral source via a FHIR-enable client application. See the Referral Workflow section of this guide for more information on the direct referral and direct referral light workflows.