0.2.0 - trial-use

KisimScheduling - Local Development build (v0.2.0). See the Directory of published versions

Home

Official URL: http://fhir.kisimdocs.ch/ig/KisimScheduling/ImplementationGuide/hl7.fhir.ch.kisimscheduling Version: 0.2.0
Active as of 2022-10-05 Computable Name: KisimScheduling

KISIM Scheduling

The following Implementation Guide (IG) describes the interaction with the Cistec AG scheduling services.

The implementation is split into two different use cases as described below. Additionally, to the basic use cases there are some operations which can be used to support the scheduling process, such as search for already created appointments and check for schedules and the offered service categories.

Booking workflow

Basic situation

Due to the specific situation in a hospital, the appointment booking process can be quite complex. Resources (Practitioners, Locations) inside a hospital are scarce and expensive, therefore the capacity utilization has to be as high as possible. The implementation described here uses already existing resources inside the hospital and publishes a subset of those resources on a FHIR-Interface. As a consequence there are some constraints concerning the time to live of a Slot resource or the acceptance of an appointment inside the system.

Accept a booked appointment

Unfortunately it is not possible for a Patient or a Practitioner to simply book an appointment in a hospital and show up on the booked time. For that reason the appointment booking and the appointment confirmation are asynchronously. This means that after an appointment booking, the hospital has to verify the booked appointment, clear the patient, create an encounter and might do some additional administrative steps.

To counter that problem, an appointment booking sends the client an affirmation for a successful booking. After that, the hospital specific processes start. After those are finished, the client receives an appointment response with a status if the appointment is accepted or declined.

Resources

The following resources are supported/needed for this IG:

Vocabulary

Name Description
CISTEC The publisher of this IG
KISIM The clinical information system from CISTEC
Plan A search plan defined in KISIM. This plan contains the locations to search for free slots and some additional info such as duration of a default appointment. The plan is not accessible in fhir as of yet
User/USER A Practitioner, the identifier of a practitioner inside KISIM (USER)
Room/KONS A Location, the identifier of a Room/Location inside KISIM (KONS)

Optional workflow

Use Cases

There are two use cases which are described by this IG.

UseCase 1: Scheduling when the client does not know the servers internal patient identifier

In this case the client does not know anything about server internal patient records. This might be the case in an online booking application from an external website.

This use case is described here

UseCase 2: Scheduling when the client knows the patient identifier

In this case the client knows the internal patient identifier. This might be the case in a portal application or an application which can do a patient clearing in a different way.

This use case is described here

Workflow

The workflow for both use cases is nearly the same, step 3 is not required for UseCase 2.

  1. Search for open slots
  2. Send an appointment resource with a slot reference and a patient (contained or reference) back (reservation of this slot)
  3. Send additional info if needed (Service request for non-patient clearing applications)
  4. Wait for an appointment response which will be triggered asynchronous. The appointment response contains the information if the appointment has been accepted or has been declined.
  5. Alternatively to the step before, the client can poll the actual appointment and check the status.

Additional Requirements

The client system has to expose an AppointmentResponse-Endpoint. The response for a specific appointment will be sent there asynchronous.