Подбор перелётов для продажи авиабилетов
Сервис необходим для поиска и продажи авиабилетов без проживания, трансферов и других услуг.
Доступен поиск и 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>