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, CRMs 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.
Adding and updating profiles
Ulyses Cloud know profiles as companies, agencies or even customers that have been hosted in our property. It will be possible to create new profiles in Ulyses Cloud just by using the following endpoint. However, if we want to sync the information of any of these between 2 different platforms (ie Ulyses Cloud and a CRM) we recommend to subscribe to Ulyses Cloud Profile Events to either get the full list of changes on any of them or to update profiles in Ulyses Cloud.
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:
- Get the reservation roomstay pending amount through the following endpoint
- Pay the amount that is pending through the following endpoint
Please note
- If the roomstay you are about to pay is Reserved, Ulyses Cloud will create a deposit linked to this roomstay
- If the roomstay is inHouse, Ulyses Cloud will add a payment on the folio and will close it
- If the roomstay is checked out, cancelled or no-show you can expect an exception