HealthcareServiceLiteSe

Introduction

HealthcareServiceLiteSe is a profile based on the FHIR resource [HealthcareService] (https://www.hl7.org/fhir/healthcareservice.html).

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

idΣ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
colorI0..0Extension(integer)
permittedPatientActionsI0..*Extension(Coding)
modifierExtension?! I0..*Extension
identifierΣ0..*Identifier
activeΣ ?!0..1boolean
providedByΣ I0..1Reference(OrganizationSEVendorLite)
categoryΣ0..1CodeableConcept
typeΣ0..0CodeableConcept
specialtyΣ0..0CodeableConceptBinding
locationΣ I0..*Reference(Location)
nameΣ1..1string
commentΣ0..0string
extraDetails0..0markdown
photoΣ I0..0Attachment
telecomI0..0ContactPoint
coverageAreaI0..0Reference(Location)
serviceProvisionCode0..0CodeableConcept
program0..0CodeableConcept
characteristic0..0CodeableConcept
communication0..0CodeableConceptBinding
referralMethod0..0CodeableConcept
appointmentRequired0..0boolean
availabilityExceptions0..0string
endpointI0..0Reference(Endpoint)

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
SEARCH 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

  • Search [baseURL]/HealthcareService/[location]

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.