Подбор перелётов для продажи авиабилетов

Сервис необходим для поиска и продажи авиабилетов без проживания, трансферов и других услуг.
Доступен поиск и OW билетов, необходимо указать данные в одну сторону, в ответ придёт один блок с билетами.

Запрос:

https://xml.tez-tour.com/ticketsearch/search?locale=ru&departureIataCodeTo=MOW&departureDateTo=20.07.2018&arrivalIataCodeTo=HKT&departureIataCodeFrom=HKT&departureDateFrom=04.08.2018&arrivalIataCodeFrom=MOW& currencyId=5561&adultCount=1&childCount=0&infantCount=0


Параметры:

departureIataCodeTo=MOW - ИАТА код аэропорта вылета "Туда" из справочника 16. Аэропорты
arrivalIataCodeTo=HKT - ИАТА код аэропорта прилёта "Туда" из справочника 16. Аэропорты
departureDateTo=20.07.2018 - даты вылета "Туда"
adultCount=1 - количество взрослых туристов (обязательный)
childCount=0 - количество детей от 3 до 12 (обязательный)
infantCount=0 - количество младенцев (обязательный)
departureIataCodeFrom=HKT - ИАТА код аэропорта вылета "Обратно" из справочника 16. Аэропорты
arrivalIataCodeFrom=MOW - ИАТА код аэропорта прилёта "Обратно" из справочника 16. Аэропорты
departureDateFrom=04.08.2018 - дата вылета "Обратно"
currencyId=5561 - идентификатор из справочника 24. Валюты (обязательный)

Ответ:
Пример с описанием всех полей.

<Tickets>
  <ticket>
  <!-- ticket - блок с информации о билетах доступных к продаже -->

    <!-- Блок с информацией о рейсе "туда" -->
    <departureCountryIdTo>1102</departureCountryIdTo>
    <!-- id страны отправления из справочника 1. Страны -->
    <departureCountryNameTo>RUSSIA</departureCountryNameTo>
    <!-- Название страны отправления из справочника 1. Страны -->
    <departureRegionIdTo>12708</departureRegionIdTo>
    <!-- id региона отправления из справочника 2. Регионы -->
    <departureRegionNameTo>MOSCOW</departureRegionNameTo>
    <!-- Название региона отправления из справочника 2. Регионы -->
    <departureCityIdTo>345</departureCityIdTo>
    <!-- id города отправления из справочника 3. Города -->
    <departureCityNameTo>MOSCOW</departureCityNameTo>
    <!-- Название города отправления из справочника 3. Города -->
    <departureAirportIdTo>220284</departureAirportIdTo>
    <!-- id аэропорта отправления из справочника 16. Аэропорты -->
    <departureAirportNameTo>VKO-A</departureAirportNameTo>
    <!-- Название аэропорта отправления из справочника 16. Аэропорты -->
    <departureDateTo>20.07.2018</departureDateTo>
    <!-- Дата отправления -->
    <arrivalCountryIdTo>12695</arrivalCountryIdTo>
    <!-- id страны прибытия из справочника 1. Страны -->
    <arrivalCountryNameTo>THAILAND</arrivalCountryNameTo>
    <!-- Название страны прибытия из справочника 1. Страны -->
    <arrivalRegionIdTo>14369</arrivalRegionIdTo>
    <!-- id региона прибытия из справочника 2. Регионы -->
    <arrivalRegionNameTo>PHUKET</arrivalRegionNameTo>
    <!-- Название региона прибытия из справочника 2. Регионы -->
    <arrivalCityIdTo>466</arrivalCityIdTo>
    <!-- id города прибытия из справочника 3. Города -->
    <arrivalCityNameTo>PHUKET</arrivalCityNameTo>
    <!-- Название города прибытия из справочника 3. Города -->
    <arrivalAirportIdTo>589</arrivalAirportIdTo>
    <!-- id аэропорта прибытия из справочника 16. Аэропорты -->
    <arrivalAirportNameTo>PHUKET (HKT)</arrivalAirportNameTo>
    <!-- Название аэропорта прибытия из справочника 16. Аэропорты -->
    <aircompanyIdTo>3023006</aircompanyIdTo>
    <!-- id авиакомпании из справочника 15. Авиакомпании -->
    <aircompanyNameTo>I FLY</aircompanyNameTo>
    <!-- Название авиакомпании из справочника 15. Авиакомпании -->
    <flightIdTo>478286</flightIdTo>
    <!-- id рейса из справочника 18. Чартерные рейсы -->
    <flightNameTo>I4 9557</flightNameTo>
    <!-- Номер рейса из справочника 18. Чартерные рейсы -->
    <flightDepartureIdTo>2260754</flightDepartureIdTo>
    <!-- id вылета из справочника 19. Чартерные вылеты -->
    <flightDepartureNameTo>I4 9557 (20.07)</flightDepartureNameTo>
    <!-- Название вылета из справочника 19. Чартерные вылеты -->
    <fdDepDateTo>20.07.2018 20:10</fdDepDateTo>
    <!-- Дата и время отправления из справочника 19. Чартерные вылеты --> 
    <fdArrDateTo>21.07.2018 10:00</fdArrDateTo>
    <!-- Дата и время прибытия из справочника 19. Чартерные вылеты -->
    <!-- Завершение блока с информацией о рейсе "туда" -->

    <!-- Блок с информацией о рейсе "обратно" -->
    <departureCountryIdFrom>12695</departureCountryIdFrom>
    <!-- id страны отправления из справочника 1. Страны -->
    <departureCountryNameFrom>THAILAND</departureCountryNameFrom>
    <!-- Название страны отправления из справочника 1. Страны -->
    <departureRegionIdFrom>14369</departureRegionIdFrom>
    <!-- id региона отправления из справочника 2. Регионы -->
    <departureRegionNameFrom>PHUKET</departureRegionNameFrom>
    <!-- Название региона отправления из справочника 2. Регионы -->
    <departureCityIdFrom>466</departureCityIdFrom>
    <-- id города отправления из справочника 3. Города -->
    <departureCityNameFrom>PHUKET</departureCityNameFrom>
    <!-- Название города отправления из справочника 3. Города -->
    <departureAirportIdFrom>589</departureAirportIdFrom>
    <!-- id аэропорта отправления из справочника 16. Аэропорты -->
    <departureAirportNameFrom>PHUKET (HKT)</departureAirportNameFrom>
    <!-- Название аэропорта отправления из справочника 16. Аэропорты -->
    <departureDateFrom>04.08.2018</departureDateFrom>
    <!-- Дата отправления -->
    <arrivalCountryIdFrom>1102</arrivalCountryIdFrom>
    <!-- id страны прибытия из справочника 1. Страны -->
    <arrivalCountryNameFrom>RUSSIA</arrivalCountryNameFrom>
    <!-- Название страны прибытия из справочника 1. Страны -->
    <arrivalRegionIdFrom>12708</arrivalRegionIdFrom>
    <!-- id региона прибытия из справочника 2. Регионы -->
    <arrivalRegionNameFrom>MOSCOW</arrivalRegionNameFrom>
    <!-- Название региона прибытия из справочника 2. Регионы -->
    <arrivalCityIdFrom>345</arrivalCityIdFrom>
    <!-- id города прибытия из справочника 3. Города -->
    <arrivalCityNameFrom>MOSCOW</arrivalCityNameFrom>
    <!-- Название города прибытия из справочника 3. Города -->
    <arrivalAirportIdFrom>220284</arrivalAirportIdFrom>
    <!-- id аэропорта прибытия из справочника 16. Аэропорты -->
    <arrivalAirportNameFrom>VKO-A</arrivalAirportNameFrom>
    <!-- Название аэропорта прибытия из справочника 16. Аэропорты -->
    <aircompanyIdFrom>3023006</aircompanyIdFrom>
    <!-- id авиакомпании из справочника 15. Авиакомпании -->
    <aircompanyNameFrom>I FLY</aircompanyNameFrom>
    <!-- Название авиакомпании из справочника 15. Авиакомпании -->
    <flightIdFrom>558054</flightIdFrom>
    <!-- id рейса из справочника 18. Чартерные рейсы -->
    <flightNameFrom>I4 9558</flightNameFrom>
    <!-- Номер рейса из справочника 18. Чартерные рейсы -->
    <flightDepartureIdFrom>2260907</flightDepartureIdFrom>
    <!-- id вылета из справочника 19. Чартерные вылеты -->
    <flightDepartureNameFrom>I4 9558 (04.08)</flightDepartureNameFrom>
    <!-- Название вылета из справочника 19. Чартерные вылеты -->
    <fdDepDateFrom>04.08.2018 12:00</fdDepDateFrom>
    <!-- Дата и время отправления из справочника 19. Чартерные вылеты -->
    <fdArrDateFrom>04.08.2018 18:10</fdArrDateFrom>
    <!-- Дата и время прибытия из справочника 19. Чартерные вылеты -->
    <!-- Завершение блока с информацией о рейсе "Обратно" -->

    <!-- Блок с информацией о свободных местах и цене "туда" -->
    <seatSetYTo>2261089</fseatSetYTo>
    <!-- id набора места (эконом) -->
    <seatSetCTo>0</seatSetCTo>
    <!-- id набора места (бизнес) -->
    <seatSetFTo>0</seatSetFTo>
    <- id набора места (Первый класс) -->
    <seatSetRTo>0</seatSetRTo>
    <!-- id набора места (Премиум-Эконом) -->
    <freeSeatYTo>293</freeSeatYTo> 
    <!-- кол-во свободных мест (эконом) -->
    <freeSeatCTo>0</freeSeatCTo>
    <!-- кол-во свободных мест (бизнес) -->
    <freeSeatFTo>0</freeSeatFTo>
    <!-- кол-во свободных мест (первый класс) -->
    <freeSeatRTo>0</freeSeatRTo>
    <!-- кол-во свободных мест (премиум-эконом) -->
    <priceSeatYTo>310</priceSeatYTo>
    <!-- цена (эконом) -->
    <priceSeatCTo>0</priceSeatCTo>
    <!-- цена (бизнес) -->
    <priceSeatFTo>0</priceSeatFTo>
    <!-- цена (первый класс) -->
    <priceSeatRTo>0</priceSeatRTo>
    <!-- цена (премиум-эконом) -->
    <!-- Завершение блока с информацией о свободных местах и цене "туда" -->

    <!-- Блок с информацией о свободных местах и цене "Обратно" -->
    <seatSetYFrom>2261044</seatSetYFrom>
    <!-- id набора места (эконом) -->
    <seatSetCFrom>0</seatSetCFrom>
    <!-- id набора места (бизнес) -->
    <seatSetFFrom>0</seatSetFFrom>
    <- id набора места (первый класс) -->
    <seatSetRFrom>0</seatSetRFrom>
    <!-- id набора места (премиум-Эконом) -->
    <freeSeatYFrom>295</freeSeatYFrom>
    <!-- кол-во свободных мест (эконом) -->
    <freeSeatCFrom>0</freeSeatCFrom>
    <!-- кол-во свободных мест (бизнес) -->
    <freeSeatFFrom>0</freeSeatFFrom>
    <!-- кол-во свободных мест (первый класс) -->
    <freeSeatRFrom>0</freeSeatRFrom>
    <!-- кол-во свободных мест (премиум-Эконом) -->
    <priceSeatYFrom>310</priceSeatYFrom>
    <!-- цена (эконом) -->
    <priceSeatCFrom>0</priceSeatCFrom>
    <!-- цена (бизнес) -->
    <priceSeatFFrom>0</priceSeatFFrom>
    <!-- цена (первый класс) -->
    <priceSeatRFrom>0</priceSeatRFrom>
    <!-- цена (премиум-эконом) -->
    <!-- Завершение блока с информацией о свободных местах и цене "Обратно" -->
	
    <!-- Блок с информацией о доплатах и валюте -->
    <extraCharge>50</extraCharge>
    <!-- сумма доплат за авиакоманию, аэропортовый сбор и т.п. -->
    <currencyId>5561</currencyId>
    <!-- id валюты из справочника 24. Валюта -->
    <currencySign>$</currencySign>
    <!-- символ валюты -->
    <depCountryResortFlagTo>0</depCountryResortFlagTo>
    <!-- признак курортной страны 1 - является, 0 - не является -->
    <arrCountryResortFlagTo>1</arrCountryResortFlagTo>
    <!-- признак курортной страны 1 - является, 0 - не является -->
    <!-- Завершение блока с информацией о доплатах и валюте -->

  </ticket>
</Tickets>



Расчёт заявки перед бронированием

Перед бронированием заявки, можно предварительно рассчитать ее стоимость. Заполненный XML с заявкой (xml тот же, что и при бронировании) необходимо передать в теле запроса. В заголовке http-запроса для поля Content-type необходимо передать  значение application/xml. Расчет доступен как для пакетных туров, так и для непакетных туров. Цена указана в валюте заявки.

Сервис:

http://xml.tez-tour.com/xmlgate/order/calculate

Сервис описан тут



Бронирование авиабилетов

Для бронирования авиабилетов необходимо в сервис (такой же как и при бронировании пакетной заявки) передать post-запрос с телом xml-заявки. В случае успешного бронирования будет получен ответ, содержащий номер заявки, иначе ответ будет содержать сообщение об ошибке.

Сервис:

http://xml.tez-tour.com/xmlgate/order/book

Шаблон:
Сформированой заявки с описанием полей.

<order>
  <OrderType>
  <!-- OrderType - блок с типом заявки -->
    <type>Charter</type>
    <!-- type - тип заявки -->
  </OrderType>
  <Country>
  <!-- Country - блок с информацией о стране отдыха -->
    <id>12695</id>
    <!-- id - идентификатор страны отдыха из справочника 1. Страны -->
    <name>THAILAND</name>
    <!-- name - название страны на английском языке из справочника 1. Страны -->
  </Country>
  <Summary>
  <!-- Summary - блок с информацией о тарифах (СПО) и ценах -->
    <price>385</price>
    <!-- price - цена за авиабилеты -->
    <currency>5561</currency>
    <!-- currency - идентификатор валюты из справочника 24. Валюты -->
  </Summary>
  <Tourist>
  <!-- Tourist - блок с информацией о туристе -->
    <touristId>1</touristId>
    <!-- touristId - идентификатор туриста, необходим для привязки к услугам -->
    <surname>ADULTMR</surname>
    <!-- surname - фамилия туриста -->
    <name>ADULTMR</name>
    <!-- name - имя туриста -->
    <gender>2688</gender>
    <!-- gender - идентификатор пола и возраста туриста из справочника 23. Пол и возраст -->
    <birthday>04.07.1978</birthday>
    <!-- birthday - дата рождения туриста -->
    <nationality>1102</nationality>
    <!-- nationality - идентификатор национальности туриста из справочника 1. Страны -->
    <passport_seria>45</passport_seria>
    <!-- passport_seria - серия паспорта -->
    <passport>4543</passport>
    <!-- passport - номер паспорта -->
    <passport_issue_date>07.07.2015</passport_issue_date>
    <!-- passport_issue_date - дата начала действия заграничного паспорта -->
    <passport_expiration_date>16.07.2020</passport_expiration_date>
    <!-- passport_expiration_date - дата окончания действия заграничного паспорта -->
    <mobile_phone></mobile_phone>
    <!-- mobile_phone - мобильный телефон в формате +79032431232 -->
    <emailBoardingPass></emailBoardingPass>
    <!-- emailBoardingPass - электронная почта туриста в формате aaa@bbb.com -->
    <genderName>MR.</genderName>
    <!-- genderName - значение пола и возраста туриста из справочника 23. Пол и возраст -->
    <sex>1</sex>
    <!-- sex - значение пола 1 - Мужчина , 2 - Женщина -->
  </Tourist>
  <Ticket>
  <!-- Ticket - блок с информацией о перелётах "туда" -->
    <serviceId>1</serviceId>
    <!-- serviceId - идентификатор услуги, необходим для привязки к туристу -->
    <flightDeparture>478286</flightDeparture>
    <!-- flightDeparture - идентификатор рейса из справочника 19. Чартерные вылеты -->
    <seatType>3</seatType>
    <!-- seatType - идентификатор класса кресла из справочника 20. Чартерные классы кресел -->
    <flightNumber>I4 9557</flightNumber> 
    <!-- flightNumber - Номер рейса -->
    <toResortCountry>true</toResortCountry>
    <!-- toResortCountry - информация о рейсе, true - рейс в страну отдыха, false - обратный рейс -->	
    <seat_type>Economy</seat_type>
    <!-- seat_type - название класса кресла из справочника 20. Чартерные классы кресел -->
    <departure_datetime>20.07.2018 20:10:22</departure_datetime>
    <!-- departure_datetime - дата и время вылета, параметр задан в виде даты и времени -->
    <arrival_datetime>21.07.2018 10:00:22</arrival_datetime>
    <!-- arrival_datetime - дата и время прилёта, параметр задан в виде даты и времени -->
    <departureAirportId>220284</departureAirportId>
    <!-- departureAirportId - идентификатор точки отправления из справочника 16. Аэропорты -->
    <departure_airport>VKO-A</departure_airport>
    <!-- departure_airport - точка отправления из справочника 16. Аэропорты -->
    <arrivalAirportId>589</arrivalAirportId>
    <!-- arrival_airport - идентификатор точки прибытия из справочника 16. Аэропорты -->
    <arrival_airport>PHUKET (HKT)</arrival_airport>
    <!-- arrival_airport - точка прибытия из справочника 16. Аэропорты -->
  </Ticket>
  <Ticket>
  <!-- Ticket - блок с информацией о перелётах "Обратно" -->
    <serviceId>2</serviceId>
    <!-- serviceId - идентификатор услуги, необходим для привязки к туристу -->
    <flightDeparture>558054</flightDeparture>
    <!-- flightDeparture - идентификатор рейса из справочника 19. Чартерные вылеты -->
    <seatType>3</seatType>
    <!-- seatType - идентификатор класса кресла из справочника 20. Чартерные классы кресел -->
    <flightNumber>I4 9558</flightNumber>
    <!-- flightNumber - Номер рейса -->	
    <toResortCountry>false</toResortCountry>
    <!-- toResortCountry - информация о рейсе, true - рейс в страну отдыха, false - обратный рейс -->
    <seat_type>Economy</seat_type>
    <!-- seat_type - название класса кресла из справочника 20. Чартерные классы кресел -->
    <departure_datetime>04.08.2018 12:00:22</departure_datetime>
    <!-- departure_datetime - дата и время вылета, параметр задан в виде даты и времени -->
    <arrival_datetime>04.08.2018 18:10:22</arrival_datetime>
    <!-- arrival_datetime - дата и время прилёта, параметр задан в виде даты и времени -->
    <departureAirportId>589</departureAirportId>
    <!-- departureAirportId - идентификатор точки отправления из справочника 16. Аэропорты -->
    <departure_airport>PHUKET (HKT)</departure_airport>
    <!-- departure_airport - точка отправления из справочника 16. Аэропорты -->
    <arrivalAirportId>220284</arrivalAirportId>
    <!-- arrival_airport - идентификатор точки прибытия из справочника 16. Аэропорты -->
    <arrival_airport>VKO-A</arrival_airport>
    <!-- arrival_airport - точка прибытия из справочника 16. Аэропорты -->
  </Ticket>
  <ServiceTourist>
  <!-- ServiceTourist Блок привязки услуги к туристу -->
    <serviceId>1</serviceId>
    <!-- serviceId - идентификатор услуги -->
    <touristId>1</touristId>
    <!-- touristId - идентификатор туриста -->
  </ServiceTourist>
  <ServiceTourist>
    <serviceId>2</serviceId>
    <touristId>1</touristId>
  </ServiceTourist>
</order>


Ответ:
<booking-result>
  <orderId>16206803</orderId>
  <!-- orderId - Номер заявки -->
</booking-result>