Request for Tour Search

Search link: http://search.tez-tour.com/toursearch/getResult?accommodationId=2&after=21.05.2013&before=30.05.2013&cityId=345&countryId=1104¤cy=5561&hotelClassBetter=true&hotelClassId=2569&hotelInStop=false&locale=ru&nightsMax=15&nightsMin=7&noTicketsFrom=false&noTicketsTo=false&priceMax=999999&priceMin=0&rAndBBetter=true&rAndBId=2424&tourId=1285&formatResult=true&xml=true

Tour search parameters are listed below.

Mandatory parameters.

countryId=1104 – Resort country id;

cityId=345 – Departure city id;

priceMin=0 – minimum package price;

priceMax=999999 – maximum package price;

before=31.05.2010 – highest value for check-in date interval;

after=21.05.2010 – lowest value for check-in date interval. Maximum allowed interval between check-in dates – 60 days;

currency=5561 – id of currency in which the price is specified;

nightsMin=7 – minimum number of nights spent at the hotel;

nightsMax=15 – maximum number of nights spent at the hotel. Maximum allowed interval - 8 nights;

accommodationId=2 – accommodation id;

hotelClassId=2569 – hotel category (stars) id;

hotelClassBetter=true / false – allows (or does not allow) to show in the tour search results the hotels of higher category than specified (in interface it is displayed as “and better” checkbox);

rAndBId=2424 – meal type id;

rAndBBetter=true / false – allows (or does not allow) to show in the tour search results the offers with meals of the higher level than specified (in interface it is displayed as “and better” checkbox);

noTicketsFrom=false / true – allows (or does not allow) to search for offers without suitable return flight (in interface it is displayed as “no tickets on arrivals” checkbox);

noTicketsTo=false / true – allows (or does not allow) to search for offers without suitable departure flight (in interface it is displayed as “no tickets on departures” checkbox);

hotelInStop=false / true – allows (or does not allow) to search for offers with hotels in stop sale (in interface it is displayed as “hotels in stop sale” checkbox);

spoRegionId=1234 – SPO region id. For each country SPO region has a specific meaning (in interface it shows as “Tour” list). Cannot be used together with tourId.

tourId=1285 – region id. You can specify several regions: tourId=14259&tourId=14385. For second accommodations it is necessary to specify region id using comma as separating character: tourId=14259,14385. The parameters cannot be used together with spoRegionId.

hotelId=1234 – hotel id. You can specify several hotels: hotelId=1234&hotelId=12345;

birthday1=22.06.2005 – child birthday. Parameter should be specified only in case of child accommodation;

birthday2=12.06.2005 – second child birthday. Parameter should be specified only in case of two children accommodation.

 

Optional parameters:

xml=true / false – search results (reply) format. True – the reply will be received in xml format, false – the reply will be received in search format.

formatResult= true / false – reply formatting. True – the reply will be formatted, false – the reply will be received as single string. Relevant only for reply in search format.

locale=ru / en – localization. Ru – Russian localization, en – English localization (under development).

Tour search results:

<com.teztour.toursearch.util.pojo.AggregateTourSearchResultsXML>
  <success>true</success>
  <serverName>odin.teztour.com</serverName>
  <data>
    <com.teztour.toursearch.dto.XMLSpoSearchResultDto>
      <checkIn>31.03.2013</checkIn>
      <checkInDayofWeek>Su</checkInDayofWeek>
      <departureDate></departureDate>
      <nightCount>7</nightCount>
      <checkOut>07.04</checkOut>
      <hotel>DELPHIN DIVA PREMIERE 5 *</hotel>
      <hotelId>9002473</hotelId>
      <hotelUrl>http://www.tez-tour.com/hotel.html?id=9002473</hotelUrl>
      <hotelRoomType>Standard Land View</hotelRoomType>
      <bookingLinks>
        <com.teztour.toursearch.dto.XMLBookingLinkDto>
          <secondHotel></secondHotel>
          <bookingUrl>http://online.tez-tour.com/armmanager/workplace/section/new-order?cDateId=
40974908563&depCity=345&arrivalCity=345&hotStType=2&priceOfferId=10064116&locale=ru</bookingUrl>
          <spoUrl>http://book.tez-tour.com/book/vc/common/spo?spoId=10064116&hotelRoomId=4116100#hotelContent4116100</spoUrl>
        </com.teztour.toursearch.dto.XMLBookingLinkDto>
      </bookingLinks>
      <tour>ANTALYA</tour>
      <region>Antalya</region>
      <comments>Tez recommends, early booking (special booking conditions)</comments>
      <pansion>UAI</pansion>
      <pansionComment>Ultra All Inclusive </pansionComment>
      <hotelStayType>DBL</hotelStayType>
      <ageGroupType>2+0+0</ageGroupType>
      <price>$1727</price>
      <spo>SPO 1046</spo>
      <existsRoom>Available</existsRoom>
      <freeSeatNumberToC>Not available</freeSeatNumberToC>
      <freeSeatNumberToY>Available</freeSeatNumberToY>
      <freeSeatNumberToR>Not available</freeSeatNumberToR>
      <extraChargeToC></extraChargeToC>
      <extraChargeToY></extraChargeToY>
      <extraChargeToR></extraChargeToR>
      <freeSeatNumberFromC>Not available</freeSeatNumberFromC>
      <freeSeatNumberFromY>Available</freeSeatNumberFromY>
      <freeSeatNumberFromR>Not available</freeSeatNumberFromR>
      <extraChargeFromC></extraChargeFromC>
      <extraChargeFromY></extraChargeFromY>
      <extraChargeFromR></extraChargeFromR>
      <containerId>40974908563</containerId>
      <hotelRoomTypeId>4116100</hotelRoomTypeId>
      <hotelPansionId>9036300</hotelPansionId>
      <groupTypeAgeId>68578</groupTypeAgeId>
      <hotelStayTypeId>2</hotelStayTypeId>
      <iconList>
        <baseHotel>
          <value>true</value>
          <comment>Tez recommends</comment>
        </baseHotel>
        <earlyBooking>
          <value>true</value>
          <comment>early booking (special booking conditions)</comment>
          <text>
            <string>up to 31.01</string>
            <string>View rules </string>
          </text>
        </earlyBooking>
        <onlineConfirm>
          <value>false</value>
        </onlineConfirm>
        <pack>
          <value>false</value>
        </pack>
        <topPriority>
          <value>false</value>
        </topPriority>
        <exclusive>
          <value>false</value>
        </exclusive>
        <flexComission>
          <value>false</value>
        </flexComission>
        <fixComission>
          <value>false</value>
        </fixComission>
      </iconList>
    </com.teztour.toursearch.dto.XMLSpoSearchResultDto>

Tour search results description:

<checkIn> - check-in date

<checkInDayofWeek> - check-in day of week

<departureDate> - departure date

<nightCount> - number of nights

<checkOut> - check out date

<hotel> - hotel name

<hotelUrl> - URL of the hotel page in the catalog at http://www.tez-tour.com/

<hotelRoomType> - room type

<secondHotel> - in case of second (or multiple) accommodation, the name of the second hotel is specified here (if there are optional hotels for second accommodation, it is specified for each of them)

<bookingUrl> - link to order booking based on this search conditions

<spoUrl> - link to detailed description of special offer.

<tour> - region

<region> - SPO region

<comments> - special notices: early booking, tez recommends, instant confirmation.

<pansion> - meals

<pansionComment> - meals description

<hotelStayType> - accommodation type

<ageGroupType> - accommodation type age groups

<spo> - price offer number

<existsRoom> - availability of rooms in the hotel

<freeSeatNumberToC> - availability of business class seats on departure flight

<freeSeatNumberToY> - availability of economy class seats on departure flight

<freeSeatNumberToR> - availability of premium economy class seats on departure flight

<extraChargeToC> - extra charge for business class on departure flight

<extraChargeToY> - extra charge for economy class on departure flight

<extraChargeToR> - extra charge for premium economy class on departure flight

<freeSeatNumberFromC>> - availability of business class seats on return flight

<freeSeatNumberFromY>> - availability of economy class seats on return flight

<freeSeatNumberFromR>> - availability of premium economy class seats on return flight

<extraChargeFromC> - extra charge for business class on return flight

<extraChargeFromY> - extra charge for economy class on return flight

<extraChargeFromR> - extra charge for premium economy class on return flight

<iconList> - element containing additional information about the tour. Usually such information is shown in the tour search results as icons.

Includes nested elements:

<baseHotel> - additional hotel characteristics. Includes nested elements:
   <value> - responsible for relevance of parent element. If it is ‘true’, then the corresponding element is set for the hotel. If it is ‘false’, then it is not set for the hotel.
   <comment> - text commentary to the characteristic. For example, ‘Tez recommends’.


<earlyBooking> - information about early booking for the offer. Includes nested elements: 
    <value> - if the value is ‘true’, then early booking is provided for this offer, if ‘false’ – then early booking is not provided.
    <comment> - text commentary to early booking. 
        <text> - the element contains the early booking details. 
           <string>up to 15.05</string> - text commentary to early booking conditions.


<onlineConfirm> - information about instant confirmations. 
     <value> - if the value is ‘true’ then instant confirmation is provided for this offer, if it’s ‘false’ then it is not provided.
      <comment> - text commentary.

<pack> - package tour indicator. 
     <value> - if the value is ‘true’, the offer is package, if it is ‘false’, it is not package offer.
<topPriority> - characteristic that determines if the hotel is in Tez Priority category. 
     <value> - if the value is ‘true’, the hotel is in Tez Priority category, if it’s ‘false’, it is not in Tez Priority category

<exclusive> - characteristic that determines if the hotel is in Tez Exclusive category.
     <value> - if the value is ‘true’, the hotel is in Tez Exclusive category, if it’s ‘false’, it is not in Tez Exclusive category


<flexComission> - contains information about flexible commission.
     <value> - if the value is ‘true’, there is flexible commission for this offer, and if it’s ‘false’, there is no flexible commission.


<fixComission> - contains information about fixed commission.
     <value> - if the value is ‘true’, there is fixed commission for this offer, and if it’s ‘false’, there is no fixed commission.

General Reference Table

The following URL is used to get general reference table:

http://search.tez-tour.com/toursearch/references?locale=ru&formatResult=true&xml=true

Reference table:

<references>
  <success>true</success>
  <cities>
    <city>
      <cityId>345</cityId>
      <name>Moscow</name>
    </city>
    <city>
      <cityId>392</cityId>
      <name>Nizhny Novgorod</name>
    </city>
    <city>
      <cityId>412</cityId>
      <name>Samara</name>
    </city>
  </cities>
  <countries>
    <country>
      <countryId>1104</countryId>
      <name>Turkey</name>
    </country>
    <country>
      <countryId>5732</countryId>
      <name>Egypt</name>
    </country>
  </countries>
  <currencies>
    <currency>
      <currencyId>5561</currencyId>
      <name>US Dollar</name>
    </currency>
    <currency>
      <currencyId>8390</currencyId>
      <name>Rouble</name>
    </currency>
  </currencies>
  <hotelClasses>
    <hotelClass>
      <classId>2566</classId>
      <name>1 *</name>
      <weight>-4</weight>
    </hotelClass>
    <hotelClass>
      <classId>2567</classId>
      <name>2 *</name>
      <weight>-1</weight>
    </hotelClass>
  </hotelClasses>
  <rAndBs>
    <rAndB>
      <rAndBId>15350</rAndBId>
      <name>RO</name>
      <weight>0</weight>
    </rAndB>
    <rAndB>
      <rAndBId>2424</rAndBId>
      <name>BB</name>
      <weight>1</weight>
    </rAndB>
  </rAndBs>
</references>

General reference table description:

<city> - city.

<cityId> - city id.

<name> - city name

<country> - country.

<countryId> - country id.

<name> - country name.

<currency> - currency.

<currencyId> - currency id.

<name> - currency name.

<hotelClass> - hotel category.

<classId> - hotel category id.

<name> - hotel category name.

<weight> - weight (coefficient) of hotel category

<rAndB> - meal type.

<rAndBId> - meal type id.

<name> - meal type name.

<weight> - weight (coefficient) of the meal type.

Reference Table by Countries

In order to get the reference table of a specific country, specify countryId=xxxx, where xxxx is the id of the necessary country in the URL:

http://search.tez-tour.com/toursearch/byCountry?countryId=5732&locale=ru&xml=true

 

Reference table by countries:

<referencesByCountry>
  <success>true</success>
  <tours>
    <tour>
      <name>Dahab</name>
      <tourId>
        <long>26313</long>
      </tourId>
      <fromCityId>
        <long>2552</long>
        <long>9001185</long>
        <long>786</long>
        <long>1392</long>
        <long>3711</long>
        <long>2680</long>
        <long>412</long>
        <long>392</long>
        <long>2141</long>
        <long>6529</long>
        <long>1107</long>
        <long>3429</long>
        <long>345</long>
        <long>2729</long>
        <long>3667</long>
        <long>12044</long>
        <long>1421</long>
        <long>1754</long>
        <long>1776</long>
        <long>2672</long>
      </fromCityId>
    </tour>
    <tour> …

</tours>
    <regions>
      <spoRegion>
        <regionId>228245153</regionId>
        <name>CAIRO+SHARM EL-SHEIKH</name>
      </spoRegion>
      <spoRegion>
        <regionId>228245154</regionId>
        <name>SHARM EL-SHEIKH+CAIRO+HURGHADA</name>
      </spoRegion>



</regions>
      <hotels>
        <hotel>
          <tourId>111466</tourId>
          <hotelId>127648</hotelId>
          <name>ABOU DABBAB RESORT 3 *</name>
          <hcWeight>2</hcWeight>
          <rbWeight>
            <long>7</long>
            <long>1</long>
            <long>3</long>
          </rbWeight>
        </hotel>
        <hotel>
          <tourId>5735</tourId>
          <hotelId>3012644</hotelId>
          <name>AIDA RESORT & HOTELS 3 *</name>
          <hcWeight>2</hcWeight>
          <rbWeight>
            <long>7</long>
            <long>3</long>
          </rbWeight>
        </hotel>



</hotels>
        <accommodations>
          <accommodation>
            <accommodationId>1</accommodationId>
            <name>SGL</name>
            <children>0</children>
          </accommodation>
          <accommodation>
            <accommodationId>14317</accommodationId>
            <name>SGL+CHD</name>
            <children>1</children>
          </accommodation>



</accommodations>
        </referencesByCountry>

Reference table description:

<tour>

<name> - region name

<tourId>

<long> - region id

</tourId>

<fromCityId> - departure cities that have flights to this region

<long> - departure city id

<long> - departure city id

</fromCityId>

</tour>

<regions>

<spoRegion>

<regionId> - SPO region id

<name> - SPO region name

</spoRegion>

</regions>

<hotels>

<hotel>

<tourId> - region id

<hotelId> - hotel id

<name> - hotel name

<hcWeight> - weight (coefficient) of hotel category

<rbWeight>

<long> - weight (coefficient) of hotel’s meal type

<long> - weight (coefficient) of hotel’s meal type

</rbWeight>

</hotel>

</hotels>

<accommodations>

<accommodation>

<accommodationId> - accommodation id

<name> - accommodation name

<children> - number of children

</accommodation>

</accommodations>

Flights List

To get the list of flights, specify departure city id in the ‘cityId’ parameter and destination country id in the ‘countryId’ parameter in the URL http://search.tez-tour.com/toursearch/getFlightDeparture?cityId=345&countryId=5733&formatResult=true&xml=true

Flights list:

<flightDepartures>
  <success>true</success>
  <data class="object-array-array">
    <object-array>
      <int>2010</int>
      <object-array/><object-array/><object-array/><object-array/>
      <object-array>
        <int>26</int>
        <int>28</int>
        <int>29</int>
        <int>30</int>
      </object-array>
      <object-array>
        <int>2</int>
        <int>3</int>
        <int>4</int>
        <int>5</int>
        <int>6</int>
        <int>8</int>
        <int>9</int>
        <int>10</int>
        <int>11</int>
        <int>12</int>
        <int>13</int>
        <int>15</int>
        <int>16</int>
        <int>17</int>
        <int>18</int>
        <int>19</int>
        <int>20</int>
        <int>22</int>
        <int>23</int>
        <int>24</int>
        <int>25</int>
        <int>26</int>
        <int>27</int>
        <int>29</int>
        <int>30</int>
      </object-array>

List description:

<int> - year

<object-array/> - 1st month

<object-array/> - 2nd month

<object-array/> - 3rd month

<object-array/> - 4th month

<object-array> - 5th month

<int> - date for which the flight is registered

<int> - date for which the flight is registered

<int> - date for which the flight is registered