SDOHCC Procedure - SDOH Clinical Care v2.2.0

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

Resource Profile: SDOHCC Procedure

Official URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-Procedure				Version: 2.2.0
Standards status: Trial-use				Computable Name: SDOHCCProcedure

Profile for interventions that address Social Determinants of Health.

Purpose

SDOHCC Procedure is generally intended to represent a procedure performed to address an identified social risk or need (e.g., SDOHCC Condition, SDOHCC Observation Screening Response, SDOHCC Observation Assessment). SDOHCC Procedure can be based on an SDOHCC ServiceRequest, pertain to an SDOHCC Goal, or be the output of an SDOHCC Task For Referral Management. See the Data Modeling Framework for more detail on the relationships between SDOHCC Procedure and the other profiles in this IG.

Usage

Procedure.code has a binding to US Core Procedure Codes (required). Procedure.code also has additional bindings to SDOH domain-specific value sets (e.g., for Food Insecurity) which are determined by the value selected for Procedure.category. When Procedure.category is a value from SDOHCC ValueSet SDOH Category (e.g., food-insecurity), Procedure.code SHALL be selected from the corresponding domain-specific value set found in Additional Bindings (i.e. Food Insecurity Procedures. If more than one value is selected from SDOHCC ValueSet SDOH Category (e.g., food-insecurity and financial-insecurity) for Procedure.category, then Procedure.code SHALL be selected from at least one of the corresponding domain-specific value sets found in Additional Bindings (e.g. Food Insecurity Procedures).

Of note, Gravity Project is continuously developing terminology for new SDOH domains. For new SDOH domains where the Gravity terminology development cycle is in progress, domain-specific value sets may not yet be available in VSAC. If a domain-specific value set is not yet available in VSAC, the Additional Binding is the default binding for the profile element. If a domain-specific value set is available in VSAC but does not yet include all standardized codes identified during the domain’s terminology development cycle, the value set’s VSAC “Description” tab will state, “In progress”. Additional information related to Gravity value sets is provided on the Social Risk Terminology Value Sets page on the Gravity Project Confluence site.

Additionally, some SDOH domains may not yet be represented in SDOHCC ValueSet SDOH Category. In this case, Procedure.category: sdoh-category-unspecified can be used so that the Procedure instance can still be categorized as SDOH-related. If desired, category.text can also be used to further specify the domain. For example, at the time of publication of this IG, “disability-status” is not yet included in SDOHCC ValueSet SDOH Category. In this case, Procedure.category: sdoh-category-unspecified can be used along with category.text: Disability Status. For Procedure.category: sdoh-category-unspecified, there will not be domain-specific value sets and Additional Bindings for Procedure.code will designate the default binding to US Core Procedure Codes (required).

For more information on the correlation between Procedure.category and the domain-specific value sets in Additional Bindings for Procedure.code, see Gravity Project Value Sets.

Usage:

Refer to this Resource Profile: SDOHCC Task For Referral Management
Examples for this Resource Profile: Procedure/SDOHCC-ProcedureFoodPantryApplicationAssistanceExample, Procedure/SDOHCC-ProcedureProvisionOfFoodExample and Procedure/SDOHCC-ProcedureSummerFoodProgramApplicationAssistanceExample

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

Differential Table
Key Elements Table
Snapshot Table
Statistics/References
All

This structure is derived from USCoreProcedureProfile

Description & Constraints

Procedure

0..*

USCoreProcedureProfile

An action that addresses an SDOH condition, observation, or goal.

Slices for extension

0..*

Extension

Extension
Slice: Unordered, Open by value:url

pertainsToGoal

S

0..*

(Complex)

Pertains to SDOH goal
URL: http://hl7.org/fhir/StructureDefinition/resource-pertainsToGoal

value[x]

S

1..1

Reference(SDOHCC Goal)

Value of extension

Slices for basedOn

S

0..*

Reference(CarePlan | ServiceRequest)

A request for this procedure
Slice: Unordered, Open by profile:resolve()

basedOn:SupportedBasedOn

S

0..*

Reference(SDOHCC ServiceRequest)

An SDOH service request for this procedure

category

0..1

CodeableConcept

Classification of the procedure

Slices for coding

S

0..*

Coding

Code defined by a terminology system
Slice: Unordered, Open by value:$this

coding:SDOH

S

0..1

Coding

e.g., food-insecurity | transportation-insecurity
Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories.

code

1..1

CodeableConcept

Procedure codes from SNOMED CT, CPT, HCPCS II, ICD-10PC, or CDT
Binding: US Core Procedure Codes (required): Codes describing the type of Procedure

Additional Bindings

Purpose

Usage

Id	Grade	Path(s)	Details	Requirements
dom-2	error	Procedure	If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty()
dom-3	error	Procedure	If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference \| %resource.descendants().as(canonical) \| %resource.descendants().as(uri) \| %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4	error	Procedure	If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5	error	Procedure	If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty()
dom-6	best practice	Procedure	A resource should have narrative for robust management : text.`div`.exists()
ele-1	error	ALL elements	All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count())
ext-1	error	ALL extensions	Must have either extensions or value[x], not both : extension.exists() != value.exists()

Resource Profile: SDOHCC Procedure

Purpose

Usage

Formal Views of Profile Content

Terminology Bindings (Differential)

Terminology Bindings

Constraints

Terminology Bindings

Constraints

Terminology Bindings (Differential)

Terminology Bindings

Constraints

Terminology Bindings

Constraints