Внимание!
Максимально допустимый диапазон между датами заезда - 20 дней.
Максимально допустимый диапазон между количество ночей - 8 ночей.
Установлено ограничение — 50 запросов в минуту с одного ip-адреса.
Для каждой страны минимальные параметры: rAndBId, hotelClassId и accommodationId могут отличаться.
Запрос на подбор тура
https://search.tez-tour.com/tariffsearch/getResult?accommodationId=2&after=20.05.2023&before=29.05.2023&cityId=345&countryId=1104&nightsMin=8&nightsMax=12&
currency=5561&priceMin=0&priceMax=120000&hotelClassId=2569&hotelClassBetter=true&rAndBId=2424&rAndBBetter=true&xml=true
Обязательные параметры:
countryId=1104 – id страны отдыха;
cityId=345 – id города вылета;
priceMin=0 – минимальная стоимость отдыха;
priceMax=120000 – максимальная стоимость отдыха;
before=31.05.2010 – верхняя планка диапазона даты заезда;
after=21.05.2010 – нижняя планка диапазона даты заезда. Максимально допустимый диапазон между датами заезда - 20 дней;
currency=5561 – id валюты, в которой указана цена;
nightsMin=7 – минимальное количество ночей, проведенных в отеле;
nightsMax=15 – максимальное количество ночей, проведенных в отеле. Максимально допустимый диапазон - 8 ночей;
accommodationId=2 – id размещения;
hotelClassId=2569 – id уровня отеля(звездность);
rAndBId=2424 – id пансиона;
Необязательные параметры:
regionId=1234 – id региона СПО. Для каждой страны регион СПО несет свою смысловую нагрузку(в интерфейсе выглядит как список «Тур»). Не может быть использован вместе с tourId.
tourId=1285 – id региона. Можно указать несколько регионов: tourId=14259&tourId=14385. Для двойного проживания значения необходимо указывать через запятую: tourId=14259,14385. Параметр не может быть использован вместе с spoRegionId.
hotelId=1234 – id отеля. Можно указать несколько отелей: hotelId=1234&hotelId=12345;
hotelClassBetter=true/false – позволяет(либо не позволяет) выдавать в результате подбора отели классом выше указанного(в интерфейсе выглядит как флажок «и лучше»); По умолчанию false
rAndBBetter=true/false – позволяет(либо не позволяет) выдавать в результате подбора предложения с пансионом уровнем выше указанного(в интерфейсе выглядит как флажок «и лучше»); По умолчанию false
birthdays=12.06.2005,12.07.2015,12.03.2002 – параметр должен быть указан только в случае поиска туров с детьми (до 4 дат рождения)
xml=true/false – формат результата подбора(ответа). True – ответ придет в формате xml, false – ответ придет в формате search.
formatResult= true/false – форматирование ответа. True – ответ будет отформатирован, false – ответ придет одной строкой. Актуально только для ответа в формате search.
groupByHotel=1 - параметр группировки цен (1 - по отелю и количеству ночей, 2 - один отель, минимальная цена, 3 - по отелю и типу питанию), по умолчанию 0
tourType=1 - состав тура статичные значения (1 - Полный пакет, 2 - Проживание + трансфер, 3 - Проживание, 6 - Проживание + перелёт), по умолчанию 1
locale=ru/en – локализация. Ru – русская локализация, en – английская локализация(на стадии доработки). По умолчанию ru
showArrivalRegion=true/false - позволяет позволяет искать по ID региона прилета. По умолчанию false
noTicketsFrom=true/false – позволяет искать предложения, для которых нет подходящих вылетов обратно (в интерфейсе выглядит как флажок «нет билетов обратно»). По умолчанию false
noTicketsTo=true/false – позволяет искать предложения, для которых нет подходящих вылетов туда (в интерфейсе выглядит как флажок «нет билетов туда»). По умолчанию false
hotelInStop=true/false – позволяет искать предложения, для которых отели в стопе (в интерфейсе выглядит как флажок «отели в стопе»). По умолчанию false
recommendedFlag=true/false - позволяет искать отели только с признаком "TEZ рекомендует". По умолчанию false
onlineConfirmFlag=true/false - позволяет искать отели только с признаком "Мгновенное подтверждение". По умолчанию false
promoFlag=true/false - позволяет искать предложения с признаком "Промо-тариф", по умолчанию true
Результат подбора тура:
<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>Вс</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>Анталия</region>
<comments>Tez рекомендует, раннее бронирование (особые условия бронирования)</comments>
<pansion>UAI</pansion>
<pansionComment>Ультра все включено</pansionComment>
<hotelStayType>DBL</hotelStayType>
<ageGroupType>2+0+0</ageGroupType>
<price>$1727</price>
<spo>SPO 1046</spo>
<existsRoom>Есть</existsRoom>
<freeSeatNumberToC>Нет</freeSeatNumberToC>
<freeSeatNumberToY>Есть</freeSeatNumberToY>
<freeSeatNumberToR>Нет</freeSeatNumberToR>
<extraChargeToC></extraChargeToC>
<extraChargeToY></extraChargeToY>
<extraChargeToR></extraChargeToR>
<freeSeatNumberFromC>Нет</freeSeatNumberFromC>
<freeSeatNumberFromY>Есть</freeSeatNumberFromY>
<freeSeatNumberFromR>Нет</freeSeatNumberFromR>
<extraChargeFromC></extraChargeFromC>
<extraChargeFromY></extraChargeFromY>
<extraChargeFromR></extraChargeFromR>
<containerId>40974908563</containerId>
<hotelRoomTypeId>4116100</hotelRoomTypeId>
<hotelPansionId>9036300</hotelPansionId>
<groupTypeAgeId>68578</groupTypeAgeId>
<hotelStayTypeId>2</hotelStayTypeId>
<arrivalRegionId>1285</arrivalRegionId>
<icons>
<baseHotel> <value>true</value>
<comment>Tez рекомендует</comment>
</baseHotel>
<earlyBooking> <value>true</value>
<comment>раннее бронирование (особые условия бронирования)</comment>
<text>до 31.10</text>
</earlyBooking>
<onlineConfirm> <value>true</value>
<comment>мгновенное подтверждение</comment>
</onlineConfirm>
<pack> <value>false</value> </pack>
<topPriority>
<value>true</value>
<comment>TEZ приоритет</comment>
</topPriority>
<exclusive> <value>true</value>
<comment>TEZ эксклюзив</comment>
</exclusive>
<flexComission> <value>false</value> </flexComission>
<fixComission> <value>true</value> <comment>Фиксированная комиссия</comment> <text>9.0 %</text> </fixComission>
<luxuryHotel> <value>false</value> </luxuryHotel>
<externalFlights> <value>true</value> <comment>Регулярные рейсы</comment> </externalFlights>
<sber> <value>false</value> </sber>
<blackFriday> <value>false</value> </blackFriday>
<balttour> <value>false</value> </balttour>
<extraServices> <value>false</value> </extraServices>
<promos class="list"/>
</icons>
Расшифровка результата подбора туров:
<checkIn> - дата заезда
<checkInDayofWeek> - день недели заезда
<departureDate> - дата вылета
<nightCount> - количество ночей
<checkOut> - проживание до указанного числа
<hotel> - название отеля
<hotelUrl> - URL на страницу отеля в справочнике на сайте http://www.tez-tour.com/
<hotelRoomType> - тип номера
<secondHotel> - в случае, если есть двойное(или более) проживание здесь указывается название отеля(если вариантов второго прожиания болше одного, то для каждого указывается)
<bookingUrl> - ссылка на создание заявки по данной записи с учетом условий поиска
<spoUrl> - ссылка на подробное описание спецпредложения.
<tour> - регион СПО
<region> - регион
<resortArrivalRegionName> - название аэропорта прилета
<comments> - специальные отметки: раннее бронирование, tez рекомендует, мгновенное подтверждение.
<pansion> - панисион
<pansionComment> - описание пансиона
<hotelStayType> - тип размещения
<ageGroupType> - размещение по возрастным группам
<groupTypeAgeId> - ID возрастной группы
<spo> - номер ценового предложения
<existsRoom> - наличие мест в отеле
<arrivalRegionId> - регион прилета
<freeSeatNumberToC> - наличие мест бизнес класса на перелет туда
<freeSeatNumberToY> - наличие мест эконом класса на перелет туда
<freeSeatNumberToR> - наличие мест премиум эконом класса на перелет туда
<extraChargeToC> - доплата за бизнес класс на перелет туда
<extraChargeToY> - доплата за эконом класс на перелет туда
<extraChargeToR> - доплата за пермиум эконом класс на перелет туда
<freeSeatNumberFromC>> - наличие мест бизнес класса на перелет обратно
<freeSeatNumberFromY>> - наличие мест эконом класса на перелет обратно
<freeSeatNumberFromR>> - наличие мест премиум эконом класса на перелет обратно
<extraChargeFromC> - доплата за бизнес класс на перелет обратно
<extraChargeFromY> - доплата за эконом класс на перелет обратно
<extraChargeFromR> - доплата за премиум эконом класс на перелет обратно
<icons> - элемент, содержащий дополнительную информацию о туре. Обычно подобная информация отображается в результатах подбора в виде иконок.
Содержит вложенные элементы:
<baseHotel> - признак "TEZ рекомендует". Содержит вложенные эелементы:
<value> - отвечает за актуальность родительского элемента. Если true, то соответсвующий элемент назначен отелю. Если false - то нет.
<comment> - текстовый комеентарий к характеристики. Например, "Tez рекомендует"
<earlyBooking> - информация о раннем бронировании по предложению. Содержит вложенные элементы:
<value> - если значение true - то для предложения предусмотрено раннее бронирование, если false - то нет.
<comment> - текстовый комментарий к раннему бронированию.
<text> - элемент содежит детали по раннему бронированию.
<string>до 15.05</string> - текстовые комментарии по условиям раннего бронирования.
<onlineConfirm> - информация о мгновенных подтверждениях.
<value> - если значение true - то для предложения предусмотерно мгновенное подтверждение, если false - то не предусмотрено.
<comment> - текстовый комментарий.
<pack> - является ли тур пакетным.
<value> - если значение true - то для предложение пакетное, если false - то нет.
<topPriority> - признак, определящий, является ли отель Tez Приоритет.
<value> - если значение true - то отель входит в Tez Приоритет, если false - то нет
<exclusive> - признак, определяющий, является ли отель Tez Эксклюзив.
<value> - если значение true - то отель входит в Tez Эксклюзив, если false - то нет
<flexComission> - содержит информацию о гибкой комиссии.
<value> - если значение true - то для предложения существует гибкая комиссия, если false - то нет.
<fixComission> - содержит информацию о фиксированной комиссии.
<value> - если значение true - то для предложения существует фиксированная комисиия, если false - то нет.
<externalFlights> - содержит информацию о необходимости подбора регулярных рейсов.
<value> - если значение true - то для предложения необходим дополнительный подбор регулярных рейсов, если false - то в предложение присутствуют чартерные рейсы.
1. Общий справочник
Для вызова общего справочника используется URL:
https://search.tez-tour.com/tariffsearch/refs?locale=ru&formatResult=true&xml=true
Справочник:
<references>
<success>true</success>
<cities>
<city>
<cityId>345</cityId>
<name>Москва</name>
</city>
<city>
<cityId>392</cityId>
<name>Нижний Новгород</name>
</city>
<city>
<cityId>412</cityId>
<name>Самара</name>
</city>
</cities>
<countries>
<country>
<countryId>1104</countryId>
<name>Турция</name>
</country>
<country>
<countryId>5732</countryId>
<name>Египет</name>
</country>
</countries>
<currencies>
<currency>
<currencyId>5561</currencyId>
<name>Доллар США</name>
</currency>
<currency>
<currencyId>8390</currencyId>
<name>Рубль</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>
Расшифровка общего справочника:
<city> - город.
<cityId> - id города.
<name> - название города.
<country> - страна.
<countryId> - id страны.
<name> - название страны.
<currency> - валюта.
<currencyId> - id валюты.
<name> - название валюты.
<hotelClass> - уровень отеля.
<classId> - id уровня отеля.
<name> - название уровня отеля.
<weight> - вес (коэффициент) уровня отеля
<rAndB> - пансион.
<rAndBId> - id пансиона.
<name> - название пансиона.
<weight> - вес (коэффициент) пансиона.
2. Справочник по странам
Для того, чтобы получить справочник по определенной стране нужно в URLе
https://search.tez-tour.com/tariffsearch/byCountry?countryId=1104&cityId=345&locale=ru&xml=true
указать параметры:
countryId=xxxx, где xxxx- id нужной страны.
cityId=хххх, где xxxx- id города вылета
Справочник по странам:
<referencesByCountry>
<success>true</success>
<tours>
<tour>
<name>Дахаб</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>
Расшифровка справочника:
<tour>
<name> - название региона
<tourId>
<long> - id региона
</tourId>
<fromCityId> - города вылета, из которых есть перелеты в этот регион
<long> - id города вылета
<long> - id города вылета
</fromCityId>
</tour>
<regions>
<spoRegion>
<regionId> - id региона СПО
<name> - название региона СПО
</spoRegion>
</regions>
<hotels>
<hotel>
<tourId> - id региона
<hotelId> - id отеля
<name> - название отеля
<hcWeight> - вес(коэффициент) уровня отеля
<rbWeight>
<long> - вес(коэффициент) пансиона отеля
<long> - вес(коэффициент) пансиона отеля
</rbWeight>
</hotel>
</hotels>
3. Список перелетов
Для получения списка перелетов нужно в URLe https://search.tez-tour.com/tariffsearch/getFlightDeparture?cityId=345&countryId=5733&formatResult=true&xml=true
указать параметры cityId – id города вылета и countryId – id страны назначения.
Список перелетов:
<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>
Расшифровка списка:
<int> - год
<object-array/> - 1й месяц
<object-array/> - 2й месяц
<object-array/> - 3й месяц
<object-array/> - 4й месяц
<object-array> - 5й месяц
<int> - число, на которое зарегистрирован рейс
<int> - число, на которое зарегистрирован рейс
<int> - число, на которое зарегистрирован рейс
4. Справочник с параметрами защиты подбора тура
Справочник ProtectSettings – в данном справочнике содержатся параметры защиты подбора тура. Зная данные параметры защиты подбора тура, можно сформировать корректный запрос на подбор тура (если параметры в подборе тура превышают значение параметров данного справочника, то в результате подбора тура вернётся ошибка).
Для просмотра справочника можно использовать URL: https://search.tez-tour.com/tariffsearch/protectSettings?countryId=1104&cityId=345&xml=true&formatResult=true
Справочник параметров защиты подбора тура:
<com.teztour.coresearch.util.pojo.AggregateProtectSettings>
<success>true</success>
<serverName>amba.teztour.com</serverName>
<settings class="list">
<com.teztour.coresearch.dto.ProtectSettingDto>
<key>checkin.range.max</key>
<value>20</value>
</com.teztour.coresearch.dto.ProtectSettingDto>
<com.teztour.coresearch.dto.ProtectSettingDto>
<key>checkout.max</key>
<value>540</value>
</com.teztour.coresearch.dto.ProtectSettingDto>
<com.teztour.coresearch.dto.ProtectSettingDto>
<key>nights.range.max</key>
<value>8</value>
</com.teztour.coresearch.dto.ProtectSettingDto>
</settings>
<priceSettings class="list">
<com.teztour.coresearch.dto.PriceSettingDto>
<currencyId>46688</currencyId>
<maxValue>1500000</maxValue>
</com.teztour.coresearch.dto.PriceSettingDto>
……………………
<com.teztour.coresearch.dto.PriceSettingDto>
<currencyId>5561</currencyId>
<maxValue>150000</maxValue>
</com.teztour.coresearch.dto.PriceSettingDto>
</priceSettings>
</com.teztour.coresearch.util.pojo.AggregateProtectSettings>
Расшифровка справочника:
<settings class="list">
<com.teztour.coresearch.dto.ProtectSettingDto>
<key>checkin.range.max</key> - максимальный диапазон дат заезда в отель
<value>20</value> - количество дней диапазона
</com.teztour.coresearch.dto.ProtectSettingDto>
<com.teztour.coresearch.dto.ProtectSettingDto>
<key>checkout.max</key> - максимальная дата выезда из отеля
<value>540</value> - количество дней (от сегодняшней даты)
</com.teztour.coresearch.dto.ProtectSettingDto>
<com.teztour.coresearch.dto.ProtectSettingDto>
<key>nights.range.max</key> - максимальный диапазон количества ночей проживания
<value>8</value> - количество ночей
</com.teztour.coresearch.dto.ProtectSettingDto>
</settings>
<priceSettings class="list"> - максимальная ширина интервала стоимости тура в запросе
<com.teztour.coresearch.dto.PriceSettingDto>
<currencyId>46688</currencyId> - ID валюты
<maxValue>1500000</maxValue> - ширина интервала
</com.teztour.coresearch.dto.PriceSettingDto>
</priceSettings>
<timestamp>29.11.2013 12:00:01</timestamp> - дата и время последнего изменения данных настроек
5. Список допустимых пансионов
Динамическое ценообразование:
https://xml.tez-tour.com/tariffsearch/randbs?cityId=345&countryId=5732&locale=ru&formatResult=true&xml=true
Ответ:
<rAndBs>
<success>true</success>
<serverName>mamba.teztour.com</serverName>
<rAndBs class="list">
<rAndB>
<rAndBId>15350</rAndBId>
<name>Размещение без питания</name>
<weight>0</weight>
<group>RO</group>
</rAndB>
...
<rAndB>
<rAndBId>5737</rAndBId>
<name>Все включено</name>
<weight>7</weight>
<group>AI</group>
</rAndB>
</rAndBs>
</rAndBs>
Расшифровка списка:
<rAndB>
<rAndBId>15350</rAndBId> - ID пансиона
<name>Размещение без питания</name> - наименование пансиона
<weight>0</weight> - данный параметр не обязателен
<group>RO</group> - группа пансионов, к которым относится данный пансион
</rAndB>
СПО:
6. Список допустимых категорий отелей
Динамическое ценообразование:
Ответ:
<hotelClasses>
<success>true</success>
<serverName>mamba.teztour.com</serverName>
<hotelClasses class="list">
<hotelClass>
<classId>2568</classId>
<name>3 *</name>
<weight>2</weight>
</hotelClass>
<hotelClass>
<classId>2569</classId>
<name>4 *</name>
<weight>5</weight>
</hotelClass>
<hotelClass>
<classId>2570</classId>
<name>5 *</name>
<weight>8</weight>
</hotelClass>
</hotelClasses>
</hotelClasses>
Расшифровка списка:
<hotelClass>
<classId>2570</classId> - ID уровня отеля
<name>5 *</name> - наименование уровня отеля
<weight>8</weight> - группа категорий, к которой относится данная категория
</hotelClass>
СПО:
7. Список допустимых типов размещения
Динамическое ценообразование:
Ответ:
<accommodations>
<success>true</success>
<serverName>mamba.teztour.com</serverName>
<accommodations class="list">
<accommodation>
<accommodationId>158525</accommodationId>
<name>1 Ребенок</name>
<children>1</children>
<adult>0</adult>
<selected>false</selected>
</accommodation>
...
<accommodation>
<accommodationId>151519</accommodationId>
<name>12 Взрослых</name>
<children>0</children>
<adult>12</adult>
<selected>false</selected>
</accommodation>
</accommodations>
</accommodations>
Расшифровка списка:
<accommodation>
<accommodationId>158525</accommodationId> - ID типа размещения
<name>1 Ребенок</name> - наименование размещение
<children>1</children> - количество детей в данном типе размещения
<adult>0</adult> - количество взрослых в данном типе размещения
<selected>false</selected> - данный параметр не обязателен
</accommodation>