This page is part of the SDOH Clinical Care for Multiple Domains (v2.2.0: STU 2.2) based on FHIR (HL7® FHIR® Standard) R4. This is the current published version. For a full list of available versions, see the Directory of published versions
Official URL: http://hl7.org/fhir/us/sdoh-clinicalcare/CapabilityStatement/SDOHCC-CoordinationPlatform | Version: 2.2.0 | |||
Standards status: Trial-use | Computable Name: SDOHCC_CoordinationPlatform |
This resource describes the required and desired behavior of systems acting as SDOH clinical care 'coordination platforms' (CPs).
CPs are intermediaries who take on responsibility for managing SDOH referrals and ensuring they are executed by appropriate service delivery organizations. These systems must respond to referral fulfillment Tasks received from Clinical Care Referral Sources and also the initiation and management of referral fulfillment Tasks subsequently directed out to Referral Recipients. They may also take on some of the diagnostic work, including having patients or care-givers complete questionnaires, extract relevant observations and preliminary findings and work with patients to define goals.
Raw OpenAPI-Swagger Definition file | Download
Generated Narrative: CapabilityStatement SDOHCC-CoordinationPlatform
xml
, json
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.
client
The clinical care coordinator needs to receive information from and update information in SDOH clinical care referral sources.
SMART-on-FHIR
Implementations must meet the general privacy & security requirements documented in this implementation guide.
batch
interaction described as follows:Allows polling for changes to multiple resource types simultaneously
The summary table lists the resources that are part of this configuration, and for each resource it lists:
_include
_revinclude
Resource Type | Profile | R | S | U | C | Searches | _include | _revinclude | Operations |
---|---|---|---|---|---|---|---|---|---|
CareTeam | Supported Profiles US Core CareTeam Profile | y | y | _id, _lastUpdated | |||||
Condition | Supported Profiles SDOHCC Condition | y | y | _id, _lastUpdated, category, clinical-status, code, patient, verification-status | |||||
Consent | Supported Profiles SDOHCC Consent | y | y | _id, _lastUpdated, source-reference | Consent:source-reference:DocumentReference | ||||
Device | Supported Profiles Device | y | y | _id, _lastUpdated | |||||
DocumentReference | Supported Profiles US Core DocumentReference Profile | y | y | _id, _lastUpdated | |||||
Goal | Supported Profiles SDOHCC Goal | y | y | _id, _lastUpdated, achievement-status, category, lifecycle-status, patient, target-date | |||||
HealthcareService | Supported Profiles SDOHCC Healthcare Service | y | y | _id, _lastUpdated, location | |||||
Location | Supported Profiles SDOHCC Location | y | y | _id, _lastUpdated | |||||
Observation | Supported 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 | y | y | _id, _lastUpdated, category, code, code-value-concept, date, derived-from, patient, status | |||||
Organization | Supported Profiles US Core Organization Profile | y | y | _id, _lastUpdated | |||||
Patient | Supported Profiles US Core Patient Profile | y | y | _id, _lastUpdated | |||||
Practitioner | Supported Profiles US Core Practitioner Profile | y | y | _id, _lastUpdated | |||||
PractitionerRole | Supported Profiles US Core PractitionerRole Profile | y | y | _id, _lastUpdated, organization, practitioner | PractitionerRole:organization , PractitionerRole:practitioner | ||||
Procedure | Supported Profiles SDOHCC Procedure | y | y | y | y | _id, _lastUpdated, based-on, category, code, date, patient, performer, status | |||
Questionnaire | Supported Profiles Extractable Questionnaire - StructureMap | y | code, context-type-value, identifier, publisher, status, subject-type, title, url, version | $populate | |||||
QuestionnaireResponse | Supported Profiles SDC Questionnaire Response | y | y | _id, _lastUpdated, author, authored, patient, questionnaire, status | |||||
RelatedPerson | Supported Profiles RelatedPerson | y | y | _id, _lastUpdated | |||||
ServiceRequest | Supported Profiles SDOHCC ServiceRequest | y | y | _id, _lastUpdated, category, code, intent, occurrence, patient, performer, requester, status, supporting-info | HealthCareService:location , ServiceRequest:supporting-info , ServiceRequest:pertains-to-goal , ServiceRequest:patient , ServiceRequest:requester , ServiceRequest:performer , PractitionerRole:practitioner , PractitionerRole:organization | ||||
Subscription | Supported Profiles R4/B Topic-Based Subscription | y | y | $status | |||||
Task | Supported Profiles SDOHCC Task For Patient SDOHCC Task For Referral Management | y | y | y | y | _id, _lastUpdated, code, owner, patient, requester, status, focus, output | Task:focus , Task:output , HealthCareService:location , ServiceRequest:supporting-info , ServiceRequest:pertains-to-goal , ServiceRequest:patient , ServiceRequest:requester , ServiceRequest:performer , PractitionerRole:practitioner , PractitionerRole:organization |
http://hl7.org/fhir/us/core/StructureDefinition/us-core-careteam
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
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known CareTeam records - and more specifically, retrieving more than one in a single call to poll for updates |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
literal
read
.search-type
.Used to access information about a patient's SDOH-related conditions, particularly those that are the reason for a referral
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known Condition records - and more specifically, retrieving more than one in a single call to poll for updates |
SHALL | category | token | Allows filtering to only SDOH-related conditions |
SHALL | patient | reference | Allows filtering to only conditions associated with a specific patient. Some systems will require that searches be patient-specific |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
SHOULD | clinical-status | token | Allows filtering to only active conditions |
SHOULD | code | token | Allows filtering to only specific SDOH conditions or sets of conditions |
SHOULD | verification-status | token | Allows filtering to exclude refuted or entered-in-error conditions |
literal
read
.search-type
.Used to access the consent that authorizes disclosure of ServiceRequest information to non-HIPAA-covered entities
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known consent records - and more specifically, retrieving more than one in a single call to poll for updates |
SHALL | source-reference | reference | Allows including the document that contains the PDF or similar representation of a paper consent |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
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
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known Device records - and more specifically, retrieving more than one in a single call to poll for updates |
SHALL | _lastUpdated | date | Allows filtering for only records that have changed since last query |
literal
read
.search-type
.Used to retrieve a scanned or other form of document representing the text of a consent. Also used for PDF forms.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known DocumentReference records - and more specifically, retrieving more than one in a single call to poll for updates |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
literal
read
.search-type
.http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-Goal
Used to access goals related to an SDOH referral
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known Goal records - and more specifically, retrieving more than one in a single call to poll for updates |
SHALL | category | token | Allows filtering to only include SDOH-related goals |
SHALL | patient | reference | Allows filtering to only include goals for a particular patient. Some systems will require searches to be patient-specific |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
SHOULD | achievement-status | token | Allows filtering to only include unmet goals |
SHOULD | lifecycle-status | token | Allows filtering to only include active goals |
SHOULD | target-date | date | Allows filtering based on when a particular goal is desired to be achieved |
literal
read
, search-type
.Used to access information about the intended performer of a ServiceRequest when the performer is a specific service within a larger facility. Note: Conformance expectations for this resource are lower because HealthcareService performers are expected to be uncommon in most SDOH uses. Also used to indicate who a patient or caregiver should contact about a particular service.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known HealthcareService records - and more specifically, retrieving more than one in a single call to poll for updates |
SHALL | location | reference | Allows retrieval of the phyical site(s) associated with a HealthService |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
literal
read
.search-type
.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.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known Location records - and more specifically, retrieving more than one in a single call to poll for updates |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
literal
read
.search-type
.http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ObservationAssessment
http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ObservationScreeningResponse
http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ObservationEthnicityOMB
http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ObservationRaceOMB
http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ObservationGenderIdentity
http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ObservationPersonalCharacteristic
http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ObservationPersonalPronouns
http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ObservationRecordedSexGender
http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ObservationSexualOrientation
Used to access information about SDOH-related observations for a patient - particularly those that are reasons for a referral. Also used to access certain SDOH-relevant demographic information.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known Observation records - and more specifically, retrieving more than one in a single call to poll for updates |
SHALL | category | token | Allows filtering for only SDOH-related observations |
SHALL | patient | reference | Allows filtering for observations specific to a particular patient. Some systems will require that all queries be patient-specific |
SHALL | status | token | Allows filtering for observations that are completed or revised (i.e. not in-progress or entered-in-error) |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
SHOULD | code | token | Allows filtering for specific types of observations |
SHOULD | date | date | Allows filtering for observations that held in a particular time period |
SHOULD | derived-from | reference | Allows filtering for observations derived from a particular QuestionnaireResponse |
MAY | code-value-concept | composite | Allows filtering for observations that have a specific coded value answer for a specified observation type |
literal
read
.search-type
.http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization
Used to access information about an Organization that is the requester or intended performer of a ServiceRequest
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known Organization records - and more specifically, retrieving more than one in a single call to poll for updates |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
literal
read
.search-type
.http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient
Used to access information about the Patient that is the subject a ServiceRequest
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known Patient records - and more specifically, retrieving more than one in a single call to poll for updates |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
literal
read
.search-type
.http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner
Used to access information about an Practitioner that is the requester or intended performer of a ServiceRequest
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known Practitioner records - and more specifically, retrieving more than one in a single call to poll for updates |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
literal
read
.search-type
.http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole
Used to access information about an PractitionerRole that is the requester or intended performer of a ServiceRequest
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known PractitionerRole records - and more specifically, retrieving more than one in a single call to poll for updates |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
SHOULD | organization | reference | Allows doing an _include on Organization when retrieving the PractitionerRole |
SHOULD | practitioner | reference | Allows doing an _include on Practitioner when retrieving the PractitionerRole |
literal
create
, update
, read
.search-type
.Used to access information about actions that have been performed as a result of a referral
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known Proceddure records - and more specifically, retrieving more than one in a single call to poll for updates |
SHALL | based-on | reference | Allows filtering for procedures resulting from a particular service request |
SHALL | category | token | Allows filtering for procedures that are SDOH-related |
SHALL | patient | reference | Allows filtering for procedures based on who they were delivered to. Some systems may require that all searches be patient-specific. |
SHALL | performer | reference | Allows filtering for procedures based on who delivered the procedure. |
SHALL | status | token | Allows filtering for procedures that are complete or in progress |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
SHOULD | code | token | Allows filtering for procedures based on the specific service delivered |
SHOULD | date | date | Allows filtering for procedures based on when they were delivered |
Used to retrieve SDOH-related Questionnaires to be filled out by a patient or representative. Also allows retrieving Questionnaires associated with existing QuestionnaireResponses for editing by SMART-on-FHIR apps.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | url | uri | Allows retrieving Questionnaires based on its canonical URL |
SHALL | version | token | Allows retrieving a specific version of a Questionnaire |
SHOULD | code | token | Allows filtering for questionnaires associated with particular LOINC or similar codes |
SHOULD | context-type-value | composite | Allows filtering for procedures that are SDOH-related |
SHOULD | identifier | token | Allows retrieving Questionnaires with a known identifier |
SHOULD | publisher | string | Allows retrieving Questionnaires based on who is responsible for them |
SHOULD | status | token | Allows retrieving Questionnaires that are active (and not draft or required) |
SHOULD | subject-type | token | Allows retrieving Questionnaires that are intended to be completed about patients - as opposed to practitioner, organizations, etc. |
SHOULD | title | string | Allows retrieving Questionnaires based on the name of the form |
Conformance | Operation | Documentation |
---|---|---|
MAY | $populate | Allows SMART on FHIR or other systems to pre-populate a questionnaire response with existing information either available locally or queried from elsewhere |
literal
read
, search-type
.http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaireresponse
Used to allow QuestionnaireResponses referenced by a ServiceRequest or Task
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known QuestionnaireResponse records - and more specifically, retrieving more than one in a single call to poll for updates |
SHALL | author | reference | Allows filtering QuestionnaireResponses previously created/edited by a particular individual |
SHALL | patient | reference | Allows retrieving QuestionnaireResponses associated with a particular patient. Some systems may only permit searches that are patient-specific |
SHALL | questionnaire | reference | Allows retrieving QuestionnaireResponses that have been completed against a specified form |
SHALL | status | token | Allows retrieving QuestionnaireResponses that are complete (or incomplete) |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
SHOULD | authored | date | Allows filtering for QuestionnaireResponses by when they were created/last edited |
literal
read
, search-type
.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
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known RelatedPerson records - and more specifically, retrieving more than one in a single call to poll for updates |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
literal
read
.search-type
.Used to retrieve an order for SDOH-related services
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known ServiceRequests records - and more specifically, retrieving more than one in a single call to poll for updates |
SHALL | category | token | Allows filtering to only retrieve ServiceRequests that are SDOH-related |
SHALL | intent | token | Allows filtering to retrieve only 'order' ServiceRequests and not plans, proposals, etc. |
SHALL | patient | reference | Allows filtering to retrieve only ServiceRequests associated with a particular patient. Note that some systems may mandate that searches are always patient-specific |
SHALL | status | token | Allows filtering to retrieve only active ServiceRequests |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
SHOULD | code | token | Allows filtering to retrieve ServiceRequests for specific types of services |
SHOULD | occurrence | date | Allows filtering to retrieve ServiceRequests based on the timeframe in which the service needs to be provided |
SHOULD | performer | reference | Allows filtering to retrieve only ServiceRequests that designate a specific performer |
SHOULD | requester | reference | Allows filtering to retrieve only ServiceRequests created by a specific practitioner |
SHOULD | supporting-info | reference | Allows _include to retrieve supporting information for a ServiceRequest - particularly Consent |
create
.update
.Used to monitor updates to Tasks on downstream systems
Conformance | Operation | Documentation |
---|---|---|
SHOULD | $status | Necessary for systems supporting subscriptions to ensure that the subscription is functioning properly and to check for errors |
literal
create
, update
, read
.search-type
.Used to create Tasks on downstream systems seeking fufillment of ServiceRequests or performance of a patient activity on a coordinating system serving as an intermediary and to retrieve Task updates from a fulfilling system.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known Task records - and more specifically, retrieving more than one in a single call to poll for updates |
SHALL | code | token | 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. |
SHALL | patient | reference | 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.) |
SHALL | requester | reference | 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 |
SHALL | status | token | Allows filtering to only active or completed tasks |
SHALL | focus | reference | Allows retrieving the task(s) seeking fulfillment of a particular ServiceRequest |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
SHOULD | owner | reference | Allows filtering only for tasks that are assigned to a particular owner (or alternatively, tasks that have not yet been assigned) |
SHOULD | output | reference | Allows for the 'output' of a Task to be included when retrieving a Task |
server
Coordinating systems and service providers will frequently need to access information from the SDOH clinical care manager.
SMART-on-FHIR
Implementations must meet the general privacy & security requirements documented in this implementation guide.
batch
interaction described as follows:Allows other systems to poll for changes to multiple resource types simultaneously
The summary table lists the resources that are part of this configuration, and for each resource it lists:
_include
_revinclude
Resource Type | Profile | R | S | U | C | Searches | _include | _revinclude | Operations |
---|---|---|---|---|---|---|---|---|---|
CareTeam | Supported Profiles US Core CareTeam Profile | y | y | _id, _lastUpdated | |||||
Condition | Supported Profiles SDOHCC Condition | y | y | y | y | _id, _lastUpdated, category, clinical-status, code, patient, verification-status | |||
Consent | Supported Profiles SDOHCC Consent | y | y | y | y | _id, _lastUpdated, source-reference | Consent:source-reference:DocumentReference | ||
Device | Supported Profiles Device | y | y | _id, _lastUpdated | |||||
DocumentReference | Supported Profiles US Core DocumentReference Profile | y | y | y | y | _id, _lastUpdated | |||
Goal | Supported Profiles SDOHCC Goal | y | y | y | y | _id, _lastUpdated, achievement-status, category, lifecycle-status, patient, target-date | |||
Group | Supported Profiles SDOHCC Group | y | y | _id, _lastUpdated, characteristic-value, code, managing-entity, member | Group:member | ||||
HealthcareService | Supported Profiles SDOHCC Healthcare Service | y | y | _id, _lastUpdated, location | |||||
Location | Supported Profiles SDOHCC Location | y | y | _id, _lastUpdated | |||||
Observation | Supported 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 | y | y | y | y | _id, _lastUpdated, category, code, code-value-concept, date, derived-from, patient, status | |||
Organization | Supported Profiles US Core Organization Profile | y | y | _id, _lastUpdated | |||||
Patient | Supported Profiles US Core Patient Profile | y | y | _id, _lastUpdated | |||||
Practitioner | Supported Profiles US Core Practitioner Profile | y | y | _id, _lastUpdated | |||||
PractitionerRole | Supported Profiles US Core PractitionerRole Profile | y | y | _id, _lastUpdated, organization, practitioner | PractitionerRole:organization , PractitionerRole:practitioner | ||||
Procedure | Supported Profiles SDOHCC Procedure | y | y | y | y | _id, _lastUpdated, based-on, category, code, date, patient, performer, status | |||
Questionnaire | Supported Profiles Extractable Questionnaire - StructureMap | y | code, context-type-value, identifier, publisher, status, subject-type, title, url, version | $populate | |||||
QuestionnaireResponse | Supported Profiles SDC Questionnaire Response | y | y | y | y | _id, _lastUpdated, author, authored, patient, questionnaire, status | |||
RelatedPerson | Supported Profiles RelatedPerson | y | y | _id, _lastUpdated | |||||
ServiceRequest | Supported Profiles SDOHCC ServiceRequest | y | y | y | y | _id, _lastUpdated, category, code, intent, occurrence, patient, performer, requester, status, supporting-info | HealthCareService:location , ServiceRequest:supporting-info , ServiceRequest:pertains-to-goal , ServiceRequest:patient , ServiceRequest:requester , ServiceRequest:performer , PractitionerRole:practitioner , PractitionerRole:organization | ||
Subscription | Supported Profiles R4/B Topic-Based Subscription | y | y | $status | |||||
Task | Supported Profiles SDOHCC Task For Patient SDOHCC Task For Referral Management | y | y | y | y | _id, _lastUpdated, code, owner, patient, requester, status, focus, output | Task:focus , Task:output , HealthCareService:location , ServiceRequest:supporting-info , ServiceRequest:pertains-to-goal , ServiceRequest:patient , ServiceRequest:requester , ServiceRequest:performer , PractitionerRole:practitioner , PractitionerRole:organization |
http://hl7.org/fhir/us/core/StructureDefinition/us-core-careteam
Used to allow downstream systems to access to information about the intended performer of a ServiceRequest when the performer is a specific team of people
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known CareTeam records - and more specifically, retrieving more than one in a single call to poll for updates |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
literal
read
, search-type
.create
, update
.Used to allow downstream systems to access to information about a patient's SDOH-related conditions, particularly those that are the reason for a referral
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known Condition records - and more specifically, retrieving more than one in a single call to poll for updates |
SHALL | category | token | Allows filtering to only SDOH-related conditions |
SHALL | patient | reference | Allows filtering to only conditions associated with a specific patient. Some systems will require that searches be patient-specific |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
SHOULD | clinical-status | token | Allows filtering to only active conditions |
SHOULD | code | token | Allows filtering to only specific SDOH conditions or sets of conditions |
SHOULD | verification-status | token | Allows filtering to exclude refuted or entered-in-error conditions |
literal
read
, search-type
.create
, update
.Used to allow access to the consent that authorizes disclosure of ServiceRequest information to non-HIPAA-covered entities
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known consent records - and more specifically, retrieving more than one in a single call to poll for updates |
SHALL | source-reference | reference | Allows including the document that contains the PDF or similar representation of a paper consent |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
Used to allow retrieval of the requester or intended performer of an SDOH ServiceRequest
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known Device records - and more specifically, retrieving more than one in a single call to poll for updates |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
literal
create
, read
, search-type
.update
.Used convey a scanned or other form of document representing the text of a consent. Also used for PDF forms.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known DocumentReference records - and more specifically, retrieving more than one in a single call to poll for updates |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
literal
read
, search-type
.create
, update
.http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-Goal
Used to allow access to goals related to an SDOH referral
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known Goal records - and more specifically, retrieving more than one in a single call to poll for updates |
SHALL | category | token | Allows filtering to only include SDOH-related goals |
SHALL | patient | reference | Allows filtering to only include goals for a particular patient. Some systems will require searches to be patient-specific |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
SHOULD | achievement-status | token | Allows filtering to only include unmet goals |
SHOULD | lifecycle-status | token | Allows filtering to only include active goals |
SHOULD | target-date | date | Allows filtering based on when a particular goal is desired to be achieved |
Exposes information about which patients associated with a particular payor coverage type currently have SDOH concerns under management
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known Group records - and more specifically, retrieving more than one in a single call to poll for updates |
SHALL | code | token | Allows filtering based on the type of group |
SHALL | member | reference | Allows performing an _include to retrieve the members of the group |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
SHOULD | characteristic-value | composite | Allows filtering based on the insurer or plan associated with the group |
SHOULD | managing-entity | reference | Allows filtering based on who is maintaining the group |
literal
read
, search-type
.Used to allow downstream systems to access to 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.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known HealthcareService records - and more specifically, retrieving more than one in a single call to poll for updates |
SHALL | location | reference | Allows retrieval of the phyical site(s) associated with a HealthService |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
literal
read
.search-type
.Used to expose 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.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known Location records - and more specifically, retrieving more than one in a single call to poll for updates |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
literal
read
, search-type
.create
, update
.http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ObservationAssessment
http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ObservationScreeningResponse
http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ObservationEthnicityOMB
http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ObservationRaceOMB
http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ObservationGenderIdentity
http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ObservationPersonalCharacteristic
http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ObservationPersonalPronouns
http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ObservationRecordedSexGender
http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ObservationSexualOrientation
Used to allow downstream systems to access to information about SDOH-related observations for a patient - particularly those that are reasons for a referral as well as certain SDOH-relevant demographic information
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known Observation records - and more specifically, retrieving more than one in a single call to poll for updates |
SHALL | category | token | Allows filtering for only SDOH-related observations |
SHALL | patient | reference | Allows filtering for observations specific to a particular patient. Some systems will require that all queries be patient-specific |
SHALL | status | token | Allows filtering for observations that are completed or revised (i.e. not in-progress or entered-in-error) |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
SHOULD | code | token | Allows filtering for specific types of observations |
SHOULD | date | date | Allows filtering for observations that held in a particular time period |
SHOULD | derived-from | reference | Allows filtering for observations derived from a particular QuestionnaireResponse |
MAY | code-value-concept | composite | Allows filtering for observations that have a specific coded value answer for a specified observation type |
literal
read
.search-type
.http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization
Used to allow downstream systems to access to information about an Organization that is the requester or intended performer of a ServiceRequest
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known Organization records - and more specifically, retrieving more than one in a single call to poll for updates |
SHALL | _lastUpdated | date | Allows filtering for only records that have changed since last query |
http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient
Used to allow downstream systems to access to information about the Patient that is the subject a ServiceRequest
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known Patient records - and more specifically, retrieving more than one in a single call to poll for updates |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
literal
read
, search-type
.http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner
Used to allow downstream systems to access to information about an Practitioner that is the requester or intended performer of a ServiceRequest
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known Practitioner records - and more specifically, retrieving more than one in a single call to poll for updates |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
literal
read
, search-type
.http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole
Used to allow downstream systems to access to information about an PractitionerRole that is the requester or intended performer of a ServiceRequest
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known PractitionerRole records - and more specifically, retrieving more than one in a single call to poll for updates |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
SHOULD | organization | reference | Allows doing an _include on Organization when retrieving the PractitionerRole |
SHOULD | practitioner | reference | Allows doing an _include on Practitioner when retrieving the PractitionerRole |
literal
create
, update
, read
, search-type
.Used to allow downstream coordination platforms and referral recipients to provide information about actions that have been performed as a result of a referral as well as to allow upstream systems to access that information.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known PractitionerRole records - and more specifically, retrieving more than one in a single call to poll for updates |
SHALL | based-on | reference | Allows filtering for procedures resulting from a particular service request |
SHALL | category | token | Allows filtering for procedures that are SDOH-related |
SHALL | patient | reference | Allows filtering for procedures based on who they were delivered to. Some systems may require that all searches be patient-specific. |
SHALL | performer | reference | Allows filtering for procedures based on who delivered the procedure. |
SHALL | status | token | Allows filtering for procedures that are complete or in progress |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
SHOULD | code | token | Allows filtering for procedures based on the specific service delivered |
SHOULD | date | date | Allows filtering for procedures based on when they were delivered |
Used to allow retrieval of SDOH-related Questionnaires to be filled out by a patient or representative. Also allows retrieving Questionnaires associated with existing QuestionnaireResponses for editing by SMART-on-FHIR apps.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | url | uri | Allows retrieving Questionnaires based on its canonical URL |
SHALL | version | token | Allows retrieving a specific version of a Questionnaire |
SHOULD | code | token | Allows filtering for questionnaires associated with particular LOINC or similar codes |
SHOULD | context-type-value | composite | Allows filtering for procedures that are SDOH-related |
SHOULD | identifier | token | Allows retrieving Questionnaires with a known identifier |
SHOULD | publisher | string | Allows retrieving Questionnaires based on who is responsible for them |
SHOULD | status | token | Allows retrieving Questionnaires that are active (and not draft or required) |
SHOULD | subject-type | token | Allows retrieving Questionnaires that are intended to be completed about patients - as opposed to practitioner, organizations, etc. |
SHOULD | title | string | Allows retrieving Questionnaires based on the name of the form |
Conformance | Operation | Documentation |
---|---|---|
MAY | $populate | Allows SMART on FHIR or other systems to pre-populate a questionnaire response with existing information either available locally or queried from elsewhere |
literal
create
, update
, read
, search-type
.http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaireresponse
Used to allow SMART apps to cread, update and retrieve QuestionnaireResponses relevant to SDOH care
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known QuestionnaireResponse records - and more specifically, retrieving more than one in a single call to poll for updates |
SHALL | author | reference | Allows filtering QuestionnaireResponses previously created/edited by a particular individual |
SHALL | patient | reference | Allows retrieving QuestionnaireResponses associated with a particular patient. Some systems may only permit searches that are patient-specific |
SHALL | questionnaire | reference | Allows retrieving QuestionnaireResponses that have been completed against a specified form |
SHALL | status | token | Allows retrieving QuestionnaireResponses that are complete (or incomplete) |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
SHOULD | authored | date | Allows filtering for QuestionnaireResponses by when they were created/last edited |
literal
read
, search-type
.Used to allow downstream systems to access to information about the requester or intended performer of a ServiceRequest when they are someone with a personal relationship to the Patient
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known RelatedPerson records - and more specifically, retrieving more than one in a single call to poll for updates |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
literal
read
, search-type
.create
, update
.Used to allow retrieval of an order for SDOH-related services
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known ServiceRequests records - and more specifically, retrieving more than one in a single call to poll for updates |
SHALL | category | token | Allows filtering to only retrieve ServiceRequests that are SDOH-related |
SHALL | intent | token | Allows filtering to retrieve only 'order' ServiceRequests and not plans, proposals, etc. |
SHALL | patient | reference | Allows filtering to retrieve only ServiceRequests associated with a particular patient. Note that some systems may mandate that searches are always patient-specific |
SHALL | status | token | Allows filtering to retrieve only active ServiceRequests |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
SHOULD | code | token | Allows filtering to retrieve ServiceRequests for specific types of services |
SHOULD | occurrence | date | Allows filtering to retrieve ServiceRequests based on the timeframe in which the service needs to be provided |
SHOULD | performer | reference | Allows filtering to retrieve only ServiceRequests that designate a specific performer |
SHOULD | requester | reference | Allows filtering to retrieve only ServiceRequests created by a specific practitioner |
SHOULD | supporting-info | reference | Allows _include to retrieve supporting information for a ServiceRequest - particularly Consent |
create
.update
.Used to allow upstream and occasionally downstream systems to subscribe to and monitor Tasks this system for change
Conformance | Operation | Documentation |
---|---|---|
SHOULD | $status | Allows upstream systems to verify their subscription is functioning properly and to check for errors |
literal
create
, update
, read
, search-type
.Used by upstream referral sources and coordination platforms to create and update Tasks seeking fufillment of ServiceRequests or performance of activities by patients and care-givers. Also used by downstream referral recipients to monitor and update Tasks stored on this system as they respond to requests to fulfill referrals and link in information about actions taken so far
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | Allows retrieving known Task records - and more specifically, retrieving more than one in a single call to poll for updates |
SHALL | code | token | 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. |
SHALL | patient | reference | 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.) |
SHALL | requester | reference | 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 |
SHALL | status | token | Allows filtering to only active or completed tasks |
SHALL | focus | reference | Allows retrieving the task(s) seeking fulfillment of a particular ServiceRequest |
SHOULD | _lastUpdated | date | Allows filtering for only records that have changed since last query |
SHOULD | owner | reference | Allows filtering only for tasks that are assigned to a particular owner (or alternatively, tasks that have not yet been assigned) |
SHOULD | output | reference | Allows for the 'output' of a Task to be included when retrieving a Task |