Reservation FAQs

In this article, we will cover some common use cases and questions related to reservations.

1. How to create a reservation with multiple rooms

To add multiple rooms when creating a reservation with postReservation, the "rooms", "adults" and "children" arrays need to be duplicated for each additional room, using the correct indexes.

2. How to create a reservation with a specific source

By default, reservations are created with the "Website / Booking engine" source. If you'd like to create the reservations with a different source, the 'sourceID' would need to be specified in the postReservation request. The 'sourceID' can be retrieved via /getSources.

You may include the 'thirdPartyIdentifier' to submit the reservation ID in the channel.

To create a reservation with a primary source, you need to add '-1' to the 'sourceID' retrieved via /getSources. For example, /getSources returns "s-2" for walk-in, so you should submit "s-2-1" in your /postReservation request.

3. How to post rates with postReservation method?

To post a rate, it must be registered in MFD. It is possible to see all rates using /getRatesPlan. getRatesPlan returns all rates/plans, independent of it being applicable to the dates (sent in the request). The difference is, if the plan isn't applicable, it will send many fields with the value 0 (example: "roomsAvailable": 0). This means that the plan isn't applicable to the parameters given.

As said, the call must be registered in MFD. At the moment, there's no call that allows that to be done with the API.

It doesn't take into consideration any applicable rate plans or promos (especially because no promo code can be sent to the call).

4. How to change a reservation status

You can update the reservation status with /putReservation:

5. How to modify reservation dates or room types?

The room type assigned or the stay dates can be modified by sending the new values in the 'rooms' array of /putReservation:

If the reservation room is upgraded or downgraded, the pricing will be automatically adjusted to the current rate for the new room. If you wish to override it, you need to send a /postAdjustment call to adjust the rate.

6. What's the difference between a 'reservationID', a 'subReservationID' and a 'thirdPartyIdentifier'?

The 'reservationID' is generated by Cloudbeds and it is the unique identifier for a reservation, whereas the 'thirdPartyIdentifier' is the reservation ID generated by the channels (e.g. the OTA reservation ID).

A reservation created in an OTA will have a Cloudbeds 'reservationID', as well as the OTA 'thirdPartyIdentifier'.

In Cloudbeds PMS, it is possible to have reservations with multiple rooms.  Each additional rooms will be assigned a 'subReservationID'.
For example, reservation ID "884565856563" is made of 3 rooms:

• Double room has subReservation ID '884565856563'
• Twin room has subReservation ID '884565856563-1'
• Triple room has subReservation ID '884565856563-2'

It is possible that the subReservation IDs are not correlative. For example, in the above example, if the double room is deleted from the reservation, its subReservationID will be removed and it will not be assigned to another room.

To call a reservation with /getReservation or similar endpoints, you can only include the reservationID in the request.

7. What's a split reservation?

Split reservations are created when there is no availability within one room type throughout the guest stay, so they need to be accommodated in two different rooms.

In the API, we don't have a specific flag for split bookings. However, they can be easily identified in the Reservation endpoints responses because we have the same 'subReservationID' assigned to multiple rooms for non-matching stay periods.