R4 Draft for Comment

This page is part of the FHIR Specification (v3.2.0: R4 Ballot 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

Patient Administration Work GroupMaturity Level: 2 Trial Use Compartments: Not linked to any defined compartments

Detailed Descriptions for the elements in the HealthcareService resource.

HealthcareService
Definition

The details of a healthcare service available at a location.

Control1..1
HealthcareService.identifier
Definition

External identifiers for this item.

NoteThis is a business identifer, not a resource identifier (see discussion)
Control0..*
TypeIdentifier
Summarytrue
HealthcareService.active
Definition

This flag is used to mark the record to not be used. This is not used when a centre is closed for maintenance, or for holidays, the notAvailable period is to be used for this.

Control0..1
Typeboolean
Is Modifiertrue
Default Valuetrue
Summarytrue
Comments

This element is labeled as a modifier because it may be used to mark that the resource was created in error.

HealthcareService.providedBy
Definition

The organization that provides this healthcare service.

Control0..1
TypeReference(Organization)
Summarytrue
Comments

This property is recommended to be the same as the Location's managingOrganization, and if not provided should be interpreted as such. If the Location does not have a managing Organization, then this property should be populated.

HealthcareService.category
Definition

Identifies the broad category of service being performed or delivered.

Control0..1
Terminology BindingServiceCategory (Example)
TypeCodeableConcept
Alternate Namesservice category
Summarytrue
Comments

Selecting a Service Category then determines the list of relevant service types that can be selected in the primary service type.

HealthcareService.type
Definition

The specific type of service that may be delivered or performed.

Control0..*
Terminology BindingServiceType (Example)
TypeCodeableConcept
Alternate Namesservice type
Summarytrue
HealthcareService.specialty
Definition

Collection of specialties handled by the service site. This is more of a medical term.

Control0..*
Terminology BindingPractice Setting Code Value Set (Preferred)
TypeCodeableConcept
Summarytrue
HealthcareService.location
Definition

The location(s) where this healthcare service may be provided.

Control0..*
TypeReference(Location)
Summarytrue
HealthcareService.name
Definition

Further description of the service as it would be presented to a consumer while searching.

Control0..1
Typestring
Summarytrue
HealthcareService.comment
Definition

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 serviceName.

Control0..1
Typestring
Summarytrue
Comments

Would expect that a user would not see this information on a search results, and it would only be available when viewing the complete details of the service.

HealthcareService.extraDetails
Definition

Extra details about the service that can't be placed in the other fields.

Control0..1
Typestring
HealthcareService.photo
Definition

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.

Control0..1
TypeAttachment
Summarytrue
HealthcareService.telecom
Definition

List of contacts related to this specific healthcare service.

Control0..*
TypeContactPoint
Comments

If this is empty, then refer to the location's contacts.

HealthcareService.coverageArea
Definition

The location(s) that this service is available to (not where the service is provided).

Control0..*
TypeReference(Location)
Comments

The locations referenced by the coverage area can include both specific locations, including areas, and also conceptual domains too (mode = kind), such as a physical area (tri-state area) and some other attribute (covered by Example Care Organization). These types of Locations are often not managed by any specific organization. This could also include generic locations such as "in-home".

HealthcareService.serviceProvisionCode
Definition

The code(s) that detail the conditions under which the healthcare service is available/offered.

Control0..*
Terminology BindingServiceProvisionConditions (Example)
TypeCodeableConcept
Comments

The provision means being commissioned by, contractually obliged or financially sourced. Types of costings that may apply to this healthcare service, such if the service may be available for free, some discounts available, or fees apply.

HealthcareService.eligibility
Definition

Does this service have specific eligibility requirements that need to be met in order to use the service?

Control0..1
Terminology BindingServiceEligibility:
TypeCodeableConcept
HealthcareService.eligibilityNote
Definition

Describes the eligibility conditions for the service.

Control0..1
Typestring
Comments

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.

HealthcareService.programName
Definition

Program Names that can be used to categorize the service.

Control0..*
Typestring
Comments

Programs are often defined externally to an Organization, commonly by governments; e.g. Home and Community Care Programs, Homeless Program, ….

HealthcareService.characteristic
Definition

Collection of characteristics (attributes).

Control0..*
Terminology BindingServiceCharacteristic:
TypeCodeableConcept
Comments

These could be such things as is wheelchair accessible.

HealthcareService.referralMethod
Definition

Ways that the service accepts referrals, if this is not provided then it is implied that no referral is required.

Control0..*
Terminology BindingReferralMethod (Example)
TypeCodeableConcept
HealthcareService.appointmentRequired
Definition

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.

Control0..1
Typeboolean
HealthcareService.availableTime
Definition

A collection of times that the Service Site is available.

Control0..*
Comments

More detailed availability information may be provided in associated Schedule/Slot resources.

HealthcareService.availableTime.daysOfWeek
Definition

Indicates which days of the week are available between the start and end Times.

Control0..*
Terminology BindingDaysOfWeek (Required)
Typecode
HealthcareService.availableTime.allDay
Definition

Is this always available? (hence times are irrelevant) e.g. 24 hour service.

Control0..1
Typeboolean
HealthcareService.availableTime.availableStartTime
Definition

The opening time of day. Note: If the AllDay flag is set, then this time is ignored.

Control0..1
Typetime
Comments

The timezone is expected to be for where this HealthcareService is provided at.

HealthcareService.availableTime.availableEndTime
Definition

The closing time of day. Note: If the AllDay flag is set, then this time is ignored.

Control0..1
Typetime
Comments

The timezone is expected to be for where this HealthcareService is provided at.

HealthcareService.notAvailable
Definition

The HealthcareService is not available during this period of time due to the provided reason.

Control0..*
HealthcareService.notAvailable.description
Definition

The reason that can be presented to the user as to why this time is not available.

Control1..1
Typestring
HealthcareService.notAvailable.during
Definition

Service is not available (seasonally or for a public holiday) from this date.

Control0..1
TypePeriod
HealthcareService.availabilityExceptions
Definition

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.

Control0..1
Typestring
HealthcareService.endpoint
Definition

Technical endpoints providing access to services operated for the specific healthcare services defined at this resource.

Control0..*
TypeReference(Endpoint)
Requirements

Organizations may have different systems covering different services at the different locations and need to be able to define the technical connection details for how to connect to them, and for what purpose.