Room assignment in Apaleo: a random free unit or planned assignment

Apaleo can give a reservation a random free unit through its API. HAYP instead plans the whole category so that as few single nights as possible stay empty. The animation shows what that means in the calendar.

Two ways to give a reservation its unit

Booking channels sell a category. In Apaleo a new reservation therefore sits on the unit group first, without a fixed unit. It needs one before arrival.

  • A random free unit. According to Apaleo's developer documentation, the API can assign a random free unit to a reservation that has none. That is quick and often enough for a property with few bookings.
  • Planned assignment. HAYP's automatic room assignment looks at the whole category with every new reservation. It puts each stay into the free unit it fits most tightly and re-plans future stays when that closes gaps.

The difference only shows once the calendar fills up. Then the order in which units were handed out decides whether a long stay still finds room.

The same bookings, two ways of assigning

Nine stays arrive one after another, on the left with a random free unit, on the right with HAYP's planning. At the end a guest asks for six nights.

RandomRandom free unit
New request: 6 nights
1234567891011121314
Apt 1
Apt 2
Apt 3
Apt 4

11 nights free in a row, longest stretch in one apartment

No apartment free for 6 nights, although the category is not full

HAYPPlanned assignment
New request: 6 nights
1234567891011121314
Apt 1
Apt 2
Apt 3
Apt 4

14 nights free in a row, longest stretch in one apartment

Fits into Apt 4, without moving anyone

Sample data. The positions are calculated, not drawn: on the left a random generator picks among the free units, on the right the rule “smallest remaining gap” applies, without the re-planning of future stays that HAYP also uses. Hatched: the longest free stretch before the new request.

The difference at a glance

Random free unitHAYP room assignment
Choice of unitAny free unit in the categoryThe free unit with the smallest remaining gap
View of other bookingsOnly this one reservationAll open reservations in the category, longer stays first
Stays that already have a unitStay where they areFuture stays are re-planned when that closes gaps; current, same-day and locked ones stay
When nothing fitsYour team has to noticeEmail to your team with the reason and the blocking stays

Why single free nights cost money

A single night between two stays is hard to sell. Many properties have minimum stays, and a guest booking a week needs seven consecutive nights in one unit. If the free nights are scattered across several apartments, the calendar looks half empty and the request still cannot be accepted.

The front desk can fix this by hand: move stays, rebook guests, reassign. With hundreds of units that no longer happens on the side. Planning does exactly this work before the gap appears.

FAQ

Frequently asked questions about room assignment in Apaleo

Doesn't Apaleo assign rooms itself?

Apaleo can assign a random free unit to a reservation without one through its API, as its developer documentation describes. That is not planning across all reservations of the category. HAYP does that part.

What does HAYP do differently?

With every new reservation HAYP plans the whole category: open reservations by arrival, longer stays first, each into the unit it fits most tightly. Future stays may move when that closes gaps.

Are guests moved shortly before arrival?

No. Stays in progress and today's arrivals stay where they are. Only stays arriving tomorrow or later are re-planned, always within the booked category. Assignments locked in Apaleo stay fixed as well.

Who benefits from planned assignment?

Operators with many units per category and guests who stay several nights, such as serviced apartments, aparthotels and vacation rentals run as a portfolio. The fuller the calendar and the longer the stays, the more scattered free nights matter. A small property with few bookings often does fine with a random unit.

Can I adjust the rules?

Yes. The process described is the standard; we adapt rules and timing to your operation on request.

What does room assignment cost?

It is part of the Portfolio Operations module: €2 per unit per month, net, with no setup costs and no minimum term. The pricing page shows all modules.

See assignment live

In the demo we show the calendar and assignment with sample data and work out how your Apaleo account is connected.