# Appointment Management

Retrieve and reserve appointments for installing or maintaining a service at a given address.

This follows the concepts in TMF646 - Appointment API.


## Return available appointment slots for a given service and address.

 - [GET /available-appointments](https://docs.thefibrecafe.net/openapi/prod/tenant-api/gen/appointment-management/handleappointmentavailability.md): This endpoint can be called to find what appointments a supplier has available
to install or maintain service(s) at a given address.

An address query parameter must be supplied specifying address ID and type along
with the required service specification as returned by the /service-availability
endpoint.

The next available appointments after the appointmentStartDate will be returned -
a suitable date should be chosen based on installationLeadTime if this was
provided during availability check.

Appointment slots are classified based on day as weekday or saturday/sunday and
by time to day, AM/PM or early morning/evening. Based on the tenant-supplier
agreement, some of these classifications will be considered premium.

This request will be routed to a particular supplier which must be specified.

## Reserve a previously returned appointment slot.

 - [POST /appointments](https://docs.thefibrecafe.net/openapi/prod/tenant-api/gen/appointment-management/handlereserveappointment.md): This endpoint can be called to reserve an appointment with a supplier to install
or maintain service(s) at a given address.

Details of a previously returned available appointment must be provided to be
reserved according to the supplier reservation policy. Where the reservation
has a TTL (time to live) before being released, the expiry time will be stated.

The returned reservation ID must be sent as part of the order at which point
it should be considered confirmed.