Documentation

Dashboard Menu
Roomstays logic within a room:

When you run either a hotels / hoteldetail request for content-api, you’ll find hotels in the response that inform different roomstay in the same room node. The purpose of this roomstay tags is to provide information in the case that the room has one or more different “stays” where the guests can sleep.

In case the roomStays element appears within a room node, it’s necessary to read the whole element to understand the number of roomStays available in the room and also get the information regarding the facilities available in each of the “stays”.

The facilities for a specific roomStay will indicate what the guest will find in that particular “stay”. By reading the facilities within the roomstay, you’ll be able to inform that the “stay” has just a Double King bed or if it has a sofa bed. There will be cases when the same roomstay offers two different facilities, eg: a roomstay can offer a Double bed by default or 2 single beds as an alternative distribution.

In order to interpret each one of the roomstays, you’ll need to pay attention to “stayType”, “roomStayFacilities” and “facilityGroupCode” for each of the roomstayFacilities

Examples:

  • Room with only 1 Roomstay and 1 RoomStayFacility
    • The roomstays on this DOUBLE EXECUTIVE indicates there is only 1 roomstay – Only 1 roomStay node
    • This roomstay is a bedroom - staytype = BED
    • There is a Double bed 131-150 width in it and this is the default for this room.
      • Facilitycode = “150” means “Double bed 131-150 width”
      • FacilityGroupCode= “61” means “Room Distribution (default)”
      • number = 1 means there’s “1” item as described
<room roomCode="DBL.EJ" isParentRoom="false" minPax="1" maxPax="5" maxAdults="4" maxChildren="4" minAdults="1" description="DOUBLE EXECUTIVE">
        <type code="DBL">
          <description>DOUBLE</description>
        </type>
        <characteristic code="EJ">
          <description>EXECUTIVE</description>
        </characteristic>
        ...
        <roomStays>
          <roomStay stayType="BED" order="1" description="Bed room">
            <roomStayFacilities>
              <roomStayFacility facilityCode="150" facilityGroupCode="61" number="1">
                <description>Double bed 131-150 width</description>
              </roomStayFacility>
            </roomStayFacilities>
          </roomStay>
        </roomStays>
      </room>

  • Room with 1 Roomstay and 2 alternative RoomStayFacilities (OR logic)

In this case roomStayFacilities have different facilitygroupcode (GroupCode 61 and 62), so the logic is an OR for those 2 roomStayFacilities.

    • The roomstays on this Double or Twin STANDARD indicates there is only 1 roomstay – Only 1 roomStay node
    • This roomstay is a bedroom - staytype = BED
    • There are two Single bed 90-130 width in it and this is the default for this room.
      • Facilitycode = “1” means “Single bed 90-130 width”
      • FacilityGroupCode= “61” means “Room Distribution (default)”
      • number = 2 means there’s “2” item as described
    • OR there could be a Double bed 131-150 width in it and this is the alternative for this room.
      • Facilitycode = “150” means “Double bed 131-150 width”
      • FacilityGroupCode= “62” means “Room Distribution Alternative”
      • number = 1 means there’s “1” item as described
<room roomCode="DBT.ST" isParentRoom="false" minPax="1" maxPax="5" maxAdults="4" maxChildren="4" minAdults="1" description="Double or Twin STANDARD">
        <type code="DBT">
          <description>Double or Twin</description>
        </type>
        <characteristic code="ST">
          <description>STANDARD</description>
        </characteristic>
....
   <roomStays>
          <roomStay stayType="BED" order="1" description="Bed room">
            <roomStayFacilities>
              <roomStayFacility facilityCode="1" facilityGroupCode="61" number="2">
                <description>Single bed 90-130 width</description>
              </roomStayFacility>
              <roomStayFacility facilityCode="150" facilityGroupCode="62" number="1">
                <description>Double bed 131-150 width</description>
              </roomStayFacility>
            </roomStayFacilities>
          </roomStay>
        </roomStays>
    </room>

  • Room with 1 Roomstay and 2 RoomStayFacilities included in the stay (AND logic)

In this case both roomStayFacilities are the default room occupancy (GroupCode 61), so the logic is an AND for the 2 roomStayFacilities.

    • The roomstays on this QUADRUPLE STANDARD indicates there is only 1 roomstay – Only 1 roomStay node
    • This roomstay is a bedroom - staytype = BED
    • There is a Double bed 131-150 width in it and this is the default for this room.
      • Facilitycode = “150” means “Double bed 131-150 width”
      • FacilityGroupCode= “61” means “Room Distribution (default)”
      • number = 1 means there’s “1” item as described
    • AND There is a Queen-size bed 150-154 width in it and this is the default for this room.
      • Facilitycode = “294” means “Queen-size bed 150-154 width”
      • FacilityGroupCode= “61” means “Room Distribution (default)”
      • number = 1 means there’s “1” item as described
<room roomCode="QUA.ST" isParentRoom="false" minPax="1" maxPax="6" maxAdults="4" maxChildren="3" minAdults="1" description="QUADRUPLE STANDARD">
        <type code="QUA">
          <description>QUADRUPLE</description>
        </type>
        <characteristic code="ST">
          <description>STANDARD</description>
        </characteristic>
...
    <roomStays>
          <roomStay stayType="BED" order="1" description="Bed room">
            <roomStayFacilities>
              <roomStayFacility facilityCode="150" facilityGroupCode="61" number="1">
                <description>Double bed 131-150 width</description>
              </roomStayFacility>
              <roomStayFacility facilityCode="294" facilityGroupCode="61" number="1">
                <description>Queen-size bed 150-154 width</description>
              </roomStayFacility>
            </roomStayFacilities>
          </roomStay>
        </roomStays>

  • Room with several Roomstays

In case there’s more than one roomStay the logic for the different roomStays is an AND. In this example, there is roomStay 1 AND roomStay 2 AND roomStay3 . See below:

    • The roomstays on this APARTMENT CAPACITY 6 TWO BEDROOMS indicates there is 3 roomstay – See below 3 roomStay node
    • The first roomstay is a bedroom – order = 1 and staytype = BED
      • There is a Double bed 131-150 width in it and this is the default for this stay.
  • Facilitycode = “150” means “Double bed 131-150 width”
  • FacilityGroupCode= “61” means “Room Distribution (default)”
  • number = 1 means there’s “1” item as described
    • The second roomstay is a bedroom – order = 2 and staytype = BED
      • There is two Single bed 90-130 width in it and this is the default for this room.
  • Facilitycode = “1” means “Single bed 90-130 width”
  • FacilityGroupCode= “61” means “Room Distribution (default)”
  • number = 2 means there’s “2” item as described
    • The third roomstay is a livingroom – order = 1 and staytype = LIV
      • There is two Sofa Bed in it and this is the default for this room.
  • Facilitycode = “284” means “Sofa Bed”
  • FacilityGroupCode= “61” means “Room Distribution (default)”
  • number = 2 means there’s “2” item as described
<room roomCode="APT.B2-C6" isParentRoom="false" minPax="1" maxPax="10" maxAdults="10" maxChildren="6" minAdults="1" description="APARTMENT CAPACITY 6 TWO BEDROOMS">
        <type code="APT">
          <description>APARTMENT</description>
        </type>
        <characteristic code="B2-C6">
          <description>CAPACITY 6 TWO BEDROOMS</description>
        </characteristic>
...
 <roomStays>
          <roomStay stayType="BED" order="1" description="Bed room">
            <roomStayFacilities>
              <roomStayFacility facilityCode="150" facilityGroupCode="61" number="1">
                <description>Double bed 131-150 width</description>
              </roomStayFacility>
            </roomStayFacilities>
          </roomStay>
          <roomStay stayType="BED" order="2" description="Bed room">
            <roomStayFacilities>
              <roomStayFacility facilityCode="1" facilityGroupCode="61" number="2">
                <description>Single bed 90-130 width</description>
              </roomStayFacility>
            </roomStayFacilities>
          </roomStay>
          <roomStay stayType="LIV" order="1">
            <roomStayFacilities>
              <roomStayFacility facilityCode="284" facilityGroupCode="61" number="2">
                <description>Sofa bed</description>
              </roomStayFacility>
            </roomStayFacilities>
          </roomStay>
       </roomStays>