Validate rate inventory interface (vendor package service)

Scene

Before entering the booking page, Fliggy may confirm whether the product is available for sales through direct connection to the vendor. The vendor should provide with the latest rate price/room allotment/cancel policy etc.Customer can modify the room allotment/occupancy/check in/check out .

Request

1. Duration of response: ≤3s (if delayed, it would be deemed as no available product can be found)
2. Explicit result of “successful” or “failed” appears.
3. Correct feedback appears if there is any change to rate, guarantee or cancel rules.

The third-party system implements the room availability method according to the definition of the interface and shifts it into service. The Fliggy system will confirm if the product is available for sales by calling the room availability service from the third party when the user select an exact room type as well as the rate.

Method to receive the interface called by Fliggy

1. The third party provides a service address for receiving request from Fliggy (notes: all interface requests share the same address) and the user name 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}/roomAvailability

Request Parameters

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

XML example:

<RoomAvailabilityRequest>
	<AuthenticationToken>
		<Username>taobao</Username>
		<RequestTimestamp>1500432371</RequestTimestamp>
		<Signature>fb731b39f746146140325a0f2ea6f4be2da949b22e9ccd805afba30fbea9cc11</Signature>
	</AuthenticationToken>
	<CheckIn>2017-07-29</CheckIn>
	<CheckOut>2017-07-30</CheckOut>
	<RateKey>XXX</RateKey>
	<RateCode>XXX</RateCode>
	<RoomTypeCode>XXX</RoomTypeCode>
	<HotelCode>10021918</HotelCode>
	<PaymentType>1</PaymentType>
	<RateCategory>1</RateCategory>
	<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>
</RoomAvailabilityRequest>

Return result

XML example:

<RoomAvailabilityResponse>
  <ResponseTimestamp>1500295485</ResponseTimestamp>
  <Hotel>
    <Name>测试</Name>
    <EnglishName>test</EnglishName>
    <Address>dsfdsf-234-234</Address>
    <CityCode>dsf</CityCode>
    <HotelCode>10021918</HotelCode>
    <CheckIn>2017-07-29</CheckIn>
    <CheckOut>2017-07-30</CheckOut>
    <PaymentType>1</PaymentType>
    <CurrencyCode>CNY</CurrencyCode>
    <RoomTypes>
      <RoomType>
        <RoomTypeCode>VIP</RoomTypeCode>
        <RoomTypeName>测试房型</RoomTypeName>
        <RoomTypeEnglishName>test room</RoomTypeEnglishName>
        <MaxRoomOccupancy>4</MaxRoomOccupancy>
        <RateInfos>
          <RateInfo>
            <RateKey>VIP</RateKey>
            <RateCode>VIP</RateCode>
            <RateName>测试rate</RateName>
            <RateEnglishName>test rate</RateEnglishName>
            <Allotment>5</Allotment>
            <MaxOccupancy>3</MaxOccupancy>
            <MaxAdults>3</MaxAdults>
            <MaxChildren>2</MaxChildren>
            <Refundable>true</Refundable>
            <Board>
              <BoardCode>American</BoardCode>
              <BoardCount>2</BoardCount>
            </Board>
            <PaymentType>1</PaymentType>
			<RateCategory>1</RateCategory>
            <CurrencyCode>CNY</CurrencyCode>
            <TotalBasePrice>400</TotalBasePrice>
            <TotalPrice>400</TotalPrice>
            <TotalTaxAndFee>80</TotalTaxAndFee>
            <TaxBreakdown>
              <TaxCode>0</TaxCode>
              <Amount>80</Amount>
              <Currency>CNY</Currency>
            </TaxBreakdown>
            <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>
            <SalesCountries>    
              <SalesCountry>CN</SalesCountry>
            </SalesCountries>
            <UserCountries>    
              <UserCountry>CN</UserCountry>
            </UserCountries>
            <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>
</RoomAvailabilityResponse>

FAQ