Hotel Detail Query interface

Scene

When users select one hotel from hotel list page, Fliggy may query the room types and their rates of the exact hotel from the vendor , then show the result to users to help them make a decision on which rates to buy.

Request

1. Duration of response: ≤3s (if delayed, the query should be deemed as no price returned.)
2. Explicit result of “successful” or “failed” appears.

Method to receive the interface called by Fliggy

1. The third party provides a service URL for receiving request from Fliggy (notes: all interface requests share the same address), the username and password for the purpose of validation.
2. Kindly to distinguish different request types through root element of xml request structure, and handle request/response according to criteria belowed.

Request URL

POST http://{vendor's host}/hotelRooms

Request Parameters

O: Optional; R: Required; SR: Special Required

XML example:

<HotelRoomsRequest>
	<AuthenticationToken>
		<Username>taobao</Username>
		<RequestTimestamp>1500432371</RequestTimestamp>
		<Signature>fb731b39f746146140325a0f2ea6f4be2da949b22e9ccd805afba30fbea9cc11</Signature>
	</AuthenticationToken>
	<CheckIn>2017-07-29</CheckIn>
	<CheckOut>2017-07-30</CheckOut>
	<HotelCode>10021918</HotelCode>
	<PaxRooms>
		<PaxRoom>
			<RoomIndex>1</RoomIndex>
			<Adults>2</Adults>
			<Children>2</Children>
			<ChildrenAges>
				<Age>8</Age>
				<Age>8</Age>
			</ChildrenAges>
		</PaxRoom>
	</PaxRooms>
        <SalesCountry>CN</SalesCountry>
        <UserCountry>CN</UserCountry>
</HotelRoomsRequest>

Return result

XML example:

<HotelRoomsResponse>
  <ResponseTimestamp>1500295485</ResponseTimestamp>
  <Hotel>
    <Name>普吉岛假日度假酒店</Name>
    <EnglishName>Holiday Inn Resort Phuket</EnglishName>
    <Address>52 Thaweewong Rd. Patong Beach Phuket, Thailand</Address>
    <CityCode>PKT23</CityCode>
    <HotelCode>10021918</HotelCode>
    <CheckIn>2017-07-29</CheckIn>
    <CheckOut>2017-07-30</CheckOut>
    <PaymentType>1</PaymentType>
    <MinPrice>230</MinPrice>
    <MinTaxPrice>12</MinTaxPrice>
    <CurrencyCode>CNY</CurrencyCode>
    <RoomTypes>
      <RoomType>
        <RoomTypeCode>Duxl-23434</RoomTypeCode>
        <RoomTypeName>测试房型</RoomTypeName>
        <RoomTypeEnglishName>test room type</RoomTypeEnglishName>
        <MaxRoomOccupancy>4</MaxRoomOccupancy>
        <RateInfos>
          <RateInfo>
            <RateKey>237a1bff37554d3db7c17a2f6fa7ae83</RateKey>
            <RateCode>BB-234-OX</RateCode>
            <RateName>含早提前预定</RateName>
            <RateEnglishName>Breakfast Included Book Advance</RateEnglishName>
            <Allotment>5</Allotment>
            <MaxOccupancy>3</MaxOccupancy>
            <MaxChildren>2</MaxChildren>
            <Refundable>false</Refundable>
            <Board>
              <BoardCode>American</BoardCode>
              <BoardCount>2</BoardCount>
            </Board>
	    <RateCategory>1</RateCategory>
            <PaymentType>1</PaymentType>
            <CurrencyCode>CNY</CurrencyCode>
            <TotalBasePrice>400</TotalBasePrice>
            <TotalPrice>400</TotalPrice>
            <TotalTaxAndFee>80</TotalTaxAndFee>
            <TaxBreakdown>
              <TaxCode>0</TaxCode>
              <Amount>80</Amount>
              <Currency>CNY</Currency>
            </TaxBreakdown>
            <ScenarioPriceTags>Chinese_price</ScenarioPriceTags>
            <SalesCountries>    
              <SalesCountry>CN</SalesCountry>
            </SalesCountries>
            <UserCountries>    
              <UserCountry>CN</UserCountry>
            </UserCountries>
            <CancelPolicyInfos>
              <CancelPolicyInfo>
                <CancelTime>16:00</CancelTime>
                <StartWindowHours>0</StartWindowHours>
                <NightCount>1</NightCount>
                <TimeZone>-08:00</TimeZone>
                <CurrencyCode>CNY</CurrencyCode>
              </CancelPolicyInfo>
              <CancelPolicyInfo>
                <CancelTime>16:00</CancelTime>
                <StartWindowHours>48</StartWindowHours>
                <NightCount>0</NightCount>
                <TimeZone>-08:00</TimeZone>
                <CurrencyCode>CNY</CurrencyCode>
              </CancelPolicyInfo>
            </CancelPolicyInfos>
            <HotelFees>
              <HotelFee>
                <TaxCode>0</TaxCode>
                <Amount>33</Amount>
                <CurrencyCode>CNY</CurrencyCode>
              </HotelFee>
            </HotelFees>
            <RateComments>
              <RateComment>drop the key at the gate</RateComment>
              <RateComment>dinner can not be served</RateComment>
            </RateComments>
            <PaxPriceRooms>
              <PaxPriceRoom>
                <RoomIndex>1</RoomIndex>
                <Adults>2</Adults>
                <Children>2</Children>
                <ChildrenAges>
                  <Age>10</Age>
                  <Age>10</Age>
                </ChildrenAges>
                <DailyInfos>
                  <DailyInfo>
                    <Day>2016-12-24</Day>
                    <Price>100</Price>
                    <BasePrice>100</BasePrice>
                    <TaxAndFee>20</TaxAndFee>
                    <CurrencyCode>CNY</CurrencyCode>
                  </DailyInfo>
                  <DailyInfo>
                    <Day>2016-12-25</Day>
                    <Price>100</Price>
                    <BasePrice>100</BasePrice>
                    <TaxAndFee>20</TaxAndFee>
                    <CurrencyCode>CNY</CurrencyCode>
                  </DailyInfo>
                </DailyInfos>
              </PaxPriceRoom>
              <PaxPriceRoom>
                <RoomIndex>2</RoomIndex>
                <Adults>2</Adults>
                <Children>0</Children>
                <DailyInfos>
                  <DailyInfo>
                    <Day>2016-12-24</Day>
                    <Price>100</Price>
                    <BasePrice>100</BasePrice>
                    <TaxAndFee>20</TaxAndFee>
                    <CurrencyCode>CNY</CurrencyCode>
                  </DailyInfo>
                  <DailyInfo>
                    <Day>2016-12-25</Day>
                    <Price>100</Price>
                    <BasePrice>100</BasePrice>
                    <TaxAndFee>20</TaxAndFee>
                    <CurrencyCode>CNY</CurrencyCode>
                  </DailyInfo>
                </DailyInfos>
              </PaxPriceRoom>
            </PaxPriceRooms>
          </RateInfo>
        </RateInfos>
      </RoomType>
    </RoomTypes>
  </Hotel>
</HotelRoomsResponse>

FAQ