BookAppointmentRequest Class

Contains set of options to book a healthcare appointment.

Namespace

healthcloudext

Usage

To book an appointment, we need to know the availability of a given practitioner at a given facility. To get this information, Health Cloud queries the specific source EHR system, using the IDs of the practitioner and the facility as stored in that source system.

Practitioner and Facility IDs:
  • The source system ID comes from the Healthcare Practitioner Facility record for the practitioner+facility combination.
  • The source system facility ID comes from an Identifier record that looks up to the Contact record for the practitioner, with the same source system as the Healthcare Practitioner Facility record.
  • The source system facility ID comes from an Identifier record that looks up to the Account record for the facility, with the same source system as the Healthcare Practitioner Facility record.

The source system requires Appointment Type and Service Type codes that are derived from the “visit type” (Work Type record) selected by the call center agent. These codes are configured via Work Type Code Set Bundle records, one per Work Type, with lookups to Code Set Bundle and Code Sets for the Service Type and Appointment Type codes in each Source System the org integrates with.

BookAppointmentRequest Properties

The following are properties for BookAppointmentRequest.

appointmentType

Represents the type of appointment, such as annual physical or intake examination.

Signature

public String appointmentType {get; set;}

healthcloudext.BookAppointmentRequest, appointmentType

Property Value

Type: String

note

Represents optional extra information about the appointment.

Signature

public String note {get; set;}

healthcloudext.BookAppointmentRequest, note

Property Value

Type: String

serviceType

Specifies the type of service to be performed at the appointment, such as dental cleaning or surgery.

Signature

public String serviceType {get; set;}

healthcloudext.BookAppointmentRequest, serviceType

Property Value

Type: String

slot

Represents the time period slot that’s assigned to the appointment.

Signature

public String slot {get; set;}

healthcloudext.BookAppointmentRequest, slot

Property Value

Type: String

sourceFacilityId

Represents the ID in the source system of the facility where the encounter will occur.

Signature

public String sourceFacilityId {get; set;}

healthcloudext.BookAppointmentRequest, sourceFacilityId

Property Value

Type: String

sourcePatientId

Represents the ID in the source system of the patient.

Signature

public String sourcePatientId {get; set;}

healthcloudext.BookAppointmentRequest, sourcePatientId

Property Value

Type: String

sourcePractitionerId

Represents the ID in the source system of the practitioner with whom the encounter will occur.

Signature

public String sourcePractitionerId {get; set;}

healthcloudext.BookAppointmentRequest, sourcePractitionerId

Property Value

Type: String

sourceSystem

Represents the name of the source system the patient record came from.

Signature

public String sourceSystem {get; set;}

healthcloudext.BookAppointmentRequest, sourceSystem

Property Value

Type: String