SDOH Clinical Care
3.0.0-ballot - STU 3 Ballot

SDOH Clinical Care - Downloaded Version 3.0.0-ballot See the Directory of published versions

## Resource Profile: SDOHCC Condition

Official URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-Condition | Version: 3.0.0-ballot
Standards status: Trial-use Active as of 2025-12-13 | Maturity Level: 2 | Computable Name: SDOHCCCondition

Profile for Social Determinants of Health (SDOH) conditions.

The Gravity Project team updated the SDOHCC Condition profile to include Protective Factors as a possible SDOHCC domain. We would encourage balloters to review this guidance and provide feedback.

### Purpose

SDOHCC Condition is generally intended to represent a health concern, problem, diagnosis related to a social risk or need, or a protective factor. SDOHCC Condition may be the result of a screening response Observation (e.g., SDOHCC Observation Screening Response or other Observations) made as part of an encounter assessment (e.g., SDOHCC Observation Assessment). SDOHCC Condition may be addressed by a Goal (SDOHCC Goal) or be the reason for a ServiceRequest (SDOHCC Service Request) or Procedure (SDOHCC Procedure). See the Data Modeling Framework for more detail on the relationships between SDOHCC Condition and the other profiles in this IG.

### Usage

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

Of note, Gravity Project is continuously developing terminology for new SDOH domains. Sometimes, a new SDOH domain may already be represented by a category code in SDOHCC ValueSet SDOH Category, but a domain-specific value set may not yet be available in VSAC. In this case, the Additional Binding for the new SDOH domain/category is the default binding for the profile element. Additionally, sometimes a domain-specific value set for a new domain is available in VSAC but does not yet include all standardized codes identified during the domain’s terminology development cycle. In this case, the value set’s “Description” tab in VSAC 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, `Condition.category`: sdoh-category-unspecified can be used so that the Condition instance can still be categorized as SDOH-related. If desired, `Condition.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, `Condition.category`: sdoh-category-unspecified can be used along with `Condition.category.text`: Disability Status. For `Condition.category`: sdoh-category-unspecified, there will not be domain-specific value sets and Additional Bindings for `Condition.code` will designate the default binding to US Core Condition Codes (required).

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

### US Core Conformance

US Core 6.1.0 and beyond profiles two Condition profiles: Encounter Diagnosis Condition Profile and Problems and Health Concerns Condition profile. The primary difference between these two profiles is in the `Condition.category` data element, where each profile requires different values to determine the category of the Condition resource. Instances derived from the SDOHCC Condition profile will be conformant to one of the US Core Condition profiles. `Condition.category` SHALL be one of encounter-diagnosis, problem-list-item, or health-concern.

### Protective Factors

In addition to representing social risks or needs, the SDOHCC Condition profile is also used to represent protective factors. Protective factors are defined as characteristics or strengths of individuals, families, or communities that act to mitigate risks and promote positive well-being. To represent a protective factor using this profile, `Condition.category` SHALL include the value `protective-factor`, in addition to adhering to all other constraints on the `Condition.category` element. Consistent with the binding logic for other SDOH domains, when `Condition.category` includes `protective-factor`, the `Condition.code` SHALL be selected from the corresponding domain-specific value set (e.g., Protective Factor Diagnoses) found in Additional Bindings. Examples of protective factors that can be represented include findings like "Spiritual strength" , "Stably housed" , or "Psychological resilience".

Usages:

- Refer to this Profile: SDOHCC Condition, SDOHCC Goal, SDOHCC Procedure, SDOHCC ServiceRequest and SDOHCC Task For Referral Management
- Examples for this Profile: Condition/SDOHCC-ConditionAsserterDeviceExample, Condition/SDOHCC-ConditionFoodInsecurityExample, Condition/SDOHCC-ConditionHomelessExample, Condition/SDOHCC-ConditionProtectiveFactor and Condition/SDOHCC-ConditionUnemployedExample
- CapabilityStatements using this Profile: SDOHCC Coordination Platform, SDOHCC Patient Application, SDOHCC Referral Recipient, SDOHCC Referral Recipient - Light and SDOHCC Referral Source

You can also check for usages in the FHIR IG Statistics

### Formal Views of Profile Content

Description Differentials, Snapshots, and other representations.

- Key Elements Table
- Differential Table
- Snapshot Table
- Statistics/References
- All

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Condition | C | 0..* | Condition | Detailed information about SDOH conditions, problems or diagnoses Constraints: con-3, con-4, con-5, SDOH-Con-1, SDOH-Con-2, SDOH-Con-3
meta | S Σ | 0..1 | Meta | Metadata about the resource
lastUpdated | S Σ | 0..1 | instant | When the resource last changed
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
Slices for extension |  | 0..* | Extension | Extension Slice: Unordered, Open by value:url
extension:asserterDevice | S C | 0..1 | Reference(Device) | Optional Extensions Element URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter
extension:assertedDate | S | 0..1 | dateTime | Date the condition was first asserted URL: http://hl7.org/fhir/StructureDefinition/condition-assertedDate
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
clinicalStatus | ?!S Σ C | 0..1 | CodeableConcept | active | recurrence | relapse | inactive | remission | resolved Binding: ConditionClinicalStatusCodes (required)
verificationStatus | ?!S Σ C | 0..1 | CodeableConcept | unconfirmed | provisional | differential | confirmed | refuted | entered-in-error Binding: ConditionVerificationStatus (required)
Slices for category | S C | 2..* | CodeableConcept | category codes Slice: Unordered, Open by value:$this Binding: ConditionCategoryCodes (extensible): A category assigned to the condition.
category:encounter-diagnosis | S | 0..1 | CodeableConcept | encounter-diagnosis Binding: ConditionCategoryCodes (extensible): A category assigned to the condition. Required Pattern: At least the following
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
coding |  | 1..* | Coding | Code defined by a terminology system Fixed Value: (Complex)
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
system |  | 1..1 | uri | Identity of the terminology system Fixed Value: http://terminology.hl7.org/CodeSystem/condition-category
version |  | 0..1 | string | Version of the system - if relevant
code |  | 1..1 | code | Symbol in syntax defined by the system Fixed Value: encounter-diagnosis
display |  | 0..1 | string | Representation defined by the system
userSelected |  | 0..1 | boolean | If this coding was chosen directly by the user
text |  | 0..1 | string | Plain text representation of the concept
category:problem-or-health-concern | S | 0..* | CodeableConcept | problem-list-item | health-concern Binding: USCoreProblemOrHealthConcern (7.0.0) (required)
category:screening-assessment | S C | 1..* | CodeableConcept | USCDI Health Status/Assessments Data Class. Requires at least a category code 'sdoh' Binding: USCoreScreeningAssessmentConditionCategory (7.0.0) (required)
category:SDOHCC | S | 0..* | CodeableConcept | e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories.
code | S Σ | 1..1 | CodeableConcept | Identification of the condition, problem or diagnosis Binding: USCoreConditionCodes (7.0.0) (required): Valueset to describe the actual problem experienced by the patient
Additional Bindings | Purpose | Usage
Digital Access Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = digital-access
Digital Literacy Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = digital-literacy
LessThanHighSchoolEducationDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = educational-attainment
Elder Abuse Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = elder-abuse
UnemploymentDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = employment-status
FinancialInsecurityDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = financial-insecurity
FoodInsecurityDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = food-insecurity
HealthInsuranceCoverageStatusDiagnoses (20241214) | Extensible | SDOHCCCondition#`Condition.category` = health-insurance-coverage-status
HomelessnessDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = homelessness
HousingInstabilityDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = housing-instability
InadequateHousingDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = inadequate-housing
Incarceration Status Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = incarceration-status
IntimatePartnerViolenceDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = intimate-partner-violence
Language Access Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = language-access
MaterialHardshipDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = material-hardship
MedicalCostBurdenDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = medical-cost-burden
HealthLiteracyDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = personal-health-literacy
SocialConnectionDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = social-connection
StressDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = stress
TransportationInsecurityDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = transportation-insecurity
Utility Insecurity Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = utility-insecurity
VeteranStatusDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = veteran-status
Protective Factors Findings | Extensible | SDOHCCCondition#`Condition.category` = protective-factor
USCoreConditionCodes (7.0.0) | Required | SDOHCCCondition#`Condition.category` = sdoh-category-unspecified
subject | S Σ | 1..1 | Reference(US Core Patient Profile(7.0.0)) | Who has the condition?
encounter | S Σ | 0..1 | Reference(US Core Encounter Profile(7.0.0)) | Encounter created as part of
onset[x] | S Σ | 0..1 |  | Estimated or actual date, date-time, or age
onsetDateTime |  |  | dateTime S |
onsetPeriod |  |  | Period |
abatement[x] | S C | 0..1 |  | When in resolution/remission
abatementDateTime |  |  | dateTime S |
abatementPeriod |  |  | Period |
recordedDate | S Σ | 0..1 | dateTime | Date record was first recorded
recorder | Σ | 0..1 | Reference(Practitioner | PractitionerRole) | Who recorded the condition
asserter | S Σ C | 0..1 | Reference(RelatedPerson | US Core Patient Profile(7.0.0) | US Core Practitioner Profile(7.0.0) | SDOHCC PractitionerRole) | Person or device that asserts this condition
evidence | S C | 0..* | BackboneElement | Supporting evidence Constraints: con-2
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
code | Σ C | 0..* | CodeableConcept | Manifestation/symptom Binding: ManifestationAndSymptomCodes (example): Codes that describe the manifestation or symptoms of a condition.
Slices for detail | Σ C | 0..* | Reference(Resource) | Supporting information found elsewhere Slice: Unordered, Open by profile:resolve()
detail:SupportedDetail | S Σ C | 0..* | Reference(SDOHCC Observation Screening Response | SDOHCC Condition | SDOHCC Observation Assessment | SDC Questionnaire Response) | Supporting information found elsewhere
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Condition.clinicalStatus | Base | required | Condition Clinical Status Codes | 📦4.0.1 | FHIR Std.
Condition.verificationStatus | Base | required | ConditionVerificationStatus | 📦4.0.1 | FHIR Std.
Condition.category | Base | extensible | Condition Category Codes | 📍4.0.1 | FHIR Std.
Condition.category:encounter-diagnosis | Base | extensible | Condition Category Codes | 📍4.0.1 | FHIR Std.
Condition.category:problem-or-health-concern | Base | required | US Core Problem or Health Concern | 📍7.0.0 | US Core v7.0
Condition.category:screening-assessment | Base | required | US Core Screening Assessment Condition Category | 📍7.0.0 | US Core v7.0
Condition.category:SDOHCC | Base | required | SDOHCC ValueSet SDOH Category | 📦3.0.0-ballot | This IG
Condition.code | Base | required | US Core Condition Codes | 📍7.0.0 | US Core v7.0
Condition.evidence.code | Base | example | Manifestation and Symptom Codes | 📍4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
SDOH-Con-1 | error | Condition | Can only have a max of one asserter. | `extension('http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter').count()+asserter.count()<=1`
SDOH-Con-2 | error | Condition | At least one Condition.category SHALL be encounter-diagnosis, problem-list-item, or health-concern | `category.where(coding.where(system = 'http://terminology.hl7.org/CodeSystem/condition-category' and code='encounter-diagnosis').exists()).exists() or category.where(coding.memberOf('http://hl7.org/fhir/us/core/ValueSet/us-core-problem-or-health-concern')).exists()`
SDOH-Con-3 | error | Condition | At least one Condition.category SHALL be sdoh | `category.where(coding.where(system = 'http://hl7.org/fhir/us/core/CodeSystem/us-core-category' and code='sdoh').exists()).exists()`
con-2 | error | Condition.evidence | evidence SHALL have code or details | `code.exists() or detail.exists()`
con-3 | best practice | Condition | Condition.clinicalStatus SHALL be present if verificationStatus is not entered-in-error and category is problem-list-item | `clinicalStatus.exists() or verificationStatus.coding.where(system='http://terminology.hl7.org/CodeSystem/condition-ver-status' and code = 'entered-in-error').exists() or category.select($this='problem-list-item').empty()`
con-4 | error | Condition | If condition is abated, then clinicalStatus must be either inactive, resolved, or remission | `abatement.empty() or clinicalStatus.coding.where(system='http://terminology.hl7.org/CodeSystem/condition-clinical' and (code='resolved' or code='remission' or code='inactive')).exists()`
con-5 | error | Condition | Condition.clinicalStatus SHALL NOT be present if verification Status is entered-in-error | `verificationStatus.coding.where(system='http://terminology.hl7.org/CodeSystem/condition-ver-status' and code='entered-in-error').empty() or clinicalStatus.empty()`
dom-2 | error | Condition | If the resource is contained in another resource, it SHALL NOT contain nested Resources | `contained.contained.empty()`
dom-3 | error | Condition | 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 | Condition | 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 | Condition | If a resource is contained in another resource, it SHALL NOT have a security label | `contained.meta.security.empty()`
dom-6 | best practice | Condition | 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()`

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Condition | C | 0..* | Condition | Detailed information about SDOH conditions, problems or diagnoses Constraints: SDOH-Con-1, SDOH-Con-2, SDOH-Con-3
meta | S | 0..1 | Meta | Metadata about the resource
lastUpdated | S | 0..1 | instant | When the resource last changed
Slices for extension |  | 0..* | Extension | Extension Slice: Unordered, Open by value:url
extension:asserterDevice | S C | 0..1 | Reference(Device) | Optional Extensions Element URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter
extension:assertedDate | S | 0..1 | dateTime | Date the condition was first asserted URL: http://hl7.org/fhir/StructureDefinition/condition-assertedDate
clinicalStatus | S | 0..1 | CodeableConcept | active | recurrence | relapse | inactive | remission | resolved Binding: ConditionClinicalStatusCodes (required)
verificationStatus | S | 0..1 | CodeableConcept | unconfirmed | provisional | differential | confirmed | refuted | entered-in-error Binding: ConditionVerificationStatus (required)
Slices for category | S C | 2..* | CodeableConcept | category codes Slice: Unordered, Open by value:$this
category:encounter-diagnosis | S | 0..1 | CodeableConcept | encounter-diagnosis 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://terminology.hl7.org/CodeSystem/condition-category
code |  | 1..1 | code | Symbol in syntax defined by the system Fixed Value: encounter-diagnosis
category:problem-or-health-concern | S | 0..* | CodeableConcept | problem-list-item | health-concern Binding: USCoreProblemOrHealthConcern (7.0.0) (required)
category:screening-assessment | S C | 1..* | CodeableConcept | USCDI Health Status/Assessments Data Class. Requires at least a category code 'sdoh' Binding: USCoreScreeningAssessmentConditionCategory (7.0.0) (required)
category:SDOHCC | S | 0..* | CodeableConcept | e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories.
code | S | 1..1 | CodeableConcept | Identification of the condition, problem or diagnosis Binding: USCoreConditionCodes (7.0.0) (required): Valueset to describe the actual problem experienced by the patient
Additional Bindings | Purpose | Usage
Digital Access Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = digital-access
Digital Literacy Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = digital-literacy
LessThanHighSchoolEducationDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = educational-attainment
Elder Abuse Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = elder-abuse
UnemploymentDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = employment-status
FinancialInsecurityDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = financial-insecurity
FoodInsecurityDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = food-insecurity
HealthInsuranceCoverageStatusDiagnoses (20241214) | Extensible | SDOHCCCondition#`Condition.category` = health-insurance-coverage-status
HomelessnessDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = homelessness
HousingInstabilityDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = housing-instability
InadequateHousingDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = inadequate-housing
Incarceration Status Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = incarceration-status
IntimatePartnerViolenceDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = intimate-partner-violence
Language Access Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = language-access
MaterialHardshipDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = material-hardship
MedicalCostBurdenDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = medical-cost-burden
HealthLiteracyDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = personal-health-literacy
SocialConnectionDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = social-connection
StressDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = stress
TransportationInsecurityDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = transportation-insecurity
Utility Insecurity Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = utility-insecurity
VeteranStatusDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = veteran-status
Protective Factors Findings | Extensible | SDOHCCCondition#`Condition.category` = protective-factor
USCoreConditionCodes (7.0.0) | Required | SDOHCCCondition#`Condition.category` = sdoh-category-unspecified
bodySite |  | 0..0 |  | Anatomical location, if relevant
subject | S | 1..1 | Reference(US Core Patient Profile(7.0.0)) | Who has the condition?
encounter | S | 0..1 | Reference(US Core Encounter Profile(7.0.0)) | Encounter created as part of
onset[x] | S | 0..1 |  | Estimated or actual date, date-time, or age
onsetDateTime |  |  | dateTime S |
onsetPeriod |  |  | Period |
abatement[x] | S | 0..1 |  | When in resolution/remission
abatementDateTime |  |  | dateTime S |
abatementPeriod |  |  | Period |
recordedDate | S | 0..1 | dateTime | Date record was first recorded
recorder |  | 0..1 | Reference(Practitioner | PractitionerRole) | Who recorded the condition
asserter | S C | 0..1 | Reference(RelatedPerson | US Core Patient Profile(7.0.0) | US Core Practitioner Profile(7.0.0) | SDOHCC PractitionerRole) | Person or device that asserts this condition
stage |  | 0..0 |  | Stage/grade, usually assessed formally
evidence | S | 0..* | BackboneElement | Supporting evidence
code |  | 0..* | CodeableConcept | Manifestation/symptom
Slices for detail |  | 0..* | Reference(Resource) | Supporting information found elsewhere Slice: Unordered, Open by profile:resolve()
detail:SupportedDetail | S | 0..* | Reference(SDOHCC Observation Screening Response | SDOHCC Condition | SDOHCC Observation Assessment | SDC Questionnaire Response) | Supporting information found elsewhere
Documentation for this format

#### Terminology Bindings (Differential)

Path | Status | Usage | ValueSet | Version | Source
Condition.clinicalStatus | Base | required | Condition Clinical Status Codes | 📦4.0.1 | FHIR Std.
Condition.verificationStatus | Base | required | ConditionVerificationStatus | 📦4.0.1 | FHIR Std.
Condition.category:problem-or-health-concern | Base | required | US Core Problem or Health Concern | 📍7.0.0 | US Core v7.0
Condition.category:screening-assessment | Base | required | US Core Screening Assessment Condition Category | 📍7.0.0 | US Core v7.0
Condition.category:SDOHCC | Base | required | SDOHCC ValueSet SDOH Category | 📦3.0.0-ballot | This IG
Condition.code | Base | required | US Core Condition Codes | 📍7.0.0 | US Core v7.0

#### Constraints

Id | Grade | Path(s) | Description | Expression
SDOH-Con-1 | error | Condition | Can only have a max of one asserter. | `extension('http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter').count()+asserter.count()<=1`
SDOH-Con-2 | error | Condition | At least one Condition.category SHALL be encounter-diagnosis, problem-list-item, or health-concern | `category.where(coding.where(system = 'http://terminology.hl7.org/CodeSystem/condition-category' and code='encounter-diagnosis').exists()).exists() or category.where(coding.memberOf('http://hl7.org/fhir/us/core/ValueSet/us-core-problem-or-health-concern')).exists()`
SDOH-Con-3 | error | Condition | At least one Condition.category SHALL be sdoh | `category.where(coding.where(system = 'http://hl7.org/fhir/us/core/CodeSystem/us-core-category' and code='sdoh').exists()).exists()`

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Condition | C | 0..* | Condition | Detailed information about SDOH conditions, problems or diagnoses Constraints: con-3, con-4, con-5, SDOH-Con-1, SDOH-Con-2, SDOH-Con-3
id | Σ | 0..1 | id | Logical id of this artifact
meta | S Σ | 0..1 | Meta | Metadata about the resource
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
versionId | Σ | 0..1 | id | Version specific identifier
lastUpdated | S Σ | 0..1 | instant | When the resource last changed
source | Σ | 0..1 | uri | Identifies where the resource comes from
profile | Σ | 0..* | canonical(StructureDefinition) | Profiles this resource claims to conform to
security | Σ | 0..* | Coding | Security Labels applied to this resource Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System.
tag | Σ | 0..* | Coding | Tags applied to this resource Binding: CommonTags (example): Codes that represent various types of tags, commonly workflow-related; e.g. "Needs review by Dr. Jones".
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
language |  | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
Additional Bindings | Purpose
AllLanguages | Max Binding
text |  | 0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained |  | 0..* | Resource | Contained, inline Resources
Slices for extension |  | 0..* | Extension | Extension Slice: Unordered, Open by value:url
extension:asserterDevice | S C | 0..1 | Reference(Device) | Optional Extensions Element URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter
extension:assertedDate | S | 0..1 | dateTime | Date the condition was first asserted URL: http://hl7.org/fhir/StructureDefinition/condition-assertedDate
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
identifier | Σ | 0..* | Identifier | External Ids for this condition
clinicalStatus | ?!S Σ C | 0..1 | CodeableConcept | active | recurrence | relapse | inactive | remission | resolved Binding: ConditionClinicalStatusCodes (required)
verificationStatus | ?!S Σ C | 0..1 | CodeableConcept | unconfirmed | provisional | differential | confirmed | refuted | entered-in-error Binding: ConditionVerificationStatus (required)
Slices for category | S C | 2..* | CodeableConcept | category codes Slice: Unordered, Open by value:$this Binding: ConditionCategoryCodes (extensible): A category assigned to the condition.
category:encounter-diagnosis | S | 0..1 | CodeableConcept | encounter-diagnosis Binding: ConditionCategoryCodes (extensible): A category assigned to the condition. Required Pattern: At least the following
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
coding |  | 1..* | Coding | Code defined by a terminology system Fixed Value: (Complex)
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
system |  | 1..1 | uri | Identity of the terminology system Fixed Value: http://terminology.hl7.org/CodeSystem/condition-category
version |  | 0..1 | string | Version of the system - if relevant
code |  | 1..1 | code | Symbol in syntax defined by the system Fixed Value: encounter-diagnosis
display |  | 0..1 | string | Representation defined by the system
userSelected |  | 0..1 | boolean | If this coding was chosen directly by the user
text |  | 0..1 | string | Plain text representation of the concept
category:problem-or-health-concern | S | 0..* | CodeableConcept | problem-list-item | health-concern Binding: USCoreProblemOrHealthConcern (7.0.0) (required)
category:screening-assessment | S C | 1..* | CodeableConcept | USCDI Health Status/Assessments Data Class. Requires at least a category code 'sdoh' Binding: USCoreScreeningAssessmentConditionCategory (7.0.0) (required)
category:SDOHCC | S | 0..* | CodeableConcept | e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories.
severity |  | 0..1 | CodeableConcept | Subjective severity of condition Binding: Condition/DiagnosisSeverity (preferred): A subjective assessment of the severity of the condition as evaluated by the clinician.
code | S Σ | 1..1 | CodeableConcept | Identification of the condition, problem or diagnosis Binding: USCoreConditionCodes (7.0.0) (required): Valueset to describe the actual problem experienced by the patient
Additional Bindings | Purpose | Usage
Digital Access Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = digital-access
Digital Literacy Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = digital-literacy
LessThanHighSchoolEducationDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = educational-attainment
Elder Abuse Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = elder-abuse
UnemploymentDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = employment-status
FinancialInsecurityDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = financial-insecurity
FoodInsecurityDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = food-insecurity
HealthInsuranceCoverageStatusDiagnoses (20241214) | Extensible | SDOHCCCondition#`Condition.category` = health-insurance-coverage-status
HomelessnessDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = homelessness
HousingInstabilityDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = housing-instability
InadequateHousingDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = inadequate-housing
Incarceration Status Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = incarceration-status
IntimatePartnerViolenceDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = intimate-partner-violence
Language Access Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = language-access
MaterialHardshipDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = material-hardship
MedicalCostBurdenDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = medical-cost-burden
HealthLiteracyDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = personal-health-literacy
SocialConnectionDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = social-connection
StressDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = stress
TransportationInsecurityDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = transportation-insecurity
Utility Insecurity Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = utility-insecurity
VeteranStatusDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = veteran-status
Protective Factors Findings | Extensible | SDOHCCCondition#`Condition.category` = protective-factor
USCoreConditionCodes (7.0.0) | Required | SDOHCCCondition#`Condition.category` = sdoh-category-unspecified
subject | S Σ | 1..1 | Reference(US Core Patient Profile(7.0.0)) | Who has the condition?
encounter | S Σ | 0..1 | Reference(US Core Encounter Profile(7.0.0)) | Encounter created as part of
onset[x] | S Σ | 0..1 |  | Estimated or actual date, date-time, or age
onsetDateTime |  |  | dateTime S |
onsetPeriod |  |  | Period |
abatement[x] | S C | 0..1 |  | When in resolution/remission
abatementDateTime |  |  | dateTime S |
abatementPeriod |  |  | Period |
recordedDate | S Σ | 0..1 | dateTime | Date record was first recorded
recorder | Σ | 0..1 | Reference(Practitioner | PractitionerRole) | Who recorded the condition
asserter | S Σ C | 0..1 | Reference(RelatedPerson | US Core Patient Profile(7.0.0) | US Core Practitioner Profile(7.0.0) | SDOHCC PractitionerRole) | Person or device that asserts this condition
evidence | S C | 0..* | BackboneElement | Supporting evidence Constraints: con-2
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
code | Σ C | 0..* | CodeableConcept | Manifestation/symptom Binding: ManifestationAndSymptomCodes (example): Codes that describe the manifestation or symptoms of a condition.
Slices for detail | Σ C | 0..* | Reference(Resource) | Supporting information found elsewhere Slice: Unordered, Open by profile:resolve()
detail:SupportedDetail | S Σ C | 0..* | Reference(SDOHCC Observation Screening Response | SDOHCC Condition | SDOHCC Observation Assessment | SDC Questionnaire Response) | Supporting information found elsewhere
note |  | 0..* | Annotation | Additional information about the Condition
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Condition.meta.security | Base | extensible | SecurityLabels | 📍4.0.1 | FHIR Std.
Condition.meta.tag | Base | example | Common Tags | 📍4.0.1 | FHIR Std.
Condition.language | Base | preferred | Common Languages | 📍4.0.1 | FHIR Std.
Condition.clinicalStatus | Base | required | Condition Clinical Status Codes | 📦4.0.1 | FHIR Std.
Condition.verificationStatus | Base | required | ConditionVerificationStatus | 📦4.0.1 | FHIR Std.
Condition.category | Base | extensible | Condition Category Codes | 📍4.0.1 | FHIR Std.
Condition.category:encounter-diagnosis | Base | extensible | Condition Category Codes | 📍4.0.1 | FHIR Std.
Condition.category:problem-or-health-concern | Base | required | US Core Problem or Health Concern | 📍7.0.0 | US Core v7.0
Condition.category:screening-assessment | Base | required | US Core Screening Assessment Condition Category | 📍7.0.0 | US Core v7.0
Condition.category:SDOHCC | Base | required | SDOHCC ValueSet SDOH Category | 📦3.0.0-ballot | This IG
Condition.severity | Base | preferred | Condition/Diagnosis Severity | 📍4.0.1 | FHIR Std.
Condition.code | Base | required | US Core Condition Codes | 📍7.0.0 | US Core v7.0
Condition.stage.summary | Base | example | Condition Stage | 📍4.0.1 | FHIR Std.
Condition.stage.type | Base | example | Condition Stage Type | 📍4.0.1 | FHIR Std.
Condition.evidence.code | Base | example | Manifestation and Symptom Codes | 📍4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
SDOH-Con-1 | error | Condition | Can only have a max of one asserter. | `extension('http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter').count()+asserter.count()<=1`
SDOH-Con-2 | error | Condition | At least one Condition.category SHALL be encounter-diagnosis, problem-list-item, or health-concern | `category.where(coding.where(system = 'http://terminology.hl7.org/CodeSystem/condition-category' and code='encounter-diagnosis').exists()).exists() or category.where(coding.memberOf('http://hl7.org/fhir/us/core/ValueSet/us-core-problem-or-health-concern')).exists()`
SDOH-Con-3 | error | Condition | At least one Condition.category SHALL be sdoh | `category.where(coding.where(system = 'http://hl7.org/fhir/us/core/CodeSystem/us-core-category' and code='sdoh').exists()).exists()`
con-2 | error | Condition.evidence | evidence SHALL have code or details | `code.exists() or detail.exists()`
con-3 | best practice | Condition | Condition.clinicalStatus SHALL be present if verificationStatus is not entered-in-error and category is problem-list-item | `clinicalStatus.exists() or verificationStatus.coding.where(system='http://terminology.hl7.org/CodeSystem/condition-ver-status' and code = 'entered-in-error').exists() or category.select($this='problem-list-item').empty()`
con-4 | error | Condition | If condition is abated, then clinicalStatus must be either inactive, resolved, or remission | `abatement.empty() or clinicalStatus.coding.where(system='http://terminology.hl7.org/CodeSystem/condition-clinical' and (code='resolved' or code='remission' or code='inactive')).exists()`
con-5 | error | Condition | Condition.clinicalStatus SHALL NOT be present if verification Status is entered-in-error | `verificationStatus.coding.where(system='http://terminology.hl7.org/CodeSystem/condition-ver-status' and code='entered-in-error').empty() or clinicalStatus.empty()`
dom-2 | error | Condition | If the resource is contained in another resource, it SHALL NOT contain nested Resources | `contained.contained.empty()`
dom-3 | error | Condition | 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 | Condition | 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 | Condition | If a resource is contained in another resource, it SHALL NOT have a security label | `contained.meta.security.empty()`
dom-6 | best practice | Condition | 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()`

Summary

Mandatory: 2 elements
Must-Support: 20 elements
Prohibited: 2 elements

Structures

This structure refers to these other structures:

- US Core Patient Profile (http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient|7.0.0)
- US Core Encounter Profile (http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter|7.0.0)
- US Core Practitioner Profile (http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner|7.0.0)
- SDOHCC PractitionerRole (http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-practitionerrole)
- SDOHCC Observation Screening Response (http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ObservationScreeningResponse)
- SDOHCC Condition (http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-Condition)
- SDOHCC Observation Assessment (http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ObservationAssessment)
- SDC Questionnaire Response (http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaireresponse)

Extensions

This structure refers to these extensions:

- http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter
- http://hl7.org/fhir/StructureDefinition/condition-assertedDate|5.2.0

Slices

This structure defines the following Slices:

- The element 1 is sliced based on the value of Condition.category
- The element 1 is sliced based on the value of Condition.evidence.detail

Maturity: 2

Key Elements View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Condition | C | 0..* | Condition | Detailed information about SDOH conditions, problems or diagnoses Constraints: con-3, con-4, con-5, SDOH-Con-1, SDOH-Con-2, SDOH-Con-3
meta | S Σ | 0..1 | Meta | Metadata about the resource
lastUpdated | S Σ | 0..1 | instant | When the resource last changed
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
Slices for extension |  | 0..* | Extension | Extension Slice: Unordered, Open by value:url
extension:asserterDevice | S C | 0..1 | Reference(Device) | Optional Extensions Element URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter
extension:assertedDate | S | 0..1 | dateTime | Date the condition was first asserted URL: http://hl7.org/fhir/StructureDefinition/condition-assertedDate
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
clinicalStatus | ?!S Σ C | 0..1 | CodeableConcept | active | recurrence | relapse | inactive | remission | resolved Binding: ConditionClinicalStatusCodes (required)
verificationStatus | ?!S Σ C | 0..1 | CodeableConcept | unconfirmed | provisional | differential | confirmed | refuted | entered-in-error Binding: ConditionVerificationStatus (required)
Slices for category | S C | 2..* | CodeableConcept | category codes Slice: Unordered, Open by value:$this Binding: ConditionCategoryCodes (extensible): A category assigned to the condition.
category:encounter-diagnosis | S | 0..1 | CodeableConcept | encounter-diagnosis Binding: ConditionCategoryCodes (extensible): A category assigned to the condition. Required Pattern: At least the following
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
coding |  | 1..* | Coding | Code defined by a terminology system Fixed Value: (Complex)
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
system |  | 1..1 | uri | Identity of the terminology system Fixed Value: http://terminology.hl7.org/CodeSystem/condition-category
version |  | 0..1 | string | Version of the system - if relevant
code |  | 1..1 | code | Symbol in syntax defined by the system Fixed Value: encounter-diagnosis
display |  | 0..1 | string | Representation defined by the system
userSelected |  | 0..1 | boolean | If this coding was chosen directly by the user
text |  | 0..1 | string | Plain text representation of the concept
category:problem-or-health-concern | S | 0..* | CodeableConcept | problem-list-item | health-concern Binding: USCoreProblemOrHealthConcern (7.0.0) (required)
category:screening-assessment | S C | 1..* | CodeableConcept | USCDI Health Status/Assessments Data Class. Requires at least a category code 'sdoh' Binding: USCoreScreeningAssessmentConditionCategory (7.0.0) (required)
category:SDOHCC | S | 0..* | CodeableConcept | e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories.
code | S Σ | 1..1 | CodeableConcept | Identification of the condition, problem or diagnosis Binding: USCoreConditionCodes (7.0.0) (required): Valueset to describe the actual problem experienced by the patient
Additional Bindings | Purpose | Usage
Digital Access Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = digital-access
Digital Literacy Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = digital-literacy
LessThanHighSchoolEducationDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = educational-attainment
Elder Abuse Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = elder-abuse
UnemploymentDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = employment-status
FinancialInsecurityDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = financial-insecurity
FoodInsecurityDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = food-insecurity
HealthInsuranceCoverageStatusDiagnoses (20241214) | Extensible | SDOHCCCondition#`Condition.category` = health-insurance-coverage-status
HomelessnessDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = homelessness
HousingInstabilityDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = housing-instability
InadequateHousingDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = inadequate-housing
Incarceration Status Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = incarceration-status
IntimatePartnerViolenceDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = intimate-partner-violence
Language Access Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = language-access
MaterialHardshipDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = material-hardship
MedicalCostBurdenDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = medical-cost-burden
HealthLiteracyDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = personal-health-literacy
SocialConnectionDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = social-connection
StressDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = stress
TransportationInsecurityDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = transportation-insecurity
Utility Insecurity Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = utility-insecurity
VeteranStatusDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = veteran-status
Protective Factors Findings | Extensible | SDOHCCCondition#`Condition.category` = protective-factor
USCoreConditionCodes (7.0.0) | Required | SDOHCCCondition#`Condition.category` = sdoh-category-unspecified
subject | S Σ | 1..1 | Reference(US Core Patient Profile(7.0.0)) | Who has the condition?
encounter | S Σ | 0..1 | Reference(US Core Encounter Profile(7.0.0)) | Encounter created as part of
onset[x] | S Σ | 0..1 |  | Estimated or actual date, date-time, or age
onsetDateTime |  |  | dateTime S |
onsetPeriod |  |  | Period |
abatement[x] | S C | 0..1 |  | When in resolution/remission
abatementDateTime |  |  | dateTime S |
abatementPeriod |  |  | Period |
recordedDate | S Σ | 0..1 | dateTime | Date record was first recorded
recorder | Σ | 0..1 | Reference(Practitioner | PractitionerRole) | Who recorded the condition
asserter | S Σ C | 0..1 | Reference(RelatedPerson | US Core Patient Profile(7.0.0) | US Core Practitioner Profile(7.0.0) | SDOHCC PractitionerRole) | Person or device that asserts this condition
evidence | S C | 0..* | BackboneElement | Supporting evidence Constraints: con-2
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
code | Σ C | 0..* | CodeableConcept | Manifestation/symptom Binding: ManifestationAndSymptomCodes (example): Codes that describe the manifestation or symptoms of a condition.
Slices for detail | Σ C | 0..* | Reference(Resource) | Supporting information found elsewhere Slice: Unordered, Open by profile:resolve()
detail:SupportedDetail | S Σ C | 0..* | Reference(SDOHCC Observation Screening Response | SDOHCC Condition | SDOHCC Observation Assessment | SDC Questionnaire Response) | Supporting information found elsewhere
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Condition.clinicalStatus | Base | required | Condition Clinical Status Codes | 📦4.0.1 | FHIR Std.
Condition.verificationStatus | Base | required | ConditionVerificationStatus | 📦4.0.1 | FHIR Std.
Condition.category | Base | extensible | Condition Category Codes | 📍4.0.1 | FHIR Std.
Condition.category:encounter-diagnosis | Base | extensible | Condition Category Codes | 📍4.0.1 | FHIR Std.
Condition.category:problem-or-health-concern | Base | required | US Core Problem or Health Concern | 📍7.0.0 | US Core v7.0
Condition.category:screening-assessment | Base | required | US Core Screening Assessment Condition Category | 📍7.0.0 | US Core v7.0
Condition.category:SDOHCC | Base | required | SDOHCC ValueSet SDOH Category | 📦3.0.0-ballot | This IG
Condition.code | Base | required | US Core Condition Codes | 📍7.0.0 | US Core v7.0
Condition.evidence.code | Base | example | Manifestation and Symptom Codes | 📍4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
SDOH-Con-1 | error | Condition | Can only have a max of one asserter. | `extension('http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter').count()+asserter.count()<=1`
SDOH-Con-2 | error | Condition | At least one Condition.category SHALL be encounter-diagnosis, problem-list-item, or health-concern | `category.where(coding.where(system = 'http://terminology.hl7.org/CodeSystem/condition-category' and code='encounter-diagnosis').exists()).exists() or category.where(coding.memberOf('http://hl7.org/fhir/us/core/ValueSet/us-core-problem-or-health-concern')).exists()`
SDOH-Con-3 | error | Condition | At least one Condition.category SHALL be sdoh | `category.where(coding.where(system = 'http://hl7.org/fhir/us/core/CodeSystem/us-core-category' and code='sdoh').exists()).exists()`
con-2 | error | Condition.evidence | evidence SHALL have code or details | `code.exists() or detail.exists()`
con-3 | best practice | Condition | Condition.clinicalStatus SHALL be present if verificationStatus is not entered-in-error and category is problem-list-item | `clinicalStatus.exists() or verificationStatus.coding.where(system='http://terminology.hl7.org/CodeSystem/condition-ver-status' and code = 'entered-in-error').exists() or category.select($this='problem-list-item').empty()`
con-4 | error | Condition | If condition is abated, then clinicalStatus must be either inactive, resolved, or remission | `abatement.empty() or clinicalStatus.coding.where(system='http://terminology.hl7.org/CodeSystem/condition-clinical' and (code='resolved' or code='remission' or code='inactive')).exists()`
con-5 | error | Condition | Condition.clinicalStatus SHALL NOT be present if verification Status is entered-in-error | `verificationStatus.coding.where(system='http://terminology.hl7.org/CodeSystem/condition-ver-status' and code='entered-in-error').empty() or clinicalStatus.empty()`
dom-2 | error | Condition | If the resource is contained in another resource, it SHALL NOT contain nested Resources | `contained.contained.empty()`
dom-3 | error | Condition | 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 | Condition | 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 | Condition | If a resource is contained in another resource, it SHALL NOT have a security label | `contained.meta.security.empty()`
dom-6 | best practice | Condition | 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()`

Differential View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Condition | C | 0..* | Condition | Detailed information about SDOH conditions, problems or diagnoses Constraints: SDOH-Con-1, SDOH-Con-2, SDOH-Con-3
meta | S | 0..1 | Meta | Metadata about the resource
lastUpdated | S | 0..1 | instant | When the resource last changed
Slices for extension |  | 0..* | Extension | Extension Slice: Unordered, Open by value:url
extension:asserterDevice | S C | 0..1 | Reference(Device) | Optional Extensions Element URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter
extension:assertedDate | S | 0..1 | dateTime | Date the condition was first asserted URL: http://hl7.org/fhir/StructureDefinition/condition-assertedDate
clinicalStatus | S | 0..1 | CodeableConcept | active | recurrence | relapse | inactive | remission | resolved Binding: ConditionClinicalStatusCodes (required)
verificationStatus | S | 0..1 | CodeableConcept | unconfirmed | provisional | differential | confirmed | refuted | entered-in-error Binding: ConditionVerificationStatus (required)
Slices for category | S C | 2..* | CodeableConcept | category codes Slice: Unordered, Open by value:$this
category:encounter-diagnosis | S | 0..1 | CodeableConcept | encounter-diagnosis 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://terminology.hl7.org/CodeSystem/condition-category
code |  | 1..1 | code | Symbol in syntax defined by the system Fixed Value: encounter-diagnosis
category:problem-or-health-concern | S | 0..* | CodeableConcept | problem-list-item | health-concern Binding: USCoreProblemOrHealthConcern (7.0.0) (required)
category:screening-assessment | S C | 1..* | CodeableConcept | USCDI Health Status/Assessments Data Class. Requires at least a category code 'sdoh' Binding: USCoreScreeningAssessmentConditionCategory (7.0.0) (required)
category:SDOHCC | S | 0..* | CodeableConcept | e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories.
code | S | 1..1 | CodeableConcept | Identification of the condition, problem or diagnosis Binding: USCoreConditionCodes (7.0.0) (required): Valueset to describe the actual problem experienced by the patient
Additional Bindings | Purpose | Usage
Digital Access Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = digital-access
Digital Literacy Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = digital-literacy
LessThanHighSchoolEducationDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = educational-attainment
Elder Abuse Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = elder-abuse
UnemploymentDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = employment-status
FinancialInsecurityDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = financial-insecurity
FoodInsecurityDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = food-insecurity
HealthInsuranceCoverageStatusDiagnoses (20241214) | Extensible | SDOHCCCondition#`Condition.category` = health-insurance-coverage-status
HomelessnessDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = homelessness
HousingInstabilityDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = housing-instability
InadequateHousingDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = inadequate-housing
Incarceration Status Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = incarceration-status
IntimatePartnerViolenceDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = intimate-partner-violence
Language Access Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = language-access
MaterialHardshipDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = material-hardship
MedicalCostBurdenDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = medical-cost-burden
HealthLiteracyDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = personal-health-literacy
SocialConnectionDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = social-connection
StressDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = stress
TransportationInsecurityDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = transportation-insecurity
Utility Insecurity Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = utility-insecurity
VeteranStatusDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = veteran-status
Protective Factors Findings | Extensible | SDOHCCCondition#`Condition.category` = protective-factor
USCoreConditionCodes (7.0.0) | Required | SDOHCCCondition#`Condition.category` = sdoh-category-unspecified
bodySite |  | 0..0 |  | Anatomical location, if relevant
subject | S | 1..1 | Reference(US Core Patient Profile(7.0.0)) | Who has the condition?
encounter | S | 0..1 | Reference(US Core Encounter Profile(7.0.0)) | Encounter created as part of
onset[x] | S | 0..1 |  | Estimated or actual date, date-time, or age
onsetDateTime |  |  | dateTime S |
onsetPeriod |  |  | Period |
abatement[x] | S | 0..1 |  | When in resolution/remission
abatementDateTime |  |  | dateTime S |
abatementPeriod |  |  | Period |
recordedDate | S | 0..1 | dateTime | Date record was first recorded
recorder |  | 0..1 | Reference(Practitioner | PractitionerRole) | Who recorded the condition
asserter | S C | 0..1 | Reference(RelatedPerson | US Core Patient Profile(7.0.0) | US Core Practitioner Profile(7.0.0) | SDOHCC PractitionerRole) | Person or device that asserts this condition
stage |  | 0..0 |  | Stage/grade, usually assessed formally
evidence | S | 0..* | BackboneElement | Supporting evidence
code |  | 0..* | CodeableConcept | Manifestation/symptom
Slices for detail |  | 0..* | Reference(Resource) | Supporting information found elsewhere Slice: Unordered, Open by profile:resolve()
detail:SupportedDetail | S | 0..* | Reference(SDOHCC Observation Screening Response | SDOHCC Condition | SDOHCC Observation Assessment | SDC Questionnaire Response) | Supporting information found elsewhere
Documentation for this format

#### Terminology Bindings (Differential)

Path | Status | Usage | ValueSet | Version | Source
Condition.clinicalStatus | Base | required | Condition Clinical Status Codes | 📦4.0.1 | FHIR Std.
Condition.verificationStatus | Base | required | ConditionVerificationStatus | 📦4.0.1 | FHIR Std.
Condition.category:problem-or-health-concern | Base | required | US Core Problem or Health Concern | 📍7.0.0 | US Core v7.0
Condition.category:screening-assessment | Base | required | US Core Screening Assessment Condition Category | 📍7.0.0 | US Core v7.0
Condition.category:SDOHCC | Base | required | SDOHCC ValueSet SDOH Category | 📦3.0.0-ballot | This IG
Condition.code | Base | required | US Core Condition Codes | 📍7.0.0 | US Core v7.0

#### Constraints

Id | Grade | Path(s) | Description | Expression
SDOH-Con-1 | error | Condition | Can only have a max of one asserter. | `extension('http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter').count()+asserter.count()<=1`
SDOH-Con-2 | error | Condition | At least one Condition.category SHALL be encounter-diagnosis, problem-list-item, or health-concern | `category.where(coding.where(system = 'http://terminology.hl7.org/CodeSystem/condition-category' and code='encounter-diagnosis').exists()).exists() or category.where(coding.memberOf('http://hl7.org/fhir/us/core/ValueSet/us-core-problem-or-health-concern')).exists()`
SDOH-Con-3 | error | Condition | At least one Condition.category SHALL be sdoh | `category.where(coding.where(system = 'http://hl7.org/fhir/us/core/CodeSystem/us-core-category' and code='sdoh').exists()).exists()`

Snapshot ViewView

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Condition | C | 0..* | Condition | Detailed information about SDOH conditions, problems or diagnoses Constraints: con-3, con-4, con-5, SDOH-Con-1, SDOH-Con-2, SDOH-Con-3
id | Σ | 0..1 | id | Logical id of this artifact
meta | S Σ | 0..1 | Meta | Metadata about the resource
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
versionId | Σ | 0..1 | id | Version specific identifier
lastUpdated | S Σ | 0..1 | instant | When the resource last changed
source | Σ | 0..1 | uri | Identifies where the resource comes from
profile | Σ | 0..* | canonical(StructureDefinition) | Profiles this resource claims to conform to
security | Σ | 0..* | Coding | Security Labels applied to this resource Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System.
tag | Σ | 0..* | Coding | Tags applied to this resource Binding: CommonTags (example): Codes that represent various types of tags, commonly workflow-related; e.g. "Needs review by Dr. Jones".
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
language |  | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
Additional Bindings | Purpose
AllLanguages | Max Binding
text |  | 0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained |  | 0..* | Resource | Contained, inline Resources
Slices for extension |  | 0..* | Extension | Extension Slice: Unordered, Open by value:url
extension:asserterDevice | S C | 0..1 | Reference(Device) | Optional Extensions Element URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter
extension:assertedDate | S | 0..1 | dateTime | Date the condition was first asserted URL: http://hl7.org/fhir/StructureDefinition/condition-assertedDate
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
identifier | Σ | 0..* | Identifier | External Ids for this condition
clinicalStatus | ?!S Σ C | 0..1 | CodeableConcept | active | recurrence | relapse | inactive | remission | resolved Binding: ConditionClinicalStatusCodes (required)
verificationStatus | ?!S Σ C | 0..1 | CodeableConcept | unconfirmed | provisional | differential | confirmed | refuted | entered-in-error Binding: ConditionVerificationStatus (required)
Slices for category | S C | 2..* | CodeableConcept | category codes Slice: Unordered, Open by value:$this Binding: ConditionCategoryCodes (extensible): A category assigned to the condition.
category:encounter-diagnosis | S | 0..1 | CodeableConcept | encounter-diagnosis Binding: ConditionCategoryCodes (extensible): A category assigned to the condition. Required Pattern: At least the following
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
coding |  | 1..* | Coding | Code defined by a terminology system Fixed Value: (Complex)
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
system |  | 1..1 | uri | Identity of the terminology system Fixed Value: http://terminology.hl7.org/CodeSystem/condition-category
version |  | 0..1 | string | Version of the system - if relevant
code |  | 1..1 | code | Symbol in syntax defined by the system Fixed Value: encounter-diagnosis
display |  | 0..1 | string | Representation defined by the system
userSelected |  | 0..1 | boolean | If this coding was chosen directly by the user
text |  | 0..1 | string | Plain text representation of the concept
category:problem-or-health-concern | S | 0..* | CodeableConcept | problem-list-item | health-concern Binding: USCoreProblemOrHealthConcern (7.0.0) (required)
category:screening-assessment | S C | 1..* | CodeableConcept | USCDI Health Status/Assessments Data Class. Requires at least a category code 'sdoh' Binding: USCoreScreeningAssessmentConditionCategory (7.0.0) (required)
category:SDOHCC | S | 0..* | CodeableConcept | e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories.
severity |  | 0..1 | CodeableConcept | Subjective severity of condition Binding: Condition/DiagnosisSeverity (preferred): A subjective assessment of the severity of the condition as evaluated by the clinician.
code | S Σ | 1..1 | CodeableConcept | Identification of the condition, problem or diagnosis Binding: USCoreConditionCodes (7.0.0) (required): Valueset to describe the actual problem experienced by the patient
Additional Bindings | Purpose | Usage
Digital Access Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = digital-access
Digital Literacy Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = digital-literacy
LessThanHighSchoolEducationDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = educational-attainment
Elder Abuse Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = elder-abuse
UnemploymentDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = employment-status
FinancialInsecurityDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = financial-insecurity
FoodInsecurityDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = food-insecurity
HealthInsuranceCoverageStatusDiagnoses (20241214) | Extensible | SDOHCCCondition#`Condition.category` = health-insurance-coverage-status
HomelessnessDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = homelessness
HousingInstabilityDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = housing-instability
InadequateHousingDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = inadequate-housing
Incarceration Status Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = incarceration-status
IntimatePartnerViolenceDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = intimate-partner-violence
Language Access Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = language-access
MaterialHardshipDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = material-hardship
MedicalCostBurdenDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = medical-cost-burden
HealthLiteracyDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = personal-health-literacy
SocialConnectionDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = social-connection
StressDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = stress
TransportationInsecurityDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = transportation-insecurity
Utility Insecurity Diagnoses | Extensible | SDOHCCCondition#`Condition.category` = utility-insecurity
VeteranStatusDiagnoses (20240604) | Extensible | SDOHCCCondition#`Condition.category` = veteran-status
Protective Factors Findings | Extensible | SDOHCCCondition#`Condition.category` = protective-factor
USCoreConditionCodes (7.0.0) | Required | SDOHCCCondition#`Condition.category` = sdoh-category-unspecified
subject | S Σ | 1..1 | Reference(US Core Patient Profile(7.0.0)) | Who has the condition?
encounter | S Σ | 0..1 | Reference(US Core Encounter Profile(7.0.0)) | Encounter created as part of
onset[x] | S Σ | 0..1 |  | Estimated or actual date, date-time, or age
onsetDateTime |  |  | dateTime S |
onsetPeriod |  |  | Period |
abatement[x] | S C | 0..1 |  | When in resolution/remission
abatementDateTime |  |  | dateTime S |
abatementPeriod |  |  | Period |
recordedDate | S Σ | 0..1 | dateTime | Date record was first recorded
recorder | Σ | 0..1 | Reference(Practitioner | PractitionerRole) | Who recorded the condition
asserter | S Σ C | 0..1 | Reference(RelatedPerson | US Core Patient Profile(7.0.0) | US Core Practitioner Profile(7.0.0) | SDOHCC PractitionerRole) | Person or device that asserts this condition
evidence | S C | 0..* | BackboneElement | Supporting evidence Constraints: con-2
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
code | Σ C | 0..* | CodeableConcept | Manifestation/symptom Binding: ManifestationAndSymptomCodes (example): Codes that describe the manifestation or symptoms of a condition.
Slices for detail | Σ C | 0..* | Reference(Resource) | Supporting information found elsewhere Slice: Unordered, Open by profile:resolve()
detail:SupportedDetail | S Σ C | 0..* | Reference(SDOHCC Observation Screening Response | SDOHCC Condition | SDOHCC Observation Assessment | SDC Questionnaire Response) | Supporting information found elsewhere
note |  | 0..* | Annotation | Additional information about the Condition
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Condition.meta.security | Base | extensible | SecurityLabels | 📍4.0.1 | FHIR Std.
Condition.meta.tag | Base | example | Common Tags | 📍4.0.1 | FHIR Std.
Condition.language | Base | preferred | Common Languages | 📍4.0.1 | FHIR Std.
Condition.clinicalStatus | Base | required | Condition Clinical Status Codes | 📦4.0.1 | FHIR Std.
Condition.verificationStatus | Base | required | ConditionVerificationStatus | 📦4.0.1 | FHIR Std.
Condition.category | Base | extensible | Condition Category Codes | 📍4.0.1 | FHIR Std.
Condition.category:encounter-diagnosis | Base | extensible | Condition Category Codes | 📍4.0.1 | FHIR Std.
Condition.category:problem-or-health-concern | Base | required | US Core Problem or Health Concern | 📍7.0.0 | US Core v7.0
Condition.category:screening-assessment | Base | required | US Core Screening Assessment Condition Category | 📍7.0.0 | US Core v7.0
Condition.category:SDOHCC | Base | required | SDOHCC ValueSet SDOH Category | 📦3.0.0-ballot | This IG
Condition.severity | Base | preferred | Condition/Diagnosis Severity | 📍4.0.1 | FHIR Std.
Condition.code | Base | required | US Core Condition Codes | 📍7.0.0 | US Core v7.0
Condition.stage.summary | Base | example | Condition Stage | 📍4.0.1 | FHIR Std.
Condition.stage.type | Base | example | Condition Stage Type | 📍4.0.1 | FHIR Std.
Condition.evidence.code | Base | example | Manifestation and Symptom Codes | 📍4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
SDOH-Con-1 | error | Condition | Can only have a max of one asserter. | `extension('http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter').count()+asserter.count()<=1`
SDOH-Con-2 | error | Condition | At least one Condition.category SHALL be encounter-diagnosis, problem-list-item, or health-concern | `category.where(coding.where(system = 'http://terminology.hl7.org/CodeSystem/condition-category' and code='encounter-diagnosis').exists()).exists() or category.where(coding.memberOf('http://hl7.org/fhir/us/core/ValueSet/us-core-problem-or-health-concern')).exists()`
SDOH-Con-3 | error | Condition | At least one Condition.category SHALL be sdoh | `category.where(coding.where(system = 'http://hl7.org/fhir/us/core/CodeSystem/us-core-category' and code='sdoh').exists()).exists()`
con-2 | error | Condition.evidence | evidence SHALL have code or details | `code.exists() or detail.exists()`
con-3 | best practice | Condition | Condition.clinicalStatus SHALL be present if verificationStatus is not entered-in-error and category is problem-list-item | `clinicalStatus.exists() or verificationStatus.coding.where(system='http://terminology.hl7.org/CodeSystem/condition-ver-status' and code = 'entered-in-error').exists() or category.select($this='problem-list-item').empty()`
con-4 | error | Condition | If condition is abated, then clinicalStatus must be either inactive, resolved, or remission | `abatement.empty() or clinicalStatus.coding.where(system='http://terminology.hl7.org/CodeSystem/condition-clinical' and (code='resolved' or code='remission' or code='inactive')).exists()`
con-5 | error | Condition | Condition.clinicalStatus SHALL NOT be present if verification Status is entered-in-error | `verificationStatus.coding.where(system='http://terminology.hl7.org/CodeSystem/condition-ver-status' and code='entered-in-error').empty() or clinicalStatus.empty()`
dom-2 | error | Condition | If the resource is contained in another resource, it SHALL NOT contain nested Resources | `contained.contained.empty()`
dom-3 | error | Condition | 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 | Condition | 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 | Condition | If a resource is contained in another resource, it SHALL NOT have a security label | `contained.meta.security.empty()`
dom-6 | best practice | Condition | 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()`

Summary

Mandatory: 2 elements
Must-Support: 20 elements
Prohibited: 2 elements

Structures

This structure refers to these other structures:

- US Core Patient Profile (http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient|7.0.0)
- US Core Encounter Profile (http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter|7.0.0)
- US Core Practitioner Profile (http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner|7.0.0)
- SDOHCC PractitionerRole (http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-practitionerrole)
- SDOHCC Observation Screening Response (http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ObservationScreeningResponse)
- SDOHCC Condition (http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-Condition)
- SDOHCC Observation Assessment (http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ObservationAssessment)
- SDC Questionnaire Response (http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaireresponse)

Extensions

This structure refers to these extensions:

- http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter
- http://hl7.org/fhir/StructureDefinition/condition-assertedDate|5.2.0

Slices

This structure defines the following Slices:

- The element 1 is sliced based on the value of Condition.category
- The element 1 is sliced based on the value of Condition.evidence.detail

Maturity: 2

Other representations of profile: CSV, Excel, Schematron