SDOH Clinical Care
2.2.0 - STU 2.2 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 2.2.0 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

CapabilityStatement: SDOHCC Referral Recipient - Light Capability Statement

Official URL: http://hl7.org/fhir/us/sdoh-clinicalcare/CapabilityStatement/SDOHCC-ReferralRecipientLight Version: 2.2.0
Standards status: Trial-use Computable Name: SDOHCC_ReferralRecipientLight

This resource describes the required and desired behavior of systems acting as 'light-weight' SDOH clinical care 'referral recipients'.

These systems fit into the SDOH care workflow in the same manner as 'regular' Referral Recipients, however they have simpler interface requirements reflecting the inability of the systems to store data locally and/or expose a FHIR service allowing access to that data. 'Light' referral recipients are not expected to expose any FHIR restful services. Instead, they act as clients, querying for tasks on the initiating Referral Sources or Coordination Platforms and creating any resulting Procedure records within the server they received the request from.

Raw OpenAPI-Swagger Definition file | Download

Generated Narrative: CapabilityStatement SDOHCC-ReferralRecipientLight

SDOHCC Referral Recipient - Light

  • Implementation Guide Version: 2.2.0
  • FHIR Version: 4.0.1
  • Supported Formats: xml, json
  • Supported Patch Formats:
  • Published on: 2021-06
  • Published by: HL7 International / Patient Care

Note to Implementers: FHIR Capabilities

Any FHIR capability may be 'allowed' by the system unless explicitly marked as 'SHALL NOT'. A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.

FHIR RESTful Capabilities

Mode: client

The light clinical care referral recipient needs to access information from and update information in SDOH clinical care referral sources and/or coordination platforms that have solicited the filling of SDOH-related referrals by this system

Security
Enable CORS: no
Security services supported: SMART-on-FHIR

Implementations must meet the general privacy & security requirements documented in this implementation guide.

Summary of System-wide Interactions
  • SHOULD support the batchinteraction described as follows:

    Allows polling for changes to multiple resource types simultaneously

Capabilities by Resource/Profile

Summary

The summary table lists the resources that are part of this configuration, and for each resource it lists:

  • The relevant profiles (if any)
  • The interactions supported by each resource (Read, Search, Update, and Create, are always shown, while VRead, Patch, Delete, History on Instance, or History on Type are only present if at least one of the resources has support for them.
  • The required, recommended, and some optional search parameters (if any).
  • The linked resources enabled for _include
  • The other resources enabled for _revinclude
  • The operations on the resource (if any)
Resource TypeProfileRSUCSearches_include_revincludeOperations
CareTeamSupported Profiles
  US Core CareTeam Profile
yy_id, _lastUpdated
ConditionSupported Profiles
  SDOHCC Condition
yy_id, _lastUpdated, category, clinical-status, code, patient, verification-status
ConsentSupported Profiles
  SDOHCC Consent
yy_id, _lastUpdated, source-referenceConsent:source-reference:DocumentReference
DeviceSupported Profiles
  Device
yy_id, _lastUpdated
DocumentReferenceSupported Profiles
  US Core DocumentReference Profile
yy_id, _lastUpdated
GoalSupported Profiles
  SDOHCC Goal
yy_id, _lastUpdated, achievement-status, category, lifecycle-status, patient, target-date
HealthcareServiceSupported Profiles
  SDOHCC Healthcare Service
yy_id, _lastUpdated, location
LocationSupported Profiles
  SDOHCC Location
yy_id, _lastUpdated
ObservationSupported Profiles
  SDOHCC Observation Assessment
  SDOHCC Observation Screening Response
  SDOHCC Observation Ethnicity OMB
  SDOHCC Observation Race OMB
  SDOHCC Observation Gender Identity
  SDOHCC Observation Personal Characteristic
  SDOHCC Observation Personal Pronouns
  SDOHCC Observation Recorded Sex Gender
  SDOHCC Observation Sexual Orientation
yy_id, _lastUpdated, category, code, code-value-concept, date, derived-from, patient, status
OrganizationSupported Profiles
  US Core Organization Profile
yy_id, _lastUpdated
PatientSupported Profiles
  US Core Patient Profile
yy_id, _lastUpdated
PractitionerSupported Profiles
  US Core Practitioner Profile
yy_id, _lastUpdated
PractitionerRoleSupported Profiles
  US Core PractitionerRole Profile
yy_id, _lastUpdated, organization, practitionerPractitionerRole:organization, PractitionerRole:practitioner
ProcedureSupported Profiles
  SDOHCC Procedure
yyyy_id, _lastUpdated, based-on, category, code, date, patient, performer, status
RelatedPersonSupported Profiles
  RelatedPerson
yy_id, _lastUpdated
ServiceRequestSupported Profiles
  SDOHCC ServiceRequest
yy_id, _lastUpdated, category, code, intent, occurrence, patient, performer, requester, status, supporting-infoHealthCareService:location, ServiceRequest:supporting-info, ServiceRequest:pertains-to-goal, ServiceRequest:patient, ServiceRequest:requester, ServiceRequest:performer, PractitionerRole:practitioner, PractitionerRole:organization
SubscriptionSupported Profiles
  R4/B Topic-Based Subscription
yy$status
TaskSupported Profiles
  SDOHCC Task For Patient
  SDOHCC Task For Referral Management
yyyy_id, _lastUpdated, code, owner, patient, requester, status, focus, outputTask:output

Resource Conformance: SHALL CareTeam

Core FHIR Resource
CareTeam
Reference Policy
literal
Interaction summary
  • MAY support
    read

    Allows the system to retrieve a CareTeam that is the intended performer of a ServiceRequest.

    search-type

    Allows the monitoring of previously-retrieved CareTeams that are the intended performer of ServiceRequests.

Supported Profiles

US Core CareTeam Profile

Documentation

For referral sources that receive referrals from upstream systems, used to access information about the intended performer of a ServiceRequest when the performer is a specific team of people. Note: Conformance expectations for this resource are lower because CareTeam performers are expected to be uncommon in most SDOH uses

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idtoken

Allows retrieving known CareTeam records - and more specifically, retrieving more than one in a single call to poll for updates

SHOULD_lastUpdateddate

Allows filtering for only records that have changed since last query

 

Resource Conformance: SHALL Condition

Core FHIR Resource
Condition
Reference Policy
literal
Interaction summary
  • SHALL support
    read

    Allows the system to retrieve a Condition that is the reason for a ServiceRequest.

  • SHOULD support
    search-type

    Allows the monitoring of previously-retrieved Conditions that are referenced by ServiceRequests.

Supported Profiles

SDOHCC Condition

Documentation

For referral sources that receive referrals from upstream systems, used to access information about a patient's SDOH-related conditions, particularly those that are the reason for a referral

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idtoken

Allows retrieving known Condition records - and more specifically, retrieving more than one in a single call to poll for updates

SHALLcategorytoken

Allows filtering to only SDOH-related conditions

SHALLpatientreference

Allows filtering to only conditions associated with a specific patient. Some systems will require that searches be patient-specific

SHOULD_lastUpdateddate

Allows filtering for only records that have changed since last query

SHOULDclinical-statustoken

Allows filtering to only active conditions

SHOULDcodetoken

Allows filtering to only specific SDOH conditions or sets of conditions

SHOULDverification-statustoken

Allows filtering to exclude refuted or entered-in-error conditions

 

Resource Conformance: SHALL Consent

Core FHIR Resource
Consent
Reference Policy
literal
Interaction summary
  • SHALL support
    read

    Allows the system to retrieve a Consent referenced as a 'supportingInformation' item of a ServiceRequest.

  • SHOULD support
    search-type

    Allows the monitoring of previously-retrieved Consents related to ServiceRequests of interest.

Supported Profiles

SDOHCC Consent

Documentation

Used to access the consent that authorizes disclosure of ServiceRequest information to non-HIPAA-covered entities

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idtoken

Allows retrieving known consent records - and more specifically, retrieving more than one in a single call to poll for updates

SHOULD_lastUpdateddate

Allows filtering for only records that have changed since last query

SHOULDsource-referencereference

Allows including the document that contains the PDF or similar representation of a paper consent

 

Resource Conformance: SHALL Device

Core FHIR Resource
Device
Reference Policy
literal
Interaction summary
  • SHOULD support
    read

    Allows the system to retrieve a Device that is the requester or intended performer of a ServiceRequest.

    search-type

    Allows the monitoring of previously-retrieved Devices that are the requester or intended performer of ServiceRequests.

Supported Profiles

Device

Documentation

Used to retrieve the requester or intended performer of an SDOH ServiceRequest. Note: Conformance expectations for this resource are lower because Device requesters and performers are expected to be uncommon in most SDOH uses

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idtoken

Allows retrieving known Device records - and more specifically, retrieving more than one in a single call to poll for updates

SHOULD_lastUpdateddate

Allows filtering for only records that have changed since last query

 

Resource Conformance: SHALL DocumentReference

Core FHIR Resource
DocumentReference
Reference Policy
literal
Interaction summary
  • SHALL support
    read

    Allows the system to retrieve a PDF or similar content referenced by a Consent or Task.

  • SHOULD support
    search-type

    Allows the monitoring of previously-retrieved DocumentReferences in the event the image/document is amended/corrected/updated.

Documentation

Used to retrieve a scanned or other form of document representing the text of a consent. Also used for PDF forms.

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idtoken

Allows retrieving known DocumentReference records - and more specifically, retrieving more than one in a single call to poll for updates

SHOULD_lastUpdateddate

Allows filtering for only records that have changed since last query

 

Resource Conformance: SHALL Goal

Core FHIR Resource
Goal
Reference Policy
literal
Interaction summary
  • SHALL support
    read

    Allows the system to retrieve a goal referenced by a ServiceRequest.

  • SHOULD support
    search-type

    Allows the monitoring of previously-retrieved Goals in the event they are updated.

Supported Profiles

SDOHCC Goal

Documentation

Used to access goals related to an SDOH referral

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idtoken

Allows retrieving known Goal records - and more specifically, retrieving more than one in a single call to poll for updates

SHALLcategorytoken

Allows filtering to only include SDOH-related goals

SHALLpatientreference

Allows filtering to only include goals for a particular patient. Some systems will require searches to be patient-specific

SHOULD_lastUpdateddate

Allows filtering for only records that have changed since last query

SHOULDachievement-statustoken

Allows filtering to only include unmet goals

SHOULDlifecycle-statustoken

Allows filtering to only include active goals

SHOULDtarget-datedate

Allows filtering based on when a particular goal is desired to be achieved

 

Resource Conformance: SHALL HealthcareService

Core FHIR Resource
HealthcareService
Reference Policy
literal
Interaction summary
  • SHOULD support
    read

    Allows the system to retrieve a HealthcareService that is the intended performer of a ServiceRequest.

    search-type

    Allows the monitoring of previously-retrieved HealthcareServices that are the intended performer of ServiceRequests.

Supported Profiles

SDOHCC Healthcare Service

Documentation

For referral sources that receive referrals from upstream systems, used to access information about the intended performer of a ServiceRequest when the performer is a specific service within a larger facility. Also used to indicate who a patient or caregiver should contact about a particular service.

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idtoken

Allows retrieving known HealthcareService records - and more specifically, retrieving more than one in a single call to poll for updates

SHALLlocationreference

Allows retrieval of the phyical site(s) associated with a HealthService

SHOULD_lastUpdateddate

Allows filtering for only records that have changed since last query

 

Resource Conformance: SHALL Location

Core FHIR Resource
Location
Reference Policy
literal
Interaction summary
  • SHOULD support
    read

    Allows the system to retrieve a Location that is an available location for a service.

  • MAY support
    search-type

    Allows the monitoring of previously-retrieved Locations that are the intended locations for services.

Supported Profiles

SDOHCC Location

Documentation

Used to access information about the potential sites at which a requested service might be performed. Allows a patient to evaluate the suitability of a proposed activity or service.

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idtoken

Allows retrieving known Location records - and more specifically, retrieving more than one in a single call to poll for updates

SHOULD_lastUpdateddate

Allows filtering for only records that have changed since last query

 

Resource Conformance: SHALL Observation

Core FHIR Resource
Observation
Reference Policy
literal
Interaction summary
  • SHALL support
    read

    Allows the system to retrieve an Observation referenced by a ServiceRequest.

  • SHOULD support
    search-type

    Allows the monitoring of previously-retrieved Observations for updates/corrections.

Documentation

For referral sources that receive referrals from upstream systems, used to access information about SDOH-related observations for a patient - particularly those that are reasons for a referral as well as certain SDOH-relevant demographic information

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idtoken

Allows retrieving known Observation records - and more specifically, retrieving more than one in a single call to poll for updates

SHALLcategorytoken

Allows filtering for only SDOH-related observations

SHALLpatientreference

Allows filtering for observations specific to a particular patient. Some systems will require that all queries be patient-specific

SHALLstatustoken

Allows filtering for observations that are completed or revised (i.e. not in-progress or entered-in-error)

SHOULD_lastUpdateddate

Allows filtering for only records that have changed since last query

SHOULDcodetoken

Allows filtering for specific types of observations

SHOULDdatedate

Allows filtering for observations that held in a particular time period

SHOULDderived-fromreference

Allows filtering for observations derived from a particular QuestionnaireResponse

MAYcode-value-conceptcomposite

Allows filtering for observations that have a specific coded value answer for a specified observation type

 

Resource Conformance: SHALL Organization

Core FHIR Resource
Organization
Reference Policy
literal
Interaction summary
  • SHALL support
    read

    Allows the system to retrieve an Organization that is the requester or intended performer of a ServiceRequest.

  • SHOULD support
    search-type

    Allows the monitoring of previously-retrieved Organizations that are the requester or intended performer of ServiceRequests.

Documentation

For referral sources that receive referrals from upstream systems, used to access information about an Organization that is the requester or intended performer of a ServiceRequest

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idtoken

Allows retrieving known Organization records - and more specifically, retrieving more than one in a single call to poll for updates

SHOULD_lastUpdateddate

Allows filtering for only records that have changed since last query

 

Resource Conformance: SHALL Patient

Core FHIR Resource
Patient
Reference Policy
literal
Interaction summary
  • SHALL support
    read

    Allows the system to retrieve the Patient that is the subject of a ServiceRequest.

  • SHOULD support
    search-type

    Allows the monitoring of previously-retrieved Patients.

Supported Profiles

US Core Patient Profile

Documentation

For referral sources that receive referrals from upstream systems, used to access information about the Patient that is the subject a ServiceRequest

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idtoken

Allows retrieving known Patient records - and more specifically, retrieving more than one in a single call to poll for updates

SHOULD_lastUpdateddate

Allows filtering for only records that have changed since last query

 

Resource Conformance: SHALL Practitioner

Core FHIR Resource
Practitioner
Reference Policy
literal
Interaction summary
  • SHALL support
    read

    Allows the system to retrieve a Practitioner that is the requester or intended performer of a ServiceRequest.

  • SHOULD support
    search-type

    Allows the monitoring of previously-retrieved Practitioners that are the requester or intended performer of ServiceRequests.

Documentation

For referral sources that receive referrals from upstream systems, used to access information about an Practitioner that is the requester or intended performer of a ServiceRequest

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idtoken

Allows retrieving known Practitioner records - and more specifically, retrieving more than one in a single call to poll for updates

SHOULD_lastUpdateddate

Allows filtering for only records that have changed since last query

 

Resource Conformance: SHALL PractitionerRole

Core FHIR Resource
PractitionerRole
Reference Policy
literal
Interaction summary
  • SHALL support
    read

    Allows the system to retrieve a PractitionerRole that is the requester or intended performer of a ServiceRequest.

  • SHOULD support
    search-type

    Allows the monitoring of previously-retrieved PractitionerRoles that are the requester or intended performer of ServiceRequests.

Documentation

For referral sources that receive referrals from upstream systems, used to access information about an PractitionerRole that is the requester or intended performer of a ServiceRequest

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idtoken

Allows retrieving known PractitionerRole records - and more specifically, retrieving more than one in a single call to poll for updates

SHOULD_lastUpdateddate

Allows filtering for only records that have changed since last query

SHOULDorganizationreference

Allows doing an _include on Organization when retrieving the PractitionerRole

SHOULDpractitionerreference

Allows doing an _include on Practitioner when retrieving the PractitionerRole

 

Resource Conformance: SHALL Procedure

Core FHIR Resource
Procedure
Reference Policy
literal
Interaction summary
  • SHALL support
    create

    Allows the system to write records of procedures done in response to a referral on the system that asked for the referral.

    update

    Allows the system to update records of procedures done in response to a referral on the system that asked for the referral.

    read

    Allows the referral recipient to retrieve procedures referenced by Tasks previously posted.

  • SHOULD support
    search-type

    Allows the referral recipient to check if others have updated (e.g. added comments) to procedures previously posted and/or to find previously submitted procedures so they can be rendered to a user.

Supported Profiles

SDOHCC Procedure

Documentation

Used to record information about actions that have been performed as a result of a referral

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idtoken

Allows retrieving known Procedure records - and more specifically, retrieving more than one in a single call to poll for updates

SHALLbased-onreference

Allows filtering for procedures resulting from a particular service request

SHALLcategorytoken

Allows filtering for procedures that are SDOH-related

SHALLpatientreference

Allows filtering for procedures based on who they were delivered to. Some systems may require that all searches be patient-specific.

SHALLperformerreference

Allows filtering for procedures based on who delivered the procedure.

SHALLstatustoken

Allows filtering for procedures that are complete or in progress

SHOULD_lastUpdateddate

Allows filtering for only records that have changed since last query

SHOULDcodetoken

Allows filtering for procedures based on the specific service delivered

SHOULDdatedate

Allows filtering for procedures based on when they were delivered

 

Resource Conformance: SHALL RelatedPerson

Core FHIR Resource
RelatedPerson
Reference Policy
literal
Interaction summary
  • MAY support
    read

    Allows the system to retrieve a RelatedPerson that is the requester or intended performer of a ServiceRequest.

    search-type

    Allows the monitoring of previously-retrieved RelatedPersons that are the requester or intended performer of ServiceRequests.

Supported Profiles

RelatedPerson

Documentation

For referral sources that receive referrals from upstream systems, used to access information about the requester or intended performer of a ServiceRequest when they are someone with a personal relationship to the Patient. Note: Conformance expectations for this resource are lower because CareTeam performers are expected to be uncommon in most SDOH uses

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idtoken

Allows retrieving known RelatedPerson records - and more specifically, retrieving more than one in a single call to poll for updates

SHOULD_lastUpdateddate

Allows filtering for only records that have changed since last query

 

Resource Conformance: SHALL ServiceRequest

Core FHIR Resource
ServiceRequest
Reference Policy
literal
Interaction summary
  • SHALL support
    read

    Allows client systems to retrieve the ServiceRequest pointed to by a Task.

  • SHOULD support
    search-type

    Allows client systems to monitor multiple ServiceRequests for change simultaneously via polling.

Supported Profiles

SDOHCC ServiceRequest

Documentation

For referral sources that receive referrals from upstream systems, used to retrieve an order for SDOH-related services

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idtoken

Allows retrieving known ServiceRequests records - and more specifically, retrieving more than one in a single call to poll for updates

SHALLcategorytoken

Allows filtering to only retrieve ServiceRequests that are SDOH-related

SHALLintenttoken

Allows filtering to retrieve only 'order' ServiceRequests and not plans, proposals, etc.

SHALLpatientreference

Allows filtering to retrieve only ServiceRequests associated with a particular patient. Note that some systems may mandate that searches are always patient-specific

SHALLstatustoken

Allows filtering to retrieve only active ServiceRequests

SHOULD_lastUpdateddate

Allows filtering for only records that have changed since last query

SHOULDcodetoken

Allows filtering to retrieve ServiceRequests for specific types of services

SHOULDoccurrencedate

Allows filtering to retrieve ServiceRequests based on the timeframe in which the service needs to be provided

SHOULDperformerreference

Allows filtering to retrieve only ServiceRequests that designate a specific performer

SHOULDrequesterreference

Allows filtering to retrieve only ServiceRequests created by a specific practitioner

SHOULDsupporting-inforeference

Allows _include to retrieve supporting information for a ServiceRequest - particularly Consent

 

Resource Conformance: SHOULD Subscription

Core FHIR Resource
Subscription
Reference Policy
Interaction summary
  • SHOULD support
    create

    Necessary if using subscriptions to monitor updates to the Task

  • MAY support
    update

    Needed to allow the requester to update a subscription - to adjust delivery target, to add additional tasks to monitor (if subscribing by id) typically to cancel a request for fulfillment

Documentation

Used to allow upstream systems to subscribe to and monitor Tasks stored on this system for change

Extended Operations
ConformanceOperationDocumentation
SHOULD$status

Necessary for systems supporting subscriptions to ensure that the subscription is functioning properly and to check for errors

Resource Conformance: SHALL Task

Core FHIR Resource
Task
Reference Policy
literal
Interaction summary
  • SHALL support
    update

    Allows modification of an assigned patient existing Task (e.g. to cancel it) or modificiation of a Task assigned to the referral recipient (to accept or reject it or add output links to performed procedures). ReferralRecipients can freely modify any Tasks they have created (though they should consider the impact of doing so on downstream recipients or the patient). However, if they are not the creator, they SHALL only modify tasks they are the 'owner' of and then, only modify Task.status, Task.statusReason, and Task.outputs are possible, and then only for Tasks where the owner is the patient.

    read

    Allows retrieval of a Task that was referenced in a subscription notification or per-Task polling for change.

    search-type

    Allows the other systems to poll multiple tasks simultaneously, as well as to retrieve referenced resources as part of a single query.

  • SHOULD support
    create

    Allows referral recipients to request actions of patients and caregivers

Documentation

Allows the referral recipient to create and monitor for Tasks assigned by referral sources or coordination platforms. Also allows the creation and monitoring of tasks assigned to patients and caregivers.

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idtoken

Allows retrieving known Task records - and more specifically, retrieving more than one in a single call to poll for updates

SHALLcodetoken

Allows filtering for 'fulfill' tasks as opposed to others. Some systems may require code to be included as a filter criteria as different Task codes may correspond to different internal database tables.

SHALLpatientreference

Allows monitoring of tasks associated with a particular patient. (Some systems may require that all queries be done in the context of a single patient.)

SHALLrequesterreference

Allows retrieving all tasks that have been requested by a particular organization or individual. This will commonly be used to monitor the tasks initiated by a particular system

SHALLstatustoken

Allows filtering to only active or completed tasks

SHALLfocusreference

Allows retrieving the task(s) seeking fulfillment of a particular ServiceRequest

SHOULD_lastUpdateddate

Allows filtering for only records that have changed since last query

SHOULDownerreference

Allows filtering only for tasks that are assigned to a particular owner (or alternatively, tasks that have not yet been assigned)

SHOULDoutputreference

Allows for the 'output' of a Task to be included when retrieving a Task