Blog Detail Title

Short Content Here

by Author Name

Date Published


Just in time for Christmas: Packages on apaleo

Andrea Stubbe November 30, 2017

It started snowing in Munich, there's cookies in the office, and we feel all Christmas-y, humming happy tunes... to make you happy, too, we introduce today a whole new set of features, and they are all about packages (a.k.a. "rate plans with included services", but that doesn't sound like Christmas at all).

Including services in rate plans

The rate plan API has expanded, to allow specifying or changing the list of services to be included. The typical example is room with breakfast. You can even specify a different price for the service - allowing for cheaper prices when they are included.

When setting rates, the price you specify is always the all-inclusive price, not the price for the rooms. Example:
1. Set up a rate plan with breakfast included for a gross price of 8 Euro per person, and a surcharge for the third person of 10 Euro.
2. A rate of 100 Euro means that the room price, as it ends up in accounting, will be 92 Euro. If two people are staying, the price of the room is only 100 - (2 * 8) = 84 Euro. You can define surcharges for additional persons, to keep a stable room price.


Good price


If you try specifying rates that would lead to negative room prices, this will fail. Same will happen if you already have rates set up, and increase the price of the included services that would also lead to negative room prices.
The exact check that's happening is: for all possible occupancies, from 1 to the maximum allowed, the defined rate + surcharges[occupancy] - (sum of all service charges for occupancy) must not be negative.


 Bad price


We also clarified the naming, and the total amount on time slices is now called TotalAmount. The old Amount field is deprecated, and will be removed on February 28th 2018.

Add a marker to services, whether they are internal only

You could already define services like breakfast, and now can specify if they should be available to sell as extra services, or whether they can only be included as parts of a package. With that, we support the use case that a hotel only wants to offer rooms with breakfast, instead of rooms with nothing and breakfast as an extra.
When requesting the list of services, you can add a parameter, to not receive the internal ones.


Consistent views for offers, reservations, folios and invoices

Previously, offers and reservations included a list of time slices and services - and on the invoice and folio, we had a list of line items per day. The exact same information, but in completely different formats. To make it easier to have a consistent view of the reservation for guests, we enhanced the response models of offers (GET booking/offers) and reservations (GET booking/reservation/{id}) to include line items as well.


Line Items for a booking for a package with double room, incl. breakfast and Wi-Fi


When you now want to display an offer or send out a reservation confirmation, you can use the new line items collection.

Deprecations: In offers, the time slice and service collections will be removed on February 28th 2018.

What's gone

  • We removed the PUT reservations endpoint. Why that? PUT was just the wrong HTTP verb to use, and our log-bot told us, that nobody was using it. As the new and better version, you can now use PATCH.
  • As announced some months ago, min persons is gone from unit groups and units.

Ho, ho, ho ❤

Andrea Stubbe

Posted by

Andrea Stubbe
Andrea started coding as a kid, paused that for some years trying to find more interesting things, but then ended up doing that for a living. After working as a freelancer, researcher, teacher, and a normal employee in small and giant corporations, she fulfilled her childhood dream and co-founded a company a year ago. Being a fan of microservices since before she knew that term, she’s still contemplating how and if to use them in micro-sized companies.


by Benjamin Schmid


IBE Integration Guide

Let's talk Internet Booking Engines (IBEs). They work best when directly connected to the PMS, without any intermediaries that might get in the way with delays ...

by Andrea Stubbe


Digital guest journey with apaleo

apaleo is building software for hotels, and our users are people that work at hotels. To create amazing guest experiences we need you, creators of guest facing ...

by Andrea Stubbe


Push it! Webhooks in apaleo

The notification service allows you to build or set up apps which subscribe to certain events on apaleo (webhooks). When an event is triggered, we send an HTTP ...


Subscribe to our a-list for all the fun:

  • Keep up to date with hotel trends
  • Understand what matters most to hotel clients
  • Sweet gifs and special offers

Get it in your inbox every Monday ;)

By entering your email you expressly consent to receive our newsletter every week and other material related to...