Home

Content is outdated

This documentation section will soon become deprecated. To know more about room type and rate plan managmeent, consult the new room type and management API management documentation.

Create a room type with multi-bedroom setup

Independent properties (such as holiday homes and apartments) often have multiple bedrooms, but are booked as one unit. To accommodate this, you can create a room type with sub-rooms inside it. Use /ota/OTA_HotelInvNotif to create room types.

Before you start

You can only define subrooms inside a room type when its value for Room[@RoomType] is one of: Apartment, Suite, Chalet, Bungalow, Holiday home, Villa, Mobile home.

Note : Please provide the bed type amenities in the subrooms section. The ones set on room level in GuestRoom/Amenities for multi-bedroom setup are not processed.

To complete the task below, you need:

Kitchen(ette) required

Room types in the following Property Class Types require a kitchen(ette) to become open and bookable:

  • Apartment (3)
  • Aparthotel (5000)
  • Condominium (8, but changed to 3)

For room types in the following Property Class Types a kitchen(ette) is highly recommended:

  • Holiday home (5006)
  • Holiday park (5009)
  • Lodge (22)
  • Villa (35)

Request

HTTP request

POST https://supply-xml.booking.com/hotels/ota/OTA_HotelInvNotif

Request body

Future deprecation of HotelInvNotif photo functionality

Adding and modifying photos through OTA_HotelInvNotif entered the sunset phase as of September 16, 2020. This means that to keep managing photos you must switch to the Photo API before September 16, 2021, when this functionality is fully depecrated.

Provide an OTA_HotelInvNotifRQ object in the request body. The details for the sub-rooms are in a SubRooms element. Example:

<OTA_HotelInvNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opentravel.org/2014B/OTA_HotelInvNotifRQ.xsd" version="6.000" id="OTA2014B" TransactionIdentifier="5" Target="Production">
    <SellableProducts HotelCode="{PropertyID}">
      <SellableProduct InvStatusType="Initial">
          <GuestRoom>
              <!-- MaxOccupancy - Maximum number of guests-->
              <Occupancy MaxOccupancy="6" MaxAdultOccupancy="6" MaxChildOccupancy="3"/>
              <Quantities MaximumAdditionalGuests="2" MaxCribs="1" MaxRollaways="1">
              <!--  -->
              <Room RoomID="{YourCustomRoomTypeID}" Quantity="2" NonSmoking="1" RoomType="Apartment" SizeMeasurement="16" SizeMeasurementUnit="sqm" LicenseNumber="AB-CD-1234"/>
              <Amenities>
                  <!-- Please provide the bed type amenities in the subrooms section -->
                  <!-- Desk: -->
                  <Amenity AmenityCode="28" />
                  <!-- Refrigerator: -->
                  <Amenity AmenityCode="88" />
                  <!-- Minibar, at extra charge: -->                    
                  <Amenity AmenityCode="69" Value="5" />
                  <!-- Telephone: -->
                  <Amenity AmenityCode="107" />
                  <!-- Flatiron: -->
                  <Amenity AmenityCode="55" />                    
                  <!-- Free toiletries: -->
                  <Amenity AmenityCode="11" />                                       
              </Amenities>
              <RoomLocation RoomLocationCode="3">
                  <Floors>
                        <Floor Number="0" />
                        <Floor Number="4" />
                        <Floor Number="7" />
                        <Floor Number="9" />
                  </Floors>
              </RoomLocation>
              <Description>  
                  <!-- We recommended uploading at least 4 room photos (2048x1536px, landscape). -->
                  <Image>http://pathtoimage/doublemer_room001.jpg</Image>
                  <Image>http://pathtoimage/doublemer_room002.jpg</Image>
                  <Image>http://pathtoimage/doublemer_room003.jpg</Image>
                  <Image>http://pathtoimage/doublemer_room004.jpg</Image>
              </Description>
              <TPA_Extensions>                    
                  <SubRooms>
                      <SubRoom RoomType='Bedroom' PrivateBathroom='1' MaxGuests="2">
                      <!-- Amenities in sub-rooms can only be beds, i.e.: 33, 58, 86, 102, 113, 200, 203, 249, 4001. -->
                          <Amenities>
                              <Amenity AmenityCode="200" Value="3" />
                          </Amenities>
                      </SubRoom>
                      <SubRoom RoomType='Living room' MaxGuests="2">  
                          <Amenities>
                              <Amenity AmenityCode="33" Value="2" />
                          </Amenities>
                      </SubRoom>
                      <SubRoom RoomType="Bathroom" Number="2" />
                  </SubRooms>
              </TPA_Extensions>
          </GuestRoom>
      </SellableProduct>
    </SellableProducts>
</OTA_HotelInvNotifRQ>

Response

The response contains an OTA_HotelInvNotifRS object.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvNotifRS xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opentravel.org/OTA/2003/05 OTA_HotelInvNotifRS.xsd" TimeStamp="2019-07-31T13:46:52-00:00" Target="Production" Version="3.000">
    <InventoryCrossRefs>
        <InventoryCrossRef RequestInvCode="{YourCustomRoomTypeID}" ResponseInvCode="{OurRoomTypeID}" />
    </InventoryCrossRefs>
    <Success />
</OTA_HotelInvNotifRS>
<!-- RUID: [XXXXXXXXXXXXXXXXXXXXXXXXXXX==] -->

Next steps

Is this page helpful?    Yes   |    No