Scene

1. Inquire the result after booking
2. Check-in compensation/noShow
3. Check-out compensation
4. Bill compensation
5. Inquire the result after cancellation

Requirements

1. Synchronous interface
2. Use the Fliggy order No. for inquiry.
3. Data must be correct and consistent with real-time order data.
4. Data must be complete. Order status, order No., order information and check-out bill (after check-out) are required.

The third-party system implements the order inquiry method according to the definition of the interface and transfers it into service. The system will call in a real time manner the order inquiry service from the third party to obtained detailed order information.

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}/searchOrder

Request parameters

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

XML example:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<SearchOrderRequest>

         <AuthenticationToken>

                  <Username>********</Username>

                  <RequestTimestamp>32423532523</RequestTimestamp>

                  <Signature>ae7e12812dc83aa255e6dd6eba8aa6e2</Signature>

         </AuthenticationToken>

         <TaoBaoOrderId>3254254325432</TaoBaoOrderId>
		 
	 <OrderId>3254254325432</OrderId>
		 
	 <IncludeDetail>true</IncludeDetail>
		  
</SearchOrderRequest>

Return result (successful)

XML example:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<SearchOrderResponse>
	<ResponseTimestamp>32423532523</ResponseTimestamp>
	<TaoBaoOrderId>32542543254326351988</TaoBaoOrderId>
	<OrderId>325425432</OrderId>
	<OrderStatus>Confirmed</OrderStatus>
        <TotalPrice>1234.34</TotalPrice>
        <CurrencyCode>CNY</CurrencyCode>
	<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>
		<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>
						<Refundable>true</Refundable>
						<Board>
							<BoardCode>American</BoardCode>
							<BoardCount>2</BoardCount>
						</Board>
						<PaymentType>1</PaymentType>
						<CurrencyCode>CNY</CurrencyCode>
						<TotalBasePrice>1260</TotalBasePrice>
						<TotalPrice>1234.34</TotalPrice>
						<TotalTaxAndFee>324.34</TotalTaxAndFee>
						<CancelPolicyInfos>
							<CancelPolicyInfo>
								<CancelTime>16:00:00</CancelTime>
								<StartWindowHours>0</StartWindowHours>
								<NightCount>1</NightCount>
								<TimeZone>-08:00</TimeZone>
								<CurrencyCode>CNY</CurrencyCode>
							</CancelPolicyInfo>
							<CancelPolicyInfo>
								<CancelTime>16:00:00</CancelTime>
								<StartWindowHours>48</StartWindowHours>
								<NightCount>0</NightCount>
								<TimeZone>-08:00</TimeZone>
								<CurrencyCode>CNY</CurrencyCode>
							</CancelPolicyInfo>
							<CancelPolicyInfo>
								<CancelTime>16:00:00</CancelTime>
								<StartWindowHours>72</StartWindowHours>
								<Amount>1000</Amount>
								<TimeZone>-08:00</TimeZone>
								<CurrencyCode>CNY</CurrencyCode>
							</CancelPolicyInfo>
						</CancelPolicyInfos>
						<HotelFees>
							<HotelFee>
								<Type>MandatoryFee</Type>
								<Amount>345</Amount>
							</HotelFee>
							<CurrencyCode>CNY</CurrencyCode>
						</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>17800</Price>
										<BasePrice>17000</BasePrice>
										<TaxAndFee>2345</TaxAndFee>
										<CurrencyCode>CNY</CurrencyCode>
									</DailyInfo>
									<DailyInfo>
										<Day>2016-12-25</Day>
										<Price>46050</Price>
										<BasePrice>46000</BasePrice>
										<TaxAndFee>2345</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>17800</Price>
										<BasePrice>17000</BasePrice>
										<TaxAndFee>2345</TaxAndFee>
										<CurrencyCode>CNY</CurrencyCode>
									</DailyInfo>
									<DailyInfo>
										<Day>2016-12-25</Day>
										<Price>46050</Price>
										<BasePrice>46000</BasePrice>
										<TaxAndFee>2345</TaxAndFee>
										<CurrencyCode>CNY</CurrencyCode>
									</DailyInfo>
								</DailyInfos>
							</PaxPriceRoom>
						</PaxPriceRooms>
					</RateInfo>
				</RateInfos>
			</RoomType>
		</RoomTypes>
	</Hotel>

</SearchOrderResponse>

FAQ