Appointment Management

From Hiasobi - FHIR
Revision as of 16:32, 13 October 2017 by Brett Esler (Talk | contribs)

Jump to: navigation, search

Information

See: Core FHIR Resources Appointment, Schedule, Slot

Todo: Oridashi Profiles for Appointment, Schedule and Slot

Available Slots

  • Schedules (Appointment Book) can be retrieved from FHIR interface (FHIR Schedule)
  • Each FHIR Schedule is for a provider (FHIR Practitioner); there may be multiple sessions per day
  • A FHIR extension defines the nominal slot period length for each Schedule
  • Free/Busy slots are available (FHIR Slot)

Appointments Requiring Action

  • Practice components search for requested/cancelled appointments from a cloud endpoint
  • Search by:
    • Appointment.status=pending - are requests that are not confirmed yet (indicates a request)
    • Appointement.location.identifier - identifies the practice associated with the appointment request

FHIR API search request:

GET [base]/Appointment?status=pending&location.identifier=<siteid>&_include=Appointment:actor

FHIR API search response:

  • Return a FHIR Bundle
  • Bundle.entry will contain Appointment resources
  • Appointment indicating are request structured like:
Appointment
 status=pending - indicates appointment needs attention
 start - expected visit start date/time
 end - expected visit end date/time
 slot - optional reference to a free/busy Slot resource
 participant [0] - participant practitioner
   type=PPRF|http://hl7.org/fhir/v3/ParticipationType - coded participation (primary performer is the attending clinician) 
   actor is Practitioner - reference to Practitioner  (FHIR internal identifier) 
   required=required - coded indicates this participation in the appointment is needed
   status = needs-action - coded indicates the participation is not confirmed
 participant [1]
   type = null
   actor is Patient - reference to Patient (FHIR internal identifier) 
   required = required- coded indicates this participation in the appointment is needed
   status = accepted - coded indicates the participation is not confirmed
 participant [2] 
   type = null
   actor is Location - reference to Location (FHIR internal identifier) 
   required = required- coded indicates this participation in the appointment is needed
   status = needs-action - coded indicates the participation is not confirmed

Appointment Accept/Reject

Clinic will update appointment to accept or reject it

PUT [base]/Appointment/<id>


Structure is like:

Appointment
  participant[0]
    status = accepted | declined
  participant[2]
    status = accepted | declined