National Directory of Healthcare Providers & Services (NDH) Implementation Guide
1.0.0-ballot - ballot United States of America flag

National Directory of Healthcare Providers & Services (NDH) Implementation Guide, published by HL7 International / Patient Administration. This guide is not an authorized publication; it is the continuous build for version 1.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-us-ndh/ and changes regularly. See the Directory of published versions

Resource Profile: NDH Base HealthcareService Profile

Official URL: http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-HealthcareService Version: 1.0.0-ballot
Active as of 2024-03-28 Computable Name: NdhHealthcareService

Copyright/Legal: HL7 International

The HealthCareService resource typically describes services offered by an organization/practitioner at a location. The resource may be used to encompass a variety of services covering the entire healthcare spectrum, including promotion, prevention, diagnostics, pharmacy, hospital and ambulatory care, home care, long-term care, and other health-related and community services.

Usage:

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

This structure is derived from HealthcareService

NameFlagsCard.TypeDescription & Constraintsdoco
.. HealthcareService HealthcareService
... meta
.... lastUpdated 1..1instantWhen the resource version last changed
... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... rating 0..*(Complex)Evaluations or reviews for the service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-rating
... newpatients 0..*(Complex)Is the service currently accepting new patients?
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-newpatients
... deliverymethod 0..*(Complex)Method of providing the service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-delivery-method
... paymentaccepted 0..*CodeableConceptForms of payment accepted.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-paymentAccepted
Binding: hl7VS-paymentMethodCode (required)
... requiredDocument 0..*(Complex)Documents required for the service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-requiredDocument
... fundingSource 0..*(Complex)Funding source for the service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-fundingSource
... usage-restriction 0..*Reference(NDH Base Restriction) {c}Usage Restriction
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-usage-restriction
... verification-status 0..1CodeableConceptVerification Status
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-verification-status
Binding: NDH Verification Status Value Set (extensible)
... network 0..*Reference(NDH Base Network Profile)Network associated with social service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-network-reference
... social-service-requirement 0..*(Complex)Social Service Requirement
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-service-or-program-requirement
... logo 0..1AttachmentService Logo
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-logo
... identifier
.... identifier-status 0..1codeIdentifier Status
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-identifier-status
Binding: Identifier Status Value Set (required)
.... assigner 0..1Reference(NDH Base Organization Profile)Organization that issued id (may be just text)
... active S1..1booleanWhether this HealthcareService record is in active use
Required Pattern: true
... providedBy S0..1Reference(NDH Base Organization Profile)Organization that provides this service
... Slices for category S1..*CodeableConceptBroad category of service being performed or delivered
Slice: Unordered, Open by pattern:$this
.... category:HSC S0..1CodeableConceptNDH HealthcareService Category
Binding: Healthcare Service Category Value Set (required)
... type S0..*CodeableConceptType of service that may be delivered or performed
Binding: HealthcareService Type Value Set (extensible)
... specialty S0..*CodeableConceptSpecialties handled by the HealthcareService
Binding: Healthcare Provider Taxonomy . (extensible)
... location S0..*Reference(NDH Base Location Profile)Location(s) where service may be provided
... name S0..1stringDescription of service as presented to a consumer while searching
... telecom
.... contactpoint-availabletime 0..*(Complex)Availability Hours for the Contact Point
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-contactpoint-availabletime
.... via-intermediary 0..1Reference(NDH Base PractitionerRole | NDH Base OrganizationAffiliation Profile | NDH Base Location Profile | NDH Base Organization Profile)Via Intermediary
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-via-intermediary
.... language-speak 0..*codeLanguage Speak
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-language-speak
Binding: CommonLanguages (extensible)
... coverageArea S0..*Reference(NDH Base Location Profile)Location(s) service is intended for/available to
... serviceProvisionCode 0..*CodeableConceptConditions under which service is available/offered
Binding: ServiceProvisionConditions (extensible)
... eligibility
.... code 0..1CodeableConceptCoded value for the eligibility
Binding: Healthcare Service Eligibility Code Value Set (extensible)
... program 0..*CodeableConceptPrograms that this service is applicable to
Binding: Program (extensible)
.... program-requirement 0..*(Complex)Program Requirement
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-service-or-program-requirement
... referralMethod 0..*CodeableConceptWays that the service accepts referrals
Binding: Healthcare Service Referral Method Value Set (extensible)
... endpoint S0..*Reference(NDH Base Endpoint Profile)Technical endpoints providing access to electronic services operated for the healthcare service

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSetURI
HealthcareService.category:HSCrequiredHealthcareServiceCategoryVS (a valid code from Healthcare Service Category Code System)
http://hl7.org/fhir/us/ndh/ValueSet/HealthcareServiceCategoryVS
from this IG
HealthcareService.typeextensibleHealthcareServiceTypeVS
http://hl7.org/fhir/us/ndh/ValueSet/HealthcareServiceTypeVS
from this IG
HealthcareService.specialtyextensibleHealthcareProviderTaxonomy . (a valid code from http://nucc.org/provider-taxonomy)
http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.114222.4.11.1066
HealthcareService.serviceProvisionCodeextensibleServiceProvisionConditions
http://hl7.org/fhir/ValueSet/service-provision-conditions
from the FHIR Standard
HealthcareService.eligibility.codeextensibleHealthcareServiceEligibilityCodeVS
http://hl7.org/fhir/us/ndh/ValueSet/HealthcareServiceEligibilityCodeVS
from this IG
HealthcareService.programextensibleProgram
http://hl7.org/fhir/ValueSet/program
from the FHIR Standard
HealthcareService.referralMethodextensibleHealthcareServiceReferralMethodVS (a valid code from Healthcare Service Referral Method Code System)
http://hl7.org/fhir/us/ndh/ValueSet/HealthcareServiceReferralMethodVS
from this IG
NameFlagsCard.TypeDescription & Constraintsdoco
.. HealthcareService 0..*HealthcareServiceThe details of a healthcare service available at a location
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... rating 0..*(Complex)Evaluations or reviews for the service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-rating
... deliverymethod 0..*(Complex)Method of providing the service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-delivery-method
... paymentaccepted 0..*CodeableConceptForms of payment accepted.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-paymentAccepted
Binding: hl7VS-paymentMethodCode (required)
... requiredDocument 0..*(Complex)Documents required for the service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-requiredDocument
... fundingSource 0..*(Complex)Funding source for the service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-fundingSource
... usage-restriction 0..*Reference(NDH Base Restriction) {c}Usage Restriction
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-usage-restriction
... verification-status 0..1CodeableConceptVerification Status
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-verification-status
Binding: NDH Verification Status Value Set (extensible)
... network 0..*Reference(NDH Base Network Profile)Network associated with social service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-network-reference
... social-service-requirement C0..*(Complex)Social Service Requirement
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-service-or-program-requirement
agerange-or-agegroup: a service or program only allow to have either age-range or age-group but not both
... logo 0..1AttachmentService Logo
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-logo
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... active ?!SΣ1..1booleanWhether this HealthcareService record is in active use
Required Pattern: true
... providedBy SΣ0..1Reference(NDH Base Organization Profile)Organization that provides this service
... Slices for category SΣ1..*CodeableConceptBroad category of service being performed or delivered
Slice: Unordered, Open by pattern:$this
Binding: ServiceCategory (example): A category of the service(s) that could be provided.


.... category:HSC SΣ0..1CodeableConceptNDH HealthcareService Category
Binding: Healthcare Service Category Value Set (required)
... type SΣ0..*CodeableConceptType of service that may be delivered or performed
Binding: HealthcareService Type Value Set (extensible)
... specialty SΣ0..*CodeableConceptSpecialties handled by the HealthcareService
Binding: Healthcare Provider Taxonomy . (extensible)
... location SΣ0..*Reference(NDH Base Location Profile)Location(s) where service may be provided
... name SΣ0..1stringDescription of service as presented to a consumer while searching
... coverageArea S0..*Reference(NDH Base Location Profile)Location(s) service is intended for/available to
... serviceProvisionCode 0..*CodeableConceptConditions under which service is available/offered
Binding: ServiceProvisionConditions (extensible)
... program 0..*CodeableConceptPrograms that this service is applicable to
Binding: Program (extensible)
.... program-requirement 0..*(Complex)Program Requirement
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-service-or-program-requirement
... referralMethod 0..*CodeableConceptWays that the service accepts referrals
Binding: Healthcare Service Referral Method Value Set (extensible)
... endpoint S0..*Reference(NDH Base Endpoint Profile)Technical endpoints providing access to electronic services operated for the healthcare service

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
HealthcareService.categoryexampleServiceCategory
http://hl7.org/fhir/ValueSet/service-category
from the FHIR Standard
HealthcareService.category:HSCrequiredHealthcareServiceCategoryVS (a valid code from Healthcare Service Category Code System)
http://hl7.org/fhir/us/ndh/ValueSet/HealthcareServiceCategoryVS
from this IG
HealthcareService.typeextensibleHealthcareServiceTypeVS
http://hl7.org/fhir/us/ndh/ValueSet/HealthcareServiceTypeVS
from this IG
HealthcareService.specialtyextensibleHealthcareProviderTaxonomy . (a valid code from http://nucc.org/provider-taxonomy)
http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.114222.4.11.1066
HealthcareService.serviceProvisionCodeextensibleServiceProvisionConditions
http://hl7.org/fhir/ValueSet/service-provision-conditions
from the FHIR Standard
HealthcareService.programextensibleProgram
http://hl7.org/fhir/ValueSet/program
from the FHIR Standard
HealthcareService.referralMethodextensibleHealthcareServiceReferralMethodVS (a valid code from Healthcare Service Referral Method Code System)
http://hl7.org/fhir/us/ndh/ValueSet/HealthcareServiceReferralMethodVS
from this IG
NameFlagsCard.TypeDescription & Constraintsdoco
.. HealthcareService 0..*HealthcareServiceThe details of a healthcare service available at a location
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... versionId Σ0..1idVersion specific identifier
.... lastUpdated Σ1..1instantWhen the resource version last changed
.... source Σ0..1uriIdentifies where the resource comes from
.... profile Σ0..*canonical(StructureDefinition)Profiles this resource claims to conform to
.... security Σ0..*CodingSecurity Labels applied to this resource
Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System.


.... tag Σ0..*CodingTags 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..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: CommonLanguages (preferred): A human language.

Additional BindingsPurpose
AllLanguagesMax Binding
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... rating 0..*(Complex)Evaluations or reviews for the service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-rating
... newpatients C0..*(Complex)Is the service currently accepting new patients?
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-newpatients
new-patients-characteristics: If no new patients are accepted, no characteristics are allowed
... deliverymethod 0..*(Complex)Method of providing the service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-delivery-method
... paymentaccepted 0..*CodeableConceptForms of payment accepted.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-paymentAccepted
Binding: hl7VS-paymentMethodCode (required)
... requiredDocument 0..*(Complex)Documents required for the service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-requiredDocument
... fundingSource 0..*(Complex)Funding source for the service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-fundingSource
... usage-restriction 0..*Reference(NDH Base Restriction) {c}Usage Restriction
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-usage-restriction
... verification-status 0..1CodeableConceptVerification Status
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-verification-status
Binding: NDH Verification Status Value Set (extensible)
... network 0..*Reference(NDH Base Network Profile)Network associated with social service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-network-reference
... social-service-requirement C0..*(Complex)Social Service Requirement
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-service-or-program-requirement
agerange-or-agegroup: a service or program only allow to have either age-range or age-group but not both
... logo 0..1AttachmentService Logo
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-logo
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier Σ0..*IdentifierExternal identifiers for this item
.... id 0..1stringUnique id for inter-element referencing
.... Slices for extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... identifier-status 0..1codeIdentifier Status
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-identifier-status
Binding: Identifier Status Value Set (required)
.... use ?!Σ0..1codeusual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .

.... type Σ0..1CodeableConceptDescription of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

.... system Σ0..1uriThe namespace for the identifier value
Example General: http://www.acme.com/identifiers/patient
.... value Σ0..1stringThe value that is unique
Example General: 123456
.... period Σ0..1PeriodTime period when id is/was valid for use
.... assigner Σ0..1Reference(NDH Base Organization Profile)Organization that issued id (may be just text)
... active ?!SΣ1..1booleanWhether this HealthcareService record is in active use
Required Pattern: true
... providedBy SΣ0..1Reference(NDH Base Organization Profile)Organization that provides this service
... Slices for category SΣ1..*CodeableConceptBroad category of service being performed or delivered
Slice: Unordered, Open by pattern:$this
Binding: ServiceCategory (example): A category of the service(s) that could be provided.


.... category:HSC SΣ0..1CodeableConceptNDH HealthcareService Category
Binding: Healthcare Service Category Value Set (required)
... type SΣ0..*CodeableConceptType of service that may be delivered or performed
Binding: HealthcareService Type Value Set (extensible)
... specialty SΣ0..*CodeableConceptSpecialties handled by the HealthcareService
Binding: Healthcare Provider Taxonomy . (extensible)
... location SΣ0..*Reference(NDH Base Location Profile)Location(s) where service may be provided
... name SΣ0..1stringDescription of service as presented to a consumer while searching
... comment Σ0..1stringAdditional description and/or any specific issues not covered elsewhere
... extraDetails 0..1markdownExtra details about the service that can't be placed in the other fields
... photo Σ0..1AttachmentFacilitates quick identification of the service
... telecom 0..*ContactPointContacts related to the healthcare service
.... id 0..1stringUnique id for inter-element referencing
.... Slices for extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... contactpoint-availabletime 0..*(Complex)Availability Hours for the Contact Point
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-contactpoint-availabletime
.... via-intermediary 0..1Reference(NDH Base PractitionerRole | NDH Base OrganizationAffiliation Profile | NDH Base Location Profile | NDH Base Organization Profile)Via Intermediary
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-via-intermediary
.... language-speak 0..*codeLanguage Speak
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-language-speak
Binding: CommonLanguages (extensible)
.... system ΣC0..1codephone | fax | email | pager | url | sms | other
Binding: ContactPointSystem (required): Telecommunications form for contact point.

.... value Σ0..1stringThe actual contact point details
.... use ?!Σ0..1codehome | work | temp | old | mobile - purpose of this contact point
Binding: ContactPointUse (required): Use of contact point.

.... rank Σ0..1positiveIntSpecify preferred order of use (1 = highest)
.... period Σ0..1PeriodTime period when the contact point was/is in use
... coverageArea S0..*Reference(NDH Base Location Profile)Location(s) service is intended for/available to
... serviceProvisionCode 0..*CodeableConceptConditions under which service is available/offered
Binding: ServiceProvisionConditions (extensible)
... eligibility 0..*BackboneElementSpecific eligibility requirements required to use the service
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... code 0..1CodeableConceptCoded value for the eligibility
Binding: Healthcare Service Eligibility Code Value Set (extensible)
.... comment 0..1markdownDescribes the eligibility conditions for the service
... program 0..*CodeableConceptPrograms that this service is applicable to
Binding: Program (extensible)
.... id 0..1stringUnique id for inter-element referencing
.... Slices for extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... program-requirement 0..*(Complex)Program Requirement
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-service-or-program-requirement
.... coding Σ0..*CodingCode defined by a terminology system
.... text Σ0..1stringPlain text representation of the concept
... characteristic 0..*CodeableConceptCollection of characteristics (attributes)
Binding: (unbound) (example): A custom attribute that could be provided at a service (e.g. Wheelchair accessibiliy).


... communication 0..*CodeableConceptThe language that this service is offered in
Binding: CommonLanguages (preferred): A human language.

Additional BindingsPurpose
AllLanguagesMax Binding

... referralMethod 0..*CodeableConceptWays that the service accepts referrals
Binding: Healthcare Service Referral Method Value Set (extensible)
... appointmentRequired 0..1booleanIf an appointment is required for access to this service
... availableTime 0..*BackboneElementTimes the Service Site is available
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... daysOfWeek 0..*codemon | tue | wed | thu | fri | sat | sun
Binding: DaysOfWeek (required): The days of the week.


.... allDay 0..1booleanAlways available? e.g. 24 hour service
.... availableStartTime 0..1timeOpening time of day (ignored if allDay = true)
.... availableEndTime 0..1timeClosing time of day (ignored if allDay = true)
... notAvailable 0..*BackboneElementNot available during this time due to provided reason
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... description 1..1stringReason presented to the user explaining why time not available
.... during 0..1PeriodService not available from this date
... availabilityExceptions 0..1stringDescription of availability exceptions
... endpoint S0..*Reference(NDH Base Endpoint Profile)Technical endpoints providing access to electronic services operated for the healthcare service

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
HealthcareService.meta.securityextensibleAll Security Labels
http://hl7.org/fhir/ValueSet/security-labels
from the FHIR Standard
HealthcareService.meta.tagexampleCommonTags
http://hl7.org/fhir/ValueSet/common-tags
from the FHIR Standard
HealthcareService.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
http://hl7.org/fhir/ValueSet/languages
from the FHIR Standard
HealthcareService.identifier.userequiredIdentifierUse
http://hl7.org/fhir/ValueSet/identifier-use|4.0.1
from the FHIR Standard
HealthcareService.identifier.typeextensibleIdentifier Type Codes
http://hl7.org/fhir/ValueSet/identifier-type
from the FHIR Standard
HealthcareService.categoryexampleServiceCategory
http://hl7.org/fhir/ValueSet/service-category
from the FHIR Standard
HealthcareService.category:HSCrequiredHealthcareServiceCategoryVS (a valid code from Healthcare Service Category Code System)
http://hl7.org/fhir/us/ndh/ValueSet/HealthcareServiceCategoryVS
from this IG
HealthcareService.typeextensibleHealthcareServiceTypeVS
http://hl7.org/fhir/us/ndh/ValueSet/HealthcareServiceTypeVS
from this IG
HealthcareService.specialtyextensibleHealthcareProviderTaxonomy . (a valid code from http://nucc.org/provider-taxonomy)
http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.114222.4.11.1066
HealthcareService.telecom.systemrequiredContactPointSystem
http://hl7.org/fhir/ValueSet/contact-point-system|4.0.1
from the FHIR Standard
HealthcareService.telecom.userequiredContactPointUse
http://hl7.org/fhir/ValueSet/contact-point-use|4.0.1
from the FHIR Standard
HealthcareService.serviceProvisionCodeextensibleServiceProvisionConditions
http://hl7.org/fhir/ValueSet/service-provision-conditions
from the FHIR Standard
HealthcareService.eligibility.codeextensibleHealthcareServiceEligibilityCodeVS
http://hl7.org/fhir/us/ndh/ValueSet/HealthcareServiceEligibilityCodeVS
from this IG
HealthcareService.programextensibleProgram
http://hl7.org/fhir/ValueSet/program
from the FHIR Standard
HealthcareService.characteristicexample
HealthcareService.communicationpreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
http://hl7.org/fhir/ValueSet/languages
from the FHIR Standard
HealthcareService.referralMethodextensibleHealthcareServiceReferralMethodVS (a valid code from Healthcare Service Referral Method Code System)
http://hl7.org/fhir/us/ndh/ValueSet/HealthcareServiceReferralMethodVS
from this IG
HealthcareService.availableTime.daysOfWeekrequiredDaysOfWeek
http://hl7.org/fhir/ValueSet/days-of-week|4.0.1
from the FHIR Standard

This structure is derived from HealthcareService

Summary

Mandatory: 2 elements (1 nested mandatory element)
Must-Support: 10 elements

Structures

This structure refers to these other structures:

Extensions

This structure refers to these extensions:

Slices

This structure defines the following Slices:

  • The element HealthcareService.category is sliced based on the value of pattern:$this

Differential View

This structure is derived from HealthcareService

NameFlagsCard.TypeDescription & Constraintsdoco
.. HealthcareService HealthcareService
... meta
.... lastUpdated 1..1instantWhen the resource version last changed
... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... rating 0..*(Complex)Evaluations or reviews for the service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-rating
... newpatients 0..*(Complex)Is the service currently accepting new patients?
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-newpatients
... deliverymethod 0..*(Complex)Method of providing the service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-delivery-method
... paymentaccepted 0..*CodeableConceptForms of payment accepted.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-paymentAccepted
Binding: hl7VS-paymentMethodCode (required)
... requiredDocument 0..*(Complex)Documents required for the service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-requiredDocument
... fundingSource 0..*(Complex)Funding source for the service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-fundingSource
... usage-restriction 0..*Reference(NDH Base Restriction) {c}Usage Restriction
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-usage-restriction
... verification-status 0..1CodeableConceptVerification Status
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-verification-status
Binding: NDH Verification Status Value Set (extensible)
... network 0..*Reference(NDH Base Network Profile)Network associated with social service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-network-reference
... social-service-requirement 0..*(Complex)Social Service Requirement
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-service-or-program-requirement
... logo 0..1AttachmentService Logo
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-logo
... identifier
.... identifier-status 0..1codeIdentifier Status
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-identifier-status
Binding: Identifier Status Value Set (required)
.... assigner 0..1Reference(NDH Base Organization Profile)Organization that issued id (may be just text)
... active S1..1booleanWhether this HealthcareService record is in active use
Required Pattern: true
... providedBy S0..1Reference(NDH Base Organization Profile)Organization that provides this service
... Slices for category S1..*CodeableConceptBroad category of service being performed or delivered
Slice: Unordered, Open by pattern:$this
.... category:HSC S0..1CodeableConceptNDH HealthcareService Category
Binding: Healthcare Service Category Value Set (required)
... type S0..*CodeableConceptType of service that may be delivered or performed
Binding: HealthcareService Type Value Set (extensible)
... specialty S0..*CodeableConceptSpecialties handled by the HealthcareService
Binding: Healthcare Provider Taxonomy . (extensible)
... location S0..*Reference(NDH Base Location Profile)Location(s) where service may be provided
... name S0..1stringDescription of service as presented to a consumer while searching
... telecom
.... contactpoint-availabletime 0..*(Complex)Availability Hours for the Contact Point
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-contactpoint-availabletime
.... via-intermediary 0..1Reference(NDH Base PractitionerRole | NDH Base OrganizationAffiliation Profile | NDH Base Location Profile | NDH Base Organization Profile)Via Intermediary
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-via-intermediary
.... language-speak 0..*codeLanguage Speak
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-language-speak
Binding: CommonLanguages (extensible)
... coverageArea S0..*Reference(NDH Base Location Profile)Location(s) service is intended for/available to
... serviceProvisionCode 0..*CodeableConceptConditions under which service is available/offered
Binding: ServiceProvisionConditions (extensible)
... eligibility
.... code 0..1CodeableConceptCoded value for the eligibility
Binding: Healthcare Service Eligibility Code Value Set (extensible)
... program 0..*CodeableConceptPrograms that this service is applicable to
Binding: Program (extensible)
.... program-requirement 0..*(Complex)Program Requirement
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-service-or-program-requirement
... referralMethod 0..*CodeableConceptWays that the service accepts referrals
Binding: Healthcare Service Referral Method Value Set (extensible)
... endpoint S0..*Reference(NDH Base Endpoint Profile)Technical endpoints providing access to electronic services operated for the healthcare service

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSetURI
HealthcareService.category:HSCrequiredHealthcareServiceCategoryVS (a valid code from Healthcare Service Category Code System)
http://hl7.org/fhir/us/ndh/ValueSet/HealthcareServiceCategoryVS
from this IG
HealthcareService.typeextensibleHealthcareServiceTypeVS
http://hl7.org/fhir/us/ndh/ValueSet/HealthcareServiceTypeVS
from this IG
HealthcareService.specialtyextensibleHealthcareProviderTaxonomy . (a valid code from http://nucc.org/provider-taxonomy)
http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.114222.4.11.1066
HealthcareService.serviceProvisionCodeextensibleServiceProvisionConditions
http://hl7.org/fhir/ValueSet/service-provision-conditions
from the FHIR Standard
HealthcareService.eligibility.codeextensibleHealthcareServiceEligibilityCodeVS
http://hl7.org/fhir/us/ndh/ValueSet/HealthcareServiceEligibilityCodeVS
from this IG
HealthcareService.programextensibleProgram
http://hl7.org/fhir/ValueSet/program
from the FHIR Standard
HealthcareService.referralMethodextensibleHealthcareServiceReferralMethodVS (a valid code from Healthcare Service Referral Method Code System)
http://hl7.org/fhir/us/ndh/ValueSet/HealthcareServiceReferralMethodVS
from this IG

Key Elements View

NameFlagsCard.TypeDescription & Constraintsdoco
.. HealthcareService 0..*HealthcareServiceThe details of a healthcare service available at a location
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... rating 0..*(Complex)Evaluations or reviews for the service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-rating
... deliverymethod 0..*(Complex)Method of providing the service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-delivery-method
... paymentaccepted 0..*CodeableConceptForms of payment accepted.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-paymentAccepted
Binding: hl7VS-paymentMethodCode (required)
... requiredDocument 0..*(Complex)Documents required for the service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-requiredDocument
... fundingSource 0..*(Complex)Funding source for the service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-fundingSource
... usage-restriction 0..*Reference(NDH Base Restriction) {c}Usage Restriction
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-usage-restriction
... verification-status 0..1CodeableConceptVerification Status
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-verification-status
Binding: NDH Verification Status Value Set (extensible)
... network 0..*Reference(NDH Base Network Profile)Network associated with social service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-network-reference
... social-service-requirement C0..*(Complex)Social Service Requirement
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-service-or-program-requirement
agerange-or-agegroup: a service or program only allow to have either age-range or age-group but not both
... logo 0..1AttachmentService Logo
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-logo
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... active ?!SΣ1..1booleanWhether this HealthcareService record is in active use
Required Pattern: true
... providedBy SΣ0..1Reference(NDH Base Organization Profile)Organization that provides this service
... Slices for category SΣ1..*CodeableConceptBroad category of service being performed or delivered
Slice: Unordered, Open by pattern:$this
Binding: ServiceCategory (example): A category of the service(s) that could be provided.


.... category:HSC SΣ0..1CodeableConceptNDH HealthcareService Category
Binding: Healthcare Service Category Value Set (required)
... type SΣ0..*CodeableConceptType of service that may be delivered or performed
Binding: HealthcareService Type Value Set (extensible)
... specialty SΣ0..*CodeableConceptSpecialties handled by the HealthcareService
Binding: Healthcare Provider Taxonomy . (extensible)
... location SΣ0..*Reference(NDH Base Location Profile)Location(s) where service may be provided
... name SΣ0..1stringDescription of service as presented to a consumer while searching
... coverageArea S0..*Reference(NDH Base Location Profile)Location(s) service is intended for/available to
... serviceProvisionCode 0..*CodeableConceptConditions under which service is available/offered
Binding: ServiceProvisionConditions (extensible)
... program 0..*CodeableConceptPrograms that this service is applicable to
Binding: Program (extensible)
.... program-requirement 0..*(Complex)Program Requirement
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-service-or-program-requirement
... referralMethod 0..*CodeableConceptWays that the service accepts referrals
Binding: Healthcare Service Referral Method Value Set (extensible)
... endpoint S0..*Reference(NDH Base Endpoint Profile)Technical endpoints providing access to electronic services operated for the healthcare service

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
HealthcareService.categoryexampleServiceCategory
http://hl7.org/fhir/ValueSet/service-category
from the FHIR Standard
HealthcareService.category:HSCrequiredHealthcareServiceCategoryVS (a valid code from Healthcare Service Category Code System)
http://hl7.org/fhir/us/ndh/ValueSet/HealthcareServiceCategoryVS
from this IG
HealthcareService.typeextensibleHealthcareServiceTypeVS
http://hl7.org/fhir/us/ndh/ValueSet/HealthcareServiceTypeVS
from this IG
HealthcareService.specialtyextensibleHealthcareProviderTaxonomy . (a valid code from http://nucc.org/provider-taxonomy)
http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.114222.4.11.1066
HealthcareService.serviceProvisionCodeextensibleServiceProvisionConditions
http://hl7.org/fhir/ValueSet/service-provision-conditions
from the FHIR Standard
HealthcareService.programextensibleProgram
http://hl7.org/fhir/ValueSet/program
from the FHIR Standard
HealthcareService.referralMethodextensibleHealthcareServiceReferralMethodVS (a valid code from Healthcare Service Referral Method Code System)
http://hl7.org/fhir/us/ndh/ValueSet/HealthcareServiceReferralMethodVS
from this IG

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. HealthcareService 0..*HealthcareServiceThe details of a healthcare service available at a location
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... versionId Σ0..1idVersion specific identifier
.... lastUpdated Σ1..1instantWhen the resource version last changed
.... source Σ0..1uriIdentifies where the resource comes from
.... profile Σ0..*canonical(StructureDefinition)Profiles this resource claims to conform to
.... security Σ0..*CodingSecurity Labels applied to this resource
Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System.


.... tag Σ0..*CodingTags 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..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: CommonLanguages (preferred): A human language.

Additional BindingsPurpose
AllLanguagesMax Binding
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... rating 0..*(Complex)Evaluations or reviews for the service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-rating
... newpatients C0..*(Complex)Is the service currently accepting new patients?
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-newpatients
new-patients-characteristics: If no new patients are accepted, no characteristics are allowed
... deliverymethod 0..*(Complex)Method of providing the service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-delivery-method
... paymentaccepted 0..*CodeableConceptForms of payment accepted.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-paymentAccepted
Binding: hl7VS-paymentMethodCode (required)
... requiredDocument 0..*(Complex)Documents required for the service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-requiredDocument
... fundingSource 0..*(Complex)Funding source for the service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-fundingSource
... usage-restriction 0..*Reference(NDH Base Restriction) {c}Usage Restriction
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-usage-restriction
... verification-status 0..1CodeableConceptVerification Status
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-verification-status
Binding: NDH Verification Status Value Set (extensible)
... network 0..*Reference(NDH Base Network Profile)Network associated with social service.
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-network-reference
... social-service-requirement C0..*(Complex)Social Service Requirement
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-service-or-program-requirement
agerange-or-agegroup: a service or program only allow to have either age-range or age-group but not both
... logo 0..1AttachmentService Logo
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-logo
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier Σ0..*IdentifierExternal identifiers for this item
.... id 0..1stringUnique id for inter-element referencing
.... Slices for extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... identifier-status 0..1codeIdentifier Status
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-identifier-status
Binding: Identifier Status Value Set (required)
.... use ?!Σ0..1codeusual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .

.... type Σ0..1CodeableConceptDescription of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

.... system Σ0..1uriThe namespace for the identifier value
Example General: http://www.acme.com/identifiers/patient
.... value Σ0..1stringThe value that is unique
Example General: 123456
.... period Σ0..1PeriodTime period when id is/was valid for use
.... assigner Σ0..1Reference(NDH Base Organization Profile)Organization that issued id (may be just text)
... active ?!SΣ1..1booleanWhether this HealthcareService record is in active use
Required Pattern: true
... providedBy SΣ0..1Reference(NDH Base Organization Profile)Organization that provides this service
... Slices for category SΣ1..*CodeableConceptBroad category of service being performed or delivered
Slice: Unordered, Open by pattern:$this
Binding: ServiceCategory (example): A category of the service(s) that could be provided.


.... category:HSC SΣ0..1CodeableConceptNDH HealthcareService Category
Binding: Healthcare Service Category Value Set (required)
... type SΣ0..*CodeableConceptType of service that may be delivered or performed
Binding: HealthcareService Type Value Set (extensible)
... specialty SΣ0..*CodeableConceptSpecialties handled by the HealthcareService
Binding: Healthcare Provider Taxonomy . (extensible)
... location SΣ0..*Reference(NDH Base Location Profile)Location(s) where service may be provided
... name SΣ0..1stringDescription of service as presented to a consumer while searching
... comment Σ0..1stringAdditional description and/or any specific issues not covered elsewhere
... extraDetails 0..1markdownExtra details about the service that can't be placed in the other fields
... photo Σ0..1AttachmentFacilitates quick identification of the service
... telecom 0..*ContactPointContacts related to the healthcare service
.... id 0..1stringUnique id for inter-element referencing
.... Slices for extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... contactpoint-availabletime 0..*(Complex)Availability Hours for the Contact Point
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-contactpoint-availabletime
.... via-intermediary 0..1Reference(NDH Base PractitionerRole | NDH Base OrganizationAffiliation Profile | NDH Base Location Profile | NDH Base Organization Profile)Via Intermediary
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-via-intermediary
.... language-speak 0..*codeLanguage Speak
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-language-speak
Binding: CommonLanguages (extensible)
.... system ΣC0..1codephone | fax | email | pager | url | sms | other
Binding: ContactPointSystem (required): Telecommunications form for contact point.

.... value Σ0..1stringThe actual contact point details
.... use ?!Σ0..1codehome | work | temp | old | mobile - purpose of this contact point
Binding: ContactPointUse (required): Use of contact point.

.... rank Σ0..1positiveIntSpecify preferred order of use (1 = highest)
.... period Σ0..1PeriodTime period when the contact point was/is in use
... coverageArea S0..*Reference(NDH Base Location Profile)Location(s) service is intended for/available to
... serviceProvisionCode 0..*CodeableConceptConditions under which service is available/offered
Binding: ServiceProvisionConditions (extensible)
... eligibility 0..*BackboneElementSpecific eligibility requirements required to use the service
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... code 0..1CodeableConceptCoded value for the eligibility
Binding: Healthcare Service Eligibility Code Value Set (extensible)
.... comment 0..1markdownDescribes the eligibility conditions for the service
... program 0..*CodeableConceptPrograms that this service is applicable to
Binding: Program (extensible)
.... id 0..1stringUnique id for inter-element referencing
.... Slices for extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... program-requirement 0..*(Complex)Program Requirement
URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-service-or-program-requirement
.... coding Σ0..*CodingCode defined by a terminology system
.... text Σ0..1stringPlain text representation of the concept
... characteristic 0..*CodeableConceptCollection of characteristics (attributes)
Binding: (unbound) (example): A custom attribute that could be provided at a service (e.g. Wheelchair accessibiliy).


... communication 0..*CodeableConceptThe language that this service is offered in
Binding: CommonLanguages (preferred): A human language.

Additional BindingsPurpose
AllLanguagesMax Binding

... referralMethod 0..*CodeableConceptWays that the service accepts referrals
Binding: Healthcare Service Referral Method Value Set (extensible)
... appointmentRequired 0..1booleanIf an appointment is required for access to this service
... availableTime 0..*BackboneElementTimes the Service Site is available
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... daysOfWeek 0..*codemon | tue | wed | thu | fri | sat | sun
Binding: DaysOfWeek (required): The days of the week.


.... allDay 0..1booleanAlways available? e.g. 24 hour service
.... availableStartTime 0..1timeOpening time of day (ignored if allDay = true)
.... availableEndTime 0..1timeClosing time of day (ignored if allDay = true)
... notAvailable 0..*BackboneElementNot available during this time due to provided reason
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... description 1..1stringReason presented to the user explaining why time not available
.... during 0..1PeriodService not available from this date
... availabilityExceptions 0..1stringDescription of availability exceptions
... endpoint S0..*Reference(NDH Base Endpoint Profile)Technical endpoints providing access to electronic services operated for the healthcare service

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
HealthcareService.meta.securityextensibleAll Security Labels
http://hl7.org/fhir/ValueSet/security-labels
from the FHIR Standard
HealthcareService.meta.tagexampleCommonTags
http://hl7.org/fhir/ValueSet/common-tags
from the FHIR Standard
HealthcareService.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
http://hl7.org/fhir/ValueSet/languages
from the FHIR Standard
HealthcareService.identifier.userequiredIdentifierUse
http://hl7.org/fhir/ValueSet/identifier-use|4.0.1
from the FHIR Standard
HealthcareService.identifier.typeextensibleIdentifier Type Codes
http://hl7.org/fhir/ValueSet/identifier-type
from the FHIR Standard
HealthcareService.categoryexampleServiceCategory
http://hl7.org/fhir/ValueSet/service-category
from the FHIR Standard
HealthcareService.category:HSCrequiredHealthcareServiceCategoryVS (a valid code from Healthcare Service Category Code System)
http://hl7.org/fhir/us/ndh/ValueSet/HealthcareServiceCategoryVS
from this IG
HealthcareService.typeextensibleHealthcareServiceTypeVS
http://hl7.org/fhir/us/ndh/ValueSet/HealthcareServiceTypeVS
from this IG
HealthcareService.specialtyextensibleHealthcareProviderTaxonomy . (a valid code from http://nucc.org/provider-taxonomy)
http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.114222.4.11.1066
HealthcareService.telecom.systemrequiredContactPointSystem
http://hl7.org/fhir/ValueSet/contact-point-system|4.0.1
from the FHIR Standard
HealthcareService.telecom.userequiredContactPointUse
http://hl7.org/fhir/ValueSet/contact-point-use|4.0.1
from the FHIR Standard
HealthcareService.serviceProvisionCodeextensibleServiceProvisionConditions
http://hl7.org/fhir/ValueSet/service-provision-conditions
from the FHIR Standard
HealthcareService.eligibility.codeextensibleHealthcareServiceEligibilityCodeVS
http://hl7.org/fhir/us/ndh/ValueSet/HealthcareServiceEligibilityCodeVS
from this IG
HealthcareService.programextensibleProgram
http://hl7.org/fhir/ValueSet/program
from the FHIR Standard
HealthcareService.characteristicexample
HealthcareService.communicationpreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
http://hl7.org/fhir/ValueSet/languages
from the FHIR Standard
HealthcareService.referralMethodextensibleHealthcareServiceReferralMethodVS (a valid code from Healthcare Service Referral Method Code System)
http://hl7.org/fhir/us/ndh/ValueSet/HealthcareServiceReferralMethodVS
from this IG
HealthcareService.availableTime.daysOfWeekrequiredDaysOfWeek
http://hl7.org/fhir/ValueSet/days-of-week|4.0.1
from the FHIR Standard

This structure is derived from HealthcareService

Summary

Mandatory: 2 elements (1 nested mandatory element)
Must-Support: 10 elements

Structures

This structure refers to these other structures:

Extensions

This structure refers to these extensions:

Slices

This structure defines the following Slices:

  • The element HealthcareService.category is sliced based on the value of pattern:$this

 

Other representations of profile: CSV, Excel, Schematron

Notes:

Search Parameters

Search Parameter defined by the NDH IG
SearchParameter Name Type Example
eligibility token GET [base]/HealthcareService?eligibility=2403008
new-patient token GET [base]/HealthcareService?new-patient=newpt
new-patient-from-network reference GET [base]/HealthcareService?new-patient-from-network.type=ntwk&new-patient-from-network.address-state=CT
verification-status token GET [base]/HealthcareService?verification-status=complete
network reference GET [base]/HealthcareService?network.type=ntwk&network.address-state=CT
social-service-age-group token GET [base]/HealthcareService?social-service-age-group=teens&program=42
social-service-birthsex token GET [base]/HealthcareService?social-service-birthsex=F
social-service-employment-status token GET [base]/HealthcareService?social-service-employment-status=unemployed
social-service-gender-identity token GET [base]/HealthcareService?social-service-gender-identity=OTH
social-service-insurance-status token GET [base]/HealthcareService?social-service-insurance-status=uninsured
social-service-preferred-language token GET [base]/HealthcareService?social-service-preferred-language=en
social-service-va-status token GET [base]/HealthcareService?social-service-va-status=true
program-requirement-age-group token GET [base]/HealthcareService?program-requirement-age-group=teens
program-requirement-birthsex token GET [base]/HealthcareService?program-requirement-birthsex=M
program-requirement-employment-status token GET [base]/HealthcareService?program-requirement-employment-status=employed
program-requirement-gender-identity token GET [base]/HealthcareService?program-requirement-gender-identity=ASKU
program-requirement-insurance-status token GET [base]/HealthcareService?program-requirement-insurance-status=uninsured
program-requirement-preferred-language token GET [base]/HealthcareService?program-requirement-preferred-language=sp
program-requirement-va-status token GET [base]/HealthcareService?program-requirement-va-status=false
location reference GET [base]/HealthcareService?location.address-state=CT
organization reference GET [base]/HealthcareService?organization.name=HOPE INC
Search Parameter defined by FHIR Search Parameter Registry and used by the NDH IG

Since there is no direct individual url for each Search Parameter defined by FHIR Serach Parameter Registry, we have provided the following links for you to access more information about them.

SearchParameter Name Type Example
active token GET [base]/HealthcareService?active=true
coverage-area reference GET [base]/HealthcareService?coverage-area.address-state=CT
endpoint reference GET [base]/HealthcareService?endpoint.connection-type=hl7-fhir-rest
identifier token GET [base]/HealthcareService?identifier=1234567
name string GET [base]/HealthcareService?name=HOPE INC
program token GET [base]/HealthcareService?prgram=6
service-category token GET [base]/HealthcareService?service-category=behav
service-type token GET [base]/HealthcareService?service-type=230
specialty token GET [base]/HealthcareService?specialty=101YS0200X
_include Search Parameter
_include Example
HealthcareService:coverage-area GET [base]/HealthcareService?_include=HealthcareService:coverage-area
HealthcareService:endpoint GET [base]/HealthcareService?_include=HealthcareService:endpoint
HealthcareService:location GET [base]/HealthcareService?_id=BurrClinicServices&_include=HealthcareService:location
HealthcareService:new-patient-from-network GET [base]/HealthcareService?_include=HealthcareService:new-patient-from-network
HealthcareService:organization GET [base]/HealthcareService?_id=BurrClinicServices&_include=HealthcareService:organization
_revinclude Search parameter
_revinclude
CareTeam:service
OrganizationAffiliation:service
PractitionerRole:service

Special Search Parameters

The search parameters outlined above are straightforward for basic scenarios but have limitations in handling complex combination queries. To enhance these capabilities, employing the special search parameters _filter is recommended.

Search use cases
Search for all organizations and locations provide a given HealthcareService

If you run the search below for the HealthcareService called BurrClinicServices, it should return a search bundle that includes the BurrClinicServices resource, as well as the associated BurrClinic Organization resource and the HospLoc1 Location resource. This indicates that the BurrClinic organization provides the BurrClinicServices healthcare service at the HospLoc1 location.

GET [base]/HealthcareService?_id=BurrClinicServices&_include=HealthcareService:organization&_include=HealthcareService:location

or GET [base]/OrganizationAffiliation?service:HealthcareService._id=BurrClinicServices

To search for a specific OrganizationAffiliation and its associated resources, you can use the following query:

GET [base]/OrganizationAffiliation?_id=BurrClinicAffil&_include=OrganizationAffiliation:service&_include=OrganizationAffiliation:location&_include=OrganizationAffiliation:participating-organization&_include=OrganizationAffiliation:network

Usage

Network extension

The primary intention for the network extension of the HealthcareService is to cater to services related to social services. Typically, healthcare service networks are tied to insurance plans. However, in the realm of social services, the delivery or subscription of services often occurs through a hub. This hub embodies a similar concept to a network, but without an insurance plan attached. To simplify the process of locating such hubs (networks), NDH offers a connection from the healthcare server to the network. For instance, the Welcome Home organization provides housing services at the Welcome Home location. This service is subscribed to through the Social Service Housing Network.

Healthcare Service and Program Requirement extensions

The extension for Healthcare Service or Program Requirement is applied at both the Service and Program levels. Each Service or Program can have multiple requirements, and each requirement can have several constraints. For instance, one service could be specifically for teens, another for females, or even one designed exclusively for teenage girls. Restrictions should be utilized only when there are particular limitations, such as services solely for females or veterans.

Language Speak extension

If a service supports multiple languages, up to six for example, it’s unlikely that these would be restricted within this extension. Instead, the languages spoken should be documented under the “healthcareService.communication” field.

User requests a healthcare service delivered by an organization at a location

The recommended approach for a user requesting a healthcare service provided by an organization at a location is to use the healthcare service resource. This depends on whether the nature of the service is offered at a single location or across multiple locations.

If a healthcare service is available at multiple locations, each location may have unique endpoints, operating hours, and telecom. The specific data for each location concerning endpoints, operating hours, and telecom (HealthcareService.location => Location.endpoint, Location.hoursOfOperation, Location.telecom …) will supersede the general data provided at the healthcare service resource instance level (HealthcareService.endpoint, HealthcareService.availabeTime, HealthcareService.telecom …). This approach provides flexibility: it permits the use of unified endpoints, operating hours, and telephones for the healthcare service when the information is consistent across all locations, while also allowing for differences in endpoints and operating hours at various locations.