This page is part of the SDOH Clinical Care for Multiple Domains (v2.0.0: STU 2) based on FHIR R4. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions
Official URL: http://hl7.org/fhir/us/sdoh-clinicalcare/CapabilityStatement/SDOHCC-ReferralSource | Version: 2.0.0 | |||
Draft as of 2021-06 | Computable Name: SDOHCC_ReferralSource |
This resource describes the required and desired behavior of systems acting as SDOH clinical care ‘referral sources’. These are typically EHR or Payer systems that initiate the process of identifying patients with SDOH needs and requesting appropriate services.
Because systems that originate requests for service may sometimes also be recipients of requests for service, the requirements include ‘SHOULD’ expectations to also accept and process requests from other systems. The referral source may either interact directly with a Referral Recipient or will interact through an intermediary Coordination Platform. Responsibilities of Referral Sources include capturing information from a patient in the form of QuestionnaireResponses, Observations, Conditions and Goals as well as creating the ServiceRequest instances that refer patients for needed services and the Tasks that initiate fulfillment of those referrals.
Raw OpenAPI-Swagger Definition file | Download
(Requirements Definition Capability Statement)
Canonical URL: http://hl7.org/fhir/us/sdoh-clinicalcare/CapabilityStatement/SDOHCC-ReferralSource Published: 2021-06 (draft)
This resource describes the required and desired behavior of systems acting as SDOH clinical care 'referral sources'. These are typically EHR or Payer systems that initiate the process of identifying patients with SDOH needs and requesting appropriate services.
FHIR Version: | 4.0.1 |
---|---|
Supported formats: | xml, json |
The referral source needs to receive information about procedures done in response to referrals. They SHOULD also be able to receive information from upstream systems in cases where they are referred to themselves.
Security:
SMART-on-FHIRImplementations must meet the general privacy & security requirements documented in this implementation guide.
Resource | Search | Read | Read Version | Instance History | Resource History | Create | Update | Delete | Operations |
---|---|---|---|---|---|---|---|---|---|
CareTeam | MAY | MAY | |||||||
Condition | SHOULD | SHOULD | |||||||
Consent | SHOULD | SHOULD | |||||||
Device | SHOULD | SHOULD | |||||||
DocumentReference | SHOULD | SHOULD | |||||||
Goal | SHOULD | SHOULD | |||||||
HealthcareService | SHOULD | SHOULD | |||||||
Location | MAY | SHOULD | |||||||
Observation | SHOULD | SHOULD | |||||||
Organization | SHOULD | SHOULD | |||||||
Patient | SHOULD | SHOULD | |||||||
Practitioner | SHOULD | SHOULD | |||||||
PractitionerRole | SHOULD | SHOULD | |||||||
Procedure | SHOULD | SHALL | |||||||
Questionnaire | SHOULD | $populate: MAY | |||||||
QuestionnaireResponse | SHOULD | SHOULD | |||||||
RelatedPerson | MAY | MAY | |||||||
ServiceRequest | SHOULD | SHOULD | |||||||
Subscription | SHOULD | MAY | $status: SHOULD $topic-list: MAY |
||||||
Task | SHOULD |
SHALL
(conditional read: modified-since) |
SHALL | SHALL |
Name | Capability Statement | Description |
---|---|---|
batch | SHOULD |
Allows polling for changes to multiple resource types simultaneously |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known CareTeam records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Condition records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
category | SHALL | token |
Allows filtering to only SDOH-related conditions |
clinical-status | SHOULD | token |
Allows filtering to only active conditions |
code | SHOULD | token |
Allows filtering to only specific SDOH conditions or sets of conditions |
patient | SHALL | reference |
Allows filtering to only conditions associated with a specific patient. Some systems will require that searches be patient-specific |
verification-status | SHOULD | token |
Allows filtering to exclude refuted or entered-in-error conditions |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Supported Includes: Consent:source-reference:DocumentReference
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known consent records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
source-reference | SHOULD | reference |
Allows including the document that contains the PDF or similar representation of a paper consent |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Device records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known DocumentReference records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Goal records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
achievement-status | SHOULD | token |
Allows filtering to only include unmet goals |
category | SHALL | token |
Allows filtering to only include SDOH-related goals |
lifecycle-status | SHOULD | token |
Allows filtering to only include active goals |
patient | SHALL | reference |
Allows filtering to only include goals for a particular patient. Some systems will require searches to be patient-specific |
target-date | SHOULD | date |
Allows filtering based on when a particular goal is desired to be achieved |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known HealthcareService records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
location | SHALL | reference |
Allows retrieval of the phyical site(s) associated with a HealthService |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Location records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Observation records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
category | SHALL | token |
Allows filtering for only SDOH-related observations |
code | SHOULD | token |
Allows filtering for specific types of observations |
code-value-concept | MAY | composite |
Allows filtering for observations that have a specific coded value answer for a specified observation type |
date | SHOULD | date |
Allows filtering for observations that held in a particular time period |
derived-from | SHOULD | reference |
Allows filtering for observations derived from a particular QuestionnaireResponse |
patient | SHALL | reference |
Allows filtering for observations specific to a particular patient. Some systems will require that all queries be patient-specific |
status | SHOULD | token |
Allows filtering for observations that are completed or revised (i.e. not in-progress or entered-in-error) |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Organization records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Name | Conformance | Description |
---|---|---|
read | SHOULD |
Allows the system to retrieve the Patient that is the subject of a ServiceRequest. |
search-type | SHOULD |
Allows the monitoring of previously-retrieved Patients. |
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Patient records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Practitioner records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Supported Includes: PractitionerRole:organization PractitionerRole:practitioner
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known PractitionerRole records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
organization | SHOULD | reference |
Allows doing an _include on Organization when retrieving the PractitionerRole |
practitioner | SHOULD | reference |
Allows doing an _include on Practitioner when retrieving the PractitionerRole |
Supported Profile(s) - if resource is supported:
Versioning support: versioned-update
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Procedure records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
based-on | SHALL | reference |
Allows filtering for procedures resulting from a particular service request |
category | SHALL | token |
Allows filtering for procedures that are SDOH-related |
code | SHOULD | token |
Allows filtering for procedures based on the specific service delivered |
date | SHOULD | date |
Allows filtering for procedures based on when they were delivered |
patient | SHALL | reference |
Allows filtering for procedures based on who they were delivered to. Some systems may require that all searches be patient-specific. |
performer | SHALL | reference |
Allows filtering for procedures based on who delivered the procedure. |
status | SHALL | token |
Allows filtering for procedures that are complete or in progress |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
code | SHOULD | token |
Allows filtering for questionnaires associated with particular LOINC or similar codes |
context-type-value | SHOULD | composite |
Allows filtering for procedures that are SDOH-related |
identifier | SHOULD | token |
Allows retrieving Questionnaires with a known identifier |
publisher | SHOULD | string |
Allows retrieving Questionnaires based on who is responsible for them |
status | SHOULD | token |
Allows retrieving Questionnaires that are active (and not draft or required) |
subject-type | SHOULD | token |
Allows retrieving Questionnaires that are intended to be completed about patients - as opposed to practitioner, organizations, etc. |
title | SHOULD | string |
Allows retrieving Questionnaires based on the name of the form |
url | SHALL | uri |
Allows retrieving Questionnaires based on its canonical URL |
version | SHALL | token |
Allows retrieving a specific version of a Questionnaire |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known QuestionnaireResponse records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
author | SHALL | reference |
Allows filtering QuestionnaireResponses previously created/edited by a particular individual |
authored | SHOULD | date |
Allows filtering for QuestionnaireResponses by when they were created/last edited |
patient | SHALL | reference |
Allows retrieving QuestionnaireResponses associated with a particular patient. Some systems may only permit searches that are patient-specific |
questionnaire | SHALL | reference |
Allows retrieving QuestionnaireResponses that have been completed against a specified form |
status | SHALL | token |
Allows retrieving QuestionnaireResponses that are complete (or incomplete) |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known RelatedPerson records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Supported Includes: HealthCareService:location ServiceRequest:supporting-info ServiceRequest:pertains-to-goal ServiceRequest:patient ServiceRequest:requester ServiceRequest:performer PractitionerRole:practitioner PractitionerRole:organization
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known ServiceRequests records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
category | SHALL | token |
Allows filtering to only retrieve ServiceRequests that are SDOH-related |
code | SHOULD | token |
Allows filtering to retrieve ServiceRequests for specific types of services |
intent | SHALL | token |
Allows filtering to retrieve only 'order' ServiceRequests and not plans, proposals, etc. |
occurrence | SHOULD | date |
Allows filtering to retrieve ServiceRequests based on the timeframe in which the service needs to be provided |
patient | SHALL | reference |
Allows filtering to retrieve only ServiceRequests associated with a particular patient. Note that some systems may mandate that searches are always patient-specific |
performer | SHOULD | reference |
Allows filtering to retrieve only ServiceRequests that designate a specific performer |
requester | SHOULD | reference |
Allows filtering to retrieve only ServiceRequests created by a specific practitioner |
status | SHALL | token |
Allows filtering to retrieve only active ServiceRequests |
supporting-info | SHOULD | reference |
Allows _include to retrieve supporting information for a ServiceRequest - particularly Consent |
Supported Profile(s) - if resource is supported:
Supported Profile(s) - if resource is supported:
Versioning support: versioned-update
Reference policy: literal
Supported Includes: Task:focus Task:output HealthCareService:location ServiceRequest:supporting-info ServiceRequest:pertains-to-goal ServiceRequest:patient ServiceRequest:requester ServiceRequest:performer PractitionerRole:practitioner PractitionerRole:organization
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Task records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
code | SHALL | 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. |
owner | SHOULD | reference |
Allows filtering only for tasks that are assigned to a particular owner (or alternatively, tasks that have not yet been assigned) |
patient | SHALL | 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.) |
requester | SHALL | 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 |
status | SHALL | token |
Allows filtering to only active or completed tasks |
focus | SHALL | reference |
Allows retrieving the task(s) seeking fulfillment of a particular ServiceRequest |
output | SHOULD | reference |
Allows for the 'output' of a Task to be included when retrieving a Task |
Referral sources must make both the referral and all information referenced by it available to downstream coordination platforms and referral recipient systems and - depending on the capabilities of the receivers - may also need to make the Tasks themselves available for query and support writing of procedures in situations where the recipient is a 'light' referral recipient that doesn't have local persistence or FHIR server capabilities.
Security:
SMART-on-FHIRImplementations must meet the general privacy & security requirements documented in this implementation guide.
Resource | Search | Read | Read Version | Instance History | Resource History | Create | Update | Delete | Operations |
---|---|---|---|---|---|---|---|---|---|
CareTeam | MAY | MAY | |||||||
Condition | SHALL | SHALL | MAY | MAY | |||||
Consent | SHALL | SHALL | MAY | MAY | |||||
Device | SHOULD | SHOULD | |||||||
DocumentReference | SHALL | SHALL | SHALL | SHOULD | |||||
Goal | SHALL | SHALL | MAY | MAY | |||||
Group | SHALL | SHALL | |||||||
HealthcareService | SHOULD | SHOULD | |||||||
Location | MAY | SHOULD | |||||||
Observation | SHALL | SHALL | MAY | MAY | |||||
Organization | SHALL | SHALL | |||||||
Patient | SHALL | SHALL | |||||||
Practitioner | SHALL | SHALL | |||||||
PractitionerRole | SHALL | SHALL | |||||||
Procedure | SHALL | SHALL | SHALL | SHALL | |||||
Questionnaire | MAY | $populate: MAY | |||||||
QuestionnaireResponse | SHOULD | SHOULD | SHOULD | SHOULD | |||||
RelatedPerson | MAY | MAY | |||||||
ServiceRequest | SHALL | SHALL | MAY | MAY | |||||
Subscription | SHOULD | MAY | $status: SHOULD $topic-list: MAY |
||||||
Task | SHALL |
SHALL
(conditional read: modified-since) |
SHALL | SHALL |
Name | Capability Statement | Description |
---|---|---|
batch | SHOULD |
Allows other systems to poll for changes to multiple resource types simultaneously |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known CareTeam records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s) - if resource is supported:
Versioning support: versioned-update
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Condition records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
category | SHALL | token |
Allows filtering to only SDOH-related conditions |
clinical-status | SHOULD | token |
Allows filtering to only active conditions |
code | SHOULD | token |
Allows filtering to only specific SDOH conditions or sets of conditions |
patient | SHALL | reference |
Allows filtering to only conditions associated with a specific patient. Some systems will require that searches be patient-specific |
verification-status | SHOULD | token |
Allows filtering to exclude refuted or entered-in-error conditions |
Supported Profile(s) - if resource is supported:
Versioning support: versioned-update
Reference policy: literal
Supported Includes: Consent:source-reference:DocumentReference
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known consent records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
source-reference | SHALL | reference |
Allows including the document that contains the PDF or similar representation of a paper consent |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Device records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known DocumentReference records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s) - if resource is supported:
Versioning support: versioned-update
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Goal records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
achievement-status | SHOULD | token |
Allows filtering to only include unmet goals |
category | SHALL | token |
Allows filtering to only include SDOH-related goals |
lifecycle-status | SHOULD | token |
Allows filtering to only include active goals |
patient | SHALL | reference |
Allows filtering to only include goals for a particular patient. Some systems will require searches to be patient-specific |
target-date | SHOULD | date |
Allows filtering based on when a particular goal is desired to be achieved |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Supported Includes: Group:member
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Group records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
characteristic-value | SHOULD | composite |
Allows filtering based on the insurer or plan associated with the group |
code | SHALL | token |
Allows filtering based on the type of group |
managing-entity | SHOULD | reference |
Allows filtering based on who is maintaining the group |
member | SHALL | reference |
Allows performing an _include to retrieve the members of the group |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known HealthcareService records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
location | SHALL | reference |
Allows retrieval of the phyical site(s) associated with a HealthService |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Location records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s) - if resource is supported:
Versioning support: versioned-update
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Observation records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
category | SHALL | token |
Allows filtering for only SDOH-related observations |
code | SHOULD | token |
Allows filtering for specific types of observations |
code-value-concept | MAY | composite |
Allows filtering for observations that have a specific coded value answer for a specified observation type |
date | SHOULD | date |
Allows filtering for observations that held in a particular time period |
derived-from | SHOULD | reference |
Allows filtering for observations derived from a particular QuestionnaireResponse |
patient | SHALL | reference |
Allows filtering for observations specific to a particular patient. Some systems will require that all queries be patient-specific |
status | SHALL | token |
Allows filtering for observations that are completed or revised (i.e. not in-progress or entered-in-error) |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Organization records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Patient records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Practitioner records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Supported Includes: PractitionerRole:organization PractitionerRole:practitioner
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known PractitionerRole records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
organization | SHOULD | reference |
Allows doing an _include on Organization when retrieving the PractitionerRole |
practitioner | SHOULD | reference |
Allows doing an _include on Practitioner when retrieving the PractitionerRole |
Supported Profile(s) - if resource is supported:
Versioning support: versioned-update
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Procedure records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
based-on | SHALL | reference |
Allows filtering for procedures resulting from a particular service request |
category | SHALL | token |
Allows filtering for procedures that are SDOH-related |
code | SHOULD | token |
Allows filtering for procedures based on the specific service delivered |
date | SHOULD | date |
Allows filtering for procedures based on when they were delivered |
patient | SHALL | reference |
Allows filtering for procedures based on who they were delivered to. Some systems may require that all searches be patient-specific. |
performer | SHALL | reference |
Allows filtering for procedures based on who delivered the procedure. |
status | SHALL | token |
Allows filtering for procedures that are complete or in progress |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
code | SHOULD | token |
Allows filtering for questionnaires associated with particular LOINC or similar codes |
context-type-value | SHOULD | composite |
Allows filtering for procedures that are SDOH-related |
identifier | SHOULD | token |
Allows retrieving Questionnaires with a known identifier |
publisher | SHOULD | string |
Allows retrieving Questionnaires based on who is responsible for them |
status | SHOULD | token |
Allows retrieving Questionnaires that are active (and not draft or required) |
subject-type | SHOULD | token |
Allows retrieving Questionnaires that are intended to be completed about patients - as opposed to practitioner, organizations, etc. |
title | SHOULD | string |
Allows retrieving Questionnaires based on the name of the form |
url | SHALL | uri |
Allows retrieving Questionnaires based on its canonical URL |
version | SHALL | token |
Allows retrieving a specific version of a Questionnaire |
Supported Profile(s) - if resource is supported:
Versioning support: versioned-update
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known QuestionnaireResponse records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
author | SHALL | reference |
Allows filtering QuestionnaireResponses previously created/edited by a particular individual |
authored | SHOULD | date |
Allows filtering for QuestionnaireResponses by when they were created/last edited |
patient | SHALL | reference |
Allows retrieving QuestionnaireResponses associated with a particular patient. Some systems may only permit searches that are patient-specific |
questionnaire | SHALL | reference |
Allows retrieving QuestionnaireResponses that have been completed against a specified form |
status | SHALL | token |
Allows retrieving QuestionnaireResponses that are complete (or incomplete) |
Supported Profile(s) - if resource is supported:
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known RelatedPerson records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s) - if resource is supported:
Versioning support: versioned-update
Reference policy: literal
Supported Includes: HealthCareService:location ServiceRequest:supporting-info ServiceRequest:pertains-to-goal ServiceRequest:patient ServiceRequest:requester ServiceRequest:performer PractitionerRole:practitioner PractitionerRole:organization
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known ServiceRequests records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
category | SHALL | token |
Allows filtering to only retrieve ServiceRequests that are SDOH-related |
code | SHOULD | token |
Allows filtering to retrieve ServiceRequests for specific types of services |
intent | SHALL | token |
Allows filtering to retrieve only 'order' ServiceRequests and not plans, proposals, etc. |
occurrence | SHOULD | date |
Allows filtering to retrieve ServiceRequests based on the timeframe in which the service needs to be provided |
patient | SHALL | reference |
Allows filtering to retrieve only ServiceRequests associated with a particular patient. Note that some systems may mandate that searches are always patient-specific |
performer | SHOULD | reference |
Allows filtering to retrieve only ServiceRequests that designate a specific performer |
requester | SHOULD | reference |
Allows filtering to retrieve only ServiceRequests created by a specific practitioner |
status | SHALL | token |
Allows filtering to retrieve only active ServiceRequests |
supporting-info | SHOULD | reference |
Allows _include to retrieve supporting information for a ServiceRequest - particularly Consent |
Supported Profile(s) - if resource is supported:
Supported Profile(s) - if resource is supported:
Versioning support: versioned-update
Reference policy: literal
Supported Includes: Task:focus Task:output HealthCareService:location ServiceRequest:supporting-info ServiceRequest:pertains-to-goal ServiceRequest:patient ServiceRequest:requester ServiceRequest:performer PractitionerRole:practitioner PractitionerRole:organization
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Task records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
code | SHALL | 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. |
owner | SHOULD | reference |
Allows filtering only for tasks that are assigned to a particular owner (or alternatively, tasks that have not yet been assigned) |
patient | SHALL | 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.) |
requester | SHALL | 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 |
status | SHALL | token |
Allows filtering to only active or completed tasks |
focus | SHALL | reference |
Allows retrieving the task(s) seeking fulfillment of a particular ServiceRequest |
output | SHOULD | reference |
Allows for the 'output' of a Task to be included when retrieving a Task |