SDOH Clinical Care
2.3.0-draft - STU 2.3 Draft
SDOH Clinical Care
2.3.0-draft - STU 2.3 Draft
SDOH Clinical Care, published by HL7 International / Patient Care. This guide is not an authorized publication; it is the continuous build for version 2.3.0-draft 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
| Official URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-Group | Version: 2.3.0-draft | |||
| Standards status: Trial-use | Maturity Level: 2 | Computable Name: SDOHCCGroup | ||
Profile for identifying groups of patients who have a Social Determinants of Health (SDOH) condition and are members of a specific payer organization.
SDOHCC Group is intended to support identification of cohorts of individuals who have conditions in the same SDOH category (domain) AND are members of the same specific payer organization. (See Gravity Use Case Package Use Case 3 which involves aggregation and analysis of individual-level social risk and need data to support clinical, system, and community activities.) The two required slices on Group.characteristic can be used to identify a cohort of subjects who have coverage through a specific payer organization AND a condition that falls into a specified SDOH category/domain.
Usage:
Description of Profiles, Differentials, Snapshots and how the different presentations work.
| Name | Flags | Card. | Type | Description & Constraints |
|---|---|---|---|---|
  Group |
C | 0..* | Group | Group of SDOH patients for a payer dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources dom-3: 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 dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated dom-5: If a resource is contained in another resource, it SHALL NOT have a security label dom-6: A resource should have narrative for robust management grp-1: Can only have members if group is "actual" |
  implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created ele-1: All FHIR elements must have a @value or children |
 modifierExtension |
?! | 0..* | Extension | Extensions that cannot be ignored ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both |
| active |
Σ | 1..1 | boolean | Whether this group's record is in active use ele-1: All FHIR elements must have a @value or children Fixed Value: true |
| type |
Σ | 1..1 | code | person Binding: GroupType (required): Types of resources that are part of group. ele-1: All FHIR elements must have a @value or children Fixed Value: person |
| actual |
ΣC | 1..1 | boolean | Descriptive or actual ele-1: All FHIR elements must have a @value or children Fixed Value: true |
  Slices for characteristic |
2..* | BackboneElement | Include / Exclude group members by Trait Slice: Unordered, Open by value:code ele-1: All FHIR elements must have a @value or children | |
   characteristic:All Slices |
Content/Rules for all slices | |||
  modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both |
 code |
1..1 | CodeableConcept | Kind of characteristic Binding Description (No ValueSet): (example): List of characteristics used to describe group members; e.g. gender, age, owner, location, etc. ele-1: All FHIR elements must have a @value or children | |
 value[x] |
1..1 | Value held by characteristic Binding Description (No ValueSet): (example): Value of descriptive member characteristic; e.g. red, male, pneumonia, Caucasian, etc. ele-1: All FHIR elements must have a @value or children | ||
| valueCodeableConcept |
CodeableConcept | |||
| valueBoolean |
boolean | |||
| valueQuantity |
Quantity | |||
| valueRange |
Range | |||
  valueReference |
Reference(Any) | |||
 exclude |
1..1 | boolean | Group includes or excludes ele-1: All FHIR elements must have a @value or children | |
 characteristic:HasSDOHCondition |
S | 1..1 | BackboneElement | Include / Exclude group members by Trait ele-1: All FHIR elements must have a @value or children |
 modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both |
 code |
S | 1..1 | CodeableConcept | Kind of characteristic Binding Description (No ValueSet): (example): List of characteristics used to describe group members; e.g. gender, age, owner, location, etc. ele-1: All FHIR elements must have a @value or children Required Pattern: At least the following |
   coding |
1..* | Coding | Code defined by a terminology system Fixed Value: (complex) | |
 system |
1..1 | uri | Identity of the terminology system Fixed Value: http://hl7.org/fhir/us/sdoh-clinicalcare/CodeSystem/SDOHCC-CodeSystemTemporaryCodes | |
| code |
1..1 | code | Symbol in syntax defined by the system Fixed Value: sdoh-condition-category | |
| value[x] |
S | 1..1 | Reference(ValueSet) | Value held by characteristic ele-1: All FHIR elements must have a @value or children Required Pattern: At least the following |
| reference |
1..1 | string | Literal reference, Relative, internal or absolute URL Fixed Value: http://hl7.org/fhir/us/sdoh-clinicalcare/ValueSet/SDOHCC-ValueSetSDOHCategory | |
 exclude |
S | 1..1 | boolean | Group includes or excludes ele-1: All FHIR elements must have a @value or children Fixed Value: false |
 characteristic:HasPayer |
S | 1..1 | BackboneElement | Include / Exclude group members by Trait ele-1: All FHIR elements must have a @value or children |
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both |
| code |
S | 1..1 | CodeableConcept | Kind of characteristic Binding Description (No ValueSet): (example): List of characteristics used to describe group members; e.g. gender, age, owner, location, etc. ele-1: All FHIR elements must have a @value or children Required Pattern: At least the following |
| coding |
1..* | Coding | Code defined by a terminology system Fixed Value: (complex) | |
| system |
1..1 | uri | Identity of the terminology system Fixed Value: http://hl7.org/fhir/us/sdoh-clinicalcare/CodeSystem/SDOHCC-CodeSystemTemporaryCodes | |
| code |
1..1 | code | Symbol in syntax defined by the system Fixed Value: payer-coverage | |
| value[x] |
S | 1..1 | Reference(US Core Organization Profile(7.0.0)) | Value held by characteristic ele-1: All FHIR elements must have a @value or children |
| exclude |
S | 1..1 | boolean | Group includes or excludes ele-1: All FHIR elements must have a @value or children Fixed Value: false |
| member |
SC | 0..* | BackboneElement | Who or what is in group ele-1: All FHIR elements must have a @value or children |
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both |
| entity |
S | 1..1 | Reference(Patient | Practitioner | PractitionerRole | Device | Medication | Substance | Group) | Reference to the group member ele-1: All FHIR elements must have a @value or children |
| Documentation for this format | ||||
| Path | Conformance | ValueSet / Code | URI |
| Group.type | required | Fixed Value: personhttp://hl7.org/fhir/ValueSet/group-type|4.0.1from the FHIR Standard | |
| Group.characteristic.code | example | ||
| Group.characteristic.value[x] | example | ||
| Group.characteristic:HasSDOHCondition.code | example | Pattern: sdoh-condition-category | |
| Group.characteristic:HasPayer.code | example | Pattern: payer-coverage |
| Id | Grade | Path(s) | Details | Requirements |
| dom-2 | error | Group | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() | |
| dom-3 | error | Group | 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 | Group | 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 | Group | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() | |
| dom-6 | best practice | Group | 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() | |
| grp-1 | error | Group | Can only have members if group is "actual" : member.empty() or (actual = true) |
Other representations of profile: CSV, Excel, Schematron
IG © 2021+ HL7 International / Patient Care. Package hl7.fhir.us.sdoh-clinicalcare#2.3.0-draft based on FHIR 4.0.1. Generated 2025-04-02
Links: Table of Contents |
QA Report
| Version History |
|
Propose a change
