Inventory and rates

Start by exploring our comprehensive guides to gain a clear understanding of how Apaleo structures inventory and rate plans, as well as the types of rate restrictions we support.

• Inventory: Hotels, room types, rooms
• Set up rate plans
• Manage rates & restrictions

If you already have a developer 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. Alternatively, you can explore rate plan API.

Apaleo introduces a unique concept called Time Slices, which may differ from what you’re familiar with. A time slice refers to the specific time period during which a room is offered. Each hotel includes two standard patterns: overnight and day-use. If your focus is exclusively on managing nightly rates, ensure all rate plans are filtered to the “overnight” category. In this context, a single time slice corresponds to one night. To GET time slices use

GET/settings/v1/properties/{propertyId}/time-slice-definitions

example below

{
  "timeSliceDefinitions": [
    {
      "id": "BER-DAY",
      "name": "Day Use",
      "template": "DayUse",
      "checkInTime": "10:00:00",
      "checkOutTime": "17:00:00",
      "isUsed": true
    },
    {
      "id": "BER-NIGHT",
      "name": "Over Night",
      "template": "OverNight",
      "checkInTime": "17:00:00",
      "checkOutTime": "10:00:00",
      "isUsed": true
    }
  ],
  "count": 2
}

As a revenue management expert, you understand revenue strategy better than anyone. However, we recommend always retrieving the rates (GET) first, setting up recommeded rates and restrictions, and then sending it back using a PUT call. Remember to account for time slices when updating rates, as these define the time periods for which the rates apply.