Typically a customer wish to perform, first, a search for hotel availability on the basis of certain criteria (city, date, type and number of rooms, etc ... - see “Searching for availability” in the documentation of the web service).
The result of this research is then shown to the customer.
It is important to note that, in this result, there is also a parameter called “deadline”: this is the date by which you can cancel without being subject to a cancellation fee.
Should however be stressed that this parameter is not definitive but only indicative for the specific hotel and type of contract!
The customer then selects a hotel from the research carried out and will investigate further on the details of the hotel itself and - possibly – will perform a reservation.
It is very important, before making your reservation, do a targeted search of the actual deadline for that hotel, dates and rooms (using the "get_deadline" method of the web service).
This will not only get the exact date of the deadline but - if required for that particular contract - it will be possible to list the cancellation penalties provided by distance from check-in where you could, possibly, cancel the reservation.
Please, note: availability searches performed on rooms with cots or extrabeds may return the rooms as available, being the check performed only on the rooms and not on the “extras”.
Due to this behavior, you may notice that a room “immediately” available let the booking goes in “pending” status.
This issue is limited to booking with cots, extrabeds and, sometimes, due to textual remarks (which should be manually processed by reservation staff).