HealthcareServiceLiteSe
Introduction
HealthcareServiceLiteSe is a profile based on the FHIR resource HealthcareService.
Intended Use
HealthcareServiceLiteSe is used as part of the booking flow, where this profile searches for a list of healthcare services that may be used to book an appointment.
Specific Rules and Limitations
Type | Description |
---|---|
Rule | The patient header 'Patient' must be included. |
Rule | The consumer of the API is responsible for making sure data retrieved is filtered in compliance with laws and regulations prior to presenting it to any end-users. |
Rule | For reading healthcare services, the external system needs to be able to evaluate PDL. This means whether the information can be displayed for a healthcare professional with a specific assignment. PDL data needed (HSA care unit and HSA care provider) is in the OrganizationSEVendorLite profile referenced in HealthcareServiceLiteSe.providedBy. |
Profile Overview
HealthcareServiceLiteSe (HealthcareService) | I | HealthcareServiceCoreSe | There are no (further) constraints on this element Element idHealthcareService The details of a healthcare service available at a location DefinitionThe details of a healthcare service available at a location.
| |
id | Σ | 0..1 | string | There are no (further) constraints on this element Element idHealthcareService.id Logical id of this artifact DefinitionThe logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes. The only time that a resource does not have an id is when it is being submitted to the server using a create operation. |
meta | Σ | 0..1 | Meta | There are no (further) constraints on this element Element idHealthcareService.meta Metadata about the resource DefinitionThe metadata about the resource. This is content that is maintained by the infrastructure. Changes to the content might not always be associated with version changes to the resource.
|
implicitRules | Σ ?! | 0..1 | uri | There are no (further) constraints on this element Element idHealthcareService.implicitRules A set of rules under which this content was created DefinitionA reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content. Often, this is a reference to an implementation guide that defines the special rules along with other profiles etc. Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element. Often, when used, the URL is a reference to an implementation guide that defines these special rules as part of it's narrative along with other profiles, value sets, etc.
|
language | 0..1 | codeBinding | There are no (further) constraints on this element Element idHealthcareService.language Language of the resource content DefinitionThe base language in which the resource is written. Language is provided to support indexing and accessibility (typically, services such as text to speech use the language tag). The html language tag in the narrative applies to the narrative. The language tag on the resource may be used to specify the language of other presentations generated from the data in the resource. Not all the content has to be in the base language. The Resource.language should not be assumed to apply to the narrative automatically. If a language is specified, it should it also be specified on the div element in the html (see rules in HTML5 for information about the relationship between xml:lang and the html lang attribute). A human language.
| |
text | 0..1 | Narrative | There are no (further) constraints on this element Element idHealthcareService.text Text summary of the resource, for human interpretation Alternate namesnarrative, html, xhtml, display DefinitionA human-readable narrative that contains a summary of the resource and can be used to represent the content of the resource to a human. The narrative need not encode all the structured data, but is required to contain sufficient detail to make it "clinically safe" for a human to just read the narrative. Resource definitions may define what content should be represented in the narrative to ensure clinical safety. Contained resources do not have narrative. Resources that are not contained SHOULD have a narrative. In some cases, a resource may only have text with little or no additional discrete data (as long as all minOccurs=1 elements are satisfied). This may be necessary for data from legacy systems where information is captured as a "text blob" or where text is additionally entered raw or narrated and encoded information is added later.
| |
contained | 0..* | Resource | There are no (further) constraints on this element Element idHealthcareService.contained Contained, inline Resources Alternate namesinline resources, anonymous resources, contained resources DefinitionThese resources do not have an independent existence apart from the resource that contains them - they cannot be identified independently, and nor can they have their own independent transaction scope. This should never be done when the content can be identified properly, as once identification is lost, it is extremely difficult (and context dependent) to restore it again. Contained resources may have profiles and tags In their meta elements, but SHALL NOT have security labels.
| |
extension | I | 0..* | Extension | Element idHealthcareService.extension Additional content defined by implementations Alternate namesextensions, user content DefinitionMay be used to represent additional information that is not part of the basic definition of the resource. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. Unordered, Open, by url(Value) Extensions are always sliced by (at least) url Constraints
|
color | I | 0..0 | Extension(integer) | Element idHealthcareService.extension:color Color used to visulize the Healthcare Service Alternate namesextensions, user content DefinitionColor used to visulize the Healthcare Service. Can be used when visulizing a schedule. There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. https://fhir.cambio.se/StructureDefinition/common-scheduleColor Constraints
|
permittedPatientActions | I | 0..* | Extension(Coding) | There are no (further) constraints on this element Element idHealthcareService.extension:permittedPatientActions Use to describe what a patient is permitted to do Alternate namesextensions, user content DefinitionUse to describe what a patient is permitted to do in the area of booking, rebooking and cancellations. There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. http://cambio.se/fhir/StructureDefinition/common-permittedPatientActions/v1 Constraints
|
modifierExtension | ?! I | 0..* | Extension | There are no (further) constraints on this element Element idHealthcareService.modifierExtension Extensions that cannot be ignored Alternate namesextensions, user content DefinitionMay be used to represent additional information that is not part of the basic definition of the resource and that modifies the understanding of the element that contains it and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself). Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions. There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. Unordered, Open, by url(Value) Extensions are always sliced by (at least) url Constraints
|
identifier | Σ | 0..* | Identifier | There are no (further) constraints on this element Element idHealthcareService.identifier External identifiers for this item DefinitionExternal identifiers for this item.
|
active | Σ ?! | 0..1 | boolean | There are no (further) constraints on this element Element idHealthcareService.active Whether this HealthcareService record is in active use DefinitionThis 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 is labeled as a modifier because it may be used to mark that the resource was created in error. This resource is generally assumed to be active if no value is provided for the active element
|
providedBy | Σ I | 0..1 | Reference(OrganizationSEVendorLite) | Element idHealthcareService.providedBy Organization that provides this service DefinitionThe organization that provides this healthcare service. 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. Reference(OrganizationSEVendorLite) Constraints
|
category | Σ | 0..1 | CodeableConcept | Element idHealthcareService.category Broad category of service being performed or delivered Alternate namesservice category DefinitionIdentifies 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. Can be used for defining if the healthcare service is used for In-patient or Out-Patient appointments. A category of the service(s) that could be provided.
|
type | Σ | 0..0 | CodeableConcept | There are no (further) constraints on this element Element idHealthcareService.type Type of service that may be delivered or performed Alternate namesservice type DefinitionThe specific type of service that may be delivered or performed. Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination. Additional details about where the content was created (e.g. clinical specialty).
|
specialty | Σ | 0..0 | CodeableConceptBinding | There are no (further) constraints on this element Element idHealthcareService.specialty Specialties handled by the HealthcareService DefinitionCollection of specialties handled by the service site. This is more of a medical term. Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination. A specialty that a healthcare service may provide.
|
location | Σ I | 0..* | Reference(Location) | There are no (further) constraints on this element Element idHealthcareService.location Location(s) where service may be provided DefinitionThe location(s) where this healthcare service may be provided. References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc.). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository.
|
name | Σ | 1..1 | string | There are no (further) constraints on this element Element idHealthcareService.name Description of service as presented to a consumer while searching DefinitionFurther description of the service as it would be presented to a consumer while searching. Note that FHIR strings SHALL NOT exceed 1MB in size
|
comment | Σ | 0..0 | string | There are no (further) constraints on this element Element idHealthcareService.comment Additional description and/or any specific issues not covered elsewhere DefinitionAny 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. 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.
|
extraDetails | 0..0 | markdown | There are no (further) constraints on this element Element idHealthcareService.extraDetails Extra details about the service that can't be placed in the other fields DefinitionExtra details about the service that can't be placed in the other fields. Systems are not required to have markdown support, so the text should be readable without markdown processing. The markdown syntax is GFM - see https://github.github.com/gfm/
| |
photo | Σ I | 0..0 | Attachment | There are no (further) constraints on this element Element idHealthcareService.photo Facilitates quick identification of the service DefinitionIf there is a photo/symbol associated with this HealthcareService, it may be included here to facilitate quick identification of the service in a list. When providing a summary view (for example with Observation.value[x]) Attachment should be represented with a brief display text such as "Signed Procedure Consent".
|
telecom | I | 0..0 | ContactPoint | There are no (further) constraints on this element Element idHealthcareService.telecom Contacts related to the healthcare service DefinitionList of contacts related to this specific healthcare service. If this is empty, then refer to the location's contacts.
|
coverageArea | I | 0..0 | Reference(Location) | There are no (further) constraints on this element Element idHealthcareService.coverageArea Location(s) service is intended for/available to DefinitionThe location(s) that this service is available to (not where the service is provided). 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".
|
serviceProvisionCode | 0..0 | CodeableConcept | There are no (further) constraints on this element Element idHealthcareService.serviceProvisionCode Conditions under which service is available/offered DefinitionThe code(s) that detail the conditions under which the healthcare service is available/offered. 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. The code(s) that detail the conditions under which the healthcare service is available/offered.
| |
eligibility | 0..0 | BackboneElement | There are no (further) constraints on this element Element idHealthcareService.eligibility Specific eligibility requirements required to use the service DefinitionDoes this service have specific eligibility requirements that need to be met in order to use the service?
| |
program | 0..0 | CodeableConcept | There are no (further) constraints on this element Element idHealthcareService.program Programs that this service is applicable to DefinitionPrograms that this service is applicable to. Programs are often defined externally to an Organization, commonly by governments; e.g. Home and Community Care Programs, Homeless Program, …. Government or local programs that this service applies to.
| |
characteristic | 0..0 | CodeableConcept | There are no (further) constraints on this element Element idHealthcareService.characteristic Collection of characteristics (attributes) DefinitionCollection of characteristics (attributes). These could be such things as is wheelchair accessible. A custom attribute that could be provided at a service (e.g. Wheelchair accessibiliy).
| |
communication | 0..0 | CodeableConceptBinding | There are no (further) constraints on this element Element idHealthcareService.communication The language that this service is offered in DefinitionSome 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 used. When using this property it indicates that the service is available with this language, it is not derived from the practitioners, and not all are required to use this language, just that this language is available while scheduling. A human language.
| |
referralMethod | 0..0 | CodeableConcept | There are no (further) constraints on this element Element idHealthcareService.referralMethod Ways that the service accepts referrals DefinitionWays that the service accepts referrals, if this is not provided then it is implied that no referral is required. Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination. The methods of referral can be used when referring to a specific HealthCareService resource.
| |
appointmentRequired | 0..0 | boolean | There are no (further) constraints on this element Element idHealthcareService.appointmentRequired If an appointment is required for access to this service DefinitionIndicates 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.
| |
availableTime | 0..0 | BackboneElement | There are no (further) constraints on this element Element idHealthcareService.availableTime Times the Service Site is available DefinitionA collection of times that the Service Site is available. More detailed availability information may be provided in associated Schedule/Slot resources.
| |
notAvailable | 0..0 | BackboneElement | There are no (further) constraints on this element Element idHealthcareService.notAvailable Not available during this time due to provided reason DefinitionThe HealthcareService is not available during this period of time due to the provided reason.
| |
availabilityExceptions | 0..0 | string | There are no (further) constraints on this element Element idHealthcareService.availabilityExceptions Description of availability exceptions DefinitionA 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. Note that FHIR strings SHALL NOT exceed 1MB in size
| |
endpoint | I | 0..0 | Reference(Endpoint) | There are no (further) constraints on this element Element idHealthcareService.endpoint Technical endpoints providing access to electronic services operated for the healthcare service DefinitionTechnical endpoints providing access to services operated for the specific healthcare services defined at this resource. References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc.). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository.
|
Versions
COS version | Profile version | Required COSMIC version | Date | Description |
---|---|---|---|---|
3.0.0 | 1.0.0 | R8.3.05 | May 2022 | Initial version, support for search. |
Extensions
Extension | Data type | Description |
---|---|---|
PermittedPatientActions | Coding | Describes what actions the patient have permission for. Never mapped on HealthcareServiceLiteSe. Only available on Appointment. |
Supported Operations
HTTP Methods
Method | Description |
---|---|
GET | Search for a list of healthcare services based on a search parameter. |
Query Operations
Search Parameters
Parameter | Format | Mandatory | Comment |
---|---|---|---|
Location | Identifier | Yes | |
_Profile | URL | Yes |
Supported Queries
GET [baseURL]/HealthcareService/_search?location=<reference>
GET [baseURL]/HealthcareService/_search?location.identifier=<identifier reference>
Supported SearchInclude operations
N/A
Supported RevInclude operations
N/A
Error Codes
In the table below, a few error messages specific for HealthcareServices are listed.
Code | Description | Comment |
---|---|---|
400 | Request header 'patient' is required. | Mandatory for MVK flow. |
400 | Could not resolve location identifier. |