# 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.

## Site Visit Reason

Not to be confused with premium timeslots, some suppliers also offer different levels of service during an appointment.
This may include additional work to be performed and/or longer appointment durations. When searching and reserving an
appointment, the tenant can specify the SITE_VISIT_REASON characteristic to choose Premium or Advanced. The presence of
telecare equipment may also require a different site visit reason.

## 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.