Resource type: appointmentresponse

Description

A reply to an appointment request for a patient and/or practitioner(s), such as a confirmation or rejection.

Elements

PathShortDefinitionComments
A reply to an appointment request for a patient and/or practitioner(s), such as a confirmation or rejectionA reply to an appointment request for a patient and/or practitioner(s), such as a confirmation or rejection.
identifierExternal Ids for this itemThis records identifiers associated with this appointment response concern that are defined by business processes and/ or used to refer to it when a direct URL reference to the resource itself is not appropriate.
appointmentAppointment this response relates toAppointment that this response is replying to.
startTime from appointment, or requested new start timeDate/Time that the appointment is to take place, or requested new start time.This may be either the same as the appointment request to confirm the details of the appointment, or alternately a new time to request a re-negotiation of the start time.
endTime from appointment, or requested new end timeThis may be either the same as the appointment request to confirm the details of the appointment, or alternately a new time to request a re-negotiation of the end time.
participantTypeRole of participant in the appointmentRole of participant in the appointment.The role of the participant can be used to declare what the actor will be doing in the scope of the referenced appointment. If the actor is not specified, then it is expected that the actor will be filled in at a later stage of planning. This value SHALL be the same as specified on the referenced Appointment so that they can be matched, and subsequently updated.
actorPerson, Location, HealthcareService, or DeviceA Person, Location, HealthcareService, or Device that is participating in the appointment.
participantStatusaccepted | declined | tentative | in-process | completed | needs-action | entered-in-errorParticipation status of the participant. When the status is declined or tentative if the start/end times are different to the appointment, then these times should be interpreted as a requested time change. When the status is accepted, the times can either be the time of the appointment (as a confirmation of the time) or can be empty.This element is labeled as a modifier because the status contains the code entered-in-error that marks the participant as not currently valid.
commentAdditional commentsAdditional comments about the appointment.This comment is particularly important when the responder is declining, tentatively accepting or requesting another time to indicate the reasons why.

Scope and Usage

Appointment resources are used to provide information about a planned meeting that may be in the future or past. They may be for a single meeting or for a series of repeating visits. Examples include a scheduled surgery, a follow-up for a clinical visit, a scheduled conference call between clinicians to discuss a case, the reservation of a piece of diagnostic equipment for a particular use, etc. The visit scheduled by an appointment may be in person or remote (by phone, video conference, etc.). All that matters is that the time and usage of one or more individuals, locations and/or pieces of equipment is being fully or partially reserved for a designated period of time.

This definition takes the concepts of appointments in a clinical setting and also extends them to be relevant in the community healthcare space, and also ease exposure to other appointment / calendar standards widely used outside of Healthcare.

The basic workflow to create an appointment

Notes:

Time zones and recurring appointments

Recurring appointments need to have the time zone defined in which the values were entered. Knowing that the start time was at 9:00:00Z+10 does not mean that the same time in 2 weeks is actually the same.

For example, if this was a time in Brisbane Australia, this time would be the same (in respect to its offset from UTC), however if this was for Melbourne Australia, during the daylight savings period Melbourne time zone becomes +11. So without the additional information as to which time zone it was created in, scheduling a 9am appointment every Wednesday would not be possible.

Search Parameters

actorThe Person, Location/HealthcareService or Device that this appointment response replies forAppointmentResponse.actor
appointmentThe appointment that the response is attached toAppointmentResponse.appointment
identifierAn Identifier in this appointment responseAppointmentResponse.identifier
locationThis Response is for this LocationAppointmentResponse.actor.where(resolve() is Location)
part-statusThe participants acceptance status for this appointmentAppointmentResponse.participantStatus
patientThis Response is for this PatientAppointmentResponse.actor.where(resolve() is Patient)
practitionerThis Response is for this PractitionerAppointmentResponse.actor.where(resolve() is Practitioner)

Extension Definitions

These are extension definitions for this resource defined by the spec