Guest onboarding solutions have become popular lately as they empower guests with functionalities such as checkin online, upgrading their accommodation prior the arrival, foster communication with personnel, door control and many more. To be able to connect these solutions with Ulyses PMS we recommend to read the following operations
Common operations
Filtering reservations
In the following article we will show you how to filter reservations based on multiple methods. Often we will need to get reservations or roomstays depending on the booking number but it will be likely that we need to search for reservations that checked-in/out dates, even a combination of them. In any case, the most important is to get the information we need in order to perform more actions afterwards.
Sending guest information
Properties need to receive guests personal information in order to complete their registration. This basically includes the registration of guest documentation but the information can even be more extensive (ie preferences, comments). To be able to send the information of a room with all its guests to Ulyses PMS we will use the following operation. As opposite, if we need to update the data of a single guest in a room stay we can use the following endpoint. The latter will be used when third parties need to update a guest profile in Ulyses PMS gradually. In other words, if a reservation has 1 room and 4 guests, the likelihood of receiving the information of each guest sequentially is higher. In this case, we may want to use the second endpoint mentioned.
Allocating room
Ulyses Connections lets end-users to choose the room where they wish to be allocated. To do that we will need to use the following endpoint. However, firstly we will need to get the list of rooms available.
Change room status
Ulyses Connections allows our partners to change the status of rooms. Even though this is not an operation that need to be triggered by end users, we may need to use it in some cases.
Add extra services
Ulyses Connections allow us to to add services to specific roomstays easily. However, we will need to get the list of services available first.
Attach documentation to a stay
Ulyses Connections allow us to send documents linked to specific reservations thanks to the following endpoint. This can be used to attach any type of communication, registration forms or invoices.
Getting reservation's charges
Ulyses Connections allow us getting the costs of a reservation so clients can pay them upfront. To know the costs of a reservation we will need to retrieve the array of proformas and, from here, we will determine the amount of the reservation. As we explained here the number of proformas will depend primarily on the payment type selected in the reservation but also need to pay attention on the number of companies acting as "Bill to"'s in the reservation.
Pay room's pending amount
Ulyses Connections allows third parties to complete the payment of a room's pending amount. To pay the full amount of a room we recommend you to follow the steps:
- Case if the room has not checked in:
- Request the list of proformas to get the amount contracted
- Post payment through the following endpoint
- If the room has already checked in we will need to request the amount within the folios, nor in the proforma. To do this:
- Request the list of folios and filter by reservationRoomStay to know the new amount pending
- Post payment through the previous endpoint
As opposite, we will just need to add a payment in a room. To do that:
- We will request the list of folios and we will filter by room
- Add payment to the correspondent folio