Purpose

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.

Usage

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

Of note, Gravity Project is continuously developing terminology for new SDOH domains. 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.

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

This structure is derived from Condition

Name	Flags	Card.	Type	Description & Constraints
Condition	C	0..*	Condition	Detailed information about SDOH conditions, problems or diagnoses SDOH-Con-1: Can only have a max of one asserter.
meta	S	0..1	Meta	Metadata about the resource
lastUpdated	S	0..1	instant	When the resource last changed
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
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
assertedDate	S	0..1	dateTime	Date the condition was first asserted URL: http://hl7.org/fhir/StructureDefinition/condition-assertedDate
clinicalStatus	S	0..1	CodeableConcept	active | recurrence | relapse | inactive | remission | resolved Binding: ConditionClinicalStatusCodes (required)
verificationStatus	S	0..1	CodeableConcept	unconfirmed | provisional | differential | confirmed | refuted | entered-in-error Binding: ConditionVerificationStatus (required)
Slices for category	S	0..*	CodeableConcept	category codes Slice: Unordered, Open by pattern:$this
category:encounter-diagnosis	S	0..1	CodeableConcept	problem-list-item | encounter-diagnosis Required Pattern: At least the following
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (complex)
system		1..1	uri	Identity of the terminology system Fixed Value: http://terminology.hl7.org/CodeSystem/condition-category
code		1..1	code	Symbol in syntax defined by the system Fixed Value: encounter-diagnosis
category:problem-or-health-concern	S	0..*	CodeableConcept	problem-list-item | health-concern Binding: US Core Problem or Health Concern (required)
category:screening-assessment	S	0..*	CodeableConcept	USCDI Health Status/Assessments Data Class Binding: US Core Screening Assessment Condition Category (required)
category:SDOH		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 Codes (preferred): Valueset to describe the actual problem experienced by the patient Additional Bindings Purpose Usage US Core Condition Codes Required Digital Access Diagnoses Extensible Condition.category = digital-access Digital Literacy Diagnoses Extensible Condition.category = digital-literacy Less Than High School Education Diagnoses Extensible Condition.category = educational-attainment Elder Abuse Diagnoses Extensible Condition.category = elder-abuse Unemployment Diagnoses Extensible Condition.category = employment-status Financial Insecurity Diagnoses Extensible Condition.category = financial-insecurity Food Insecurity Diagnoses Extensible Condition.category = food-insecurity Health Insurance Coverage Status Diagnoses Extensible Condition.category = health-insurance-coverage-status Homelessness Diagnoses Extensible Condition.category = homelessness Housing Instability Diagnoses Extensible Condition.category = housing-instability Inadequate Housing Diagnoses Extensible Condition.category = inadequate-housing Intimate Partner Violence Diagnoses Extensible Condition.category = intimate-partner-violence Material Hardship Diagnoses Extensible Condition.category = material-hardship Medical Cost Burden Diagnoses Extensible Condition.category = medical-cost-burden Health Literacy Diagnoses Extensible Condition.category = personal-health-literacy Social Connection Diagnoses Extensible Condition.category = social-connection Stress Diagnoses Extensible Condition.category = stress Transportation Insecurity Diagnoses Extensible Condition.category = transportation-insecurity Utility Insecurity Diagnoses Extensible Condition.category = utility-insecurity Veteran Status Diagnoses Extensible Condition.category = veteran-status US Core Condition Codes Required Condition.category = sdoh-category-unspecified
bodySite		0..0
subject	S	1..1	Reference(US Core Patient Profile)	Who has the condition?
encounter	S	0..1	Reference(US Core Encounter Profile)	Encounter created as part of
onset[x]	S	0..1		Estimated or actual date, date-time, or age
onsetDateTime			dateTime S
onsetPeriod			Period
abatement[x]	S	0..1		When in resolution/remission
abatementDateTime			dateTime S
abatementPeriod			Period
recordedDate	S	0..1	dateTime	Date record was first recorded
recorder		0..1	Reference(Practitioner | PractitionerRole)	Who recorded the condition
asserter	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

Terminology Bindings (Differential)

Path	Conformance	ValueSet	URI
Condition.clinicalStatus	required	ConditionClinicalStatusCodes http://hl7.org/fhir/ValueSet/condition-clinical from the FHIR Standard
Condition.verificationStatus	required	ConditionVerificationStatus http://hl7.org/fhir/ValueSet/condition-ver-status from the FHIR Standard
Condition.category:problem-or-health-concern	required	USCoreProblemOrHealthConcern http://hl7.org/fhir/us/core/ValueSet/us-core-problem-or-health-concern
Condition.category:screening-assessment	required	USCoreScreeningAssessmentConditionCategory http://hl7.org/fhir/us/core/ValueSet/us-core-screening-assessment-condition-category
Condition.category:SDOH	required	SDOHCCValueSetSDOHCategory http://hl7.org/fhir/us/sdoh-clinicalcare/ValueSet/SDOHCC-ValueSetSDOHCategory from this IG
Condition.code	preferred	USCoreConditionCodes http://hl7.org/fhir/us/core/ValueSet/us-core-condition-code

Constraints

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..*	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.
meta	SΣ	0..1	Meta	Metadata about the resource
lastUpdated	SΣ	0..1	instant	When the resource last changed
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
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
assertedDate	S	0..1	dateTime	Date the condition was first asserted URL: http://hl7.org/fhir/StructureDefinition/condition-assertedDate
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
clinicalStatus	?!SΣC	0..1	CodeableConcept	active | recurrence | relapse | inactive | remission | resolved Binding: ConditionClinicalStatusCodes (required)
verificationStatus	?!SΣC	0..1	CodeableConcept	unconfirmed | provisional | differential | confirmed | refuted | entered-in-error Binding: ConditionVerificationStatus (required)
Slices for category	S	0..*	CodeableConcept	category codes Slice: Unordered, Open by pattern:$this Binding: ConditionCategoryCodes (extensible): A category assigned to the condition.
category:encounter-diagnosis	S	0..1	CodeableConcept	problem-list-item | encounter-diagnosis Binding: ConditionCategoryCodes (extensible): A category assigned to the condition. Required Pattern: At least the following
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (complex)
system		1..1	uri	Identity of the terminology system Fixed Value: http://terminology.hl7.org/CodeSystem/condition-category
code		1..1	code	Symbol in syntax defined by the system Fixed Value: encounter-diagnosis
category:problem-or-health-concern	S	0..*	CodeableConcept	problem-list-item | health-concern Binding: US Core Problem or Health Concern (required)
category:screening-assessment	S	0..*	CodeableConcept	USCDI Health Status/Assessments Data Class Binding: US Core Screening Assessment Condition Category (required)
category:SDOH		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 Codes (preferred): Valueset to describe the actual problem experienced by the patient Additional Bindings Purpose Usage US Core Condition Codes Required Digital Access Diagnoses Extensible Condition.category = digital-access Digital Literacy Diagnoses Extensible Condition.category = digital-literacy Less Than High School Education Diagnoses Extensible Condition.category = educational-attainment Elder Abuse Diagnoses Extensible Condition.category = elder-abuse Unemployment Diagnoses Extensible Condition.category = employment-status Financial Insecurity Diagnoses Extensible Condition.category = financial-insecurity Food Insecurity Diagnoses Extensible Condition.category = food-insecurity Health Insurance Coverage Status Diagnoses Extensible Condition.category = health-insurance-coverage-status Homelessness Diagnoses Extensible Condition.category = homelessness Housing Instability Diagnoses Extensible Condition.category = housing-instability Inadequate Housing Diagnoses Extensible Condition.category = inadequate-housing Intimate Partner Violence Diagnoses Extensible Condition.category = intimate-partner-violence Material Hardship Diagnoses Extensible Condition.category = material-hardship Medical Cost Burden Diagnoses Extensible Condition.category = medical-cost-burden Health Literacy Diagnoses Extensible Condition.category = personal-health-literacy Social Connection Diagnoses Extensible Condition.category = social-connection Stress Diagnoses Extensible Condition.category = stress Transportation Insecurity Diagnoses Extensible Condition.category = transportation-insecurity Utility Insecurity Diagnoses Extensible Condition.category = utility-insecurity Veteran Status Diagnoses Extensible Condition.category = veteran-status US Core Condition Codes Required Condition.category = sdoh-category-unspecified
subject	SΣ	1..1	Reference(US Core Patient Profile)	Who has the condition?
encounter	SΣ	0..1	Reference(US Core Encounter Profile)	Encounter created as part of
onset[x]	SΣ	0..1		Estimated or actual date, date-time, or age
onsetDateTime			dateTime
abatement[x]	SC	0..1		When in resolution/remission
abatementDateTime			dateTime
recordedDate	SΣ	0..1	dateTime	Date record was first recorded
recorder	Σ	0..1	Reference(Practitioner | PractitionerRole)	Who recorded the condition
asserter	SΣC	0..1	Reference(RelatedPerson | US Core Patient Profile | 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

Terminology Bindings

Path	Conformance	ValueSet / Code	URI
Condition.clinicalStatus	required	ConditionClinicalStatusCodes http://hl7.org/fhir/ValueSet/condition-clinical from the FHIR Standard
Condition.verificationStatus	required	ConditionVerificationStatus http://hl7.org/fhir/ValueSet/condition-ver-status from the FHIR Standard
Condition.category	extensible	ConditionCategoryCodes http://hl7.org/fhir/ValueSet/condition-category from the FHIR Standard
Condition.category:encounter-diagnosis	extensible	Pattern: encounter-diagnosis http://hl7.org/fhir/ValueSet/condition-category from the FHIR Standard
Condition.category:problem-or-health-concern	required	USCoreProblemOrHealthConcern http://hl7.org/fhir/us/core/ValueSet/us-core-problem-or-health-concern
Condition.category:screening-assessment	required	USCoreScreeningAssessmentConditionCategory http://hl7.org/fhir/us/core/ValueSet/us-core-screening-assessment-condition-category
Condition.category:SDOH	required	SDOHCCValueSetSDOHCategory http://hl7.org/fhir/us/sdoh-clinicalcare/ValueSet/SDOHCC-ValueSetSDOHCategory from this IG
Condition.code	preferred	USCoreConditionCodes http://hl7.org/fhir/us/core/ValueSet/us-core-condition-code
Condition.evidence.code	example	ManifestationAndSymptomCodes http://hl7.org/fhir/ValueSet/manifestation-or-symptom from the FHIR Standard

Constraints

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()

Name	Flags	Card.	Type	Description & Constraints
Condition	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.
id	Σ	0..1	id	Logical id of this artifact
meta	SΣ	0..1	Meta	Metadata about the resource
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
versionId	Σ	0..1	id	Version specific identifier
lastUpdated	SΣ	0..1	instant	When the resource last changed
source	Σ	0..1	uri	Identifies where the resource comes from
profile	Σ	0..*	canonical(StructureDefinition)	Profiles this resource claims to conform to
security	Σ	0..*	Coding	Security Labels applied to this resource Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System.
tag	Σ	0..*	Coding	Tags applied to this resource Binding: CommonTags (example): Codes that represent various types of tags, commonly workflow-related; e.g. "Needs review by Dr. Jones".
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
language		0..1	code	Language of the resource content Binding: CommonLanguages (preferred): A human language. Additional Bindings Purpose AllLanguages Max Binding
text		0..1	Narrative	Text summary of the resource, for human interpretation
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
assertedDate	S	0..1	dateTime	Date the condition was first asserted URL: http://hl7.org/fhir/StructureDefinition/condition-assertedDate
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
identifier	Σ	0..*	Identifier	External Ids for this condition
clinicalStatus	?!SΣC	0..1	CodeableConcept	active | recurrence | relapse | inactive | remission | resolved Binding: ConditionClinicalStatusCodes (required)
verificationStatus	?!SΣC	0..1	CodeableConcept	unconfirmed | provisional | differential | confirmed | refuted | entered-in-error Binding: ConditionVerificationStatus (required)
Slices for category	S	0..*	CodeableConcept	category codes Slice: Unordered, Open by pattern:$this Binding: ConditionCategoryCodes (extensible): A category assigned to the condition.
category:encounter-diagnosis	S	0..1	CodeableConcept	problem-list-item | encounter-diagnosis Binding: ConditionCategoryCodes (extensible): A category assigned to the condition. Required Pattern: At least the following
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (complex)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
system		1..1	uri	Identity of the terminology system Fixed Value: http://terminology.hl7.org/CodeSystem/condition-category
version		0..1	string	Version of the system - if relevant
code		1..1	code	Symbol in syntax defined by the system Fixed Value: encounter-diagnosis
display		0..1	string	Representation defined by the system
userSelected		0..1	boolean	If this coding was chosen directly by the user
text		0..1	string	Plain text representation of the concept
category:problem-or-health-concern	S	0..*	CodeableConcept	problem-list-item | health-concern Binding: US Core Problem or Health Concern (required)
category:screening-assessment	S	0..*	CodeableConcept	USCDI Health Status/Assessments Data Class Binding: US Core Screening Assessment Condition Category (required)
category:SDOH		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 Codes (preferred): Valueset to describe the actual problem experienced by the patient Additional Bindings Purpose Usage US Core Condition Codes Required Digital Access Diagnoses Extensible Condition.category = digital-access Digital Literacy Diagnoses Extensible Condition.category = digital-literacy Less Than High School Education Diagnoses Extensible Condition.category = educational-attainment Elder Abuse Diagnoses Extensible Condition.category = elder-abuse Unemployment Diagnoses Extensible Condition.category = employment-status Financial Insecurity Diagnoses Extensible Condition.category = financial-insecurity Food Insecurity Diagnoses Extensible Condition.category = food-insecurity Health Insurance Coverage Status Diagnoses Extensible Condition.category = health-insurance-coverage-status Homelessness Diagnoses Extensible Condition.category = homelessness Housing Instability Diagnoses Extensible Condition.category = housing-instability Inadequate Housing Diagnoses Extensible Condition.category = inadequate-housing Intimate Partner Violence Diagnoses Extensible Condition.category = intimate-partner-violence Material Hardship Diagnoses Extensible Condition.category = material-hardship Medical Cost Burden Diagnoses Extensible Condition.category = medical-cost-burden Health Literacy Diagnoses Extensible Condition.category = personal-health-literacy Social Connection Diagnoses Extensible Condition.category = social-connection Stress Diagnoses Extensible Condition.category = stress Transportation Insecurity Diagnoses Extensible Condition.category = transportation-insecurity Utility Insecurity Diagnoses Extensible Condition.category = utility-insecurity Veteran Status Diagnoses Extensible Condition.category = veteran-status US Core Condition Codes Required Condition.category = sdoh-category-unspecified
subject	SΣ	1..1	Reference(US Core Patient Profile)	Who has the condition?
encounter	SΣ	0..1	Reference(US Core Encounter Profile)	Encounter created as part of
onset[x]	SΣ	0..1		Estimated or actual date, date-time, or age
onsetDateTime			dateTime S
onsetPeriod			Period
abatement[x]	SC	0..1		When in resolution/remission
abatementDateTime			dateTime S
abatementPeriod			Period
recordedDate	SΣ	0..1	dateTime	Date record was first recorded
recorder	Σ	0..1	Reference(Practitioner | PractitionerRole)	Who recorded the condition
asserter	SΣC	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

Terminology Bindings

Path	Conformance	ValueSet / Code	URI
Condition.meta.security	extensible	All Security Labels http://hl7.org/fhir/ValueSet/security-labels from the FHIR Standard
Condition.meta.tag	example	CommonTags http://hl7.org/fhir/ValueSet/common-tags from the FHIR Standard
Condition.language	preferred	CommonLanguages Additional Bindings Purpose AllLanguages Max Binding http://hl7.org/fhir/ValueSet/languages from the FHIR Standard
Condition.clinicalStatus	required	ConditionClinicalStatusCodes http://hl7.org/fhir/ValueSet/condition-clinical from the FHIR Standard
Condition.verificationStatus	required	ConditionVerificationStatus http://hl7.org/fhir/ValueSet/condition-ver-status from the FHIR Standard
Condition.category	extensible	ConditionCategoryCodes http://hl7.org/fhir/ValueSet/condition-category from the FHIR Standard
Condition.category:encounter-diagnosis	extensible	Pattern: encounter-diagnosis http://hl7.org/fhir/ValueSet/condition-category from the FHIR Standard
Condition.category:problem-or-health-concern	required	USCoreProblemOrHealthConcern http://hl7.org/fhir/us/core/ValueSet/us-core-problem-or-health-concern
Condition.category:screening-assessment	required	USCoreScreeningAssessmentConditionCategory http://hl7.org/fhir/us/core/ValueSet/us-core-screening-assessment-condition-category
Condition.category:SDOH	required	SDOHCCValueSetSDOHCategory http://hl7.org/fhir/us/sdoh-clinicalcare/ValueSet/SDOHCC-ValueSetSDOHCategory from this IG
Condition.severity	preferred	Condition/DiagnosisSeverity http://hl7.org/fhir/ValueSet/condition-severity from the FHIR Standard
Condition.code	preferred	USCoreConditionCodes http://hl7.org/fhir/us/core/ValueSet/us-core-condition-code
Condition.stage.summary	example	ConditionStage http://hl7.org/fhir/ValueSet/condition-stage from the FHIR Standard
Condition.stage.type	example	ConditionStageType http://hl7.org/fhir/ValueSet/condition-stage-type from the FHIR Standard
Condition.evidence.code	example	ManifestationAndSymptomCodes http://hl7.org/fhir/ValueSet/manifestation-or-symptom from the FHIR Standard

Constraints

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()

Differential View

This structure is derived from Condition

Name	Flags	Card.	Type	Description & Constraints
Condition	C	0..*	Condition	Detailed information about SDOH conditions, problems or diagnoses SDOH-Con-1: Can only have a max of one asserter.
meta	S	0..1	Meta	Metadata about the resource
lastUpdated	S	0..1	instant	When the resource last changed
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
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
assertedDate	S	0..1	dateTime	Date the condition was first asserted URL: http://hl7.org/fhir/StructureDefinition/condition-assertedDate
clinicalStatus	S	0..1	CodeableConcept	active | recurrence | relapse | inactive | remission | resolved Binding: ConditionClinicalStatusCodes (required)
verificationStatus	S	0..1	CodeableConcept	unconfirmed | provisional | differential | confirmed | refuted | entered-in-error Binding: ConditionVerificationStatus (required)
Slices for category	S	0..*	CodeableConcept	category codes Slice: Unordered, Open by pattern:$this
category:encounter-diagnosis	S	0..1	CodeableConcept	problem-list-item | encounter-diagnosis Required Pattern: At least the following
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (complex)
system		1..1	uri	Identity of the terminology system Fixed Value: http://terminology.hl7.org/CodeSystem/condition-category
code		1..1	code	Symbol in syntax defined by the system Fixed Value: encounter-diagnosis
category:problem-or-health-concern	S	0..*	CodeableConcept	problem-list-item | health-concern Binding: US Core Problem or Health Concern (required)
category:screening-assessment	S	0..*	CodeableConcept	USCDI Health Status/Assessments Data Class Binding: US Core Screening Assessment Condition Category (required)
category:SDOH		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 Codes (preferred): Valueset to describe the actual problem experienced by the patient Additional Bindings Purpose Usage US Core Condition Codes Required Digital Access Diagnoses Extensible Condition.category = digital-access Digital Literacy Diagnoses Extensible Condition.category = digital-literacy Less Than High School Education Diagnoses Extensible Condition.category = educational-attainment Elder Abuse Diagnoses Extensible Condition.category = elder-abuse Unemployment Diagnoses Extensible Condition.category = employment-status Financial Insecurity Diagnoses Extensible Condition.category = financial-insecurity Food Insecurity Diagnoses Extensible Condition.category = food-insecurity Health Insurance Coverage Status Diagnoses Extensible Condition.category = health-insurance-coverage-status Homelessness Diagnoses Extensible Condition.category = homelessness Housing Instability Diagnoses Extensible Condition.category = housing-instability Inadequate Housing Diagnoses Extensible Condition.category = inadequate-housing Intimate Partner Violence Diagnoses Extensible Condition.category = intimate-partner-violence Material Hardship Diagnoses Extensible Condition.category = material-hardship Medical Cost Burden Diagnoses Extensible Condition.category = medical-cost-burden Health Literacy Diagnoses Extensible Condition.category = personal-health-literacy Social Connection Diagnoses Extensible Condition.category = social-connection Stress Diagnoses Extensible Condition.category = stress Transportation Insecurity Diagnoses Extensible Condition.category = transportation-insecurity Utility Insecurity Diagnoses Extensible Condition.category = utility-insecurity Veteran Status Diagnoses Extensible Condition.category = veteran-status US Core Condition Codes Required Condition.category = sdoh-category-unspecified
bodySite		0..0
subject	S	1..1	Reference(US Core Patient Profile)	Who has the condition?
encounter	S	0..1	Reference(US Core Encounter Profile)	Encounter created as part of
onset[x]	S	0..1		Estimated or actual date, date-time, or age
onsetDateTime			dateTime S
onsetPeriod			Period
abatement[x]	S	0..1		When in resolution/remission
abatementDateTime			dateTime S
abatementPeriod			Period
recordedDate	S	0..1	dateTime	Date record was first recorded
recorder		0..1	Reference(Practitioner | PractitionerRole)	Who recorded the condition
asserter	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

Terminology Bindings (Differential)

Path	Conformance	ValueSet	URI
Condition.clinicalStatus	required	ConditionClinicalStatusCodes http://hl7.org/fhir/ValueSet/condition-clinical from the FHIR Standard
Condition.verificationStatus	required	ConditionVerificationStatus http://hl7.org/fhir/ValueSet/condition-ver-status from the FHIR Standard
Condition.category:problem-or-health-concern	required	USCoreProblemOrHealthConcern http://hl7.org/fhir/us/core/ValueSet/us-core-problem-or-health-concern
Condition.category:screening-assessment	required	USCoreScreeningAssessmentConditionCategory http://hl7.org/fhir/us/core/ValueSet/us-core-screening-assessment-condition-category
Condition.category:SDOH	required	SDOHCCValueSetSDOHCategory http://hl7.org/fhir/us/sdoh-clinicalcare/ValueSet/SDOHCC-ValueSetSDOHCategory from this IG
Condition.code	preferred	USCoreConditionCodes http://hl7.org/fhir/us/core/ValueSet/us-core-condition-code

Constraints

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..*	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.
meta	SΣ	0..1	Meta	Metadata about the resource
lastUpdated	SΣ	0..1	instant	When the resource last changed
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
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
assertedDate	S	0..1	dateTime	Date the condition was first asserted URL: http://hl7.org/fhir/StructureDefinition/condition-assertedDate
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
clinicalStatus	?!SΣC	0..1	CodeableConcept	active | recurrence | relapse | inactive | remission | resolved Binding: ConditionClinicalStatusCodes (required)
verificationStatus	?!SΣC	0..1	CodeableConcept	unconfirmed | provisional | differential | confirmed | refuted | entered-in-error Binding: ConditionVerificationStatus (required)
Slices for category	S	0..*	CodeableConcept	category codes Slice: Unordered, Open by pattern:$this Binding: ConditionCategoryCodes (extensible): A category assigned to the condition.
category:encounter-diagnosis	S	0..1	CodeableConcept	problem-list-item | encounter-diagnosis Binding: ConditionCategoryCodes (extensible): A category assigned to the condition. Required Pattern: At least the following
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (complex)
system		1..1	uri	Identity of the terminology system Fixed Value: http://terminology.hl7.org/CodeSystem/condition-category
code		1..1	code	Symbol in syntax defined by the system Fixed Value: encounter-diagnosis
category:problem-or-health-concern	S	0..*	CodeableConcept	problem-list-item | health-concern Binding: US Core Problem or Health Concern (required)
category:screening-assessment	S	0..*	CodeableConcept	USCDI Health Status/Assessments Data Class Binding: US Core Screening Assessment Condition Category (required)
category:SDOH		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 Codes (preferred): Valueset to describe the actual problem experienced by the patient Additional Bindings Purpose Usage US Core Condition Codes Required Digital Access Diagnoses Extensible Condition.category = digital-access Digital Literacy Diagnoses Extensible Condition.category = digital-literacy Less Than High School Education Diagnoses Extensible Condition.category = educational-attainment Elder Abuse Diagnoses Extensible Condition.category = elder-abuse Unemployment Diagnoses Extensible Condition.category = employment-status Financial Insecurity Diagnoses Extensible Condition.category = financial-insecurity Food Insecurity Diagnoses Extensible Condition.category = food-insecurity Health Insurance Coverage Status Diagnoses Extensible Condition.category = health-insurance-coverage-status Homelessness Diagnoses Extensible Condition.category = homelessness Housing Instability Diagnoses Extensible Condition.category = housing-instability Inadequate Housing Diagnoses Extensible Condition.category = inadequate-housing Intimate Partner Violence Diagnoses Extensible Condition.category = intimate-partner-violence Material Hardship Diagnoses Extensible Condition.category = material-hardship Medical Cost Burden Diagnoses Extensible Condition.category = medical-cost-burden Health Literacy Diagnoses Extensible Condition.category = personal-health-literacy Social Connection Diagnoses Extensible Condition.category = social-connection Stress Diagnoses Extensible Condition.category = stress Transportation Insecurity Diagnoses Extensible Condition.category = transportation-insecurity Utility Insecurity Diagnoses Extensible Condition.category = utility-insecurity Veteran Status Diagnoses Extensible Condition.category = veteran-status US Core Condition Codes Required Condition.category = sdoh-category-unspecified
subject	SΣ	1..1	Reference(US Core Patient Profile)	Who has the condition?
encounter	SΣ	0..1	Reference(US Core Encounter Profile)	Encounter created as part of
onset[x]	SΣ	0..1		Estimated or actual date, date-time, or age
onsetDateTime			dateTime
abatement[x]	SC	0..1		When in resolution/remission
abatementDateTime			dateTime
recordedDate	SΣ	0..1	dateTime	Date record was first recorded
recorder	Σ	0..1	Reference(Practitioner | PractitionerRole)	Who recorded the condition
asserter	SΣC	0..1	Reference(RelatedPerson | US Core Patient Profile | 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

Terminology Bindings

Path	Conformance	ValueSet / Code	URI
Condition.clinicalStatus	required	ConditionClinicalStatusCodes http://hl7.org/fhir/ValueSet/condition-clinical from the FHIR Standard
Condition.verificationStatus	required	ConditionVerificationStatus http://hl7.org/fhir/ValueSet/condition-ver-status from the FHIR Standard
Condition.category	extensible	ConditionCategoryCodes http://hl7.org/fhir/ValueSet/condition-category from the FHIR Standard
Condition.category:encounter-diagnosis	extensible	Pattern: encounter-diagnosis http://hl7.org/fhir/ValueSet/condition-category from the FHIR Standard
Condition.category:problem-or-health-concern	required	USCoreProblemOrHealthConcern http://hl7.org/fhir/us/core/ValueSet/us-core-problem-or-health-concern
Condition.category:screening-assessment	required	USCoreScreeningAssessmentConditionCategory http://hl7.org/fhir/us/core/ValueSet/us-core-screening-assessment-condition-category
Condition.category:SDOH	required	SDOHCCValueSetSDOHCategory http://hl7.org/fhir/us/sdoh-clinicalcare/ValueSet/SDOHCC-ValueSetSDOHCategory from this IG
Condition.code	preferred	USCoreConditionCodes http://hl7.org/fhir/us/core/ValueSet/us-core-condition-code
Condition.evidence.code	example	ManifestationAndSymptomCodes http://hl7.org/fhir/ValueSet/manifestation-or-symptom from the FHIR Standard

Constraints

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()

Snapshot View

Name	Flags	Card.	Type	Description & Constraints
Condition	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.
id	Σ	0..1	id	Logical id of this artifact
meta	SΣ	0..1	Meta	Metadata about the resource
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
versionId	Σ	0..1	id	Version specific identifier
lastUpdated	SΣ	0..1	instant	When the resource last changed
source	Σ	0..1	uri	Identifies where the resource comes from
profile	Σ	0..*	canonical(StructureDefinition)	Profiles this resource claims to conform to
security	Σ	0..*	Coding	Security Labels applied to this resource Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System.
tag	Σ	0..*	Coding	Tags applied to this resource Binding: CommonTags (example): Codes that represent various types of tags, commonly workflow-related; e.g. "Needs review by Dr. Jones".
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
language		0..1	code	Language of the resource content Binding: CommonLanguages (preferred): A human language. Additional Bindings Purpose AllLanguages Max Binding
text		0..1	Narrative	Text summary of the resource, for human interpretation
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
assertedDate	S	0..1	dateTime	Date the condition was first asserted URL: http://hl7.org/fhir/StructureDefinition/condition-assertedDate
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
identifier	Σ	0..*	Identifier	External Ids for this condition
clinicalStatus	?!SΣC	0..1	CodeableConcept	active | recurrence | relapse | inactive | remission | resolved Binding: ConditionClinicalStatusCodes (required)
verificationStatus	?!SΣC	0..1	CodeableConcept	unconfirmed | provisional | differential | confirmed | refuted | entered-in-error Binding: ConditionVerificationStatus (required)
Slices for category	S	0..*	CodeableConcept	category codes Slice: Unordered, Open by pattern:$this Binding: ConditionCategoryCodes (extensible): A category assigned to the condition.
category:encounter-diagnosis	S	0..1	CodeableConcept	problem-list-item | encounter-diagnosis Binding: ConditionCategoryCodes (extensible): A category assigned to the condition. Required Pattern: At least the following
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (complex)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
system		1..1	uri	Identity of the terminology system Fixed Value: http://terminology.hl7.org/CodeSystem/condition-category
version		0..1	string	Version of the system - if relevant
code		1..1	code	Symbol in syntax defined by the system Fixed Value: encounter-diagnosis
display		0..1	string	Representation defined by the system
userSelected		0..1	boolean	If this coding was chosen directly by the user
text		0..1	string	Plain text representation of the concept
category:problem-or-health-concern	S	0..*	CodeableConcept	problem-list-item | health-concern Binding: US Core Problem or Health Concern (required)
category:screening-assessment	S	0..*	CodeableConcept	USCDI Health Status/Assessments Data Class Binding: US Core Screening Assessment Condition Category (required)
category:SDOH		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 Codes (preferred): Valueset to describe the actual problem experienced by the patient Additional Bindings Purpose Usage US Core Condition Codes Required Digital Access Diagnoses Extensible Condition.category = digital-access Digital Literacy Diagnoses Extensible Condition.category = digital-literacy Less Than High School Education Diagnoses Extensible Condition.category = educational-attainment Elder Abuse Diagnoses Extensible Condition.category = elder-abuse Unemployment Diagnoses Extensible Condition.category = employment-status Financial Insecurity Diagnoses Extensible Condition.category = financial-insecurity Food Insecurity Diagnoses Extensible Condition.category = food-insecurity Health Insurance Coverage Status Diagnoses Extensible Condition.category = health-insurance-coverage-status Homelessness Diagnoses Extensible Condition.category = homelessness Housing Instability Diagnoses Extensible Condition.category = housing-instability Inadequate Housing Diagnoses Extensible Condition.category = inadequate-housing Intimate Partner Violence Diagnoses Extensible Condition.category = intimate-partner-violence Material Hardship Diagnoses Extensible Condition.category = material-hardship Medical Cost Burden Diagnoses Extensible Condition.category = medical-cost-burden Health Literacy Diagnoses Extensible Condition.category = personal-health-literacy Social Connection Diagnoses Extensible Condition.category = social-connection Stress Diagnoses Extensible Condition.category = stress Transportation Insecurity Diagnoses Extensible Condition.category = transportation-insecurity Utility Insecurity Diagnoses Extensible Condition.category = utility-insecurity Veteran Status Diagnoses Extensible Condition.category = veteran-status US Core Condition Codes Required Condition.category = sdoh-category-unspecified
subject	SΣ	1..1	Reference(US Core Patient Profile)	Who has the condition?
encounter	SΣ	0..1	Reference(US Core Encounter Profile)	Encounter created as part of
onset[x]	SΣ	0..1		Estimated or actual date, date-time, or age
onsetDateTime			dateTime S
onsetPeriod			Period
abatement[x]	SC	0..1		When in resolution/remission
abatementDateTime			dateTime S
abatementPeriod			Period
recordedDate	SΣ	0..1	dateTime	Date record was first recorded
recorder	Σ	0..1	Reference(Practitioner | PractitionerRole)	Who recorded the condition
asserter	SΣC	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

Terminology Bindings

Path	Conformance	ValueSet / Code	URI
Condition.meta.security	extensible	All Security Labels http://hl7.org/fhir/ValueSet/security-labels from the FHIR Standard
Condition.meta.tag	example	CommonTags http://hl7.org/fhir/ValueSet/common-tags from the FHIR Standard
Condition.language	preferred	CommonLanguages Additional Bindings Purpose AllLanguages Max Binding http://hl7.org/fhir/ValueSet/languages from the FHIR Standard
Condition.clinicalStatus	required	ConditionClinicalStatusCodes http://hl7.org/fhir/ValueSet/condition-clinical from the FHIR Standard
Condition.verificationStatus	required	ConditionVerificationStatus http://hl7.org/fhir/ValueSet/condition-ver-status from the FHIR Standard
Condition.category	extensible	ConditionCategoryCodes http://hl7.org/fhir/ValueSet/condition-category from the FHIR Standard
Condition.category:encounter-diagnosis	extensible	Pattern: encounter-diagnosis http://hl7.org/fhir/ValueSet/condition-category from the FHIR Standard
Condition.category:problem-or-health-concern	required	USCoreProblemOrHealthConcern http://hl7.org/fhir/us/core/ValueSet/us-core-problem-or-health-concern
Condition.category:screening-assessment	required	USCoreScreeningAssessmentConditionCategory http://hl7.org/fhir/us/core/ValueSet/us-core-screening-assessment-condition-category
Condition.category:SDOH	required	SDOHCCValueSetSDOHCategory http://hl7.org/fhir/us/sdoh-clinicalcare/ValueSet/SDOHCC-ValueSetSDOHCategory from this IG
Condition.severity	preferred	Condition/DiagnosisSeverity http://hl7.org/fhir/ValueSet/condition-severity from the FHIR Standard
Condition.code	preferred	USCoreConditionCodes http://hl7.org/fhir/us/core/ValueSet/us-core-condition-code
Condition.stage.summary	example	ConditionStage http://hl7.org/fhir/ValueSet/condition-stage from the FHIR Standard
Condition.stage.type	example	ConditionStageType http://hl7.org/fhir/ValueSet/condition-stage-type from the FHIR Standard
Condition.evidence.code	example	ManifestationAndSymptomCodes http://hl7.org/fhir/ValueSet/manifestation-or-symptom from the FHIR Standard

Constraints

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()

This structure is derived from Condition

Summary

Mandatory: 1 element
Must-Support: 19 elements
Prohibited: 2 elements

Structures

This structure refers to these other structures:

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

Extensions

This structure refers to these extensions:

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

Slices

This structure defines the following Slices:

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