Appointments
Appointment slots are classified based on day: weekday or saturday/sunday; and by time of day: AM/PM or early morning/evening. Based on the tenant-supplier agreement, some of these classifications will be considered "premium".
Classification
Timeslots fall into one of the following classifications:
- WEEKDAY
- WEEKDAY_AM
- WEEKDAY_PM
- WEEKDAY_EARLY
- WEEKDAY_EVENING
- SATURDAY
- SATURDAY_AM
- SATURDAY_PM
- SATURDAY_EARLY
- SATURDAY_EVENING
- SUNDAY
- SUNDAY_AM
- SUNDAY_PM
- SUNDAY_EARLY
- SUNDAY_EVENING
The start and end of timeslots will vary between suppliers and will be set according to the tenant/supplier agreement. Where a supplier is not able to provide the classification (or provides a different classification), the gateway can classify timeslots itself to ensure the tenant always receives consistent timeslot information.
Premium timeslots
Based on the tenant/supplier agreement, some timeslots will be considered "premium" and may carry an additional charge/premium. Where the supplier does not currently mark timeslots appropriately, the gateway can be configured to apply the standard/premium marker to appropriate timeslots to ensure the tenant always receives consistent timeslot information.
Reappointing
Where the tenant needs to reschedule or reappoint for a customer, this works in a similar way to booking an appointment. The tenant would find and reserve an appointment slot, then amend the order with the new reservation id to confirm.
Cancelling
In the case of a supplier cancelling an appointment, this would be notified via a KCI - either a REAPPOINT or (if the appointment is not required) via an update with APPOINTMENT_NOT_REQUIRED and no reservation id.
T2R
When requesting and reserving appointment slots for a service problem, the SERVICE_ID and CARE_LEVEL characteristics should be passed in the request. Please note the CARE_LEVEL should be set to what the customer has already subscribed to. The appointmentPurpose should also be set to REPAIR.