This page is part of the SDOH Clinical Care for Multiple Domains (v2.3.0: STU 2.3) based on FHIR (HL7® FHIR® Standard) R4. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions
| Official URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-Condition | Version: 2.3.0 | |||
| Standards status: Trial-use | Maturity Level: 2 | Computable Name: SDOHCCCondition | ||
Profile for Social Determinants of Health (SDOH) conditions.
SDOHCC Condition is generally intended to represent a health concern, problem, or diagnosis related to a social risk or need. 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.
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 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.
Usage:
Description of Profiles, Differentials, Snapshots and how the different presentations work.
| Name | Flags | Card. | Type | Description & Constraints![]() |
|---|---|---|---|---|
![]() |
C | 0..* | Condition | Detailed information about SDOH conditions, problems or diagnoses con-3: Condition.clinicalStatus SHALL be present if verificationStatus is not entered-in-error and category is problem-list-item con-4: If condition is abated, then clinicalStatus must be either inactive, resolved, or remission con-5: Condition.clinicalStatus SHALL NOT be present if verification Status is entered-in-error dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources dom-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated dom-5: If a resource is contained in another resource, it SHALL NOT have a security label dom-6: A resource should have narrative for robust management SDOH-Con-1: Can only have a max of one asserter. SDOH-Con-2: At least one Condition.category SHALL be encounter-diagnosis, problem-list-item, or health-concern SDOH-Con-3: At least one Condition.category SHALL be sdoh |
![]() ![]() |
SΣ | 0..1 | Meta | Metadata about the resource ele-1: All FHIR elements must have a @value or children |
![]() ![]() ![]() |
SΣ | 0..1 | instant | When the resource last changed ele-1: All FHIR elements must have a @value or children |
![]() ![]() |
?!Σ | 0..1 | uri | A set of rules under which this content was created ele-1: All FHIR elements must have a @value or children |
![]() ![]() |
0..* | Extension | Extension Slice: Unordered, Open by value:url ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both | |
![]() ![]() ![]() |
SC | 0..1 | Reference(Device) | Optional Extensions Element URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both |
![]() ![]() ![]() |
S | 0..1 | dateTime | Date the condition was first asserted URL: http://hl7.org/fhir/StructureDefinition/condition-assertedDate ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both |
![]() ![]() |
?! | 0..* | Extension | Extensions that cannot be ignored ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both |
![]() ![]() |
?!SΣC | 0..1 | CodeableConcept | active | recurrence | relapse | inactive | remission | resolved Binding: ConditionClinicalStatusCodes (required) ele-1: All FHIR elements must have a @value or children |
![]() ![]() |
?!SΣC | 0..1 | CodeableConcept | unconfirmed | provisional | differential | confirmed | refuted | entered-in-error Binding: ConditionVerificationStatus (required) ele-1: All FHIR elements must have a @value or children |
![]() ![]() |
SC | 2..* | CodeableConcept | category codes Slice: Unordered, Open by value:$this Binding: ConditionCategoryCodes (extensible): A category assigned to the condition. ele-1: All FHIR elements must have a @value or children |
![]() ![]() ![]() |
S | 0..1 | CodeableConcept | encounter-diagnosis Binding: ConditionCategoryCodes (extensible): A category assigned to the condition. ele-1: All FHIR elements must have a @value or children Required Pattern: At least the following |
![]() ![]() ![]() ![]() |
1..* | Coding | Code defined by a terminology system Fixed Value: (complex) | |
![]() ![]() ![]() ![]() ![]() |
1..1 | uri | Identity of the terminology system Fixed Value: http://terminology.hl7.org/CodeSystem/condition-category | |
![]() ![]() ![]() ![]() ![]() |
1..1 | code | Symbol in syntax defined by the system Fixed Value: encounter-diagnosis | |
![]() ![]() ![]() |
S | 0..* | CodeableConcept | problem-list-item | health-concern Binding: USCoreProblemOrHealthConcern (7.0.0) (required) ele-1: All FHIR elements must have a @value or children |
![]() ![]() ![]() |
SC | 1..* | CodeableConcept | USCDI Health Status/Assessments Data Class. Requires at least a category code 'sdoh' Binding: USCoreScreeningAssessmentConditionCategory (7.0.0) (required) ele-1: All FHIR elements must have a @value or children |
![]() ![]() ![]() |
S | 0..* | CodeableConcept | e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories. ele-1: All FHIR elements must have a @value or children |
![]() ![]() |
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 ele-1: All FHIR elements must have a @value or children |
![]() ![]() |
SΣ | 1..1 | Reference(US Core Patient Profile(7.0.0)) | Who has the condition? ele-1: All FHIR elements must have a @value or children |
![]() ![]() |
SΣ | 0..1 | Reference(US Core Encounter Profile(7.0.0)) | Encounter created as part of ele-1: All FHIR elements must have a @value or children |
![]() ![]() |
SΣ | 0..1 | Estimated or actual date, date-time, or age ele-1: All FHIR elements must have a @value or children | |
![]() ![]() ![]() |
dateTime | |||
![]() ![]() |
SC | 0..1 | When in resolution/remission ele-1: All FHIR elements must have a @value or children | |
![]() ![]() ![]() |
dateTime | |||
![]() ![]() |
SΣ | 0..1 | dateTime | Date record was first recorded ele-1: All FHIR elements must have a @value or children |
![]() ![]() |
Σ | 0..1 | Reference(Practitioner | PractitionerRole) | Who recorded the condition ele-1: All FHIR elements must have a @value or children |
![]() ![]() |
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 ele-1: All FHIR elements must have a @value or children |
![]() ![]() |
SC | 0..* | BackboneElement | Supporting evidence con-2: evidence SHALL have code or details ele-1: All FHIR elements must have a @value or children |
![]() ![]() ![]() |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both |
![]() ![]() ![]() |
ΣC | 0..* | CodeableConcept | Manifestation/symptom Binding: ManifestationAndSymptomCodes (example): Codes that describe the manifestation or symptoms of a condition. ele-1: All FHIR elements must have a @value or children |
![]() ![]() ![]() |
ΣC | 0..* | Reference(Resource) | Supporting information found elsewhere Slice: Unordered, Open by profile:resolve() ele-1: All FHIR elements must have a @value or children |
![]() ![]() ![]() ![]() |
SΣC | 0..* | Reference(SDOHCC Observation Screening Response | SDOHCC Condition | SDOHCC Observation Assessment | SDC Questionnaire Response) | Supporting information found elsewhere ele-1: All FHIR elements must have a @value or children |
Documentation for this format | ||||
| Path | Conformance | ValueSet / Code | URI |
| Condition.clinicalStatus | required | ConditionClinicalStatusCodeshttp://hl7.org/fhir/ValueSet/condition-clinicalfrom the FHIR Standard | |
| Condition.verificationStatus | required | ConditionVerificationStatushttp://hl7.org/fhir/ValueSet/condition-ver-statusfrom the FHIR Standard | |
| Condition.category | extensible | ConditionCategoryCodeshttp://hl7.org/fhir/ValueSet/condition-categoryfrom the FHIR Standard | |
| Condition.category:encounter-diagnosis | extensible | Pattern: encounter-diagnosishttp://hl7.org/fhir/ValueSet/condition-categoryfrom the FHIR Standard | |
| Condition.category:problem-or-health-concern | required | USCoreProblemOrHealthConcernhttp://hl7.org/fhir/us/core/ValueSet/us-core-problem-or-health-concern|7.0.0 | |
| Condition.category:screening-assessment | required | USCoreScreeningAssessmentConditionCategoryhttp://hl7.org/fhir/us/core/ValueSet/us-core-screening-assessment-condition-category|7.0.0 | |
| Condition.category:SDOHCC | required | SDOHCCValueSetSDOHCategoryhttp://hl7.org/fhir/us/sdoh-clinicalcare/ValueSet/SDOHCC-ValueSetSDOHCategoryfrom this IG | |
| Condition.code | required | USCoreConditionCodeshttp://hl7.org/fhir/us/core/ValueSet/us-core-condition-code|7.0.0 | |
| Condition.evidence.code | example | ManifestationAndSymptomCodeshttp://hl7.org/fhir/ValueSet/manifestation-or-symptomfrom the FHIR Standard |
| Id | Grade | Path(s) | Details | Requirements |
| 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 Condition
| Name | Flags | Card. | Type | Description & Constraints![]() |
|---|---|---|---|---|
![]() |
C | 0..* | Condition | Detailed information about SDOH conditions, problems or diagnoses SDOH-Con-1: Can only have a max of one asserter. SDOH-Con-2: At least one Condition.category SHALL be encounter-diagnosis, problem-list-item, or health-concern SDOH-Con-3: At least one Condition.category SHALL be sdoh |
![]() ![]() |
S | 0..1 | Meta | Metadata about the resource |
![]() ![]() ![]() |
S | 0..1 | instant | When the resource last changed |
![]() ![]() |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |
![]() ![]() ![]() |
SC | 0..1 | Reference(Device) | Optional Extensions Element URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter |
![]() ![]() ![]() |
S | 0..1 | dateTime | Date the condition was first asserted URL: http://hl7.org/fhir/StructureDefinition/condition-assertedDate |
![]() ![]() |
S | 0..1 | CodeableConcept | active | recurrence | relapse | inactive | remission | resolved Binding: ConditionClinicalStatusCodes (required) |
![]() ![]() |
S | 0..1 | CodeableConcept | unconfirmed | provisional | differential | confirmed | refuted | entered-in-error Binding: ConditionVerificationStatus (required) |
![]() ![]() |
SC | 2..* | CodeableConcept | category codes Slice: Unordered, Open by value:$this |
![]() ![]() ![]() |
S | 0..1 | CodeableConcept | encounter-diagnosis Required Pattern: At least the following |
![]() ![]() ![]() ![]() |
1..* | Coding | Code defined by a terminology system Fixed Value: (complex) | |
![]() ![]() ![]() ![]() ![]() |
1..1 | uri | Identity of the terminology system Fixed Value: http://terminology.hl7.org/CodeSystem/condition-category | |
![]() ![]() ![]() ![]() ![]() |
1..1 | code | Symbol in syntax defined by the system Fixed Value: encounter-diagnosis | |
![]() ![]() ![]() |
S | 0..* | CodeableConcept | problem-list-item | health-concern Binding: USCoreProblemOrHealthConcern (7.0.0) (required) |
![]() ![]() ![]() |
SC | 1..* | CodeableConcept | USCDI Health Status/Assessments Data Class. Requires at least a category code 'sdoh' Binding: USCoreScreeningAssessmentConditionCategory (7.0.0) (required) |
![]() ![]() ![]() |
S | 0..* | CodeableConcept | e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories. |
![]() ![]() |
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 |
![]() ![]() |
0..0 | |||
![]() ![]() |
S | 1..1 | Reference(US Core Patient Profile(7.0.0)) | Who has the condition? |
![]() ![]() |
S | 0..1 | Reference(US Core Encounter Profile(7.0.0)) | Encounter created as part of |
![]() ![]() |
S | 0..1 | Estimated or actual date, date-time, or age | |
![]() ![]() ![]() |
dateTime S | |||
![]() ![]() ![]() |
Period | |||
![]() ![]() |
S | 0..1 | When in resolution/remission | |
![]() ![]() ![]() |
dateTime S | |||
![]() ![]() ![]() |
Period | |||
![]() ![]() |
S | 0..1 | dateTime | Date record was first recorded |
![]() ![]() |
0..1 | Reference(Practitioner | PractitionerRole) | Who recorded the condition | |
![]() ![]() |
SC | 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 |
![]() ![]() |
0..0 | |||
![]() ![]() |
S | 0..* | BackboneElement | Supporting evidence |
![]() ![]() ![]() |
0..* | CodeableConcept | Manifestation/symptom | |
![]() ![]() ![]() |
0..* | Reference(Resource) | Supporting information found elsewhere Slice: Unordered, Open by profile:resolve() | |
![]() ![]() ![]() ![]() |
S | 0..* | Reference(SDOHCC Observation Screening Response | SDOHCC Condition | SDOHCC Observation Assessment | SDC Questionnaire Response) | Supporting information found elsewhere |
Documentation for this format | ||||
| Path | Conformance | ValueSet | URI |
| Condition.clinicalStatus | required | ConditionClinicalStatusCodeshttp://hl7.org/fhir/ValueSet/condition-clinicalfrom the FHIR Standard | |
| Condition.verificationStatus | required | ConditionVerificationStatushttp://hl7.org/fhir/ValueSet/condition-ver-statusfrom the FHIR Standard | |
| Condition.category:problem-or-health-concern | required | USCoreProblemOrHealthConcernhttp://hl7.org/fhir/us/core/ValueSet/us-core-problem-or-health-concern|7.0.0 | |
| Condition.category:screening-assessment | required | USCoreScreeningAssessmentConditionCategoryhttp://hl7.org/fhir/us/core/ValueSet/us-core-screening-assessment-condition-category|7.0.0 | |
| Condition.category:SDOHCC | required | SDOHCCValueSetSDOHCategoryhttp://hl7.org/fhir/us/sdoh-clinicalcare/ValueSet/SDOHCC-ValueSetSDOHCategoryfrom this IG | |
| Condition.code | required | USCoreConditionCodeshttp://hl7.org/fhir/us/core/ValueSet/us-core-condition-code|7.0.0 |
| Id | Grade | Path(s) | Details | Requirements |
| 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![]() | ||||
|---|---|---|---|---|---|---|---|---|
![]() |
C | 0..* | Condition | Detailed information about SDOH conditions, problems or diagnoses con-3: Condition.clinicalStatus SHALL be present if verificationStatus is not entered-in-error and category is problem-list-item con-4: If condition is abated, then clinicalStatus must be either inactive, resolved, or remission con-5: Condition.clinicalStatus SHALL NOT be present if verification Status is entered-in-error SDOH-Con-1: Can only have a max of one asserter. SDOH-Con-2: At least one Condition.category SHALL be encounter-diagnosis, problem-list-item, or health-concern SDOH-Con-3: At least one Condition.category SHALL be sdoh | ||||
![]() ![]() |
Σ | 0..1 | id | Logical id of this artifact | ||||
![]() ![]() |
SΣ | 0..1 | Meta | Metadata about the resource | ||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
![]() ![]() ![]() |
Σ | 0..1 | id | Version specific identifier | ||||
![]() ![]() ![]() |
SΣ | 0..1 | instant | When the resource last changed | ||||
![]() ![]() ![]() |
Σ | 0..1 | uri | Identifies where the resource comes from | ||||
![]() ![]() ![]() |
Σ | 0..* | canonical(StructureDefinition) | Profiles this resource claims to conform to | ||||
![]() ![]() ![]() |
Σ | 0..* | Coding | Security Labels applied to this resource Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System. | ||||
![]() ![]() ![]() |
Σ | 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". | ||||
![]() ![]() |
?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||
![]() ![]() |
0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||
![]() ![]() |
0..1 | Narrative | Text summary of the resource, for human interpretation | |||||
![]() ![]() |
0..* | Resource | Contained, inline Resources | |||||
![]() ![]() |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||
![]() ![]() ![]() |
SC | 0..1 | Reference(Device) | Optional Extensions Element URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter | ||||
![]() ![]() ![]() |
S | 0..1 | dateTime | Date the condition was first asserted URL: http://hl7.org/fhir/StructureDefinition/condition-assertedDate | ||||
![]() ![]() |
?! | 0..* | Extension | Extensions that cannot be ignored | ||||
![]() ![]() |
Σ | 0..* | Identifier | External Ids for this condition | ||||
![]() ![]() |
?!SΣC | 0..1 | CodeableConcept | active | recurrence | relapse | inactive | remission | resolved Binding: ConditionClinicalStatusCodes (required) | ||||
![]() ![]() |
?!SΣC | 0..1 | CodeableConcept | unconfirmed | provisional | differential | confirmed | refuted | entered-in-error Binding: ConditionVerificationStatus (required) | ||||
![]() ![]() |
SC | 2..* | CodeableConcept | category codes Slice: Unordered, Open by value:$this Binding: ConditionCategoryCodes (extensible): A category assigned to the condition. | ||||
![]() ![]() ![]() |
S | 0..1 | CodeableConcept | encounter-diagnosis Binding: ConditionCategoryCodes (extensible): A category assigned to the condition. Required Pattern: At least the following | ||||
![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||
![]() ![]() ![]() ![]() |
1..* | Coding | Code defined by a terminology system Fixed Value: (complex) | |||||
![]() ![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||
![]() ![]() ![]() ![]() ![]() |
1..1 | uri | Identity of the terminology system Fixed Value: http://terminology.hl7.org/CodeSystem/condition-category | |||||
![]() ![]() ![]() ![]() ![]() |
0..1 | string | Version of the system - if relevant | |||||
![]() ![]() ![]() ![]() ![]() |
1..1 | code | Symbol in syntax defined by the system Fixed Value: encounter-diagnosis | |||||
![]() ![]() ![]() ![]() ![]() |
0..1 | string | Representation defined by the system | |||||
![]() ![]() ![]() ![]() ![]() |
0..1 | boolean | If this coding was chosen directly by the user | |||||
![]() ![]() ![]() ![]() |
0..1 | string | Plain text representation of the concept | |||||
![]() ![]() ![]() |
S | 0..* | CodeableConcept | problem-list-item | health-concern Binding: USCoreProblemOrHealthConcern (7.0.0) (required) | ||||
![]() ![]() ![]() |
SC | 1..* | CodeableConcept | USCDI Health Status/Assessments Data Class. Requires at least a category code 'sdoh' Binding: USCoreScreeningAssessmentConditionCategory (7.0.0) (required) | ||||
![]() ![]() ![]() |
S | 0..* | CodeableConcept | e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories. | ||||
![]() ![]() |
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. | |||||
![]() ![]() |
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 | ||||
![]() ![]() |
SΣ | 1..1 | Reference(US Core Patient Profile(7.0.0)) | Who has the condition? | ||||
![]() ![]() |
SΣ | 0..1 | Reference(US Core Encounter Profile(7.0.0)) | Encounter created as part of | ||||
![]() ![]() |
SΣ | 0..1 | Estimated or actual date, date-time, or age | |||||
![]() ![]() ![]() |
dateTime S | |||||||
![]() ![]() ![]() |
Period | |||||||
![]() ![]() |
SC | 0..1 | When in resolution/remission | |||||
![]() ![]() ![]() |
dateTime S | |||||||
![]() ![]() ![]() |
Period | |||||||
![]() ![]() |
SΣ | 0..1 | dateTime | Date record was first recorded | ||||
![]() ![]() |
Σ | 0..1 | Reference(Practitioner | PractitionerRole) | Who recorded the condition | ||||
![]() ![]() |
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 | ||||
![]() ![]() |
SC | 0..* | BackboneElement | Supporting evidence con-2: evidence SHALL have code or details | ||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||
![]() ![]() ![]() |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
![]() ![]() ![]() |
ΣC | 0..* | CodeableConcept | Manifestation/symptom Binding: ManifestationAndSymptomCodes (example): Codes that describe the manifestation or symptoms of a condition. | ||||
![]() ![]() ![]() |
ΣC | 0..* | Reference(Resource) | Supporting information found elsewhere Slice: Unordered, Open by profile:resolve() | ||||
![]() ![]() ![]() ![]() |
SΣC | 0..* | Reference(SDOHCC Observation Screening Response | SDOHCC Condition | SDOHCC Observation Assessment | SDC Questionnaire Response) | Supporting information found elsewhere | ||||
![]() ![]() |
0..* | Annotation | Additional information about the Condition | |||||
Documentation for this format | ||||||||
| Path | Conformance | ValueSet / Code | URI | |||
| Condition.meta.security | extensible | All Security Labelshttp://hl7.org/fhir/ValueSet/security-labelsfrom the FHIR Standard | ||||
| Condition.meta.tag | example | CommonTagshttp://hl7.org/fhir/ValueSet/common-tagsfrom the FHIR Standard | ||||
| Condition.language | preferred | CommonLanguageshttp://hl7.org/fhir/ValueSet/languagesfrom the FHIR Standard
| ||||
| Condition.clinicalStatus | required | ConditionClinicalStatusCodeshttp://hl7.org/fhir/ValueSet/condition-clinicalfrom the FHIR Standard | ||||
| Condition.verificationStatus | required | ConditionVerificationStatushttp://hl7.org/fhir/ValueSet/condition-ver-statusfrom the FHIR Standard | ||||
| Condition.category | extensible | ConditionCategoryCodeshttp://hl7.org/fhir/ValueSet/condition-categoryfrom the FHIR Standard | ||||
| Condition.category:encounter-diagnosis | extensible | Pattern: encounter-diagnosishttp://hl7.org/fhir/ValueSet/condition-categoryfrom the FHIR Standard | ||||
| Condition.category:problem-or-health-concern | required | USCoreProblemOrHealthConcernhttp://hl7.org/fhir/us/core/ValueSet/us-core-problem-or-health-concern|7.0.0 | ||||
| Condition.category:screening-assessment | required | USCoreScreeningAssessmentConditionCategoryhttp://hl7.org/fhir/us/core/ValueSet/us-core-screening-assessment-condition-category|7.0.0 | ||||
| Condition.category:SDOHCC | required | SDOHCCValueSetSDOHCategoryhttp://hl7.org/fhir/us/sdoh-clinicalcare/ValueSet/SDOHCC-ValueSetSDOHCategoryfrom this IG | ||||
| Condition.severity | preferred | Condition/DiagnosisSeverityhttp://hl7.org/fhir/ValueSet/condition-severityfrom the FHIR Standard | ||||
| Condition.code | required | USCoreConditionCodeshttp://hl7.org/fhir/us/core/ValueSet/us-core-condition-code|7.0.0 | ||||
| Condition.stage.summary | example | ConditionStagehttp://hl7.org/fhir/ValueSet/condition-stagefrom the FHIR Standard | ||||
| Condition.stage.type | example | ConditionStageTypehttp://hl7.org/fhir/ValueSet/condition-stage-typefrom the FHIR Standard | ||||
| Condition.evidence.code | example | ManifestationAndSymptomCodeshttp://hl7.org/fhir/ValueSet/manifestation-or-symptomfrom the FHIR Standard |
| Id | Grade | Path(s) | Details | Requirements |
| 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 Condition
Summary
Mandatory: 2 elements
Must-Support: 20 elements
Prohibited: 2 elements
Structures
This structure refers to these other structures:
Extensions
This structure refers to these extensions:
Slices
This structure defines the following Slices:
Maturity: 2
Key Elements View
| Name | Flags | Card. | Type | Description & Constraints![]() |
|---|---|---|---|---|
![]() |
C | 0..* | Condition | Detailed information about SDOH conditions, problems or diagnoses con-3: Condition.clinicalStatus SHALL be present if verificationStatus is not entered-in-error and category is problem-list-item con-4: If condition is abated, then clinicalStatus must be either inactive, resolved, or remission con-5: Condition.clinicalStatus SHALL NOT be present if verification Status is entered-in-error dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources dom-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated dom-5: If a resource is contained in another resource, it SHALL NOT have a security label dom-6: A resource should have narrative for robust management SDOH-Con-1: Can only have a max of one asserter. SDOH-Con-2: At least one Condition.category SHALL be encounter-diagnosis, problem-list-item, or health-concern SDOH-Con-3: At least one Condition.category SHALL be sdoh |
![]() ![]() |
SΣ | 0..1 | Meta | Metadata about the resource ele-1: All FHIR elements must have a @value or children |
![]() ![]() ![]() |
SΣ | 0..1 | instant | When the resource last changed ele-1: All FHIR elements must have a @value or children |
![]() ![]() |
?!Σ | 0..1 | uri | A set of rules under which this content was created ele-1: All FHIR elements must have a @value or children |
![]() ![]() |
0..* | Extension | Extension Slice: Unordered, Open by value:url ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both | |
![]() ![]() ![]() |
SC | 0..1 | Reference(Device) | Optional Extensions Element URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both |
![]() ![]() ![]() |
S | 0..1 | dateTime | Date the condition was first asserted URL: http://hl7.org/fhir/StructureDefinition/condition-assertedDate ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both |
![]() ![]() |
?! | 0..* | Extension | Extensions that cannot be ignored ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both |
![]() ![]() |
?!SΣC | 0..1 | CodeableConcept | active | recurrence | relapse | inactive | remission | resolved Binding: ConditionClinicalStatusCodes (required) ele-1: All FHIR elements must have a @value or children |
![]() ![]() |
?!SΣC | 0..1 | CodeableConcept | unconfirmed | provisional | differential | confirmed | refuted | entered-in-error Binding: ConditionVerificationStatus (required) ele-1: All FHIR elements must have a @value or children |
![]() ![]() |
SC | 2..* | CodeableConcept | category codes Slice: Unordered, Open by value:$this Binding: ConditionCategoryCodes (extensible): A category assigned to the condition. ele-1: All FHIR elements must have a @value or children |
![]() ![]() ![]() |
S | 0..1 | CodeableConcept | encounter-diagnosis Binding: ConditionCategoryCodes (extensible): A category assigned to the condition. ele-1: All FHIR elements must have a @value or children Required Pattern: At least the following |
![]() ![]() ![]() ![]() |
1..* | Coding | Code defined by a terminology system Fixed Value: (complex) | |
![]() ![]() ![]() ![]() ![]() |
1..1 | uri | Identity of the terminology system Fixed Value: http://terminology.hl7.org/CodeSystem/condition-category | |
![]() ![]() ![]() ![]() ![]() |
1..1 | code | Symbol in syntax defined by the system Fixed Value: encounter-diagnosis | |
![]() ![]() ![]() |
S | 0..* | CodeableConcept | problem-list-item | health-concern Binding: USCoreProblemOrHealthConcern (7.0.0) (required) ele-1: All FHIR elements must have a @value or children |
![]() ![]() ![]() |
SC | 1..* | CodeableConcept | USCDI Health Status/Assessments Data Class. Requires at least a category code 'sdoh' Binding: USCoreScreeningAssessmentConditionCategory (7.0.0) (required) ele-1: All FHIR elements must have a @value or children |
![]() ![]() ![]() |
S | 0..* | CodeableConcept | e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories. ele-1: All FHIR elements must have a @value or children |
![]() ![]() |
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 ele-1: All FHIR elements must have a @value or children |
![]() ![]() |
SΣ | 1..1 | Reference(US Core Patient Profile(7.0.0)) | Who has the condition? ele-1: All FHIR elements must have a @value or children |
![]() ![]() |
SΣ | 0..1 | Reference(US Core Encounter Profile(7.0.0)) | Encounter created as part of ele-1: All FHIR elements must have a @value or children |
![]() ![]() |
SΣ | 0..1 | Estimated or actual date, date-time, or age ele-1: All FHIR elements must have a @value or children | |
![]() ![]() ![]() |
dateTime | |||
![]() ![]() |
SC | 0..1 | When in resolution/remission ele-1: All FHIR elements must have a @value or children | |
![]() ![]() ![]() |
dateTime | |||
![]() ![]() |
SΣ | 0..1 | dateTime | Date record was first recorded ele-1: All FHIR elements must have a @value or children |
![]() ![]() |
Σ | 0..1 | Reference(Practitioner | PractitionerRole) | Who recorded the condition ele-1: All FHIR elements must have a @value or children |
![]() ![]() |
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 ele-1: All FHIR elements must have a @value or children |
![]() ![]() |
SC | 0..* | BackboneElement | Supporting evidence con-2: evidence SHALL have code or details ele-1: All FHIR elements must have a @value or children |
![]() ![]() ![]() |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both |
![]() ![]() ![]() |
ΣC | 0..* | CodeableConcept | Manifestation/symptom Binding: ManifestationAndSymptomCodes (example): Codes that describe the manifestation or symptoms of a condition. ele-1: All FHIR elements must have a @value or children |
![]() ![]() ![]() |
ΣC | 0..* | Reference(Resource) | Supporting information found elsewhere Slice: Unordered, Open by profile:resolve() ele-1: All FHIR elements must have a @value or children |
![]() ![]() ![]() ![]() |
SΣC | 0..* | Reference(SDOHCC Observation Screening Response | SDOHCC Condition | SDOHCC Observation Assessment | SDC Questionnaire Response) | Supporting information found elsewhere ele-1: All FHIR elements must have a @value or children |
Documentation for this format | ||||
| Path | Conformance | ValueSet / Code | URI |
| Condition.clinicalStatus | required | ConditionClinicalStatusCodeshttp://hl7.org/fhir/ValueSet/condition-clinicalfrom the FHIR Standard | |
| Condition.verificationStatus | required | ConditionVerificationStatushttp://hl7.org/fhir/ValueSet/condition-ver-statusfrom the FHIR Standard | |
| Condition.category | extensible | ConditionCategoryCodeshttp://hl7.org/fhir/ValueSet/condition-categoryfrom the FHIR Standard | |
| Condition.category:encounter-diagnosis | extensible | Pattern: encounter-diagnosishttp://hl7.org/fhir/ValueSet/condition-categoryfrom the FHIR Standard | |
| Condition.category:problem-or-health-concern | required | USCoreProblemOrHealthConcernhttp://hl7.org/fhir/us/core/ValueSet/us-core-problem-or-health-concern|7.0.0 | |
| Condition.category:screening-assessment | required | USCoreScreeningAssessmentConditionCategoryhttp://hl7.org/fhir/us/core/ValueSet/us-core-screening-assessment-condition-category|7.0.0 | |
| Condition.category:SDOHCC | required | SDOHCCValueSetSDOHCategoryhttp://hl7.org/fhir/us/sdoh-clinicalcare/ValueSet/SDOHCC-ValueSetSDOHCategoryfrom this IG | |
| Condition.code | required | USCoreConditionCodeshttp://hl7.org/fhir/us/core/ValueSet/us-core-condition-code|7.0.0 | |
| Condition.evidence.code | example | ManifestationAndSymptomCodeshttp://hl7.org/fhir/ValueSet/manifestation-or-symptomfrom the FHIR Standard |
| Id | Grade | Path(s) | Details | Requirements |
| 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 Condition
| Name | Flags | Card. | Type | Description & Constraints![]() |
|---|---|---|---|---|
![]() |
C | 0..* | Condition | Detailed information about SDOH conditions, problems or diagnoses SDOH-Con-1: Can only have a max of one asserter. SDOH-Con-2: At least one Condition.category SHALL be encounter-diagnosis, problem-list-item, or health-concern SDOH-Con-3: At least one Condition.category SHALL be sdoh |
![]() ![]() |
S | 0..1 | Meta | Metadata about the resource |
![]() ![]() ![]() |
S | 0..1 | instant | When the resource last changed |
![]() ![]() |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |
![]() ![]() ![]() |
SC | 0..1 | Reference(Device) | Optional Extensions Element URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter |
![]() ![]() ![]() |
S | 0..1 | dateTime | Date the condition was first asserted URL: http://hl7.org/fhir/StructureDefinition/condition-assertedDate |
![]() ![]() |
S | 0..1 | CodeableConcept | active | recurrence | relapse | inactive | remission | resolved Binding: ConditionClinicalStatusCodes (required) |
![]() ![]() |
S | 0..1 | CodeableConcept | unconfirmed | provisional | differential | confirmed | refuted | entered-in-error Binding: ConditionVerificationStatus (required) |
![]() ![]() |
SC | 2..* | CodeableConcept | category codes Slice: Unordered, Open by value:$this |
![]() ![]() ![]() |
S | 0..1 | CodeableConcept | encounter-diagnosis Required Pattern: At least the following |
![]() ![]() ![]() ![]() |
1..* | Coding | Code defined by a terminology system Fixed Value: (complex) | |
![]() ![]() ![]() ![]() ![]() |
1..1 | uri | Identity of the terminology system Fixed Value: http://terminology.hl7.org/CodeSystem/condition-category | |
![]() ![]() ![]() ![]() ![]() |
1..1 | code | Symbol in syntax defined by the system Fixed Value: encounter-diagnosis | |
![]() ![]() ![]() |
S | 0..* | CodeableConcept | problem-list-item | health-concern Binding: USCoreProblemOrHealthConcern (7.0.0) (required) |
![]() ![]() ![]() |
SC | 1..* | CodeableConcept | USCDI Health Status/Assessments Data Class. Requires at least a category code 'sdoh' Binding: USCoreScreeningAssessmentConditionCategory (7.0.0) (required) |
![]() ![]() ![]() |
S | 0..* | CodeableConcept | e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories. |
![]() ![]() |
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 |
![]() ![]() |
0..0 | |||
![]() ![]() |
S | 1..1 | Reference(US Core Patient Profile(7.0.0)) | Who has the condition? |
![]() ![]() |
S | 0..1 | Reference(US Core Encounter Profile(7.0.0)) | Encounter created as part of |
![]() ![]() |
S | 0..1 | Estimated or actual date, date-time, or age | |
![]() ![]() ![]() |
dateTime S | |||
![]() ![]() ![]() |
Period | |||
![]() ![]() |
S | 0..1 | When in resolution/remission | |
![]() ![]() ![]() |
dateTime S | |||
![]() ![]() ![]() |
Period | |||
![]() ![]() |
S | 0..1 | dateTime | Date record was first recorded |
![]() ![]() |
0..1 | Reference(Practitioner | PractitionerRole) | Who recorded the condition | |
![]() ![]() |
SC | 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 |
![]() ![]() |
0..0 | |||
![]() ![]() |
S | 0..* | BackboneElement | Supporting evidence |
![]() ![]() ![]() |
0..* | CodeableConcept | Manifestation/symptom | |
![]() ![]() ![]() |
0..* | Reference(Resource) | Supporting information found elsewhere Slice: Unordered, Open by profile:resolve() | |
![]() ![]() ![]() ![]() |
S | 0..* | Reference(SDOHCC Observation Screening Response | SDOHCC Condition | SDOHCC Observation Assessment | SDC Questionnaire Response) | Supporting information found elsewhere |
Documentation for this format | ||||
| Path | Conformance | ValueSet | URI |
| Condition.clinicalStatus | required | ConditionClinicalStatusCodeshttp://hl7.org/fhir/ValueSet/condition-clinicalfrom the FHIR Standard | |
| Condition.verificationStatus | required | ConditionVerificationStatushttp://hl7.org/fhir/ValueSet/condition-ver-statusfrom the FHIR Standard | |
| Condition.category:problem-or-health-concern | required | USCoreProblemOrHealthConcernhttp://hl7.org/fhir/us/core/ValueSet/us-core-problem-or-health-concern|7.0.0 | |
| Condition.category:screening-assessment | required | USCoreScreeningAssessmentConditionCategoryhttp://hl7.org/fhir/us/core/ValueSet/us-core-screening-assessment-condition-category|7.0.0 | |
| Condition.category:SDOHCC | required | SDOHCCValueSetSDOHCategoryhttp://hl7.org/fhir/us/sdoh-clinicalcare/ValueSet/SDOHCC-ValueSetSDOHCategoryfrom this IG | |
| Condition.code | required | USCoreConditionCodeshttp://hl7.org/fhir/us/core/ValueSet/us-core-condition-code|7.0.0 |
| Id | Grade | Path(s) | Details | Requirements |
| 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 View
| Name | Flags | Card. | Type | Description & Constraints![]() | ||||
|---|---|---|---|---|---|---|---|---|
![]() |
C | 0..* | Condition | Detailed information about SDOH conditions, problems or diagnoses con-3: Condition.clinicalStatus SHALL be present if verificationStatus is not entered-in-error and category is problem-list-item con-4: If condition is abated, then clinicalStatus must be either inactive, resolved, or remission con-5: Condition.clinicalStatus SHALL NOT be present if verification Status is entered-in-error SDOH-Con-1: Can only have a max of one asserter. SDOH-Con-2: At least one Condition.category SHALL be encounter-diagnosis, problem-list-item, or health-concern SDOH-Con-3: At least one Condition.category SHALL be sdoh | ||||
![]() ![]() |
Σ | 0..1 | id | Logical id of this artifact | ||||
![]() ![]() |
SΣ | 0..1 | Meta | Metadata about the resource | ||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
![]() ![]() ![]() |
Σ | 0..1 | id | Version specific identifier | ||||
![]() ![]() ![]() |
SΣ | 0..1 | instant | When the resource last changed | ||||
![]() ![]() ![]() |
Σ | 0..1 | uri | Identifies where the resource comes from | ||||
![]() ![]() ![]() |
Σ | 0..* | canonical(StructureDefinition) | Profiles this resource claims to conform to | ||||
![]() ![]() ![]() |
Σ | 0..* | Coding | Security Labels applied to this resource Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System. | ||||
![]() ![]() ![]() |
Σ | 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". | ||||
![]() ![]() |
?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||
![]() ![]() |
0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||
![]() ![]() |
0..1 | Narrative | Text summary of the resource, for human interpretation | |||||
![]() ![]() |
0..* | Resource | Contained, inline Resources | |||||
![]() ![]() |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||
![]() ![]() ![]() |
SC | 0..1 | Reference(Device) | Optional Extensions Element URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter | ||||
![]() ![]() ![]() |
S | 0..1 | dateTime | Date the condition was first asserted URL: http://hl7.org/fhir/StructureDefinition/condition-assertedDate | ||||
![]() ![]() |
?! | 0..* | Extension | Extensions that cannot be ignored | ||||
![]() ![]() |
Σ | 0..* | Identifier | External Ids for this condition | ||||
![]() ![]() |
?!SΣC | 0..1 | CodeableConcept | active | recurrence | relapse | inactive | remission | resolved Binding: ConditionClinicalStatusCodes (required) | ||||
![]() ![]() |
?!SΣC | 0..1 | CodeableConcept | unconfirmed | provisional | differential | confirmed | refuted | entered-in-error Binding: ConditionVerificationStatus (required) | ||||
![]() ![]() |
SC | 2..* | CodeableConcept | category codes Slice: Unordered, Open by value:$this Binding: ConditionCategoryCodes (extensible): A category assigned to the condition. | ||||
![]() ![]() ![]() |
S | 0..1 | CodeableConcept | encounter-diagnosis Binding: ConditionCategoryCodes (extensible): A category assigned to the condition. Required Pattern: At least the following | ||||
![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||
![]() ![]() ![]() ![]() |
1..* | Coding | Code defined by a terminology system Fixed Value: (complex) | |||||
![]() ![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||
![]() ![]() ![]() ![]() ![]() |
1..1 | uri | Identity of the terminology system Fixed Value: http://terminology.hl7.org/CodeSystem/condition-category | |||||
![]() ![]() ![]() ![]() ![]() |
0..1 | string | Version of the system - if relevant | |||||
![]() ![]() ![]() ![]() ![]() |
1..1 | code | Symbol in syntax defined by the system Fixed Value: encounter-diagnosis | |||||
![]() ![]() ![]() ![]() ![]() |
0..1 | string | Representation defined by the system | |||||
![]() ![]() ![]() ![]() ![]() |
0..1 | boolean | If this coding was chosen directly by the user | |||||
![]() ![]() ![]() ![]() |
0..1 | string | Plain text representation of the concept | |||||
![]() ![]() ![]() |
S | 0..* | CodeableConcept | problem-list-item | health-concern Binding: USCoreProblemOrHealthConcern (7.0.0) (required) | ||||
![]() ![]() ![]() |
SC | 1..* | CodeableConcept | USCDI Health Status/Assessments Data Class. Requires at least a category code 'sdoh' Binding: USCoreScreeningAssessmentConditionCategory (7.0.0) (required) | ||||
![]() ![]() ![]() |
S | 0..* | CodeableConcept | e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories. | ||||
![]() ![]() |
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. | |||||
![]() ![]() |
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 | ||||
![]() ![]() |
SΣ | 1..1 | Reference(US Core Patient Profile(7.0.0)) | Who has the condition? | ||||
![]() ![]() |
SΣ | 0..1 | Reference(US Core Encounter Profile(7.0.0)) | Encounter created as part of | ||||
![]() ![]() |
SΣ | 0..1 | Estimated or actual date, date-time, or age | |||||
![]() ![]() ![]() |
dateTime S | |||||||
![]() ![]() ![]() |
Period | |||||||
![]() ![]() |
SC | 0..1 | When in resolution/remission | |||||
![]() ![]() ![]() |
dateTime S | |||||||
![]() ![]() ![]() |
Period | |||||||
![]() ![]() |
SΣ | 0..1 | dateTime | Date record was first recorded | ||||
![]() ![]() |
Σ | 0..1 | Reference(Practitioner | PractitionerRole) | Who recorded the condition | ||||
![]() ![]() |
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 | ||||
![]() ![]() |
SC | 0..* | BackboneElement | Supporting evidence con-2: evidence SHALL have code or details | ||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||
![]() ![]() ![]() |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
![]() ![]() ![]() |
ΣC | 0..* | CodeableConcept | Manifestation/symptom Binding: ManifestationAndSymptomCodes (example): Codes that describe the manifestation or symptoms of a condition. | ||||
![]() ![]() ![]() |
ΣC | 0..* | Reference(Resource) | Supporting information found elsewhere Slice: Unordered, Open by profile:resolve() | ||||
![]() ![]() ![]() ![]() |
SΣC | 0..* | Reference(SDOHCC Observation Screening Response | SDOHCC Condition | SDOHCC Observation Assessment | SDC Questionnaire Response) | Supporting information found elsewhere | ||||
![]() ![]() |
0..* | Annotation | Additional information about the Condition | |||||
Documentation for this format | ||||||||
| Path | Conformance | ValueSet / Code | URI | |||
| Condition.meta.security | extensible | All Security Labelshttp://hl7.org/fhir/ValueSet/security-labelsfrom the FHIR Standard | ||||
| Condition.meta.tag | example | CommonTagshttp://hl7.org/fhir/ValueSet/common-tagsfrom the FHIR Standard | ||||
| Condition.language | preferred | CommonLanguageshttp://hl7.org/fhir/ValueSet/languagesfrom the FHIR Standard
| ||||
| Condition.clinicalStatus | required | ConditionClinicalStatusCodeshttp://hl7.org/fhir/ValueSet/condition-clinicalfrom the FHIR Standard | ||||
| Condition.verificationStatus | required | ConditionVerificationStatushttp://hl7.org/fhir/ValueSet/condition-ver-statusfrom the FHIR Standard | ||||
| Condition.category | extensible | ConditionCategoryCodeshttp://hl7.org/fhir/ValueSet/condition-categoryfrom the FHIR Standard | ||||
| Condition.category:encounter-diagnosis | extensible | Pattern: encounter-diagnosishttp://hl7.org/fhir/ValueSet/condition-categoryfrom the FHIR Standard | ||||
| Condition.category:problem-or-health-concern | required | USCoreProblemOrHealthConcernhttp://hl7.org/fhir/us/core/ValueSet/us-core-problem-or-health-concern|7.0.0 | ||||
| Condition.category:screening-assessment | required | USCoreScreeningAssessmentConditionCategoryhttp://hl7.org/fhir/us/core/ValueSet/us-core-screening-assessment-condition-category|7.0.0 | ||||
| Condition.category:SDOHCC | required | SDOHCCValueSetSDOHCategoryhttp://hl7.org/fhir/us/sdoh-clinicalcare/ValueSet/SDOHCC-ValueSetSDOHCategoryfrom this IG | ||||
| Condition.severity | preferred | Condition/DiagnosisSeverityhttp://hl7.org/fhir/ValueSet/condition-severityfrom the FHIR Standard | ||||
| Condition.code | required | USCoreConditionCodeshttp://hl7.org/fhir/us/core/ValueSet/us-core-condition-code|7.0.0 | ||||
| Condition.stage.summary | example | ConditionStagehttp://hl7.org/fhir/ValueSet/condition-stagefrom the FHIR Standard | ||||
| Condition.stage.type | example | ConditionStageTypehttp://hl7.org/fhir/ValueSet/condition-stage-typefrom the FHIR Standard | ||||
| Condition.evidence.code | example | ManifestationAndSymptomCodeshttp://hl7.org/fhir/ValueSet/manifestation-or-symptomfrom the FHIR Standard |
| Id | Grade | Path(s) | Details | Requirements |
| 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 Condition
Summary
Mandatory: 2 elements
Must-Support: 20 elements
Prohibited: 2 elements
Structures
This structure refers to these other structures:
Extensions
This structure refers to these extensions:
Slices
This structure defines the following Slices:
Maturity: 2
Other representations of profile: CSV, Excel, Schematron