This guide explains how you can connect your revenue or rate management application (RMS) to apaleo. If you are new to apaleo APIs, head over to the quick-start guide , and learn how you can implement the apaleo connect flow.
Inventory and rates in apaleo
First, head over to our guides and get familiar with the way apaleo models inventory and rate plans, and what rate restrictions we support.
If you already have a test account set up, you can follow these guides to set up rates, and check the network traffic in your browser. The apaleo UI is using the same API as you will, and this is a great way to get familiar with the calls.
There is one concept in apaleo which is quite different from what you might now: Time slices. With this, we mean the time slot, for which a room is offered. Each hotel comes with two standard patterns, overnight and day-use. If you only want to manage rates for nights, be sure to filter all rate plans to be overnight. Then, you can think of 'one time slice' as being the same as 'one night'.
Rate plan APIs
Browse all apaleo APIs on https://api.apaleo.com/. For most revenue or rate management integrations, the Core APIs are the only ones needed. Switch between different modules using the dropdown in the top right corner.
First, you need to initialise your system, and let it know which rate plans exist on apaleo. You can do this in the Rate Plan APIs
As it is not possible to change the rates of derived rate plans, set the filter to exclude those: isDerived=false. There are more filters, too, if you want to limit to specific properties or channels.
Next, you want to get and set some rates, right? Here you go:
This retrieves all rates in a given time interval. If the price is not set, it means no rates have been initialised for this 'time slice'. The rates also include the restrictions. To initialise or update rates and restrictions, call
To be on the safe side, we recommend to always GET the rates, then manipulate the data you retrieved, and send it back with the PUT call.
Getting training data
For step 2, before setting the rates, you might have some magic calculation in place. apaleo lets you access every single piece of data stored in it, and you can use it all for training for army of friendly and smart recommendation robots. Here are some suggestions:
All the reservations, with all their prices. And info on if they were cancelled, how many people stay there, if it was part of a multi-room booking, if services were included, how long in advance the booking was made - anything.
Check current availability and pricing information, using the offer-index:
Or what channel managers do, and get real time updates on ARI (availability, rates, and inventory) data using the Distribution API.
Care to dig deeper? Access folio data, to check when the guest paid and how:
This is where your expertise lies, though, and we are sure you know better than us, what data you want or need. Whatever idea you have - we're pretty sure, apaleo has an API for that. And if not, let us know on https://apaleo.github.com/apis.
Posted byAndrea Stubbe