This page is part of the FHIR Specification (v0.0.82: DSTU 1). The current version which supercedes this version is 5.0.0 . For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2 Content Examples Detailed Descriptions Mappings Profiles 5.6 Resource HealthcareService - Content This resource maintained by the Patient Administration Work Group The details of a Healthcare Service available at a location. 5.6.1 Scope and Usage The HealthcareService resource is used to describe a single healthcare service that is being provided by an organization at a location. The location of the services could be virtual, as with TeleMedicine Services. Common examples of HealthcareServices resources are: Allied Health Clinical Neuropsychologist Podiatry Service Smallville Hospital Emergency Services Respite care provided at a nursing home or hostel 24hr crisis telephone counselling service Information, advice and/or referral services; Disability, Telecommunications Rural TeleHealth Services Hospital in the home Yellow Cabs Pharmacy Active Rehab Social Support Drug and/or alcohol counselling Day Programs, Adult Training & Support Services Consulting psychologists and/or psychology services Group Hydrotherapy Little River Home Maintenance Example mowing services HealthcareService resources do not represent Computer related Services (not SOA) Example uses of HealthcareService resources are: National Services Directory - Consumer Focus National Services Directory - Practitioner Referrals Searching Organization's Client Portal - to locate services / book appointments Address book of services for Referrals including references to Questionnaires for assessments that are required as part of the referral Health Network internal directory Used for tracking available services offered internally, and also those offered by business partners. This information may also include costing information. 5.6.2 Boundaries and Relationships The Schedule resource can be used with the Schedule resource to define actual availability of the service. This would be done by using the Schedule's Actor property. When creating an Appointment, the HealthcareService is be assigned to one of the participants. It is up to the scheduling system to determine if the service is available, and can be accepted. This resource is referenced by Appointment , AppointmentResponse and Practitioner 5.6.3 Resource Content Structure UML XML JSON All Structure Name Flags Card. Type Description & Constraints HealthcareService DomainResource The details of a Healthcare Service available at a location identifier Σ 0..* Identifier External Identifiers for this item providedBy Σ 0..1 Organization The organization that provides this Healthcare Service location Σ 1..1 Location The location where this healthcare service may be provided serviceCategory Σ 0..1 CodeableConcept Identifies the broad category of service being performed or delivered. Selecting a Service Category then determines the list of relevant service types that can be selected in the Primary Service Type serviceType Σ 0..* Element A specific type of service that may be delivered or performed type Σ 1..1 CodeableConcept The specific type of service being delivered or performed DocumentC80PracticeSetting ( Preferred ) specialty Σ 0..* CodeableConcept Collection of Specialties handled by the Service Site. This is more of a Medical Term serviceName Σ 0..1 string Further description of the service as it would be presented to a consumer while searching comment Σ 0..1 string Additional description of the or any specific issues not covered by the other attributes, which can be displayed as further detail under the serviceName extraDetails 0..1 string Extra details about the service that can't be placed in the other fields photo Σ 0..1 Attachment If there is a photo/symbol associated with this HealthcareService, it may be included here to facilitate quick identification of the service in a list telecom 0..* ContactPoint List of contacts related to this specific healthcare service. If this is empty, then refer to the location's contacts coverageArea 0..* Location The location(s) that this service is available to (not where the service is provided) eligibility 0..1 CodeableConcept Does this service have specific eligibility requirements that need to be met in order to use the service eligibilityNote 0..1 string Describes the eligibility conditions for the service programName 0..* string Program Names that can be used to categorize the service characteristic 0..* CodeableConcept Collection of Characteristics (attributes) referralMethod 0..* CodeableConcept Ways that the service accepts referrals ReferralMethod ( Example ) publicKey 0..1 string The public part of the 'keys' allocated to an Organization by an accredited body to support secure exchange of data over the internet. To be provided by the Organization, where available appointmentRequired 0..1 boolean Indicates if an appointment is required for access to this service availableTime 0..* Element A Collection of times that the Service Site is available daysOfWeek 0..* CodeableConcept mon | tue | wed | thu | fri | sat | sun allDay 0..1 boolean Is this always available? (hence times are irrelevant) e.g. 24 hour service availableStartTime 0..1 time The opening time of day. Note: If the AllDay flag is set, then this time is ignored availableEndTime 0..1 time The closing time of day. Note: If the AllDay flag is set, then this time is ignored notAvailable 0..* Element The HealthcareService is not available during this period of time due to the provided reason description 1..1 string The reason that can be presented to the user as to why this time is not available during 0..1 Period Service is not available (seasonally or for a public holiday) from this date availabilityExceptions 0..1 string A description of Site availability exceptions, e.g., public holiday availability. Succinctly describing all possible exceptions to normal Site availability as details in the Available Times and Not Available Times UML Diagram HealthcareService ( DomainResource ) External Identifiers for this item identifier : Identifier 0..* The organization that provides this Healthcare Service providedBy : Reference ( Organization ) 0..1 The location where this healthcare service may be provided location : Reference ( Location ) 1..1 Identifies the broad category of service being performed or delivered. Selecting a Service Category then determines the list of relevant service types that can be selected in the Primary Service Type serviceCategory : CodeableConcept 0..1 Further description of the service as it would be presented to a consumer while searching serviceName : string 0..1 Additional description of the or any specific issues not covered by the other attributes, which can be displayed as further detail under the serviceName comment : string 0..1 Extra details about the service that can't be placed in the other fields extraDetails : string 0..1 If there is a photo/symbol associated with this HealthcareService, it may be included here to facilitate quick identification of the service in a list photo : Attachment 0..1 List of contacts related to this specific healthcare service. If this is empty, then refer to the location's contacts telecom : ContactPoint 0..* The location(s) that this service is available to (not where the service is provided) coverageArea : Reference ( Location ) 0..* Does this service have specific eligibility requirements that need to be met in order to use the service eligibility : CodeableConcept 0..1 The description of service eligibility should, in general, not exceed one or two paragraphs. It should be sufficient for a prospective consumer to determine if they are likely to be eligible or not. Where eligibility requirements and conditions are complex, it may simply be noted that an eligibility assessment is required. Where eligibility is determined by an outside source, such as an Act of Parliament, this should be noted, preferably with a reference to a commonly available copy of the source document such as a web page eligibilityNote : string 0..1 Program Names that can be used to categorize the service programName : string 0..* Collection of Characteristics (attributes) characteristic : CodeableConcept 0..* Ways that the service accepts referrals, if this is not provided then it is implied that no referral is required referralMethod : CodeableConcept 0..* « ( The methods of referral can be used when referring to a specific HealthCareService resource ReferralMethod ) » The public part of the 'keys' allocated to an Organization by an accredited body to support secure exchange of data over the internet. To be provided by the Organization, where available publicKey : string 0..1 Indicates whether or not a prospective consumer will require an appointment for a particular service at a Site to be provided by the Organization. Indicates if an appointment is required for access to this service appointmentRequired : boolean 0..1 A description of Site availability exceptions, e.g., public holiday availability. Succinctly describing all possible exceptions to normal Site availability as details in the Available Times and Not Available Times availabilityExceptions : string 0..1 ServiceType The specific type of service being delivered or performed type : CodeableConcept 1..1 « Additional details about where the content was created (e.g. clinical specialty) DocumentC80PracticeSetting + » Collection of Specialties handled by the Service Site. This is more of a Medical Term specialty : CodeableConcept 0..* AvailableTime Indicates which Days of the week are available between the Start and End Times daysOfWeek : CodeableConcept 0..* Is this always available? (hence times are irrelevant) e.g. 24 hour service allDay : boolean 0..1 The opening time of day. Note: If the AllDay flag is set, then this time is ignored availableStartTime : time 0..1 The closing time of day. Note: If the AllDay flag is set, then this time is ignored availableEndTime : time 0..1 NotAvailable The reason that can be presented to the user as to why this time is not available description : string 1..1 Service is not available (seasonally or for a public holiday) from this date during : Period 0..1 A specific type of service that may be delivered or performed serviceType 0..* A Collection of times that the Service Site is available availableTime 0..* The HealthcareService is not available during this period of time due to the provided reason notAvailable 0..* XML Template < <!-- from --> <!-- from --> <</identifier> < The organization that provides this Healthcare Service</providedBy> < The location where this healthcare service may be provided</location> < Identifies the broad category of service being performed or delivered. Selecting a Service Category then determines the list of relevant service types that can be selected in the Primary Service Type</serviceCategory> < <</type> < Collection of Specialties handled by the Service Site. This is more of a Medical Term</specialty> </serviceType> < Further description of the service as it would be presented to a consumer while searching < Additional description of the or any specific issues not covered by the other attributes, which can be displayed as further detail under the serviceName < < If there is a photo/symbol associated with this HealthcareService, it may be included here to facilitate quick identification of the service in a list</photo> < List of contacts related to this specific healthcare service. If this is empty, then refer to the location's contacts</telecom> < The location(s) that this service is available to (not where the service is provided)</coverageArea> < Does this service have specific eligibility requirements that need to be met in order to use the service</eligibility> < < < Collection of Characteristics (attributes)</characteristic> <</referralMethod> < The public part of the 'keys' allocated to an Organization by an accredited body to support secure exchange of data over the internet. To be provided by the Organization, where available < < <</daysOfWeek> < < The opening time of day. Note: If the AllDay flag is set, then this time is ignored < The closing time of day. Note: If the AllDay flag is set, then this time is ignored </availableTime> < < < Service is not available (seasonally or for a public holiday) from this date</during> </notAvailable> < A description of Site availability exceptions, e.g., public holiday availability. Succinctly describing all possible exceptions to normal Site availability as details in the Available Times and Not Available Times </HealthcareService> JSON Template { "resourceType" : "", // from // from " " The organization that provides this Healthcare Service " The location where this healthcare service may be provided " Identifies the broad category of service being performed or delivered. Selecting a Service Category then determines the list of relevant service types that can be selected in the Primary Service Type " " " Collection of Specialties handled by the Service Site. This is more of a Medical Term }], " Further description of the service as it would be presented to a consumer while searching " Additional description of the or any specific issues not covered by the other attributes, which can be displayed as further detail under the serviceName " " If there is a photo/symbol associated with this HealthcareService, it may be included here to facilitate quick identification of the service in a list " List of contacts related to this specific healthcare service. If this is empty, then refer to the location's contacts " The location(s) that this service is available to (not where the service is provided) " Does this service have specific eligibility requirements that need to be met in order to use the service " " " Collection of Characteristics (attributes) " " The public part of the 'keys' allocated to an Organization by an accredited body to support secure exchange of data over the internet. To be provided by the Organization, where available " " " " " The opening time of day. Note: If the AllDay flag is set, then this time is ignored " The closing time of day. Note: If the AllDay flag is set, then this time is ignored }], " The HealthcareService is not available during this period of time due to the provided reason " " Service is not available (seasonally or for a public holiday) from this date }], " A description of Site availability exceptions, e.g., public holiday availability. Succinctly describing all possible exceptions to normal Site availability as details in the Available Times and Not Available Times } Structure Name Flags Card. Type Description & Constraints HealthcareService DomainResource The details of a Healthcare Service available at a location identifier Σ 0..* Identifier External Identifiers for this item providedBy Σ 0..1 Organization The organization that provides this Healthcare Service location Σ 1..1 Location The location where this healthcare service may be provided serviceCategory Σ 0..1 CodeableConcept Identifies the broad category of service being performed or delivered. Selecting a Service Category then determines the list of relevant service types that can be selected in the Primary Service Type serviceType Σ 0..* Element A specific type of service that may be delivered or performed type Σ 1..1 CodeableConcept The specific type of service being delivered or performed DocumentC80PracticeSetting ( Preferred ) specialty Σ 0..* CodeableConcept Collection of Specialties handled by the Service Site. This is more of a Medical Term serviceName Σ 0..1 string Further description of the service as it would be presented to a consumer while searching comment Σ 0..1 string Additional description of the or any specific issues not covered by the other attributes, which can be displayed as further detail under the serviceName extraDetails 0..1 string Extra details about the service that can't be placed in the other fields photo Σ 0..1 Attachment If there is a photo/symbol associated with this HealthcareService, it may be included here to facilitate quick identification of the service in a list telecom 0..* ContactPoint List of contacts related to this specific healthcare service. If this is empty, then refer to the location's contacts coverageArea 0..* Location The location(s) that this service is available to (not where the service is provided) eligibility 0..1 CodeableConcept Does this service have specific eligibility requirements that need to be met in order to use the service eligibilityNote 0..1 string Describes the eligibility conditions for the service programName 0..* string Program Names that can be used to categorize the service characteristic 0..* CodeableConcept Collection of Characteristics (attributes) referralMethod 0..* CodeableConcept Ways that the service accepts referrals ReferralMethod ( Example ) publicKey 0..1 string The public part of the 'keys' allocated to an Organization by an accredited body to support secure exchange of data over the internet. To be provided by the Organization, where available appointmentRequired 0..1 boolean Indicates if an appointment is required for access to this service availableTime 0..* Element A Collection of times that the Service Site is available daysOfWeek 0..* CodeableConcept mon | tue | wed | thu | fri | sat | sun allDay 0..1 boolean Is this always available? (hence times are irrelevant) e.g. 24 hour service availableStartTime 0..1 time The opening time of day. Note: If the AllDay flag is set, then this time is ignored availableEndTime 0..1 time The closing time of day. Note: If the AllDay flag is set, then this time is ignored notAvailable 0..* Element The HealthcareService is not available during this period of time due to the provided reason description 1..1 string The reason that can be presented to the user as to why this time is not available during 0..1 Period Service is not available (seasonally or for a public holiday) from this date availabilityExceptions 0..1 string A description of Site availability exceptions, e.g., public holiday availability. Succinctly describing all possible exceptions to normal Site availability as details in the Available Times and Not Available Times UML Diagram HealthcareService ( DomainResource ) External Identifiers for this item identifier : Identifier 0..* The organization that provides this Healthcare Service providedBy : Reference ( Organization ) 0..1 The location where this healthcare service may be provided location : Reference ( Location ) 1..1 Identifies the broad category of service being performed or delivered. Selecting a Service Category then determines the list of relevant service types that can be selected in the Primary Service Type serviceCategory : CodeableConcept 0..1 Further description of the service as it would be presented to a consumer while searching serviceName : string 0..1 Additional description of the or any specific issues not covered by the other attributes, which can be displayed as further detail under the serviceName comment : string 0..1 Extra details about the service that can't be placed in the other fields extraDetails : string 0..1 If there is a photo/symbol associated with this HealthcareService, it may be included here to facilitate quick identification of the service in a list photo : Attachment 0..1 List of contacts related to this specific healthcare service. If this is empty, then refer to the location's contacts telecom : ContactPoint 0..* The location(s) that this service is available to (not where the service is provided) coverageArea : Reference ( Location ) 0..* Does this service have specific eligibility requirements that need to be met in order to use the service eligibility : CodeableConcept 0..1 The description of service eligibility should, in general, not exceed one or two paragraphs. It should be sufficient for a prospective consumer to determine if they are likely to be eligible or not. Where eligibility requirements and conditions are complex, it may simply be noted that an eligibility assessment is required. Where eligibility is determined by an outside source, such as an Act of Parliament, this should be noted, preferably with a reference to a commonly available copy of the source document such as a web page eligibilityNote : string 0..1 Program Names that can be used to categorize the service programName : string 0..* Collection of Characteristics (attributes) characteristic : CodeableConcept 0..* Ways that the service accepts referrals, if this is not provided then it is implied that no referral is required referralMethod : CodeableConcept 0..* « ( The methods of referral can be used when referring to a specific HealthCareService resource ReferralMethod ) » The public part of the 'keys' allocated to an Organization by an accredited body to support secure exchange of data over the internet. To be provided by the Organization, where available publicKey : string 0..1 Indicates whether or not a prospective consumer will require an appointment for a particular service at a Site to be provided by the Organization. Indicates if an appointment is required for access to this service appointmentRequired : boolean 0..1 A description of Site availability exceptions, e.g., public holiday availability. Succinctly describing all possible exceptions to normal Site availability as details in the Available Times and Not Available Times availabilityExceptions : string 0..1 ServiceType The specific type of service being delivered or performed type : CodeableConcept 1..1 « Additional details about where the content was created (e.g. clinical specialty) DocumentC80PracticeSetting + » Collection of Specialties handled by the Service Site. This is more of a Medical Term specialty : CodeableConcept 0..* AvailableTime Indicates which Days of the week are available between the Start and End Times daysOfWeek : CodeableConcept 0..* Is this always available? (hence times are irrelevant) e.g. 24 hour service allDay : boolean 0..1 The opening time of day. Note: If the AllDay flag is set, then this time is ignored availableStartTime : time 0..1 The closing time of day. Note: If the AllDay flag is set, then this time is ignored availableEndTime : time 0..1 NotAvailable The reason that can be presented to the user as to why this time is not available description : string 1..1 Service is not available (seasonally or for a public holiday) from this date during : Period 0..1 A specific type of service that may be delivered or performed serviceType 0..* A Collection of times that the Service Site is available availableTime 0..* The HealthcareService is not available during this period of time due to the provided reason notAvailable 0..* XML Template < <!-- from --> <!-- from --> <</identifier> < The organization that provides this Healthcare Service</providedBy> < The location where this healthcare service may be provided</location> < Identifies the broad category of service being performed or delivered. Selecting a Service Category then determines the list of relevant service types that can be selected in the Primary Service Type</serviceCategory> < <</type> < Collection of Specialties handled by the Service Site. This is more of a Medical Term</specialty> </serviceType> < Further description of the service as it would be presented to a consumer while searching < Additional description of the or any specific issues not covered by the other attributes, which can be displayed as further detail under the serviceName < < If there is a photo/symbol associated with this HealthcareService, it may be included here to facilitate quick identification of the service in a list</photo> < List of contacts related to this specific healthcare service. If this is empty, then refer to the location's contacts</telecom> < The location(s) that this service is available to (not where the service is provided)</coverageArea> < Does this service have specific eligibility requirements that need to be met in order to use the service</eligibility> < < < Collection of Characteristics (attributes)</characteristic> <</referralMethod> < The public part of the 'keys' allocated to an Organization by an accredited body to support secure exchange of data over the internet. To be provided by the Organization, where available < < <</daysOfWeek> < < The opening time of day. Note: If the AllDay flag is set, then this time is ignored < The closing time of day. Note: If the AllDay flag is set, then this time is ignored </availableTime> < < < Service is not available (seasonally or for a public holiday) from this date</during> </notAvailable> < A description of Site availability exceptions, e.g., public holiday availability. Succinctly describing all possible exceptions to normal Site availability as details in the Available Times and Not Available Times </HealthcareService> JSON Template { "resourceType" : "", // from // from " " The organization that provides this Healthcare Service " The location where this healthcare service may be provided " Identifies the broad category of service being performed or delivered. Selecting a Service Category then determines the list of relevant service types that can be selected in the Primary Service Type " " " Collection of Specialties handled by the Service Site. This is more of a Medical Term }], " Further description of the service as it would be presented to a consumer while searching " Additional description of the or any specific issues not covered by the other attributes, which can be displayed as further detail under the serviceName " " If there is a photo/symbol associated with this HealthcareService, it may be included here to facilitate quick identification of the service in a list " List of contacts related to this specific healthcare service. If this is empty, then refer to the location's contacts " The location(s) that this service is available to (not where the service is provided) " Does this service have specific eligibility requirements that need to be met in order to use the service " " " Collection of Characteristics (attributes) " " The public part of the 'keys' allocated to an Organization by an accredited body to support secure exchange of data over the internet. To be provided by the Organization, where available " " " " " The opening time of day. Note: If the AllDay flag is set, then this time is ignored " The closing time of day. Note: If the AllDay flag is set, then this time is ignored }], " The HealthcareService is not available during this period of time due to the provided reason " " Service is not available (seasonally or for a public holiday) from this date }], " A description of Site availability exceptions, e.g., public holiday availability. Succinctly describing all possible exceptions to normal Site availability as details in the Available Times and Not Available Times }   Alternate definitions: Schema / Schematron , Resource Profile ( XML , JSON ), Questionnaire 5.6.3.1 Terminology Bindings Path Definition Type Reference HealthcareService.serviceType.type Additional details about where the content was created (e.g. clinical specialty) Preferred http://hl7.org/fhir/vs/c80-practice-codes HealthcareService.referralMethod The methods of referral can be used when referring to a specific HealthCareService resource Example http://hl7.org/fhir/service-referral-method 5.6.4 Notes: 5.6.5 Search Parameters Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services. Name Type Description Paths characteristic token One of the HealthcareService's characteristics HealthcareService.characteristic location reference The location of the Healthcare Service HealthcareService.location ( Location ) name string A portion of the Healthcare service name HealthcareService.serviceName organization reference The organization that provides this Healthcare Service HealthcareService.providedBy ( Organization ) programname string One of the Program Names serviced by this HealthcareService HealthcareService.programName servicecategory token Service Category of the Healthcare Service HealthcareService.serviceCategory servicetype token The type of service provided by this healthcare service HealthcareService.serviceType.type © HL7.org 2011+. FHIR DSTU (v0.4.0-4902) generated on Fri, Mar 27, 2015 00:20+1100. Links: What's a DSTU? | Version History | Specification Map | Compare to DSTU1 | | Propose a change try { var currentTabIndex = sessionStorage.getItem('fhir-resource-tab-index'); } catch(exception){ if (navigator.userAgent.toLowerCase().indexof('msie') == -1) alert(exception); } if (!currentTabIndex) currentTabIndex = '0'; $( '#tabs' ).tabs({ active: currentTabIndex, activate: function( event, ui ) { var active = $('.selector').tabs('option', 'active'); currentTabIndex = ui.newTab.index(); try { sessionStorage.setItem('fhir-resource-tab-index', currentTabIndex); } catch(exception){ if (navigator.userAgent.toLowerCase().indexof('msie') == -1) alert(exception); } } });