SHINNYHRSN - Local Development build (v2.0.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
Resource Profile: SHINNY SDOHCC Condition Profile
| Official URL: http://test.shinny.org/us/ny/hrsn/StructureDefinition/SHINNY-SDOHCC-Condition | Version: 2.0.0 | |||
| Active as of 2026-08-20 | Computable Name: SHINNYSDOHCCCondition | |||
- SHINNY HRSN: Needed for Assessments. Include in Assessment bundles.
- Profiled off of the SDOHCC Condition: Profile for Social Determinants of Health (SDOH) conditions.
Usages:
- Refer to this Profile: SHINNY Encounter Profile
- Examples for this Profile: Condition/ConditionFoodInsecurityExample and Condition/ConditionFoodInsecurityExampleResolved
You can also check for usages in the FHIR IG Statistics
Formal Views of Profile Content
Description of Profiles, Differentials, Snapshots and how the different presentations work.
| Name | Flags | Card. | Type | Description & Constraints Filter:   |
|---|---|---|---|---|
  Condition |
C | 0..* | SDOHCCCondition | Detailed information about SDOH conditions, problems or diagnoses Constraints: con-3, con-4, con-5, SDOH-Con-1, SDOH-Con-2, SDOH-Con-3, Condition-RecordedDate |
  id |
SΣ | 1..1 | id | The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes. |
  meta |
SΣ | 1..1 | SHINNYMeta | Metadata about the resource |
 lastUpdated |
SΣ | 0..1 | instant | When the resource last changed |
 profile |
SΣ | 1..1 | canonical(StructureDefinition) | Profiles this resource claims to conform to |
| implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created |
| language |
0..1 | code | Language of the resource content Binding: SHINNYLanguageVS (preferred) | |
 Slices for extension |
Content/Rules for all slices | |||
  extension:asserterDevice |
SC | 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 |
SC | 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 |
SC | 1..* | CodeableConcept | USCDI Health Status/Assessments Data Class. Requires at least a category code 'sdoh' Binding: USCoreScreeningAssessmentConditionCategory (7.0.0) (required) |
| category:SDOHCC |
S | 1..* | 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 |
 subject |
SΣ | 1..1 | Reference(US Core Patient Profile(7.0.0)) | Who has the condition? |
| encounter |
SΣ | 1..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] |
SC | 0..1 | When in resolution/remission | |
| abatementDateTime |
dateTime S | |||
| abatementPeriod |
Period | |||
| recordedDate |
SΣ | 0..1 | dateTime | Date record was first recorded |
| asserter |
SΣC | 1..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 |
SC | 0..* | BackboneElement | Supporting evidence Constraints: con-2 |
 modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
| 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.language | Base | preferred | SHINNYLanguageVS | 📦2.0.0 | This IG |
| 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 | 📦2.3.0 | SDOH Clinical Care v2.3 |
| Condition.code | Base | required | US Core Condition Codes | 📍7.0.0 | US Core v7.0 |
Constraints
| Id | Grade | Path(s) | Description | Expression |
| Condition-RecordedDate | error | Condition | Ensure that all conditions have a recordedDate. |
recordedDate.exists()
|
| 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()
|
This structure is derived from SDOHCCCondition
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| Condition |
C | 0..* | SDOHCCCondition | Detailed information about SDOH conditions, problems or diagnoses Constraints: Condition-RecordedDate |
 id |
S | 1..1 | id | The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes. |
| meta |
1..1 | SHINNYMeta | Metadata about the resource | |
| profile |
S | 1..1 | canonical(StructureDefinition) | Profiles this resource claims to conform to |
| language |
0..1 | code | Language of the resource content Binding: SHINNYLanguageVS (preferred) | |
| Slices for category |
Content/Rules for all slices | |||
| category:SDOHCC |
1..* | CodeableConcept | e.g., food-insecurity | transportation-insecurity | |
| encounter |
1..1 | Reference(US Core Encounter Profile(7.0.0)) | Encounter created as part of | |
| asserter |
1..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 | |
| Documentation for this format | ||||
Terminology Bindings (Differential)
| Path | Status | Usage | ValueSet | Version | Source |
| Condition.language | Base | preferred | SHINNYLanguageVS | 📦2.0.0 | This IG |
Constraints
| Id | Grade | Path(s) | Description | Expression |
| Condition-RecordedDate | error | Condition | Ensure that all conditions have a recordedDate. |
recordedDate.exists()
|
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| Condition |
C | 0..* | SDOHCCCondition | Detailed information about SDOH conditions, problems or diagnoses Constraints: con-3, con-4, con-5, SDOH-Con-1, SDOH-Con-2, SDOH-Con-3, Condition-RecordedDate |
| id |
SΣ | 1..1 | id | The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes. |
| meta |
SΣ | 1..1 | SHINNYMeta | 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 |
SΣ | 1..1 | 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: SHINNYLanguageVS (preferred) | |
| 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 |
SC | 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 |
SC | 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 |
SC | 1..* | CodeableConcept | USCDI Health Status/Assessments Data Class. Requires at least a category code 'sdoh' Binding: USCoreScreeningAssessmentConditionCategory (7.0.0) (required) |
| category:SDOHCC |
S | 1..* | 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 |
| subject |
SΣ | 1..1 | Reference(US Core Patient Profile(7.0.0)) | Who has the condition? |
| encounter |
SΣ | 1..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] |
SC | 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 | 1..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 |
SC | 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 | SHINNYLanguageVS | 📦2.0.0 | This IG |
| 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 | 📦2.3.0 | SDOH Clinical Care v2.3 |
| 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 |
| Condition-RecordedDate | error | Condition | Ensure that all conditions have a recordedDate. |
recordedDate.exists()
|
| 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()
|
This structure is derived from SDOHCCCondition
Key Elements View
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| Condition |
C | 0..* | SDOHCCCondition | Detailed information about SDOH conditions, problems or diagnoses Constraints: con-3, con-4, con-5, SDOH-Con-1, SDOH-Con-2, SDOH-Con-3, Condition-RecordedDate |
| id |
SΣ | 1..1 | id | The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes. |
| meta |
SΣ | 1..1 | SHINNYMeta | Metadata about the resource |
| lastUpdated |
SΣ | 0..1 | instant | When the resource last changed |
| profile |
SΣ | 1..1 | canonical(StructureDefinition) | Profiles this resource claims to conform to |
| implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created |
| language |
0..1 | code | Language of the resource content Binding: SHINNYLanguageVS (preferred) | |
| Slices for extension |
Content/Rules for all slices | |||
| extension:asserterDevice |
SC | 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 |
SC | 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 |
SC | 1..* | CodeableConcept | USCDI Health Status/Assessments Data Class. Requires at least a category code 'sdoh' Binding: USCoreScreeningAssessmentConditionCategory (7.0.0) (required) |
| category:SDOHCC |
S | 1..* | 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 |
| subject |
SΣ | 1..1 | Reference(US Core Patient Profile(7.0.0)) | Who has the condition? |
| encounter |
SΣ | 1..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] |
SC | 0..1 | When in resolution/remission | |
| abatementDateTime |
dateTime S | |||
| abatementPeriod |
Period | |||
| recordedDate |
SΣ | 0..1 | dateTime | Date record was first recorded |
| asserter |
SΣC | 1..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 |
SC | 0..* | BackboneElement | Supporting evidence Constraints: con-2 |
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
| 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.language | Base | preferred | SHINNYLanguageVS | 📦2.0.0 | This IG |
| 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 | 📦2.3.0 | SDOH Clinical Care v2.3 |
| Condition.code | Base | required | US Core Condition Codes | 📍7.0.0 | US Core v7.0 |
Constraints
| Id | Grade | Path(s) | Description | Expression |
| Condition-RecordedDate | error | Condition | Ensure that all conditions have a recordedDate. |
recordedDate.exists()
|
| 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
This structure is derived from SDOHCCCondition
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| Condition |
C | 0..* | SDOHCCCondition | Detailed information about SDOH conditions, problems or diagnoses Constraints: Condition-RecordedDate |
| id |
S | 1..1 | id | The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes. |
| meta |
1..1 | SHINNYMeta | Metadata about the resource | |
| profile |
S | 1..1 | canonical(StructureDefinition) | Profiles this resource claims to conform to |
| language |
0..1 | code | Language of the resource content Binding: SHINNYLanguageVS (preferred) | |
| Slices for category |
Content/Rules for all slices | |||
| category:SDOHCC |
1..* | CodeableConcept | e.g., food-insecurity | transportation-insecurity | |
| encounter |
1..1 | Reference(US Core Encounter Profile(7.0.0)) | Encounter created as part of | |
| asserter |
1..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 | |
| Documentation for this format | ||||
Terminology Bindings (Differential)
| Path | Status | Usage | ValueSet | Version | Source |
| Condition.language | Base | preferred | SHINNYLanguageVS | 📦2.0.0 | This IG |
Constraints
| Id | Grade | Path(s) | Description | Expression |
| Condition-RecordedDate | error | Condition | Ensure that all conditions have a recordedDate. |
recordedDate.exists()
|
Snapshot View
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| Condition |
C | 0..* | SDOHCCCondition | Detailed information about SDOH conditions, problems or diagnoses Constraints: con-3, con-4, con-5, SDOH-Con-1, SDOH-Con-2, SDOH-Con-3, Condition-RecordedDate |
| id |
SΣ | 1..1 | id | The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes. |
| meta |
SΣ | 1..1 | SHINNYMeta | 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 |
SΣ | 1..1 | 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: SHINNYLanguageVS (preferred) | |
| 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 |
SC | 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 |
SC | 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 |
SC | 1..* | CodeableConcept | USCDI Health Status/Assessments Data Class. Requires at least a category code 'sdoh' Binding: USCoreScreeningAssessmentConditionCategory (7.0.0) (required) |
| category:SDOHCC |
S | 1..* | 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 |
| subject |
SΣ | 1..1 | Reference(US Core Patient Profile(7.0.0)) | Who has the condition? |
| encounter |
SΣ | 1..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] |
SC | 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 | 1..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 |
SC | 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 | SHINNYLanguageVS | 📦2.0.0 | This IG |
| 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 | 📦2.3.0 | SDOH Clinical Care v2.3 |
| 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 |
| Condition-RecordedDate | error | Condition | Ensure that all conditions have a recordedDate. |
recordedDate.exists()
|
| 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()
|
This structure is derived from SDOHCCCondition
Other representations of profile: CSV, Excel, Schematron