SDOH Clinical Care
2.2.0 - STU 2.2
SDOH Clinical Care
2.2.0 - STU 2.2
SDOH Clinical Care, published by HL7 International / Patient Care. This guide is not an authorized publication; it is the continuous build for version 2.2.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhir-sdoh-clinicalcare/ and changes regularly. See the Directory of published versions
| Official URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-Condition | Version: 2.2.0 | |||
| Standards status: Trial-use | 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 Observations (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. For new SDOH domains where the Gravity terminology development cycle is in progress, domain-specific value sets may not yet be available in VSAC. If a domain-specific value set is not yet available in VSAC, the Additional Binding is the default binding for the profile element. If a domain-specific value set is available in VSAC but does not yet include all standardized codes identified during the domain’s terminology development cycle, the value set’s VSAC “Description” tab will state, “In progress”. Additional information related to Gravity value sets is provided on the Social Risk Terminology Value Sets page on the Gravity Project Confluence site.
Additionally, some SDOH domains may not yet be represented in SDOHCC ValueSet SDOH Category. In this case, Condition.category: sdoh-category-unspecified can be used so that the Condition instance can still be categorized as SDOH-related. If desired, category.text can also be used to further specify the domain. For example, at the time of publication of this IG, “disability-status” is not yet included in SDOHCC ValueSet SDOH Category. In this case, Condition.category: sdoh-category-unspecified can be used along with 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.
Usage:
Description of Profiles, Differentials, Snapshots and how the different presentations work.
This structure is derived from USCoreCondition
| Name | Flags | Card. | Type | Description & Constraints | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
  Condition |
C | 0..* | USCoreCondition | Detailed information about SDOH conditions, problems or diagnoses SDOH-Con-1: Can only have a max of one asserter. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  Slices for extension |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
   asserterDevice |
SC | 0..1 | (Complex) | Optional Extensions Element URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
   value[x] |
0..1 | Reference(Device) | Value of extension | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  verificationStatus |
0..1 | CodeableConcept | unconfirmed | provisional | differential | confirmed | refuted | entered-in-error | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
 Slices for category |
1..* | CodeableConcept | problem-list-item | encounter-diagnosis | health-concern Slice: Unordered, Open by value:$this | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
 category:SDOH |
0..* | CodeableConcept | e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| code |
1..1 | CodeableConcept | Identification of the condition, problem or diagnosis Binding: US Core Condition Code (required): Valueset to describe the actual problem experienced by the patient
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| bodySite |
0..0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| subject |
1..1 | Reference(US Core Patient Profile) | Who has the condition? | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
 onset[x] |
S | 0..1 | Estimated dateTime or Period | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
 onsetDateTime |
dateTime | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  onsetPeriod |
Period | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| abatement[x] |
S | 0..1 | When in resolution/remission | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| abatementDateTime |
dateTime | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| abatementPeriod |
Period | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| recorder |
0..1 | Reference(Practitioner | PractitionerRole) | Who recorded the condition | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| asserter |
SC | 0..1 | Reference(RelatedPerson | US Core Patient Profile | US Core Practitioner Profile | US Core PractitionerRole Profile) | Person or device that asserts this condition | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| stage |
0..0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
 evidence |
S | 0..* | BackboneElement | Supporting evidence | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| code |
0..* | CodeableConcept | Manifestation/symptom | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Slices for detail |
0..* | Reference(Resource) | Supporting information found elsewhere Slice: Unordered, Open by profile:resolve() | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| detail:SupportedDetail |
S | 0..* | Reference(SDOHCC Observation Screening Response | SDOHCC Condition | SDOHCC Observation Assessment | SDC Questionnaire Response) | Supporting information found elsewhere | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Documentation for this format | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Path | Conformance | ValueSet | URI | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Condition.category:SDOH | required | SDOHCCValueSetSDOHCategoryhttp://hl7.org/fhir/us/sdoh-clinicalcare/ValueSet/SDOHCC-ValueSetSDOHCategoryfrom this IG | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Condition.code | required | USCoreConditionCode
http://hl7.org/fhir/us/core/ValueSet/us-core-condition-code |
| 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 |
| Name | Flags | Card. | Type | Description & Constraints | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Condition |
C | 0..* | USCoreCondition | 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 us-core-1: A code in Condition.category SHOULD be from US Core Condition Category Codes value set. SDOH-Con-1: Can only have a max of one asserter. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Slices for extension |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| asserterDevice |
SC | 0..1 | (Complex) | Optional Extensions Element URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
 extension |
0..0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| url |
1..1 | uri | "http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter" | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| value[x] |
0..1 | Reference(Device) | Value of extension | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
 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 | 1..* | CodeableConcept | problem-list-item | encounter-diagnosis | health-concern Slice: Unordered, Open by value:$this Binding: US Core Condition Category Codes (extensible) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| category:SDOH |
SC | 0..* | CodeableConcept | e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| code |
SΣ | 1..1 | CodeableConcept | Identification of the condition, problem or diagnosis Binding: US Core Condition Code (required): Valueset to describe the actual problem experienced by the patient
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| subject |
SΣ | 1..1 | Reference(US Core Patient Profile) | Who has the condition? | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| onset[x] |
SΣ | 0..1 | Estimated dateTime or Period | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| onsetDateTime |
dateTime | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| onsetPeriod |
Period | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| abatement[x] |
SC | 0..1 | When in resolution/remission | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| abatementDateTime |
dateTime | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| abatementPeriod |
Period | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| recorder |
Σ | 0..1 | Reference(Practitioner | PractitionerRole) | Who recorded the condition | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| asserter |
SΣC | 0..1 | Reference(RelatedPerson | US Core Patient Profile | US Core Practitioner Profile | US Core PractitionerRole Profile) | Person or device that asserts this condition | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| evidence |
SC | 0..* | BackboneElement | Supporting evidence con-2: evidence SHALL have code or details | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| code |
ΣC | 0..* | CodeableConcept | Manifestation/symptom Binding: ManifestationAndSymptomCodes (example): Codes that describe the manifestation or symptoms of a condition. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Slices for detail |
ΣC | 0..* | Reference(Resource) | Supporting information found elsewhere Slice: Unordered, Open by profile:resolve() | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| detail:SupportedDetail |
SΣC | 0..* | Reference(SDOHCC Observation Screening Response | SDOHCC Condition | SDOHCC Observation Assessment | SDC Questionnaire Response) | Supporting information found elsewhere | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Documentation for this format | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 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 | extensible | USCoreConditionCategoryCodeshttp://hl7.org/fhir/us/core/ValueSet/us-core-condition-category | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Condition.category:SDOH | required | SDOHCCValueSetSDOHCategoryhttp://hl7.org/fhir/us/sdoh-clinicalcare/ValueSet/SDOHCC-ValueSetSDOHCategoryfrom this IG | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Condition.code | required | USCoreConditionCode
http://hl7.org/fhir/us/core/ValueSet/us-core-condition-code | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 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 | |
| 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() | |
| us-core-1 | best practice | Condition | A code in Condition.category SHOULD be from US Core Condition Category Codes value set. : where(category.memberOf('http://hl7.org/fhir/us/core/ValueSet/us-core-condition-category')).exists() |
| Name | Flags | Card. | Type | Description & Constraints | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Condition |
C | 0..* | USCoreCondition | 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 us-core-1: A code in Condition.category SHOULD be from US Core Condition Category Codes value set. SDOH-Con-1: Can only have a max of one asserter. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| id |
Σ | 0..1 | id | Logical id of this artifact | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| meta |
Σ | 0..1 | Meta | Metadata about the resource | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| language |
0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| text |
0..1 | Narrative | Text summary of the resource, for human interpretation | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| contained |
0..* | Resource | Contained, inline Resources | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Slices for extension |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| asserterDevice |
SC | 0..1 | (Complex) | Optional Extensions Element URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| extension |
0..0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| url |
1..1 | uri | "http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter" | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| value[x] |
0..1 | Reference(Device) | Value of extension | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 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 | 1..* | CodeableConcept | problem-list-item | encounter-diagnosis | health-concern Slice: Unordered, Open by value:$this Binding: US Core Condition Category Codes (extensible) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| category:SDOH |
SC | 0..* | CodeableConcept | e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| severity |
0..1 | CodeableConcept | Subjective severity of condition Binding: Condition/DiagnosisSeverity (preferred): A subjective assessment of the severity of the condition as evaluated by the clinician. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| code |
SΣ | 1..1 | CodeableConcept | Identification of the condition, problem or diagnosis Binding: US Core Condition Code (required): Valueset to describe the actual problem experienced by the patient
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| subject |
SΣ | 1..1 | Reference(US Core Patient Profile) | Who has the condition? | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| encounter |
Σ | 0..1 | Reference(Encounter) | Encounter created as part of | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| onset[x] |
SΣ | 0..1 | Estimated dateTime or Period | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| onsetDateTime |
dateTime | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| onsetPeriod |
Period | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| abatement[x] |
SC | 0..1 | When in resolution/remission | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| abatementDateTime |
dateTime | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| abatementPeriod |
Period | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| recordedDate |
Σ | 0..1 | dateTime | Date record was first recorded | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| recorder |
Σ | 0..1 | Reference(Practitioner | PractitionerRole) | Who recorded the condition | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| asserter |
SΣC | 0..1 | Reference(RelatedPerson | US Core Patient Profile | US Core Practitioner Profile | US Core PractitionerRole Profile) | Person or device that asserts this condition | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| evidence |
SC | 0..* | BackboneElement | Supporting evidence con-2: evidence SHALL have code or details | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 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 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Path | Conformance | ValueSet | URI | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Condition.language | preferred | CommonLanguages
http://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 | USCoreConditionCategoryCodeshttp://hl7.org/fhir/us/core/ValueSet/us-core-condition-category | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Condition.category:SDOH | 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 | USCoreConditionCode
http://hl7.org/fhir/us/core/ValueSet/us-core-condition-code | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 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 | |
| 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() | |
| us-core-1 | best practice | Condition | A code in Condition.category SHOULD be from US Core Condition Category Codes value set. : where(category.memberOf('http://hl7.org/fhir/us/core/ValueSet/us-core-condition-category')).exists() |
This structure is derived from USCoreCondition
Summary
Must-Support: 6 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:
Differential View
This structure is derived from USCoreCondition
| Name | Flags | Card. | Type | Description & Constraints | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Condition |
C | 0..* | USCoreCondition | Detailed information about SDOH conditions, problems or diagnoses SDOH-Con-1: Can only have a max of one asserter. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Slices for extension |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| asserterDevice |
SC | 0..1 | (Complex) | Optional Extensions Element URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| value[x] |
0..1 | Reference(Device) | Value of extension | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| verificationStatus |
0..1 | CodeableConcept | unconfirmed | provisional | differential | confirmed | refuted | entered-in-error | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Slices for category |
1..* | CodeableConcept | problem-list-item | encounter-diagnosis | health-concern Slice: Unordered, Open by value:$this | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| category:SDOH |
0..* | CodeableConcept | e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| code |
1..1 | CodeableConcept | Identification of the condition, problem or diagnosis Binding: US Core Condition Code (required): Valueset to describe the actual problem experienced by the patient
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| bodySite |
0..0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| subject |
1..1 | Reference(US Core Patient Profile) | Who has the condition? | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| onset[x] |
S | 0..1 | Estimated dateTime or Period | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| onsetDateTime |
dateTime | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| onsetPeriod |
Period | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| abatement[x] |
S | 0..1 | When in resolution/remission | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| abatementDateTime |
dateTime | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| abatementPeriod |
Period | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| recorder |
0..1 | Reference(Practitioner | PractitionerRole) | Who recorded the condition | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| asserter |
SC | 0..1 | Reference(RelatedPerson | US Core Patient Profile | US Core Practitioner Profile | US Core PractitionerRole Profile) | Person or device that asserts this condition | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| stage |
0..0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| evidence |
S | 0..* | BackboneElement | Supporting evidence | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| code |
0..* | CodeableConcept | Manifestation/symptom | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Slices for detail |
0..* | Reference(Resource) | Supporting information found elsewhere Slice: Unordered, Open by profile:resolve() | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| detail:SupportedDetail |
S | 0..* | Reference(SDOHCC Observation Screening Response | SDOHCC Condition | SDOHCC Observation Assessment | SDC Questionnaire Response) | Supporting information found elsewhere | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Documentation for this format | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Path | Conformance | ValueSet | URI | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Condition.category:SDOH | required | SDOHCCValueSetSDOHCategoryhttp://hl7.org/fhir/us/sdoh-clinicalcare/ValueSet/SDOHCC-ValueSetSDOHCategoryfrom this IG | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Condition.code | required | USCoreConditionCode
http://hl7.org/fhir/us/core/ValueSet/us-core-condition-code |
| 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 |
Key Elements View
| Name | Flags | Card. | Type | Description & Constraints | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Condition |
C | 0..* | USCoreCondition | 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 us-core-1: A code in Condition.category SHOULD be from US Core Condition Category Codes value set. SDOH-Con-1: Can only have a max of one asserter. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Slices for extension |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| asserterDevice |
SC | 0..1 | (Complex) | Optional Extensions Element URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| extension |
0..0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| url |
1..1 | uri | "http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter" | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| value[x] |
0..1 | Reference(Device) | Value of extension | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 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 | 1..* | CodeableConcept | problem-list-item | encounter-diagnosis | health-concern Slice: Unordered, Open by value:$this Binding: US Core Condition Category Codes (extensible) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| category:SDOH |
SC | 0..* | CodeableConcept | e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| code |
SΣ | 1..1 | CodeableConcept | Identification of the condition, problem or diagnosis Binding: US Core Condition Code (required): Valueset to describe the actual problem experienced by the patient
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| subject |
SΣ | 1..1 | Reference(US Core Patient Profile) | Who has the condition? | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| onset[x] |
SΣ | 0..1 | Estimated dateTime or Period | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| onsetDateTime |
dateTime | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| onsetPeriod |
Period | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| abatement[x] |
SC | 0..1 | When in resolution/remission | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| abatementDateTime |
dateTime | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| abatementPeriod |
Period | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| recorder |
Σ | 0..1 | Reference(Practitioner | PractitionerRole) | Who recorded the condition | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| asserter |
SΣC | 0..1 | Reference(RelatedPerson | US Core Patient Profile | US Core Practitioner Profile | US Core PractitionerRole Profile) | Person or device that asserts this condition | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| evidence |
SC | 0..* | BackboneElement | Supporting evidence con-2: evidence SHALL have code or details | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| code |
ΣC | 0..* | CodeableConcept | Manifestation/symptom Binding: ManifestationAndSymptomCodes (example): Codes that describe the manifestation or symptoms of a condition. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Slices for detail |
ΣC | 0..* | Reference(Resource) | Supporting information found elsewhere Slice: Unordered, Open by profile:resolve() | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| detail:SupportedDetail |
SΣC | 0..* | Reference(SDOHCC Observation Screening Response | SDOHCC Condition | SDOHCC Observation Assessment | SDC Questionnaire Response) | Supporting information found elsewhere | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Documentation for this format | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 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 | extensible | USCoreConditionCategoryCodeshttp://hl7.org/fhir/us/core/ValueSet/us-core-condition-category | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Condition.category:SDOH | required | SDOHCCValueSetSDOHCategoryhttp://hl7.org/fhir/us/sdoh-clinicalcare/ValueSet/SDOHCC-ValueSetSDOHCategoryfrom this IG | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Condition.code | required | USCoreConditionCode
http://hl7.org/fhir/us/core/ValueSet/us-core-condition-code | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 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 | |
| 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() | |
| us-core-1 | best practice | Condition | A code in Condition.category SHOULD be from US Core Condition Category Codes value set. : where(category.memberOf('http://hl7.org/fhir/us/core/ValueSet/us-core-condition-category')).exists() |
Snapshot View
| Name | Flags | Card. | Type | Description & Constraints | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Condition |
C | 0..* | USCoreCondition | 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 us-core-1: A code in Condition.category SHOULD be from US Core Condition Category Codes value set. SDOH-Con-1: Can only have a max of one asserter. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| id |
Σ | 0..1 | id | Logical id of this artifact | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| meta |
Σ | 0..1 | Meta | Metadata about the resource | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| language |
0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| text |
0..1 | Narrative | Text summary of the resource, for human interpretation | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| contained |
0..* | Resource | Contained, inline Resources | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Slices for extension |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| asserterDevice |
SC | 0..1 | (Complex) | Optional Extensions Element URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| extension |
0..0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| url |
1..1 | uri | "http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionConditionAsserter" | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| value[x] |
0..1 | Reference(Device) | Value of extension | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 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 | 1..* | CodeableConcept | problem-list-item | encounter-diagnosis | health-concern Slice: Unordered, Open by value:$this Binding: US Core Condition Category Codes (extensible) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| category:SDOH |
SC | 0..* | CodeableConcept | e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| severity |
0..1 | CodeableConcept | Subjective severity of condition Binding: Condition/DiagnosisSeverity (preferred): A subjective assessment of the severity of the condition as evaluated by the clinician. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| code |
SΣ | 1..1 | CodeableConcept | Identification of the condition, problem or diagnosis Binding: US Core Condition Code (required): Valueset to describe the actual problem experienced by the patient
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| subject |
SΣ | 1..1 | Reference(US Core Patient Profile) | Who has the condition? | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| encounter |
Σ | 0..1 | Reference(Encounter) | Encounter created as part of | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| onset[x] |
SΣ | 0..1 | Estimated dateTime or Period | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| onsetDateTime |
dateTime | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| onsetPeriod |
Period | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| abatement[x] |
SC | 0..1 | When in resolution/remission | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| abatementDateTime |
dateTime | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| abatementPeriod |
Period | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| recordedDate |
Σ | 0..1 | dateTime | Date record was first recorded | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| recorder |
Σ | 0..1 | Reference(Practitioner | PractitionerRole) | Who recorded the condition | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| asserter |
SΣC | 0..1 | Reference(RelatedPerson | US Core Patient Profile | US Core Practitioner Profile | US Core PractitionerRole Profile) | Person or device that asserts this condition | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| evidence |
SC | 0..* | BackboneElement | Supporting evidence con-2: evidence SHALL have code or details | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 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 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Path | Conformance | ValueSet | URI | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Condition.language | preferred | CommonLanguages
http://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 | USCoreConditionCategoryCodeshttp://hl7.org/fhir/us/core/ValueSet/us-core-condition-category | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Condition.category:SDOH | 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 | USCoreConditionCode
http://hl7.org/fhir/us/core/ValueSet/us-core-condition-code | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 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 | |
| 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() | |
| us-core-1 | best practice | Condition | A code in Condition.category SHOULD be from US Core Condition Category Codes value set. : where(category.memberOf('http://hl7.org/fhir/us/core/ValueSet/us-core-condition-category')).exists() |
This structure is derived from USCoreCondition
Summary
Must-Support: 6 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:
Other representations of profile: CSV, Excel, Schematron
IG © 2021+ HL7 International / Patient Care. Package hl7.fhir.us.sdoh-clinicalcare#2.2.0 based on FHIR 4.0.1. Generated 2024-09-06
Links: Table of Contents |
QA Report
| Version History |
|
Propose a change
