ПОДПИСЫВАЙТЕСЬ НА НАШ ТЕЛЕГРАМ-КАНАЛ @nemo_travel_official

Веб-служба поиска авиабилетов: различия между версиями

Материал из Центр поддержки системы бронировании
Перейти к навигации Перейти к поиску
(Сложный маршрут)
 
(не показано 5 промежуточных версий 2 участников)
Строка 3: Строка 3:
 
Это сервис внутри Nemo, который позволяет получить результаты поиска.
 
Это сервис внутри Nemo, который позволяет получить результаты поиска.
  
Для подключения к веб-службе поиска авиабилетов необходимо открыть доступ нужному пользователю. Это можно сделать в разделе '''«Администрирование»''' ⇨ '''«Веб-служба. Авторизация»'''.
+
Для подключения к веб-службе поиска авиабилетов необходимо открыть доступ нужному пользователю. Это можно сделать в разделе '''«Настройки системы»''' ⇨ '''«Интеграция»''' ⇨ '''«Nemo (SOAP API)»'''.
  
 
После добавления пользователя, ему будут присвоены Номер (ClientId) и API ключ клиента, которые нужно использовать для подключения.
 
После добавления пользователя, ему будут присвоены Номер (ClientId) и API ключ клиента, которые нужно использовать для подключения.
Строка 254: Строка 254:
 
                                 <Tariff Code="?" SegNum="?"/>
 
                                 <Tariff Code="?" SegNum="?"/>
 
                                 <!--Code — код тарифа, SegNum — номер сегмента, к которому применён тариф-->
 
                                 <!--Code — код тарифа, SegNum — номер сегмента, к которому применён тариф-->
 +
                                    <FareFamilies>
 +
                                    <!--FareFamilies - наличие данного параметра у сегмента, означает, что у а\к заведены семейства тарифов-->
 +
                                      <FullName>?</FullName>
 +
                                      <!--FullName - название тарифа, который принадлежит семейству тарифов, у сегмента-->
 +
                                    </FareFamilies>
 +
                                </Tariff>
 
                               </Tariffs>
 
                               </Tariffs>
 
                               <FareCalc>?</FareCalc>
 
                               <FareCalc>?</FareCalc>
Строка 291: Строка 297:
  
 
В ссылках на просмотр страницы результата поиска и на бронирование конкретного перелета, домен агентства/субагентства определяется следующим образом:
 
В ссылках на просмотр страницы результата поиска и на бронирование конкретного перелета, домен агентства/субагентства определяется следующим образом:
* Если текущий домен агентства/субагентства есть в настройках ('''Администрирование''' ⇨ '''Настройки агентства''' ⇨ '''Доменное имя сайта для загрузки настроек'''), то этот домен используется в ссылках.
+
* Если текущий домен агентства/субагентства есть в настройках ('''Управление сайтом''' ⇨ '''Домены и протоколы''' ⇨ '''Доменное имя сайта для загрузки настроек'''), то этот домен используется в ссылках.
 
* Если текущего домена нет в настройках, то используется первый домен из настроек.
 
* Если текущего домена нет в настройках, то используется первый домен из настроек.
 
* Если в настройках не прописано ни одного домена, то используется текущий домен.
 
* Если в настройках не прописано ни одного домена, то используется текущий домен.
Строка 321: Строка 327:
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
<syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
 
<syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://www.nemo.dev:8080/nemoflights/?version%3D1.0%26for%3DSearchFlights">
+
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://CLIEN_DOMAIN/nemoflights/?version%3D1.0%26for%3DSearchFlights">
 
   <soapenv:Header/>
 
   <soapenv:Header/>
 
   <soapenv:Body>
 
   <soapenv:Body>
Строка 602: Строка 608:
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
<syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
 
<syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://trunk.mlsd.ru/nemoflights/?version%3D1.0%26for%3DSearchFlights" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://CLIEN_DOMAIN/nemoflights/?version%3D1.0%26for%3DSearchFlights" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 
     <SOAP-ENV:Body>
 
     <SOAP-ENV:Body>
 
       <ns1:searchResponse>
 
       <ns1:searchResponse>
Строка 608: Строка 614:
 
             <Response>
 
             <Response>
 
               <SearchFlights>
 
               <SearchFlights>
                   <Flights SearchId="221983" ResultURL="http%3A%2F%2Fdima.nemo.dev%3A8080%2F%3Fgo%3Dsearch%2Fview_results%26uid%3D221983">
+
                   <Flights SearchId="221983" ResultURL="http%3A%2F%2FCLIEN_DOMAIN%2F%3Fgo%3Dsearch%2Fview_results%26uid%3D221983">
 
                     <Flight FlightId="1387400001" Nemo2FlightId="142939437030005">
 
                     <Flight FlightId="1387400001" Nemo2FlightId="142939437030005">
 
                         <WebService>SABRE</WebService>
 
                         <WebService>SABRE</WebService>

Текущая версия на 16:10, 8 октября 2020

Подключение

Это сервис внутри Nemo, который позволяет получить результаты поиска.

Для подключения к веб-службе поиска авиабилетов необходимо открыть доступ нужному пользователю. Это можно сделать в разделе «Настройки системы»«Интеграция»«Nemo (SOAP API)».

После добавления пользователя, ему будут присвоены Номер (ClientId) и API ключ клиента, которые нужно использовать для подключения.

WSDL находится по адресу: http://CLIENT_DOMAIN/nemoflights/wsdl.php?for=SearchFlights

Общий формат запроса / ответа поиска

развернуть

Запрос

развернуть

Ответ

В ссылках на просмотр страницы результата поиска и на бронирование конкретного перелета, домен агентства/субагентства определяется следующим образом:

  • Если текущий домен агентства/субагентства есть в настройках (Управление сайтомДомены и протоколыДоменное имя сайта для загрузки настроек), то этот домен используется в ссылках.
  • Если текущего домена нет в настройках, то используется первый домен из настроек.
  • Если в настройках не прописано ни одного домена, то используется текущий домен.

На поиск действуют ограничения заданные в настройках агентства, в частности ограничения по пассажирам и ограничение ближайшей разрешенной даты поиска билетов.

  • Если дата поиска меньше ближайшей разрешенной даты для поиска билетов, то выводится сообщение об ошибке Invalid search param: Неверная дата вылета: слишком близкая
  • Если количество взрослых пассажиров превышает допустимое ограничение - Invalid search param: Слишком много взрослых
  • Если количество детей в поисковом запросе превышает допустимое ограничение - Invalid search param: Слишком много детей
  • Если количество младенцев в поисковом запросе превышает допустимое ограничение - Invalid search param: Слишком много инфантов
  • Если количество младенцев с местом в поисковом запросе превышает допустимое ограничение - Invalid search param: Слишком много инфантов

Примечание:

Если в запросе поиска указать PriceRefundType = “Both”, то для всех ГРС кроме Sabre будет отправляться 2 запроса. Если количество доп. цен в БФМ запросе в Сейбре больше 10, то и в нем будет 2 запроса. Количество доп. цен в запросе зависит от:

  • Настроек прайсинга по альтернативным J типам в пакете реквизитов;
  • Количества запрошенных классов перелетов;
  • Количества запрошенных типов пассажиров;
  • Настройки "Дополнительно запросить только публичные тарифы" в применявшемся правила маршрутизатора.

Примеры использования

Односторонний перелет

Пример одностороннего перелета: Москва — Санкт-Петербург, 1 взрослый, эконом класс, предпочитаемая авиакомпания — ЮТэйр.

развернуть

Запрос

развернуть

Ответ

Перелет туда-обратно

Пример перелета туда-обратно: Москва — Париж, 2 взрослых, бизнес класс. Выдача с именами авиакомпаний, воздушных судов, аэропортов.

развернуть

Запрос

развернуть

Ответ

Сложный маршрут

Пример сложного маршрута: Прага — Москва — Милан — Мадрид, 1 взрослый, 1 младенец, эконом класс. Выдача с именами авиакомпаний, воздушных судов, аэропортов.

развернуть

Запрос

развернуть

Ответ

См. также