Book Appointment R4: RequestedPeriod question

[Jean Minnaar]

When making the FHIR API call for booking appointment, the requestedPeriod is one of the properties in the request body.   https://fhir.cerner.com/millennium/r4/base/workflow/appointment/#create shows:

  "requestedPeriod": [ 

 { 

     "start": "2020-02-07T13:28:17-05:00", 

     "end": "2021-02-07T13:28:17-05:00" 

 } ]

1) Are these UTC times?

2) Are these related the the slot's datetime?

3) what does the '17-05' in the "start" property denote?

4) Should/can these datetimes end in a 'Z' if these are UTC datetimes?

[Richard Leaf]

Hi there - requestedPeriod is only required when creating a proposed appointment

When creating a booked appointment, no date/time information is needed in the request body in the form of requestedPeriod since that is all derived from the Slot reference.

When creating a proposed appointment for requestedPeriod we will take in UTC which must end with a Z (e.g. 2021-08-01T06:00:00.000Z), or an offset (e.g. 2021-08-01T06:00:00.000-05:00). 

For question 3, since requestedPeriod is only for propsoed appointments, we still take in those values and record them since that just defines a window for when the consumer would like a given appointment to be booked.  In this case, when that date range is included in a slot search, the slot service will only return slots that qualify for that range.