Creating properties for hotel and apartment setups via API

Setting up inventory correctly ensures accurate availability syncing and room distribution across sales channels. This article provides steps to set up apartment and hotel structure and explains the differences between them.

To understand how sales channels distribute inventory depending on the chosen setup, see Understanding the differences between building, multiunit unit property and multiunit group.

Hotel setup

Hotel setups use a multiunit structure where multiple identical rooms belong to a single room category.

Follow the steps below to configure a hotel setup.

Step by step:

  1. Create a building to represent the physical hotel by using the Push_PutBuilding_RQ API method.

  2. Create properties to represent each specific room type within the hotel by using the Push_PutProperty_RQ API method.

  3. Set the NoOfUnits parameter to match the exact number of physical rooms available for that room type.

How hotel availability syncs

When configuring a room type with multiple units, the integration automatically manages the listing creation and reservation processing:

  • Channel listing creation: The system creates a single listing on the sales channel, representing a hotel and linking back to the created building.

  • Reservation processing: When a guest books a stay, the system automatically reduces the number of available units for the booked dates.

  • Property assignment: The incoming reservation routes directly to the corresponding room type in Rentals United.

Apartment setup

Apartment setups operate on a single-unit structure where each accommodation is unique and managed independently.

Follow the steps below to configure an apartment setup.

Step by step:

  1. Create a property for each individual apartment by using the Push_PutProperty_RQ  API method.

  2. Ensure each created property represents one distinct physical address or unit.

How apartment availability syncs

Single-unit properties use a straightforward binary availability model:

  • Base availability: The total availability for an individual apartment property is always "1".

  • Reservation processing: Availability closes ("0") whenever a booking enters the system, rendering the property immediately unavailable for further stays during those selected dates.

Was this article helpful?
0 out of 0 found this helpful