SDOH Clinical Care, published by HL7 International / Patient Care. This guide is not an authorized publication; it is the continuous build for version 3.0.0-ballot 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

• Content
• Detailed Descriptions
• Mappings
• Examples
• XML
• JSON
• TTL

Resource Profile: SDOHCC Healthcare Service for Referral Management

Profile that extends SDOHCC HealthcareService to support capacity status queries, allowing referral sources to determine if a CBO has capacity before initiating a referral. Includes the capacity-status extension and elements for describing services, programs, and contact information.

Usages:

• Examples for this Profile: HACC

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

Description Differentials, Snapshots, and other representations.

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

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
HealthcareService		0..*	SDOHCCHealthcareService	The details of a healthcare service available at a location
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
extension:capacity-status		1..1	(Complex)	Is the service currently at capacity? URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionHealthcareServiceCapacityStatus
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
active	?!SΣ	1..1	boolean	Whether this HealthcareService record is in active use Fixed Value: true
category	SΣ	1..*	CodeableConcept	Broad category of service being performed or delivered Binding: ServiceCategory (example): A category of the service(s) that could be provided.
Slices for coding	SΣ	1..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:$this
coding:ServiceCategory	SΣ	1..1	Coding	Code defined by a terminology system Binding: SDOHCC ValueSet Service Category (required)
coding:SDOHCC	SΣ	0..*	Coding	e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories.
type	SΣ	1..1	CodeableConcept	Type of service that may be delivered or performed Binding: SDOHCC ValueSet Healthcare Service Type (extensible)
location	SΣ	0..*	Reference(SDOHCC Location)	Location(s) where service may be provided
name	SΣ	1..1	string	Description of service as presented to a consumer while searching
Slices for telecom		1..*	ContactPoint	Contacts related to the healthcare service Slice: Unordered, Open by exists:extension('http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionHealthcareServiceTelecomAppointment')
telecom:AppointmentContact	S	1..*	ContactPoint	Contacts related to the healthcare service
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
extension:ForAppointment	S	1..1	boolean	Telecom is for making appointments URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionHealthcareServiceTelecomAppointment
system	SΣC	1..1	code	phone | fax | email | pager | url | sms | other Binding: ContactPointSystem (required): Telecommunications form for contact point.
value	SΣ	1..1	string	The actual contact point details
use	?!Σ	0..1	code	home | work | temp | old | mobile - purpose of this contact point Binding: ContactPointUse (required): Use of contact point.
program	S	0..*	CodeableConcept	Programs that this service is applicable to Binding: Social Determinants of Health Programs SNOMED CT (extensible)
communication	S	0..*	CodeableConcept	The language that this service is offered in Binding: CommonLanguages (preferred): A human language. Additional Bindings Purpose AllLanguages Max Binding
appointmentRequired	S	0..1	boolean	If an appointment is required for access to this service
availableTime	S	0..*	BackboneElement	Times the Service Site is available
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
notAvailable	S	0..*	BackboneElement	Not available during this time due to provided reason
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
description		1..1	string	Reason presented to the user explaining why time not available
availabilityExceptions	S	0..1	string	Description of availability exceptions
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
HealthcareService.category	Base	example	Service category	📍4.0.1	FHIR Std.
HealthcareService.category.​coding:ServiceCategory	Base	required	SDOHCC ValueSet Service Category	📦3.0.0-ballot	This IG
HealthcareService.category.​coding:SDOHCC	Base	required	SDOHCC ValueSet SDOH Category	📦3.0.0-ballot	This IG
HealthcareService.type	Base	extensible	SDOHCC ValueSet Healthcare Service Type	📦3.0.0-ballot	This IG
HealthcareService.telecom:AppointmentContact.​system	Base	required	ContactPointSystem	📍4.0.1	FHIR Std.
HealthcareService.telecom:AppointmentContact.​use	Base	required	ContactPointUse	📍4.0.1	FHIR Std.
HealthcareService.program	Base	extensible	Social Determinants of Health Programs SNOMED CT	📦20251018	VSAC v0.24
HealthcareService.communication	Base	preferred	Common Languages	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
dom-2	error	HealthcareService	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	HealthcareService	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	HealthcareService	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	HealthcareService	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	HealthcareService	A resource should have narrative for robust management	text.`div`.exists()
ele-1	error	**ALL** elements	All FHIR elements must have a @value or children	hasValue() or (children().count() > id.count())
ext-1	error	**ALL** extensions	Must have either extensions or value[x], not both	extension.exists() != value.exists()

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
HealthcareService		0..*	SDOHCCHealthcareService	The details of a healthcare service available at a location
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
extension:capacity-status		1..1	(Complex)	Is the service currently at capacity? URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionHealthcareServiceCapacityStatus
category	S	1..*	CodeableConcept	Broad category of service being performed or delivered
Slices for coding	S	1..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:$this
coding:ServiceCategory	S	1..1	Coding	Code defined by a terminology system Binding: SDOHCC ValueSet Service Category (required)
coding:SDOHCC	S	0..*	Coding	e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories.
type	S	1..1	CodeableConcept	Type of service that may be delivered or performed
name	S	1..1	string	Description of service as presented to a consumer while searching
program	S	0..*	CodeableConcept	Programs that this service is applicable to
Documentation for this format

Terminology Bindings (Differential)

Path	Status	Usage	ValueSet	Version	Source
HealthcareService.category.​coding:ServiceCategory	Base	required	SDOHCC ValueSet Service Category	📦3.0.0-ballot	This IG
HealthcareService.category.​coding:SDOHCC	Base	required	SDOHCC ValueSet SDOH Category	📦3.0.0-ballot	This IG

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
HealthcareService		0..*	SDOHCCHealthcareService	The details of a healthcare service available at a location
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. Additional Bindings Purpose AllLanguages Max Binding
text		0..1	Narrative	Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained		0..*	Resource	Contained, inline Resources
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
extension:capacity-status		1..1	(Complex)	Is the service currently at capacity? URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionHealthcareServiceCapacityStatus
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
identifier	Σ	0..*	Identifier	External identifiers for this item
active	?!SΣ	1..1	boolean	Whether this HealthcareService record is in active use Fixed Value: true
providedBy	Σ	0..1	Reference(Organization)	Organization that provides this service
category	SΣ	1..*	CodeableConcept	Broad category of service being performed or delivered Binding: ServiceCategory (example): A category of the service(s) that could be provided.
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
Slices for coding	SΣ	1..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:$this
coding:ServiceCategory	SΣ	1..1	Coding	Code defined by a terminology system Binding: SDOHCC ValueSet Service Category (required)
coding:SDOHCC	SΣ	0..*	Coding	e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories.
text	Σ	0..1	string	Plain text representation of the concept
type	SΣ	1..1	CodeableConcept	Type of service that may be delivered or performed Binding: SDOHCC ValueSet Healthcare Service Type (extensible)
specialty	Σ	0..*	CodeableConcept	Specialties handled by the HealthcareService Binding: PracticeSettingCodeValueSet (preferred): A specialty that a healthcare service may provide.
location	SΣ	0..*	Reference(SDOHCC Location)	Location(s) where service may be provided
name	SΣ	1..1	string	Description of service as presented to a consumer while searching
comment	Σ	0..1	string	Additional description and/or any specific issues not covered elsewhere
extraDetails		0..1	markdown	Extra details about the service that can't be placed in the other fields
photo	Σ	0..1	Attachment	Facilitates quick identification of the service
Slices for telecom		1..*	ContactPoint	Contacts related to the healthcare service Slice: Unordered, Open by exists:extension('http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionHealthcareServiceTelecomAppointment')
telecom:AppointmentContact	S	1..*	ContactPoint	Contacts related to the healthcare service
id		0..1	string	Unique id for inter-element referencing
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
extension:ForAppointment	S	1..1	boolean	Telecom is for making appointments URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionHealthcareServiceTelecomAppointment
system	SΣC	1..1	code	phone | fax | email | pager | url | sms | other Binding: ContactPointSystem (required): Telecommunications form for contact point.
value	SΣ	1..1	string	The actual contact point details
use	?!Σ	0..1	code	home | work | temp | old | mobile - purpose of this contact point Binding: ContactPointUse (required): Use of contact point.
rank	Σ	0..1	positiveInt	Specify preferred order of use (1 = highest)
period	Σ	0..1	Period	Time period when the contact point was/is in use
coverageArea		0..*	Reference(Location)	Location(s) service is intended for/available to
serviceProvisionCode		0..*	CodeableConcept	Conditions under which service is available/offered Binding: ServiceProvisionConditions (example): The code(s) that detail the conditions under which the healthcare service is available/offered.
eligibility		0..*	BackboneElement	Specific eligibility requirements required to use the service
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		0..1	CodeableConcept	Coded value for the eligibility Binding Description: (example): Coded values underwhich a specific service is made available.
comment		0..1	markdown	Describes the eligibility conditions for the service
program	S	0..*	CodeableConcept	Programs that this service is applicable to Binding: Social Determinants of Health Programs SNOMED CT (extensible)
characteristic		0..*	CodeableConcept	Collection of characteristics (attributes) Binding Description: (example): A custom attribute that could be provided at a service (e.g. Wheelchair accessibiliy).
communication	S	0..*	CodeableConcept	The language that this service is offered in Binding: CommonLanguages (preferred): A human language. Additional Bindings Purpose AllLanguages Max Binding
referralMethod		0..*	CodeableConcept	Ways that the service accepts referrals Binding: ReferralMethod (example): The methods of referral can be used when referring to a specific HealthCareService resource.
appointmentRequired	S	0..1	boolean	If an appointment is required for access to this service
availableTime	S	0..*	BackboneElement	Times the Service Site is available
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
daysOfWeek		0..*	code	mon | tue | wed | thu | fri | sat | sun Binding: DaysOfWeek (required): The days of the week.
allDay		0..1	boolean	Always available? e.g. 24 hour service
availableStartTime		0..1	time	Opening time of day (ignored if allDay = true)
availableEndTime		0..1	time	Closing time of day (ignored if allDay = true)
notAvailable	S	0..*	BackboneElement	Not available during this time due to provided reason
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
description		1..1	string	Reason presented to the user explaining why time not available
during		0..1	Period	Service not available from this date
availabilityExceptions	S	0..1	string	Description of availability exceptions
endpoint		0..*	Reference(Endpoint)	Technical endpoints providing access to electronic services operated for the healthcare service
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
HealthcareService.language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
HealthcareService.category	Base	example	Service category	📍4.0.1	FHIR Std.
HealthcareService.category.​coding:ServiceCategory	Base	required	SDOHCC ValueSet Service Category	📦3.0.0-ballot	This IG
HealthcareService.category.​coding:SDOHCC	Base	required	SDOHCC ValueSet SDOH Category	📦3.0.0-ballot	This IG
HealthcareService.type	Base	extensible	SDOHCC ValueSet Healthcare Service Type	📦3.0.0-ballot	This IG
HealthcareService.specialty	Base	preferred	Practice Setting Code Value Set	📍4.0.1	FHIR Std.
HealthcareService.telecom:AppointmentContact.​system	Base	required	ContactPointSystem	📍4.0.1	FHIR Std.
HealthcareService.telecom:AppointmentContact.​use	Base	required	ContactPointUse	📍4.0.1	FHIR Std.
HealthcareService.serviceProvisionCode	Base	example	ServiceProvisionConditions	📍4.0.1	FHIR Std.
HealthcareService.eligibility.​code	Base	example		Not State	Unknown
HealthcareService.program	Base	extensible	Social Determinants of Health Programs SNOMED CT	📦20251018	VSAC v0.24
HealthcareService.characteristic	Base	example		Not State	Unknown
HealthcareService.communication	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
HealthcareService.referralMethod	Base	example	ReferralMethod	📍4.0.1	FHIR Std.
HealthcareService.availableTime.​daysOfWeek	Base	required	DaysOfWeek	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
dom-2	error	HealthcareService	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	HealthcareService	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	HealthcareService	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	HealthcareService	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	HealthcareService	A resource should have narrative for robust management	text.`div`.exists()
ele-1	error	**ALL** elements	All FHIR elements must have a @value or children	hasValue() or (children().count() > id.count())
ext-1	error	**ALL** extensions	Must have either extensions or value[x], not both	extension.exists() != value.exists()

Summary

Mandatory: 7 elements
Must-Support: 7 elements

Extensions

This structure refers to these extensions:

• http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionHealthcareServiceCapacityStatus

Slices

This structure defines the following Slices:

• The element 1 is sliced based on the value of HealthcareService.category.coding

Maturity: 2

Key Elements View

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
HealthcareService		0..*	SDOHCCHealthcareService	The details of a healthcare service available at a location
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
extension:capacity-status		1..1	(Complex)	Is the service currently at capacity? URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionHealthcareServiceCapacityStatus
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
active	?!SΣ	1..1	boolean	Whether this HealthcareService record is in active use Fixed Value: true
category	SΣ	1..*	CodeableConcept	Broad category of service being performed or delivered Binding: ServiceCategory (example): A category of the service(s) that could be provided.
Slices for coding	SΣ	1..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:$this
coding:ServiceCategory	SΣ	1..1	Coding	Code defined by a terminology system Binding: SDOHCC ValueSet Service Category (required)
coding:SDOHCC	SΣ	0..*	Coding	e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories.
type	SΣ	1..1	CodeableConcept	Type of service that may be delivered or performed Binding: SDOHCC ValueSet Healthcare Service Type (extensible)
location	SΣ	0..*	Reference(SDOHCC Location)	Location(s) where service may be provided
name	SΣ	1..1	string	Description of service as presented to a consumer while searching
Slices for telecom		1..*	ContactPoint	Contacts related to the healthcare service Slice: Unordered, Open by exists:extension('http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionHealthcareServiceTelecomAppointment')
telecom:AppointmentContact	S	1..*	ContactPoint	Contacts related to the healthcare service
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
extension:ForAppointment	S	1..1	boolean	Telecom is for making appointments URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionHealthcareServiceTelecomAppointment
system	SΣC	1..1	code	phone | fax | email | pager | url | sms | other Binding: ContactPointSystem (required): Telecommunications form for contact point.
value	SΣ	1..1	string	The actual contact point details
use	?!Σ	0..1	code	home | work | temp | old | mobile - purpose of this contact point Binding: ContactPointUse (required): Use of contact point.
program	S	0..*	CodeableConcept	Programs that this service is applicable to Binding: Social Determinants of Health Programs SNOMED CT (extensible)
communication	S	0..*	CodeableConcept	The language that this service is offered in Binding: CommonLanguages (preferred): A human language. Additional Bindings Purpose AllLanguages Max Binding
appointmentRequired	S	0..1	boolean	If an appointment is required for access to this service
availableTime	S	0..*	BackboneElement	Times the Service Site is available
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
notAvailable	S	0..*	BackboneElement	Not available during this time due to provided reason
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
description		1..1	string	Reason presented to the user explaining why time not available
availabilityExceptions	S	0..1	string	Description of availability exceptions
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
HealthcareService.category	Base	example	Service category	📍4.0.1	FHIR Std.
HealthcareService.category.​coding:ServiceCategory	Base	required	SDOHCC ValueSet Service Category	📦3.0.0-ballot	This IG
HealthcareService.category.​coding:SDOHCC	Base	required	SDOHCC ValueSet SDOH Category	📦3.0.0-ballot	This IG
HealthcareService.type	Base	extensible	SDOHCC ValueSet Healthcare Service Type	📦3.0.0-ballot	This IG
HealthcareService.telecom:AppointmentContact.​system	Base	required	ContactPointSystem	📍4.0.1	FHIR Std.
HealthcareService.telecom:AppointmentContact.​use	Base	required	ContactPointUse	📍4.0.1	FHIR Std.
HealthcareService.program	Base	extensible	Social Determinants of Health Programs SNOMED CT	📦20251018	VSAC v0.24
HealthcareService.communication	Base	preferred	Common Languages	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
dom-2	error	HealthcareService	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	HealthcareService	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	HealthcareService	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	HealthcareService	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	HealthcareService	A resource should have narrative for robust management	text.`div`.exists()
ele-1	error	**ALL** elements	All FHIR elements must have a @value or children	hasValue() or (children().count() > id.count())
ext-1	error	**ALL** extensions	Must have either extensions or value[x], not both	extension.exists() != value.exists()

Differential View

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
HealthcareService		0..*	SDOHCCHealthcareService	The details of a healthcare service available at a location
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
extension:capacity-status		1..1	(Complex)	Is the service currently at capacity? URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionHealthcareServiceCapacityStatus
category	S	1..*	CodeableConcept	Broad category of service being performed or delivered
Slices for coding	S	1..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:$this
coding:ServiceCategory	S	1..1	Coding	Code defined by a terminology system Binding: SDOHCC ValueSet Service Category (required)
coding:SDOHCC	S	0..*	Coding	e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories.
type	S	1..1	CodeableConcept	Type of service that may be delivered or performed
name	S	1..1	string	Description of service as presented to a consumer while searching
program	S	0..*	CodeableConcept	Programs that this service is applicable to
Documentation for this format

Terminology Bindings (Differential)

Path	Status	Usage	ValueSet	Version	Source
HealthcareService.category.​coding:ServiceCategory	Base	required	SDOHCC ValueSet Service Category	📦3.0.0-ballot	This IG
HealthcareService.category.​coding:SDOHCC	Base	required	SDOHCC ValueSet SDOH Category	📦3.0.0-ballot	This IG

Snapshot ViewView

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
HealthcareService		0..*	SDOHCCHealthcareService	The details of a healthcare service available at a location
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. Additional Bindings Purpose AllLanguages Max Binding
text		0..1	Narrative	Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained		0..*	Resource	Contained, inline Resources
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
extension:capacity-status		1..1	(Complex)	Is the service currently at capacity? URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionHealthcareServiceCapacityStatus
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
identifier	Σ	0..*	Identifier	External identifiers for this item
active	?!SΣ	1..1	boolean	Whether this HealthcareService record is in active use Fixed Value: true
providedBy	Σ	0..1	Reference(Organization)	Organization that provides this service
category	SΣ	1..*	CodeableConcept	Broad category of service being performed or delivered Binding: ServiceCategory (example): A category of the service(s) that could be provided.
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
Slices for coding	SΣ	1..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:$this
coding:ServiceCategory	SΣ	1..1	Coding	Code defined by a terminology system Binding: SDOHCC ValueSet Service Category (required)
coding:SDOHCC	SΣ	0..*	Coding	e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories.
text	Σ	0..1	string	Plain text representation of the concept
type	SΣ	1..1	CodeableConcept	Type of service that may be delivered or performed Binding: SDOHCC ValueSet Healthcare Service Type (extensible)
specialty	Σ	0..*	CodeableConcept	Specialties handled by the HealthcareService Binding: PracticeSettingCodeValueSet (preferred): A specialty that a healthcare service may provide.
location	SΣ	0..*	Reference(SDOHCC Location)	Location(s) where service may be provided
name	SΣ	1..1	string	Description of service as presented to a consumer while searching
comment	Σ	0..1	string	Additional description and/or any specific issues not covered elsewhere
extraDetails		0..1	markdown	Extra details about the service that can't be placed in the other fields
photo	Σ	0..1	Attachment	Facilitates quick identification of the service
Slices for telecom		1..*	ContactPoint	Contacts related to the healthcare service Slice: Unordered, Open by exists:extension('http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionHealthcareServiceTelecomAppointment')
telecom:AppointmentContact	S	1..*	ContactPoint	Contacts related to the healthcare service
id		0..1	string	Unique id for inter-element referencing
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
extension:ForAppointment	S	1..1	boolean	Telecom is for making appointments URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionHealthcareServiceTelecomAppointment
system	SΣC	1..1	code	phone | fax | email | pager | url | sms | other Binding: ContactPointSystem (required): Telecommunications form for contact point.
value	SΣ	1..1	string	The actual contact point details
use	?!Σ	0..1	code	home | work | temp | old | mobile - purpose of this contact point Binding: ContactPointUse (required): Use of contact point.
rank	Σ	0..1	positiveInt	Specify preferred order of use (1 = highest)
period	Σ	0..1	Period	Time period when the contact point was/is in use
coverageArea		0..*	Reference(Location)	Location(s) service is intended for/available to
serviceProvisionCode		0..*	CodeableConcept	Conditions under which service is available/offered Binding: ServiceProvisionConditions (example): The code(s) that detail the conditions under which the healthcare service is available/offered.
eligibility		0..*	BackboneElement	Specific eligibility requirements required to use the service
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		0..1	CodeableConcept	Coded value for the eligibility Binding Description: (example): Coded values underwhich a specific service is made available.
comment		0..1	markdown	Describes the eligibility conditions for the service
program	S	0..*	CodeableConcept	Programs that this service is applicable to Binding: Social Determinants of Health Programs SNOMED CT (extensible)
characteristic		0..*	CodeableConcept	Collection of characteristics (attributes) Binding Description: (example): A custom attribute that could be provided at a service (e.g. Wheelchair accessibiliy).
communication	S	0..*	CodeableConcept	The language that this service is offered in Binding: CommonLanguages (preferred): A human language. Additional Bindings Purpose AllLanguages Max Binding
referralMethod		0..*	CodeableConcept	Ways that the service accepts referrals Binding: ReferralMethod (example): The methods of referral can be used when referring to a specific HealthCareService resource.
appointmentRequired	S	0..1	boolean	If an appointment is required for access to this service
availableTime	S	0..*	BackboneElement	Times the Service Site is available
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
daysOfWeek		0..*	code	mon | tue | wed | thu | fri | sat | sun Binding: DaysOfWeek (required): The days of the week.
allDay		0..1	boolean	Always available? e.g. 24 hour service
availableStartTime		0..1	time	Opening time of day (ignored if allDay = true)
availableEndTime		0..1	time	Closing time of day (ignored if allDay = true)
notAvailable	S	0..*	BackboneElement	Not available during this time due to provided reason
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
description		1..1	string	Reason presented to the user explaining why time not available
during		0..1	Period	Service not available from this date
availabilityExceptions	S	0..1	string	Description of availability exceptions
endpoint		0..*	Reference(Endpoint)	Technical endpoints providing access to electronic services operated for the healthcare service
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
HealthcareService.language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
HealthcareService.category	Base	example	Service category	📍4.0.1	FHIR Std.
HealthcareService.category.​coding:ServiceCategory	Base	required	SDOHCC ValueSet Service Category	📦3.0.0-ballot	This IG
HealthcareService.category.​coding:SDOHCC	Base	required	SDOHCC ValueSet SDOH Category	📦3.0.0-ballot	This IG
HealthcareService.type	Base	extensible	SDOHCC ValueSet Healthcare Service Type	📦3.0.0-ballot	This IG
HealthcareService.specialty	Base	preferred	Practice Setting Code Value Set	📍4.0.1	FHIR Std.
HealthcareService.telecom:AppointmentContact.​system	Base	required	ContactPointSystem	📍4.0.1	FHIR Std.
HealthcareService.telecom:AppointmentContact.​use	Base	required	ContactPointUse	📍4.0.1	FHIR Std.
HealthcareService.serviceProvisionCode	Base	example	ServiceProvisionConditions	📍4.0.1	FHIR Std.
HealthcareService.eligibility.​code	Base	example		Not State	Unknown
HealthcareService.program	Base	extensible	Social Determinants of Health Programs SNOMED CT	📦20251018	VSAC v0.24
HealthcareService.characteristic	Base	example		Not State	Unknown
HealthcareService.communication	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
HealthcareService.referralMethod	Base	example	ReferralMethod	📍4.0.1	FHIR Std.
HealthcareService.availableTime.​daysOfWeek	Base	required	DaysOfWeek	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
dom-2	error	HealthcareService	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	HealthcareService	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	HealthcareService	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	HealthcareService	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	HealthcareService	A resource should have narrative for robust management	text.`div`.exists()
ele-1	error	**ALL** elements	All FHIR elements must have a @value or children	hasValue() or (children().count() > id.count())
ext-1	error	**ALL** extensions	Must have either extensions or value[x], not both	extension.exists() != value.exists()

Summary

Mandatory: 7 elements
Must-Support: 7 elements

Extensions

This structure refers to these extensions:

• http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ExtensionHealthcareServiceCapacityStatus

Slices

This structure defines the following Slices:

• The element 1 is sliced based on the value of HealthcareService.category.coding

Maturity: 2

Other representations of profile: CSV, Excel, Schematron