Need appointment details for all patients of a provider or location

231 views
Skip to first unread message

Isita Das

unread,
Sep 4, 2020, 9:32:38 AM9/4/20
to Cerner FHIR Developers
Hi,
  We want to do a POC about getting all appointment details for a provider through cerner smart on FHIR APIs. To do that, can we get any test provider Id , patient Id etc ? What type of authorization needed for that ? 
Also please let us know what is the related API to get that information of Appointments ? We need historical appointment details for a specific location or provider.

Thanks,
Isita

Max Philips (Cerner)

unread,
Sep 4, 2020, 12:25:09 PM9/4/20
to Cerner FHIR Developers
Hi Isita,

I have added some Practitioner, Location, and Slot-Type information to Cerner's test patient document, available here: https://docs.google.com/document/d/10RnVyF1etl_17pyCyK96tyhUWRbrTyEcqpwzW-Z-Ybs/edit. Please scroll to the very end and check the section entitled "Scheduling Data".

What type of authorization is needed?

Please check our documentation on fhir.cerner.com for each API you are interested in consuming, as the supported authorization types will be indicated. For example, Cerner's R4 Appointment search API supports provider and system access: http://fhir.cerner.com/millennium/r4/scheduling/appointment/#authorization-types

What are the related APIs to get Appointment information?

For both R4 and DSTU 2, you can view all our available Scheduling APIs at the following links:

Thanks,
Max (Cerner)

Isita Das

unread,
Sep 7, 2020, 4:44:59 AM9/7/20
to Cerner FHIR Developers
Hi Max,

 Thanks for your reply.

 We need one more clarification. Our objective is to get all patients historical appointments for a given location or provider. But the current API for Appointment as mentioned in http://fhir.cerner.com/millennium/r4/scheduling/ Or http://fhir.cerner.com/millennium/dstu2/scheduling/ is describing that patient Id is mandatory parameter. What should be the workaround for that ? Please suggest.

Also please suggest whether location Id, practitioner Id etc are Cerner's internal Ids ? If so, how we can get to know those ?

Thanks,
Isita

Max Philips (Cerner)

unread,
Sep 8, 2020, 11:52:19 AM9/8/20
to Cerner FHIR Developers
Hi Isita,

Cerner's FHIR APIs are patient-centric - unfortunately meaning that there is not a workaround for what you've learned in our documentation. As documented, patient is a mandatory search parameter.

Also as documented on individual pages like http://fhir.cerner.com/millennium/r4/scheduling/appointment/ in the Overview:

"When integrating your application with a client’s production environment you will work with the client to determine the Practitioner and Location ids (Millennium personnel and location codes, respectively) which they want to make available to third-party applications for enabling scheduling functionality."

In the sandbox environment as mentioned in this thread, we will provide you the ids. And as you work through the development process, Cerner will facilitate continued id discovery in new environments.

Thanks,
Max (Cerner)

Isita Das

unread,
Sep 10, 2020, 10:11:03 AM9/10/20
to Cerner FHIR Developers

Thanks Max.

 One more clarification needed. If a provider/hospital has multiple facility/clinics, will we get the facility/clinic name and it's type from the appointment response ? From the http://fhir.cerner.com/millennium/r4/scheduling/appointment/ , we could not detect any element related to clinic type.

Thanks,
Isita

Max Philips (Cerner)

unread,
Sep 10, 2020, 1:23:27 PM9/10/20
to Cerner FHIR Developers
Hi Isita,

It sounds like you might be after information contained in the Participant array. You should be able to find a Participant that has .actor with a reference to a Location. Each Location represents a specific facility/clinic and its .display should be returned as well.

Thanks,
Max (Cerner)

Isita Das

unread,
Sep 11, 2020, 1:30:32 AM9/11/20
to cerner-fhir...@googlegroups.com
Thanks Max. 
One more question, is there any API which will return the requests for appointments ? I.e. the appointment is not yet scheduled but the request arrived.

Regards,
Isita

--
You received this message because you are subscribed to the Google Groups "Cerner FHIR Developers" group.
To unsubscribe from this group and stop receiving emails from it, send an email to cerner-fhir-devel...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/cerner-fhir-developers/ad74a89b-6f60-41be-b6ac-69516f545729o%40googlegroups.com.

Isita Das

unread,
Sep 11, 2020, 6:05:02 AM9/11/20
to cerner-fhir...@googlegroups.com
Thanks Max. Can we get the information about type of the clinic (e.g. diabetic clinic, pediatrics clinic etc) ?

Isita

On Thu, 10 Sep 2020 at 22:53, 'Max Philips (Cerner)' via Cerner FHIR Developers <cerner-fhir...@googlegroups.com> wrote:
--

Max Philips (Cerner)

unread,
Sep 11, 2020, 1:59:24 PM9/11/20
to Cerner FHIR Developers
Hi Isita,

Is there any API which will return the requests for appointments?

If you haven't already, please feel free to review both Cerner's documentation, available here: http://fhir.cerner.com/millennium/r4/scheduling/appointment/, and HL7's documentation, available here: https://www.hl7.org/fhir/r4/valueset-appointmentstatus.html

In FHIR, requests for appointments usually fall into Appointment.status = proposed

Can we get the information about type of the clinic (e.g. diabetic clinic, pediatrics clinic etc)?

In theory, you would be able to do that by performing another query using the Location id from the Appointment.participant array entry. Note that at this time, Cerner does not expose a Location API so this is not possible.

However, as noted on fhir.cerner.com, Cerner will work with you to identify specific Locations (specific clinic types) that will help you to test and do the same when you might move to a client's domain.

Thanks,
Max (Cerner)


Isita Das

unread,
Sep 15, 2020, 8:20:46 AM9/15/20
to cerner-fhir...@googlegroups.com
Hi Max, 

  As we have seen R4 APIs give us appointment information along with servicetype. Does R4 have any API for slots ? Or to get slots we need to call DSTU2 APIs ? 
So if we need both Slot and Appointments, can we use Appointment API from R4 and slots API from DSTU from a single application ?

Please confirm.

Regards,
Isita




--
You received this message because you are subscribed to the Google Groups "Cerner FHIR Developers" group.
To unsubscribe from this group and stop receiving emails from it, send an email to cerner-fhir-devel...@googlegroups.com.

Benjamin Eichhorn (Cerner)

unread,
Sep 15, 2020, 9:14:17 AM9/15/20
to Cerner FHIR Developers
Hi,

Unfortunately we do not support the Slot resource for R4 at this time. So to use the Appointment resource in R4, yes you will need to consume the DSTU2 version of the Slot resource to retrieve Slots that can be used to book an Appointment in R4.

Thanks
Ben (Cerner)
Reply all
Reply to author
Forward
This conversation is locked
You cannot reply and perform actions on locked conversations.
0 new messages