Scheduling Support

Search appointment books as Schedule resource

See: Core FHIR Resources Appointment, Schedule, Slot

REQUEST

Appointment books may be broken in to periods during a single day.

Get 'all' is 6 weeks of all practitioners as Schedule resource:

GET [base]/Schedule HTTP/1.1
Accept: application/fhir+json

Get all schedules for a practitioner:

GET [base]/Schedule?actor=Practitioner/<practitioner id> HTTP/1.1
Accept: application/fhir+json

Get all schedules for a location:

GET [base]/Schedule?actor=Location/<location id> HTTP/1.1
Accept: application/fhir+json

Get all schedules for a practitioner at a location on a date:

GET [base]/Schedule?date=<date>&actor=Practitioner/<practitioner id>&actor=Location/<location id> HTTP/1.1
Accept: application/fhir+json

Can include Practitioner and Locations details also

&_include=Schedule:actor

RESPONSE

• Return a FHIR Bundle
• Bundle.entry will contain Schedule entries
• Example response in xml and json format:

schedule-response-json

Search available slots as Slot resource

REQUEST

• LIMITED SUPPORT Get all slots in a given schedule (appointment book)
• add $_count=10000 if you don't want response bundle paging

GET [base]/Slot?schedule=<schedule.id> HTTP/1.1
Accept: application/fhir+json

RESPONSE

• Return a FHIR Bundle
• Bundle.entry will contain Slot entries
• Example response in xml + json format:

slot-response-json

Appointment Details

• Create a FHIR Appointment resource instance to submit based on the slot start/end and practitioner info
• 1..1 status : pending (appointment is proposed)
• 1..1 start/ 1..1 end : date-time period for the appointment
• 0..1 description : top line summary text for the appointment
• 0..* participant : entities involved with the appointment
  • actor.reference : reference the FHIR id of the entity
  • 1..1 Practitioner participant must be provided (by reference); required = required (must attend); status = needs-action (system yet to accept)

POST https://localhost.oridashi.com.au:8102/Appointment HTTP/1.1
Content-Length: 424
Accept: application/fhir+json
Content-Type: application/fhir+json
{
   "resourceType":"Appointment",
   "status":"pending",
   "start":"2018-06-21T09:30:00+10:00",
   "end":"2018-06-21T09:45:00+10:00",
   "description":"Online Appointment",
   "participant":[
      {
         "actor":{
            "reference":"Practitioner/6FA2AA1CA439ABFB38D48297E0ACC3FF.1"
         },
         "required":"required",
         "status":"needs-action"
      },
      {
         "actor":{
            "reference":"Patient/6FA2AA1CA439ABFB38D48297E0ACC3FF.2"
         },
         "required":"required",
         "status":"accepted"
      }
   ],
   "comment":"test notes"
}

example-appointment-json

Typical Usage

Get calendars and include practitioners and locations; then get slots

GET https://localhost.oridashi.com.au:8102/Schedule?date=2018-06-19&_include=Schedule:actor HTTP/1.1
Accept: application/fhir+json

Get slots from all schedules e.g. slots for each schedule by id like:

GET https://localhost.oridashi.com.au:8102/Slot?schedule=6FA2AA1CA439ABFB38D48297E0ACC3FF.1-20180619-32400-3600-900-1 HTTP/1.1
Accept: application/fhir+json

Archive Material: Appointment Management