Managing room amenities

In addition to creating room types (Room type and rate plan API), you can also use the /ota/OTA_HotelInvNotif endpoint to add, update, retrieve, or remove a property's room amenities for one or more existing room types.

What are room amenities?

Room amenities are predefined labels that you can use to list features or facilities available in a physical room of a given property. Booking.com provides a list of supported room amenities each identified using an amenity type code, including bed types room amenities which you can use to specify the types of beds in the room.

→ For a list of all the possible Booking.com room amenities, see room amenity type code. To see a list of all bed types, see bed type codes.

What falls under managing room amenities?

Managing room amenities involves the following actions:

• Adding and updating room amenities
• Retrieving room amenities (of a property)
• Removing room amenities

Adding and updating room amenities

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

The POST /ota/OTA_HotelInvNotif request enables you to add and update room amenities of one or more existing room types per property.

To update room amenities:

• Set InvNotifType to Overlay.

• Include InvCode, which is the Booking.com ID referring to an existing room type. You do not need to add the RoomType again.

• Change the Amenities elements you want to update and include all the existing room information.

  → To retrieve a property's room amenities details, see retrieving room amenities.

  → To add room amenities when creating a room type, set the InvNotifType to New. For more information, see creating a room type.

Overlay exception while updating bed-type amenities

In general, when overlaying details of an existing property, room type, or other object, the body of your current request replaces the existing information. Therefore, existing information may get deleted if you do not include it in your request. To update an object without deleting existing information, your request must contain both the updates and the existing information.

However, there is an exception to this overlay behaviour while updating bed-type room amenities. Updating only bed-type room amenities does not overlay existing room amenities. For example, when you add or update bed types, it does not affect existing non-bed type room amenities. Similarly, updating only non-bed type room amenities does not overlay existing bed-type amenities.

Adding bed types for rooms that support multiple bedrooms

To add bed types for rooms that support multiple bedrooms (such as Apartment or Suite), you must use the Amenities element under SubRooms.

For example, see room amenities and bed types in a multi-bedroom room type.

Requirements for adding or updating room amenities

To add or update room amenities of a room type on Booking.com, the following elements are required:

• Property ID
• Booking.com room type ID
• Room amenity type code

Please note that you will now be able to set any occupancy, the limitation of max 4 children is no longer in place.

Body parameters

The following table describes the elements to add in the request body:

Request body example: Room amenities

The following request body sets a kitchenette, a desk and a minibar in the room type:

<OTA_HotelInvNotifRQ> 
    <SellableProducts HotelCode="6314570">
        <SellableProduct InvNotifType="Overlay" InvCode="631457019">
            <GuestRoom>
                <Amenities>
                    <Amenity AmenityCode="61"/>
                    <Amenity AmenityCode="28"/>
                    <Amenity AmenityCode="69" Value="1"/>
                </Amenities>
            </GuestRoom>
        </SellableProduct>
    </SellableProducts>
</OTA_HotelInvNotifRQ>

Request body example: Bed types

The following request body sets two single beds available in the standard room arrangement in the room type:

<OTA_HotelInvNotifRQ> 
    <SellableProducts HotelCode="6314570">
        <SellableProduct InvNotifType="Overlay" InvCode="631457019">
            <GuestRoom>
                <Amenities>
                    <Amenity AmenityCode="203" Value="2" Configuration="1"/>
                </Amenities>
            </GuestRoom>
        </SellableProduct>
    </SellableProducts>
</OTA_HotelInvNotifRQ>

Request body example: Room amenities and bed types in a multi-bedroom room type

The following request body sets a desk, a refrigerator and free toiletries in the room type Apartment. In addition, it sets one double bed in the subroom Bedroom and one sofa bed in the subroom Living room:

<OTA_HotelInvNotifRQ>
    <SellableProducts HotelCode="6314570">
        <SellableProduct InvNotifType="Overlay" InvCode="631457019">
            <GuestRoom>
                <Amenities>
                  <Amenity AmenityCode="28" />
                  <Amenity AmenityCode="88" />
                  <Amenity AmenityCode="11" />
              </Amenities>
                <TPA_Extensions>
                  <SubRooms>
                      <SubRoom RoomType='Bedroom' PrivateBathroom="0">
                      <Amenities>
                              <Amenity AmenityCode="249" Value="1" />
                          </Amenities>
                      </SubRoom>
                      <SubRoom RoomType="Living room">
                      <Amenities>
                              <Amenity AmenityCode="102" Value="1" />
                          </Amenities>
                      </SubRoom>
                  </SubRooms>
              </TPA_Extensions>
            </GuestRoom>
        </SellableProduct>
    </SellableProducts>
</OTA_HotelInvNotifRQ>

Response body example

The following is a successful response body example:

<OTA_HotelInvNotifRS >
    <Success />
</OTA_HotelInvNotifRS>
<!-- RUID: [UmFuZG9tSVYkc2RlIyh9YU4iplNAF3/GEVjlG+mTXmB9OwspcIGa+KqcbMzyiykpi6Yx5oKzRKEMxDhfrI] -->

Response body parameters

The following table describes the response elements:

Retrieving room amenities

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

The POST /ota/OTA_HotelDescriptiveInfo request enables you to retrieve room amenities of all the active room types of a property.

→ To retrieve room amenities of both deactivated and active room types, you must retrieve the property details and filter on GuestRooms.

Body parameters

The following table describes the elements you must add in the request body:

Request body example

The following is a request body example:

<OTA_HotelDescriptiveInfoRQ>
    <HotelDescriptiveInfos>
        <HotelDescriptiveInfo HotelCode="6314570"></HotelDescriptiveInfo>
    </HotelDescriptiveInfos>
</OTA_HotelDescriptiveInfoRQ>

Response body example

The following shows the relevant information of a successful response body example:

<OTA_HotelDescriptiveInfoRS>
...
<GuestRooms>
        <GuestRoom ID="631457019" Active="1" RoomTypeName="Double" NonSmoking="Unknown">
          <Amenity RoomAmenityCode="28" AmenityCode="28"/>
          <Amenity RoomAmenityCode="61" AmenityCode="61"/>
          <Amenity RoomAmenityCode="69" AmenityCode="69"/>
          <Amenity RoomAmenityCode="203" Quantity="2" AmenityCode="203" Value="2" Configuration="1"/>
          <DescriptiveText>Deluxe Double Room with Mountain View</DescriptiveText>
          <Occupancy MaxOccupancy="2" MaxAdultOccupancy="2" MaxChildOccupancy="1"/>
          <Quantities MaxCribs="0" MaxRollaways="0"/>
				  <TPA_Extensions>  
            <Occupancy MaxChildPayableOccupancy="1" />  
          </TPA_Extensions>  
        </GuestRoom>
      </GuestRooms>
...
</OTA_HotelDescriptiveInfoRS>
<!-- RUID: [UmFuZG9tSVYkc2RlIyh9YZvDaUET+NMaXKN+9zcX6t7ygxdUDjvU4TNDD8JwtXxnIZuaEi] -->

Response body parameters

The following table describes the response elements:

Removing room amenities

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

The POST /ota/OTA_HotelInvNotif request enables you to remove room amenities of one or more existing room types for your property.

To remove one or more room amenities:

• Set InvNotifType to Overlay.

• Include InvCode, which is the Booking.com ID referring to an existing room type. You do not need to add the RoomType again.

• Include all the other existing room information and change the Amenities elements you want to update.

• Specify “0” in attribute Value for the room amenities and bed types you want to remove.

  → To retrieve information on your property's room amenities, see retrieving room amenities.

Overlay exception while removing bed-type amenities

Similar with updating bed-type amenities, there is also an exception to the overlay behaviour while removing bed-type room amenities. Removing only bed-type room amenities does not overlay existing room amenities. For example, when you remove bed types, it does not affect existing non-bed type room amenities. Similarly, removing only non-bed type room amenities does not overlay existing bed-type amenities.

Requirements for removing room amenities

To remove room amenities of a room type on Booking.com, you only need the following elements:

• Property ID
• Booking.com room type ID
• Room amenity type code

Body parameters

The following table describes the elements to add in the request body:

Request body example: Room amenities

The following request body removes the Kitchenette, the desk and the minibar in the room type:

<OTA_HotelInvNotifRQ> 
    <SellableProducts HotelCode="6314570">
        <SellableProduct InvNotifType="Overlay" InvCode="631457019">
            <GuestRoom>
                <Amenities>
                    <Amenity AmenityCode="61" Value="0"/>
                    <Amenity AmenityCode="28" Value="0"/>
                    <Amenity AmenityCode="69" Value="0"/>
                </Amenities>
            </GuestRoom>
        </SellableProduct>
    </SellableProducts>
</OTA_HotelInvNotifRQ>

Request body example: Bed types

The following request body removes the single bed (which is available in the standard room arrangement) in the room type:

<OTA_HotelInvNotifRQ> 
    <SellableProducts HotelCode="6314570">
        <SellableProduct InvNotifType="Overlay" InvCode="631457019">
            <GuestRoom>
                <Amenities>
                    <Amenity AmenityCode="203" Value="0" Configuration="1"/>
                </Amenities>
            </GuestRoom>
        </SellableProduct>
    </SellableProducts>
</OTA_HotelInvNotifRQ>

Response body example

The following is a successful response body example:

<OTA_HotelInvNotifRS >
    <Success />
</OTA_HotelInvNotifRS>
<!-- RUID: [UmFuZG9tSVYkc2RlIyh9YU4iplNAF3/GEVjlG+mTXmB9OwspcIGa+KqcbMzyiykpi6Yx5oKzRKEMxDhfrI] -->

Response body parameters

The following table describes the response elements: