This document outlines the differences that can occur in <NumberofNights> vs <NumberofActualNights> in the API Endpoints:
- <NumberofActualNights> = Number of actual nights guest stay at the hotel
- <NumberofNights> = Number of booked nights
- As a side note, the <ArrivalDate> and <DepartureDate> fields are both based on the dates that the guest actually stayed so the difference would equal the <NumberofActualNights>
Early Check Out
In the following example, the guest has made a booking with a Date In of May 7 and a Date Out of May 12, a 5 night stay:
After staying one night in the hotel, the guest decides to checkout; this is flagged as an "early checkout" in RoomKeyPMS. The Date Out now reflects the new departure date of May 8:
When this reservation is presented on the API Endpoint, the <NumberofNights> is 5 and the <NumberofActualNights> is 1:
Overstayed Reservation
An overstayed reservation occurs when the property does not check the reservation out of RoomKeyPMS on the day of Departure. In the example below, today's date in May 9th and Barry MacPhail is an overstayed reservation that was supposed to check out on May 2 => this would have been a 1 night stay:
When the reservation is checked out on May 9th, the <NumberofNights> is 1 and the <NumberofActualNights> is 8:
