Categories and appointment service types question

For requests or help with our API
Post Reply
jarkkok
Posts: 16
Joined: Mon Jul 26, 2021 7:46 am

Categories and appointment service types question

Post by jarkkok » Thu Jul 29, 2021 10:17 am

I'm thinking of a use case example where a patient a crown scheduled. The patient wants to cancel that appointment and reschedule crown for another date and time. Patient then want to query open slots that are available for crown operation, and pick a new appointment time from from those.

Do you categorize in major categories such filling, crown and hygienist etc?

GET /appointments/SlotsWebSched?dateStart=2021-02-15&dateEnd=2021-02-15&defNumApptType=326
-How to get explanation of defNumApptTypes?

GET /appointments/SlotsWebSched?dateStart=2021-02-15&dateEnd=2021-02-15&defNumApptType=326
-When requesting slots how do we know what to ask for in defNumApptType?

GET single appointment
-How could we determine the defNumApptType of a specific appointment?

Thank you.

SLeon
Posts: 24
Joined: Mon Mar 01, 2021 11:00 am

Re: Categories and appointment service types question

Post by SLeon » Thu Jul 29, 2021 11:07 am

The defNumApptType parameter for GET /appointments/SlotsWebSched is defined in our documentation as "definition.DefNum where definition.Category=42 (NewPat) or 51 (ExistingPat)". These are the AppointmentTypes specifically associated with the Web Scheduling eService. You can send the following API requests to list all the AppointmentTypes the office has defined for that category:
GET /definitions?Category=42
GET /definitions?Category=51

The GET /appointments/SlotsWebSched requires the office to do a bit of setup for Web Scheduling, but only those two categories (42 and 51) are ever used. If you are wanting to search for appointment slots similar to as within Open Dental (not Web Scheduling), you will want to use GET /appointments/Slots instead. More about this other method can be accessed from the first link on our manual page https://www.opendental.com/manual212/fhir.html.

jarkkok
Posts: 16
Joined: Mon Jul 26, 2021 7:46 am

Re: Categories and appointment service types question

Post by jarkkok » Fri Jul 30, 2021 2:29 pm

Thank you for the help, Sleon. Much appreciated.

One more question about this, please. I currently have Patient and Appointment permissions for development purposes (no real patient data). https://www.opendental.com/manual/websc ... setup.html says that "Sign up for Web Sched Existing Patient" and https://www.opendental.com/site/websched.html says that "Practices must be on support with a unique registration key to use Web Sched". Do I need upgraded priviledges for Existing and New Patient WebSched?

I have created Appointment Types and linked Appointment Types and Operatories to WebSched (to both New and Existing patient) so I believe those should be available, but I get no time slots when I do:
https://api.opendental.com/api/v1/appoi ... ptType=308

https://api.opendental.com/api/v1/defin ... ategory=51 results:
[
{
"DefNum": 307,
"ItemName": "Emergency/Tooth Pain",
"ItemValue": "",
"Category": 51,
"category": "WebSchedExistingApptTypes",
"isHidden": "false"
},
{
"DefNum": 308,
"ItemName": "Cosmetic Whitening",
"ItemValue": "",
"Category": 51,
"category": "WebSchedExistingApptTypes",
"isHidden": "false"
},
{
"DefNum": 320,
"ItemName": "Extraction",
"ItemValue": "",
"Category": 51,
"category": "WebSchedExistingApptTypes",
"isHidden": "false"
},
{
"DefNum": 323,
"ItemName": "Existing fix",
"ItemValue": "",
"Category": 51,
"category": "WebSchedExistingApptTypes",
"isHidden": "false"
}
]

Thank you

jarkkok
Posts: 16
Joined: Mon Jul 26, 2021 7:46 am

Re: Categories and appointment service types question

Post by jarkkok » Tue Aug 03, 2021 7:48 am

I got the GET SlotsWebSched working.

To further clarify my question about service types, I'd like to ask:

In our app we are trying to reschedule an existing appointment. We have the appointment Id so we can query the API for appointment details.

In order to reschedule we call “get SlotsWebsched”. This API call requires us to specify an appointment type.

How can we figure out the appt type based on the details of the existing appointment?

Thank you.

SLeon
Posts: 24
Joined: Mon Mar 01, 2021 11:00 am

Re: Categories and appointment service types question

Post by SLeon » Tue Aug 03, 2021 8:53 am

I am glad to hear you were able to get GET SlotsWebSched working! The appointment type is not currently a field that is returned when using GET appointments, but is clearly necessary for this workflow. I will add this to our development list.

Do you have any remaining questions/concerns about using GET SlotsWebSched?

jarkkok
Posts: 16
Joined: Mon Jul 26, 2021 7:46 am

Re: Categories and appointment service types question

Post by jarkkok » Tue Aug 03, 2021 11:08 am

Very good to hear you added appointment type to the development list.

I'll back back to you soon if there's more that could be good for the GET SlotsWebSched. Now I believe location Id (ClinicNum) might be useful. There's an Op (operatory), but a more specific location may be good.

jarkkok
Posts: 16
Joined: Mon Jul 26, 2021 7:46 am

Re: Categories and appointment service types question

Post by jarkkok » Wed Aug 04, 2021 8:10 am

This service type should go to both GET single appointment and GET multiple appointments.

jarkkok
Posts: 16
Joined: Mon Jul 26, 2021 7:46 am

Re: Categories and appointment service types question

Post by jarkkok » Fri Aug 06, 2021 2:07 pm

There's one more thing about Appointments GET SlotsWebSched. The specs say ClinicNum: Required if clinics enabled.

How do I find out if clinics are enabled?

SLeon
Posts: 24
Joined: Mon Mar 01, 2021 11:00 am

Re: Categories and appointment service types question

Post by SLeon » Fri Aug 06, 2021 2:30 pm

Whether clinics are enabled are not is stored as a preference so you can utilize the Preferences GET method for this. The PrefName is called EasyNoClinics, where a value of 0 indicates that clinics are enabled.

jarkkok
Posts: 16
Joined: Mon Jul 26, 2021 7:46 am

Re: Categories and appointment service types question

Post by jarkkok » Fri Aug 06, 2021 2:38 pm

Excellent. Thank you.

Post Reply