Release 5 Draft Ballot

This is the Continuous Integration Build of FHIR (will be incorrect/inconsistent at times).
See the Directory of published versions

8.8 Resource HealthcareService - Content

Patient Administration Work GroupMaturity Level: 2 Trial UseSecurity Category: Business Compartments: Not linked to any defined compartments

The details of a healthcare service available at a location.

The HealthcareService resource is used to describe a single healthcare service or category of services that are 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 counseling 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 counseling
  • Day Programs, Adult Training & Support Services
  • Consulting psychologists and/or psychology services
  • Group Hydrotherapy
  • Little River Home Maintenance
  • CT Head Scan w/o Contrast
  • CT Head Scan with Contrast
  • CT Head+Chest Scan with Contrast

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.
  • Catalog of schedulable services or activities

The HealthcareService 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 to 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.

The HealthcareService resource is used with the following resources:

  • Organization: The organization provides the services, the healthcareservice describes the services
  • ServiceRequest: This is a subject specific request for a specific service, it may be to a specific healthcare service, and/or simply a coded service value. The granularity included in the request codes may be finer than defined in the healthcare service.
  • OrganizationAffiliation: Might constrain a list of healthcare services that are available between 2 organizations
  • Location: Specifies the place where the service(s) are offered/available within.

This resource is referenced by UsageContext, Account, ActivityDefinition, Appointment, AppointmentResponse, CarePlan, ChargeItem, ChargeItemDefinition, Communication, CommunicationRequest, Consent, DeviceRequest, Encounter, itself, ImagingSelection, ImagingStudy, MedicationRequest, OrganizationAffiliation, Permission, PlanDefinition, PractitionerRole, Procedure, RequestGroup, Schedule, ServiceRequest, Slot, SupplyRequest, Task and Transport.

This resource implements the Participant pattern.

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. HealthcareService TUDomainResourceThe details of a healthcare service available at a location

Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... identifier Σ0..*IdentifierExternal identifiers for this item

... active ?!Σ0..1booleanWhether this HealthcareService record is in active use
... providedBy Σ0..1Reference(Organization)Organization that provides this service
... category Σ0..*CodeableConceptBroad category of service being performed or delivered
ServiceCategory (Example)

... type Σ0..*CodeableConceptType of service that may be delivered or performed
ServiceType (Example)

... specialty Σ0..*CodeableConceptSpecialties handled by the HealthcareService
service-specialty (Preferred)

... location Σ0..*Reference(Location)Location(s) where service may be provided

... name Σ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
... contact 0..*ExtendedContactDetailOfficial contact details for the HealthcareService

... coverageArea 0..*Reference(Location)Location(s) service is intended for/available to

... serviceProvisionCode 0..*CodeableConceptConditions under which service is available/offered
ServiceProvisionConditions (Example)

... eligibility 0..*BackboneElementSpecific eligibility requirements required to use the service

.... code 0..1CodeableConceptCoded value for the eligibility
ServiceEligibility (Example)
.... comment 0..1markdownDescribes the eligibility conditions for the service
... program 0..*CodeableConceptPrograms that this service is applicable to
Program (Example)

... characteristic 0..*CodeableConceptCollection of characteristics (attributes)
ServiceCharacteristic (Example)

... communication 0..*CodeableConceptThe language that this service is offered in
Common Languages (Preferred but limited to AllLanguages)

... referralMethod 0..*CodeableConceptWays that the service accepts referrals
ReferralMethod (Example)

... appointmentRequired 0..1booleanIf an appointment is required for access to this service
... availability 0..*AvailabilityTimes the healthcare service is available (including exceptions)

... endpoint 0..*Reference(Endpoint)Technical endpoints providing access to electronic services operated for the healthcare service


doco Documentation for this format

UML Diagram (Legend)

HealthcareService (DomainResource)External identifiers for this itemidentifier : Identifier [0..*]This flag is used to mark the record to not be used. This is not used when a center is closed for maintenance, or for holidays, the notAvailable period is to be used for this (this element modifies the meaning of other elements)active : boolean [0..1]The organization that provides this healthcare serviceprovidedBy : Reference [0..1] « Organization »When the HealthcareService is representing a specific, schedulable service, the availableIn property can refer to a generic serviceofferedIn : Reference [0..*] « HealthcareService »Identifies the broad category of service being performed or deliveredcategory : CodeableConcept [0..*] « null (Strength=Example)ServiceCategory?? »The specific type of service that may be delivered or performedtype : CodeableConcept [0..*] « null (Strength=Example)ServiceType?? »Collection of specialties handled by the Healthcare service. This is more of a medical termspecialty : CodeableConcept [0..*] « null (Strength=Preferred)service-specialty? »The location(s) where this healthcare service may be providedlocation : Reference [0..*] « Location »Further description of the service as it would be presented to a consumer while searchingname : string [0..1]Any additional description of the service and/or any specific issues not covered by the other attributes, which can be displayed as further detail under the serviceNamecomment : string [0..1]Extra details about the service that can't be placed in the other fieldsextraDetails : markdown [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 listphoto : Attachment [0..1]The contact details of communication devices available relevant to the specific HealthcareService. This can include addresses, phone numbers, fax numbers, mobile numbers, email addresses and web sitescontact : ExtendedContactDetail [0..*]The location(s) that this service is available to (not where the service is provided)coverageArea : Reference [0..*] « Location »The code(s) that detail the conditions under which the healthcare service is available/offeredserviceProvisionCode : CodeableConcept [0..*] « null (Strength=Example) ServiceProvisionConditions?? »Programs that this service is applicable toprogram : CodeableConcept [0..*] « null (Strength=Example)Program?? »Collection of characteristics (attributes)characteristic : CodeableConcept [0..*] « null (Strength=Example)ServiceCharacteristic?? »Some services are specifically made available in multiple languages, this property permits a directory to declare the languages this is offered in. Typically this is only provided where a service operates in communities with mixed languages usedcommunication : CodeableConcept [0..*] « null (Strength=Preferred)CommonLanguages? »Ways that the service accepts referrals, if this is not provided then it is implied that no referral is requiredreferralMethod : CodeableConcept [0..*] « null (Strength=Example)ReferralMethod?? »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 serviceappointmentRequired : boolean [0..1]A collection of times that the healthcare service is availableavailability : Availability [0..*]Technical endpoints providing access to services operated for the specific healthcare services defined at this resourceendpoint : Reference [0..*] « Endpoint »EligibilityCoded value for the eligibilitycode : CodeableConcept [0..1] « null (Strength=Example)ServiceEligibility?? »Describes the eligibility conditions for the servicecomment : markdown [0..1]Does this service have specific eligibility requirements that need to be met in order to use the service?eligibility[0..*]

XML Template

<HealthcareService xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- 0..* Identifier External identifiers for this item --></identifier>
 <active value="[boolean]"/><!-- 0..1 Whether this HealthcareService record is in active use -->
 <providedBy><!-- 0..1 Reference(Organization) Organization that provides this service --></providedBy>
 <offeredIn><!-- 0..* Reference(HealthcareService) The service within which this service is offered --></offeredIn>
 <category><!-- 0..* CodeableConcept Broad category of service being performed or delivered --></category>
 <type><!-- 0..* CodeableConcept Type of service that may be delivered or performed --></type>
 <specialty><!-- 0..* CodeableConcept Specialties handled by the HealthcareService  --></specialty>
 <location><!-- 0..* Reference(Location) Location(s) where service may be provided --></location>
 <name value="[string]"/><!-- 0..1 Description of service as presented to a consumer while searching -->
 <comment value="[string]"/><!-- 0..1 Additional description and/or any specific issues not covered elsewhere -->
 <extraDetails value="[markdown]"/><!-- 0..1 Extra details about the service that can't be placed in the other fields -->
 <photo><!-- 0..1 Attachment Facilitates quick identification of the service --></photo>
 <contact><!-- 0..* ExtendedContactDetail Official contact details for the HealthcareService --></contact>
 <coverageArea><!-- 0..* Reference(Location) Location(s) service is intended for/available to --></coverageArea>
 <serviceProvisionCode><!-- 0..* CodeableConcept Conditions under which service is available/offered --></serviceProvisionCode>
 <eligibility>  <!-- 0..* Specific eligibility requirements required to use the service -->
  <code><!-- 0..1 CodeableConcept Coded value for the eligibility --></code>
  <comment value="[markdown]"/><!-- 0..1 Describes the eligibility conditions for the service -->
 </eligibility>
 <program><!-- 0..* CodeableConcept Programs that this service is applicable to --></program>
 <characteristic><!-- 0..* CodeableConcept Collection of characteristics (attributes) --></characteristic>
 <communication><!-- 0..* CodeableConcept The language that this service is offered in --></communication>
 <referralMethod><!-- 0..* CodeableConcept Ways that the service accepts referrals --></referralMethod>
 <appointmentRequired value="[boolean]"/><!-- 0..1 If an appointment is required for access to this service -->
 <availability><!-- 0..* Availability Times the healthcare service is available (including exceptions) --></availability>
 <endpoint><!-- 0..* Reference(Endpoint) Technical endpoints providing access to electronic services operated for the healthcare service --></endpoint>
</HealthcareService>

JSON Template

{doco
  "resourceType" : "HealthcareService",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // External identifiers for this item
  "active" : <boolean>, // Whether this HealthcareService record is in active use
  "providedBy" : { Reference(Organization) }, // Organization that provides this service
  "offeredIn" : [{ Reference(HealthcareService) }], // The service within which this service is offered
  "category" : [{ CodeableConcept }], // Broad category of service being performed or delivered
  "type" : [{ CodeableConcept }], // Type of service that may be delivered or performed
  "specialty" : [{ CodeableConcept }], // Specialties handled by the HealthcareService 
  "location" : [{ Reference(Location) }], // Location(s) where service may be provided
  "name" : "<string>", // Description of service as presented to a consumer while searching
  "comment" : "<string>", // Additional description and/or any specific issues not covered elsewhere
  "extraDetails" : "<markdown>", // Extra details about the service that can't be placed in the other fields
  "photo" : { Attachment }, // Facilitates quick identification of the service
  "contact" : [{ ExtendedContactDetail }], // Official contact details for the HealthcareService
  "coverageArea" : [{ Reference(Location) }], // Location(s) service is intended for/available to
  "serviceProvisionCode" : [{ CodeableConcept }], // Conditions under which service is available/offered
  "eligibility" : [{ // Specific eligibility requirements required to use the service
    "code" : { CodeableConcept }, // Coded value for the eligibility
    "comment" : "<markdown>" // Describes the eligibility conditions for the service
  }],
  "program" : [{ CodeableConcept }], // Programs that this service is applicable to
  "characteristic" : [{ CodeableConcept }], // Collection of characteristics (attributes)
  "communication" : [{ CodeableConcept }], // The language that this service is offered in
  "referralMethod" : [{ CodeableConcept }], // Ways that the service accepts referrals
  "appointmentRequired" : <boolean>, // If an appointment is required for access to this service
  "availability" : [{ Availability }], // Times the healthcare service is available (including exceptions)
  "endpoint" : [{ Reference(Endpoint) }] // Technical endpoints providing access to electronic services operated for the healthcare service
}

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:HealthcareService;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:HealthcareService.identifier [ Identifier ], ... ; # 0..* External identifiers for this item
  fhir:HealthcareService.active [ boolean ]; # 0..1 Whether this HealthcareService record is in active use
  fhir:HealthcareService.providedBy [ Reference(Organization) ]; # 0..1 Organization that provides this service
  fhir:HealthcareService.offeredIn [ Reference(HealthcareService) ], ... ; # 0..* The service within which this service is offered
  fhir:HealthcareService.category [ CodeableConcept ], ... ; # 0..* Broad category of service being performed or delivered
  fhir:HealthcareService.type [ CodeableConcept ], ... ; # 0..* Type of service that may be delivered or performed
  fhir:HealthcareService.specialty [ CodeableConcept ], ... ; # 0..* Specialties handled by the HealthcareService
  fhir:HealthcareService.location [ Reference(Location) ], ... ; # 0..* Location(s) where service may be provided
  fhir:HealthcareService.name [ string ]; # 0..1 Description of service as presented to a consumer while searching
  fhir:HealthcareService.comment [ string ]; # 0..1 Additional description and/or any specific issues not covered elsewhere
  fhir:HealthcareService.extraDetails [ markdown ]; # 0..1 Extra details about the service that can't be placed in the other fields
  fhir:HealthcareService.photo [ Attachment ]; # 0..1 Facilitates quick identification of the service
  fhir:HealthcareService.contact [ ExtendedContactDetail ], ... ; # 0..* Official contact details for the HealthcareService
  fhir:HealthcareService.coverageArea [ Reference(Location) ], ... ; # 0..* Location(s) service is intended for/available to
  fhir:HealthcareService.serviceProvisionCode [ CodeableConcept ], ... ; # 0..* Conditions under which service is available/offered
  fhir:HealthcareService.eligibility [ # 0..* Specific eligibility requirements required to use the service
    fhir:HealthcareService.eligibility.code [ CodeableConcept ]; # 0..1 Coded value for the eligibility
    fhir:HealthcareService.eligibility.comment [ markdown ]; # 0..1 Describes the eligibility conditions for the service
  ], ...;
  fhir:HealthcareService.program [ CodeableConcept ], ... ; # 0..* Programs that this service is applicable to
  fhir:HealthcareService.characteristic [ CodeableConcept ], ... ; # 0..* Collection of characteristics (attributes)
  fhir:HealthcareService.communication [ CodeableConcept ], ... ; # 0..* The language that this service is offered in
  fhir:HealthcareService.referralMethod [ CodeableConcept ], ... ; # 0..* Ways that the service accepts referrals
  fhir:HealthcareService.appointmentRequired [ boolean ]; # 0..1 If an appointment is required for access to this service
  fhir:HealthcareService.availability [ Availability ], ... ; # 0..* Times the healthcare service is available (including exceptions)
  fhir:HealthcareService.endpoint [ Reference(Endpoint) ], ... ; # 0..* Technical endpoints providing access to electronic services operated for the healthcare service
]

Changes since R4

HealthcareService
HealthcareService.offeredIn
  • Added Element
HealthcareService.contact
  • Added Element
HealthcareService.availability
  • Added Element
HealthcareService.telecom
  • deleted
HealthcareService.availableTime
  • deleted
HealthcareService.notAvailable
  • deleted
HealthcareService.availabilityExceptions
  • deleted

See the Full Difference for further information

This analysis is available as XML or JSON.

See R3 <--> R4 Conversion Maps (status = 1 test that all execute ok. All tests pass round-trip testing and 1 r3 resources are invalid (0 errors).)

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. HealthcareService TUDomainResourceThe details of a healthcare service available at a location

Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... identifier Σ0..*IdentifierExternal identifiers for this item

... active ?!Σ0..1booleanWhether this HealthcareService record is in active use
... providedBy Σ0..1Reference(Organization)Organization that provides this service
... category Σ0..*CodeableConceptBroad category of service being performed or delivered
ServiceCategory (Example)

... type Σ0..*CodeableConceptType of service that may be delivered or performed
ServiceType (Example)

... specialty Σ0..*CodeableConceptSpecialties handled by the HealthcareService
service-specialty (Preferred)

... location Σ0..*Reference(Location)Location(s) where service may be provided

... name Σ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
... contact 0..*ExtendedContactDetailOfficial contact details for the HealthcareService

... coverageArea 0..*Reference(Location)Location(s) service is intended for/available to

... serviceProvisionCode 0..*CodeableConceptConditions under which service is available/offered
ServiceProvisionConditions (Example)

... eligibility 0..*BackboneElementSpecific eligibility requirements required to use the service

.... code 0..1CodeableConceptCoded value for the eligibility
ServiceEligibility (Example)
.... comment 0..1markdownDescribes the eligibility conditions for the service
... program 0..*CodeableConceptPrograms that this service is applicable to
Program (Example)

... characteristic 0..*CodeableConceptCollection of characteristics (attributes)
ServiceCharacteristic (Example)

... communication 0..*CodeableConceptThe language that this service is offered in
Common Languages (Preferred but limited to AllLanguages)

... referralMethod 0..*CodeableConceptWays that the service accepts referrals
ReferralMethod (Example)

... appointmentRequired 0..1booleanIf an appointment is required for access to this service
... availability 0..*AvailabilityTimes the healthcare service is available (including exceptions)

... endpoint 0..*Reference(Endpoint)Technical endpoints providing access to electronic services operated for the healthcare service


doco Documentation for this format

UML Diagram (Legend)

HealthcareService (DomainResource)External identifiers for this itemidentifier : Identifier [0..*]This flag is used to mark the record to not be used. This is not used when a center is closed for maintenance, or for holidays, the notAvailable period is to be used for this (this element modifies the meaning of other elements)active : boolean [0..1]The organization that provides this healthcare serviceprovidedBy : Reference [0..1] « Organization »When the HealthcareService is representing a specific, schedulable service, the availableIn property can refer to a generic serviceofferedIn : Reference [0..*] « HealthcareService »Identifies the broad category of service being performed or deliveredcategory : CodeableConcept [0..*] « null (Strength=Example)ServiceCategory?? »The specific type of service that may be delivered or performedtype : CodeableConcept [0..*] « null (Strength=Example)ServiceType?? »Collection of specialties handled by the Healthcare service. This is more of a medical termspecialty : CodeableConcept [0..*] « null (Strength=Preferred)service-specialty? »The location(s) where this healthcare service may be providedlocation : Reference [0..*] « Location »Further description of the service as it would be presented to a consumer while searchingname : string [0..1]Any additional description of the service and/or any specific issues not covered by the other attributes, which can be displayed as further detail under the serviceNamecomment : string [0..1]Extra details about the service that can't be placed in the other fieldsextraDetails : markdown [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 listphoto : Attachment [0..1]The contact details of communication devices available relevant to the specific HealthcareService. This can include addresses, phone numbers, fax numbers, mobile numbers, email addresses and web sitescontact : ExtendedContactDetail [0..*]The location(s) that this service is available to (not where the service is provided)coverageArea : Reference [0..*] « Location »The code(s) that detail the conditions under which the healthcare service is available/offeredserviceProvisionCode : CodeableConcept [0..*] « null (Strength=Example) ServiceProvisionConditions?? »Programs that this service is applicable toprogram : CodeableConcept [0..*] « null (Strength=Example)Program?? »Collection of characteristics (attributes)characteristic : CodeableConcept [0..*] « null (Strength=Example)ServiceCharacteristic?? »Some services are specifically made available in multiple languages, this property permits a directory to declare the languages this is offered in. Typically this is only provided where a service operates in communities with mixed languages usedcommunication : CodeableConcept [0..*] « null (Strength=Preferred)CommonLanguages? »Ways that the service accepts referrals, if this is not provided then it is implied that no referral is requiredreferralMethod : CodeableConcept [0..*] « null (Strength=Example)ReferralMethod?? »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 serviceappointmentRequired : boolean [0..1]A collection of times that the healthcare service is availableavailability : Availability [0..*]Technical endpoints providing access to services operated for the specific healthcare services defined at this resourceendpoint : Reference [0..*] « Endpoint »EligibilityCoded value for the eligibilitycode : CodeableConcept [0..1] « null (Strength=Example)ServiceEligibility?? »Describes the eligibility conditions for the servicecomment : markdown [0..1]Does this service have specific eligibility requirements that need to be met in order to use the service?eligibility[0..*]

XML Template

<HealthcareService xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- 0..* Identifier External identifiers for this item --></identifier>
 <active value="[boolean]"/><!-- 0..1 Whether this HealthcareService record is in active use -->
 <providedBy><!-- 0..1 Reference(Organization) Organization that provides this service --></providedBy>
 <offeredIn><!-- 0..* Reference(HealthcareService) The service within which this service is offered --></offeredIn>
 <category><!-- 0..* CodeableConcept Broad category of service being performed or delivered --></category>
 <type><!-- 0..* CodeableConcept Type of service that may be delivered or performed --></type>
 <specialty><!-- 0..* CodeableConcept Specialties handled by the HealthcareService  --></specialty>
 <location><!-- 0..* Reference(Location) Location(s) where service may be provided --></location>
 <name value="[string]"/><!-- 0..1 Description of service as presented to a consumer while searching -->
 <comment value="[string]"/><!-- 0..1 Additional description and/or any specific issues not covered elsewhere -->
 <extraDetails value="[markdown]"/><!-- 0..1 Extra details about the service that can't be placed in the other fields -->
 <photo><!-- 0..1 Attachment Facilitates quick identification of the service --></photo>
 <contact><!-- 0..* ExtendedContactDetail Official contact details for the HealthcareService --></contact>
 <coverageArea><!-- 0..* Reference(Location) Location(s) service is intended for/available to --></coverageArea>
 <serviceProvisionCode><!-- 0..* CodeableConcept Conditions under which service is available/offered --></serviceProvisionCode>
 <eligibility>  <!-- 0..* Specific eligibility requirements required to use the service -->
  <code><!-- 0..1 CodeableConcept Coded value for the eligibility --></code>
  <comment value="[markdown]"/><!-- 0..1 Describes the eligibility conditions for the service -->
 </eligibility>
 <program><!-- 0..* CodeableConcept Programs that this service is applicable to --></program>
 <characteristic><!-- 0..* CodeableConcept Collection of characteristics (attributes) --></characteristic>
 <communication><!-- 0..* CodeableConcept The language that this service is offered in --></communication>
 <referralMethod><!-- 0..* CodeableConcept Ways that the service accepts referrals --></referralMethod>
 <appointmentRequired value="[boolean]"/><!-- 0..1 If an appointment is required for access to this service -->
 <availability><!-- 0..* Availability Times the healthcare service is available (including exceptions) --></availability>
 <endpoint><!-- 0..* Reference(Endpoint) Technical endpoints providing access to electronic services operated for the healthcare service --></endpoint>
</HealthcareService>

JSON Template

{doco
  "resourceType" : "HealthcareService",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // External identifiers for this item
  "active" : <boolean>, // Whether this HealthcareService record is in active use
  "providedBy" : { Reference(Organization) }, // Organization that provides this service
  "offeredIn" : [{ Reference(HealthcareService) }], // The service within which this service is offered
  "category" : [{ CodeableConcept }], // Broad category of service being performed or delivered
  "type" : [{ CodeableConcept }], // Type of service that may be delivered or performed
  "specialty" : [{ CodeableConcept }], // Specialties handled by the HealthcareService 
  "location" : [{ Reference(Location) }], // Location(s) where service may be provided
  "name" : "<string>", // Description of service as presented to a consumer while searching
  "comment" : "<string>", // Additional description and/or any specific issues not covered elsewhere
  "extraDetails" : "<markdown>", // Extra details about the service that can't be placed in the other fields
  "photo" : { Attachment }, // Facilitates quick identification of the service
  "contact" : [{ ExtendedContactDetail }], // Official contact details for the HealthcareService
  "coverageArea" : [{ Reference(Location) }], // Location(s) service is intended for/available to
  "serviceProvisionCode" : [{ CodeableConcept }], // Conditions under which service is available/offered
  "eligibility" : [{ // Specific eligibility requirements required to use the service
    "code" : { CodeableConcept }, // Coded value for the eligibility
    "comment" : "<markdown>" // Describes the eligibility conditions for the service
  }],
  "program" : [{ CodeableConcept }], // Programs that this service is applicable to
  "characteristic" : [{ CodeableConcept }], // Collection of characteristics (attributes)
  "communication" : [{ CodeableConcept }], // The language that this service is offered in
  "referralMethod" : [{ CodeableConcept }], // Ways that the service accepts referrals
  "appointmentRequired" : <boolean>, // If an appointment is required for access to this service
  "availability" : [{ Availability }], // Times the healthcare service is available (including exceptions)
  "endpoint" : [{ Reference(Endpoint) }] // Technical endpoints providing access to electronic services operated for the healthcare service
}

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:HealthcareService;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:HealthcareService.identifier [ Identifier ], ... ; # 0..* External identifiers for this item
  fhir:HealthcareService.active [ boolean ]; # 0..1 Whether this HealthcareService record is in active use
  fhir:HealthcareService.providedBy [ Reference(Organization) ]; # 0..1 Organization that provides this service
  fhir:HealthcareService.offeredIn [ Reference(HealthcareService) ], ... ; # 0..* The service within which this service is offered
  fhir:HealthcareService.category [ CodeableConcept ], ... ; # 0..* Broad category of service being performed or delivered
  fhir:HealthcareService.type [ CodeableConcept ], ... ; # 0..* Type of service that may be delivered or performed
  fhir:HealthcareService.specialty [ CodeableConcept ], ... ; # 0..* Specialties handled by the HealthcareService
  fhir:HealthcareService.location [ Reference(Location) ], ... ; # 0..* Location(s) where service may be provided
  fhir:HealthcareService.name [ string ]; # 0..1 Description of service as presented to a consumer while searching
  fhir:HealthcareService.comment [ string ]; # 0..1 Additional description and/or any specific issues not covered elsewhere
  fhir:HealthcareService.extraDetails [ markdown ]; # 0..1 Extra details about the service that can't be placed in the other fields
  fhir:HealthcareService.photo [ Attachment ]; # 0..1 Facilitates quick identification of the service
  fhir:HealthcareService.contact [ ExtendedContactDetail ], ... ; # 0..* Official contact details for the HealthcareService
  fhir:HealthcareService.coverageArea [ Reference(Location) ], ... ; # 0..* Location(s) service is intended for/available to
  fhir:HealthcareService.serviceProvisionCode [ CodeableConcept ], ... ; # 0..* Conditions under which service is available/offered
  fhir:HealthcareService.eligibility [ # 0..* Specific eligibility requirements required to use the service
    fhir:HealthcareService.eligibility.code [ CodeableConcept ]; # 0..1 Coded value for the eligibility
    fhir:HealthcareService.eligibility.comment [ markdown ]; # 0..1 Describes the eligibility conditions for the service
  ], ...;
  fhir:HealthcareService.program [ CodeableConcept ], ... ; # 0..* Programs that this service is applicable to
  fhir:HealthcareService.characteristic [ CodeableConcept ], ... ; # 0..* Collection of characteristics (attributes)
  fhir:HealthcareService.communication [ CodeableConcept ], ... ; # 0..* The language that this service is offered in
  fhir:HealthcareService.referralMethod [ CodeableConcept ], ... ; # 0..* Ways that the service accepts referrals
  fhir:HealthcareService.appointmentRequired [ boolean ]; # 0..1 If an appointment is required for access to this service
  fhir:HealthcareService.availability [ Availability ], ... ; # 0..* Times the healthcare service is available (including exceptions)
  fhir:HealthcareService.endpoint [ Reference(Endpoint) ], ... ; # 0..* Technical endpoints providing access to electronic services operated for the healthcare service
]

Changes since Release 4

HealthcareService
HealthcareService.offeredIn
  • Added Element
HealthcareService.contact
  • Added Element
HealthcareService.availability
  • Added Element
HealthcareService.telecom
  • deleted
HealthcareService.availableTime
  • deleted
HealthcareService.notAvailable
  • deleted
HealthcareService.availabilityExceptions
  • deleted

See the Full Difference for further information

This analysis is available as XML or JSON.

See R3 <--> R4 Conversion Maps (status = 1 test that all execute ok. All tests pass round-trip testing and 1 r3 resources are invalid (0 errors).)

 

See the Profiles & Extensions and the alternate definitions: Master Definition XML + JSON, XML Schema/Schematron + JSON Schema, ShEx (for Turtle) + see the extensions, the spreadsheet version & the dependency analysis

PathDefinitionTypeReference
HealthcareService.category ExampleServiceCategory
HealthcareService.type ExampleServiceType
HealthcareService.specialty Preferredhttp://hl7.org/fhir/ValueSet/c80-practice-codes
HealthcareService.serviceProvisionCode ExampleServiceProvisionConditions
HealthcareService.eligibility.code Example??
HealthcareService.program ExampleProgram
HealthcareService.characteristic Example??
HealthcareService.communication Preferred, but limited to AllLanguagesCommonLanguages
HealthcareService.referralMethod ExampleReferralMethod

  • The HealthcareService could be mapped to components of the IHE Care Services Directory, and/or the OMG ServD standards

Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.

NameTypeDescriptionExpressionIn Common
active NtokenThe Healthcare Service is currently marked as activeHealthcareService.active
characteristictokenOne of the HealthcareService's characteristicsHealthcareService.characteristic
coverage-areareferenceLocation(s) service is intended for/available toHealthcareService.coverageArea
(Location)
endpointreferenceTechnical endpoints providing access to electronic services operated for the healthcare serviceHealthcareService.endpoint
(Endpoint)
identifiertokenExternal identifiers for this itemHealthcareService.identifier
locationreferenceThe location of the Healthcare ServiceHealthcareService.location
(Location)
name NstringA portion of the Healthcare service nameHealthcareService.name
offered-inreferenceThe service within which this service is offeredHealthcareService.offeredIn
(HealthcareService)
organizationreferenceThe organization that provides this Healthcare ServiceHealthcareService.providedBy
(Organization)
programtokenOne of the Programs supported by this HealthcareServiceHealthcareService.program
service-categorytokenService Category of the Healthcare ServiceHealthcareService.category
service-typetokenThe type of service provided by this healthcare serviceHealthcareService.type
specialtytokenThe specialty of the service provided by this healthcare serviceHealthcareService.specialty