Агентский API Авиабилеты: различия между версиями

Материал из Центр поддержки системы бронировании
Перейти к навигации Перейти к поиску
(→‎Агентский АПИ выписки)
(→‎Схема использования агентского API (workflow))
 
(не показаны 132 промежуточные версии 16 участников)
Строка 1: Строка 1:
 +
{{Attention|В системе реализован усовершенствованный API-проект «Nemo Connect», настоятельно рекомендуем подключаться по схеме, описанной в документации по [http://docs.nemo.travel/ ссылке]}}
 +
== Схема использования агентского API (workflow) ==
 +
 
[[Категория:Интеграция]]
 
[[Категория:Интеграция]]
 +
[[Категория:Агентский API]]
 +
[[Категория:Модули]]
 +
[[Категория:Встроенные модули]]
 +
Для авторизации в системе, в запросе необходимо указать APIKey и ClientID. Эти данные можно узнать в разделе Администрирование - Веб-сервис. Авторизация. Там же можно включить/выключить нотификацию для действий, совершенных через АПИ.
 +
 +
Необходимо придерживаться [[Схема использования агентского API (workflow) | рекомендованной схемы использования API]]. Если вы планируете отступать от этой схемы - пожалуйста, согласуйте отклонения от нее со службой технической поддержки.
 +
 +
{{Attention| Пользователь и агентство из Немо Тревел 2.0 и Немо Тревел 1.0 должны соответствовать друг другу. }}
 +
 +
== Агентский АПИ поиска авиабилетов ==
 +
 +
*[[Веб-служба поиска авиабилетов]]
 +
** [[Веб-служба поиска авиабилетов#Подключение|Подключение]]
 +
** [[Веб-служба поиска авиабилетов#Общий формат запроса / ответа поиска|Общий формат запроса / ответа поиска]]
 +
** [[Веб-служба поиска авиабилетов#Примеры использования|Примеры использования]]
 +
 +
== Агентский АПИ бронирования авиабилетов ==
 +
 +
*[[Веб-служба бронирования]]
 +
** [[Веб-служба бронирования#Подключение|Подключение]]
 +
** [[Веб-служба бронирования#Общий формат запроса / ответа бронирования|Общий формат запроса / ответа бронирования]]
 +
** [[Веб-служба бронирования#Пример использования|Пример использования]]
 +
** [[Веб-служба бронирования#Общий формат запроса / ответа отмены бронирования|Общий формат запроса / ответа отмены бронирования]]
 +
 +
== Агентский АПИ выписки ==
 +
 +
*[[Веб-служба выписки]]
 +
** [[Веб-служба выписки#Информация|Информация]]
 +
** [[Веб-служба выписки#Общий формат запроса / ответа выписки|Общий формат запроса / ответа выписки]]
 +
** [[Веб-служба выписки#Общий формат запроса / ответа войдирования|Общий формат запроса / ответа войдирования]]
 +
 +
== Агентский АПИ Оплаты==
 +
 +
*[[Агентский API Оплата]]
 +
** [[Агентский API Оплата#Фиксация оплаты внешним запросом|Фиксация оплаты внешним запросом]]
 +
** [[Агентский API Оплата#Получение списка доступных способов оплаты|Получение списка доступных способов оплаты]]
 +
** [[Агентский API Оплата#Выбор конкретного способа оплаты|Выбор конкретного способа оплаты]]
 +
 +
== Агентский АПИ возврата авиабилетов ==
 +
 +
*[[Веб-служба возврата билетов]]
 +
** [[Веб-служба возврата билетов#Информация|Информация]]
 +
** [[Веб-служба возврата билетов#Общий формат запроса / ответа получения информации по возврату|Общий формат запроса / ответа получения информации по возврату]]
 +
** [[Веб-служба возврата билетов#Общий формат запроса / ответа возврата билетов|Общий формат запроса / ответа возврата билетов]]
 +
 +
== Агентский АПИ дополнительных запросов ==
 +
 +
*[[Дополнительные запросы АПИ авиабилетов]]
 +
**[[Дополнительные запросы АПИ авиабилетов#Проверка на доступность|Проверка на доступность]]
 +
**[[Дополнительные запросы АПИ авиабилетов#Получение документа|Получение документа]]
 +
**[[Дополнительные запросы АПИ авиабилетов#Создание отложенного заказа в системе Nemo|Создание отложенного заказа в системе Nemo]]
 +
**[[Дополнительные запросы АПИ авиабилетов#Запрос на обновление заказа|Запрос на обновление заказа]]
 +
**[[Дополнительные запросы АПИ авиабилетов#Запрос на модификацию заказа|Запрос на модификацию заказа]]
 +
**[[Дополнительные запросы АПИ авиабилетов#Чтение тарифных правил|Чтение тарифных правил]]
 +
**[[Дополнительные запросы АПИ авиабилетов#Запрос на чтение очереди|Запрос на чтение очереди]]
 +
**[[Дополнительные запросы АПИ авиабилетов#Запрос на удаление заказа из очереди|Запрос на удаление заказа из очереди]]
 +
**[[Дополнительные запросы АПИ авиабилетов#Запрос на получение семейств тарифов для перелета|Запрос на получение семейств тарифов для перелета]]
 +
**[[Дополнительные запросы АПИ авиабилетов#Запрос на импорт заказа|Запрос на импорт заказа]]
 +
**[[Дополнительные запросы АПИ авиабилетов#Запрос на получение изменившихся заказов|Запрос на получение изменившихся заказов]]
 +
 +
== Дополнительная информация по параметрам ==
 +
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
 +
==== Параметры, используемые в запросах ====
 +
<div class="mw-collapsible-content">
 +
<table border="1">
 +
<tr bgcolor="#CCCCCC">
 +
<th> Имя элемента </th><th> Обязательный      </th><th> Тип  </th><th>    Описание  </th>
 +
</tr>
 +
<tr>
 +
 +
<td>BookFlight </td><td>да </td><td>сложный </td><td>Контейнер для тела запроса бронирования</td>
 +
</tr>
 +
<tr>
 +
<td>FlightId </td><td class="col1">да </td><td>число</td><td >Id перелёта для которого будет производится бронирование(поиск тарифных правил, проверка доступности)</td>
 +
</tr>
 +
<tr>
 +
<td>CurrencyCode </td><td>нет</td><td>строка</td><td>Трёх буквенный код валюты (обязателен для комиссии в валюте)</td>
 +
 +
</tr>
 +
<tr>
 +
<td>Agency </td><td>да </td><td>сложный </td><td>Информация об агентстве</td>
 +
 +
</tr>
 +
<tr>
 +
<td>Name </td><td>да </td><td>строка </td><td>Название агентства</td>
 +
</tr>
 +
<tr>
 +
<td>Telephone </td><td>нет </td><td>сложный </td><td>Контактный телефон агентства</td>
 +
 +
</tr>
 +
<tr>
 +
<td>Type</td><td>да </td><td>строка </td><td>Тип номера, возможные значения: M - мобильный, H - домашний, B - рабочий, A - агентство</td>
 +
</tr>
 +
<tr>
 +
<td>PhoneNumber </td><td>да </td><td>строка </td><td>Номер телефона</td>
 +
 +
</tr>
 +
<tr>
 +
<td>CountryAccessCode </td><td>нет </td><td>строка </td><td>Код страны</td>
 +
</tr>
 +
<tr>
 +
<td>AreaCityCode </td><td>нет </td><td>строка</td><td>Код региона/города</td>
 +
 +
</tr>
 +
<tr>
 +
<td>Address</td><td>да </td><td>сложный </td><td class="col3">Адрес агентства</td>
 +
</tr>
 +
<tr>
 +
<td>City</td><td>да </td><td class="col2">строка </td><td>Город, в котором расположено агентство</td>
 +
 +
</tr>
 +
<tr>
 +
<td>StreetAddress </td><td>нет </td><td>сложный </td><td>Адрес агентства в городе (улица, дом, корпус, офис и т.д.)</td>
 +
</tr>
 +
<tr>
 +
<td>PostalCode </td><td>нет </td><td>строка </td><td>Почтовый код, индекс.</td>
 +
 +
</tr>
 +
<tr>
 +
<td>CountryCode </td><td>нет </td><td>строка </td><td>Код страны (RU, UA, US и т.д.)</td>
 +
</tr>
 +
<tr>
 +
<td>Travellers </td><td>да </td><td>сложный </td><td>Контейнер для информации о пассажирах (для которых будет производится поиск перелёта, бронирование)</td>
 +
 +
</tr>
 +
<tr>
 +
<td class="col0">Traveller </td><td class="col1">да </td><td class="col2">сложный </td><td class="col3">Информация о пассажире</td>
 +
</tr>
 +
<tr class="row24">
 +
<td>Type</td><td>да</td><td>строка</td><td>Тип пассажира возможные значения: ADT - взрослые, CNN - дети, UNN - дети без сопровождения взрослых, INF - младенцы, INS - младенцы с местом</td>
 +
 +
</tr>
 +
<tr class="row25">
 +
<td class="col0">IsContact </td><td class="col1">нет</td><td class="col2">булевский </td><td class="col3">Индикатор показывающий является ли данное лицо контактным, возможные значение: true - пассажир является контактным лицом, false - не является. Контактное лицо может быть только одно, если среди пассажиров есть взрослые, то только кто-то из них может быть контактным лицом. Если не указано, то по умолчанию false.</td>
 +
</tr>
 +
<tr class="row26">
 +
<td class="col0">LinkedTo </td><td class="col1">нет </td><td class="col2">целое число </td><td class="col3">Номер взрослого, к которому привязан младенец/ребёнок (привязка ребёнка ко взрослому является опциональной)</td>
 +
 +
</tr>
 +
<tr class="row27">
 +
<td class="col0">Num </td><td class="col1">да </td><td class="col2">число </td><td class="col3">Номер пассажира.</td>
 +
</tr>
 +
<tr class="row28">
 +
<td class="col0">PreferedPlace </td><td class="col1">нет </td><td class="col2">сложный </td><td class="col3">Информация о предпочитаемом месте. Если указаны номер ряда и номер места, то параметры Smoking и Location игнорируются и могут быть не указаны.</td>
 +
 +
</tr>
 +
<tr class="row29">
 +
<td class="col0">SmokingAllowed </td><td class="col1">нет </td><td class="col2">булевский </td><td class="col3">true - место для курящих, false - место для некурящих. По умолчанию false.</td>
 +
</tr>
 +
<tr class="row30">
 +
<td class="col0">Location </td><td class="col1">нет </td><td class="col2">строка </td><td class="col3">Расположение места, возможные значения: W - у окна (Window); M - где-то в середине ряда (Middle); NPW - возле прохода (NearPassengerWay); NS - нет предпочтения (NotSpecified).</td>
 +
</tr>
 +
<tr class="row31">
 +
<td class="col0">RowNumber</td><td class="col1">нет</td><td class="col2">строка </td><td class="col3">Номер ряда</td>
 +
</tr>
 +
<tr class="row32">
 +
<td class="col0">PlaceNumber </td><td class="col1">нет </td><td class="col2">строка </td><td class="col3">Номер места</td>
 +
 +
</tr>
 +
<tr class="row33">
 +
<td class="col0">SegNumber </td><td class="col1">да </td><td class="col2">строка </td><td class="col3">Номер сегмента</td>
 +
</tr>
 +
<tr class="row34">
 +
<td class="col0">DocumentInfo </td><td class="col1">да </td><td class="col2">сложный </td><td class="col3">Паспортные данные</td>
 +
 +
</tr>
 +
<tr class="row35">
 +
<td class="col0">DocType </td><td class="col1">да </td><td class="col2">строка </td><td class="col3">Тип документа, обязательный.</td>
 +
</tr>
 +
<tr class="row36">
 +
<td class="col0">DocNum </td><td class="col1">да </td><td class="col2">строка </td><td class="col3">Номер документа</td>
 +
</tr>
 +
<tr class="row37">
 +
<td class="col0">CountryCode </td><td class="col1">да </td><td class="col2">строка </td><td class="col3">Страна выдачи, двух буквенный код(RU, US и т.д.)</td>
 +
</tr>
 +
<tr class="row38">
 +
<td class="col0">DocElapsedTime</td><td class="col1">да </td><td class="col2">строка </td><td class="col3">Срок истечения срока действия паспорта в фирмате dd.mm.yyyy (например 31.12.2012)</td>
 +
 +
</tr>
 +
<tr class="row39">
 +
<td class="col0">VisaInfo </td><td class="col1">нет </td><td class="col2">сложный </td><td class="col3">Информация о визе</td>
 +
</tr>
 +
<tr class="row40">
 +
<td class="col0">Num </td><td class="col1">да </td><td class="col2">строка </td><td class="col3">Номер визы</td>
 +
 +
</tr>
 +
<tr class="row41">
 +
<td class="col0">IssueDate </td><td class="col1">да </td><td class="col2">строка </td><td class="col3">Дата выдачи визы в формате dd.mm.yyyy</td>
 +
</tr>
 +
<tr class="row42">
 +
<td class="col0">IssueCountry </td><td class="col1">да </td><td class="col2">строка </td><td class="col3">Страна выдачи визы</td>
 +
 +
</tr>
 +
<tr class="row43">
 +
<td class="col0">IssuePlace </td><td class="col1">да </td><td class="col2">строка </td><td class="col3">Место выдачи визы</td>
 +
</tr>
 +
<tr class="row44">
 +
<td class="col0">BirthCountry </td><td class="col1">нет </td><td class="col2">строка </td><td class="col3">Страна рождения (IATA код страны)</td>
 +
 +
</tr>
 +
<tr class="row45">
 +
<td class="col0">BirthCity </td><td class="col1">нет</td><td class="col2">строка</td><td class="col3">Город рождения (название)</td>
 +
</tr>
 +
<tr class="row46">
 +
<td class="col0">ArrAddress </td><td class="col1">нет </td><td class="col2">сложный </td><td class="col3">Адрес прибытия, для въезжающих в США (не граждан США) информация является обязательной. Если она не заполняется при оформлении брони, то её всё равно придётся заполнять при посадке на самолёт.</td>
 +
 +
</tr>
 +
<tr class="row47">
 +
<td class="col0">CountryCode </td><td class="col1">да </td><td class="col2">строка </td><td class="col3">IATA код страны</td>
 +
</tr>
 +
<tr class="row48">
 +
<td class="col0">State </td><td class="col1">да </td><td class="col2">строка </td><td class="col3">Штат или область въезда</td>
 +
 +
</tr>
 +
<tr class="row49">
 +
<td class="col0">PostalCode </td><td class="col1">да </td><td class="col2">строка </td><td class="col3">Почтовый код</td>
 +
</tr>
 +
<tr class="row50">
 +
<td class="col0">City </td><td class="col1">да </td><td class="col2">строка </td><td class="col3">Город</td>
 +
 +
</tr>
 +
<tr class="row51">
 +
<td class="col0">StreetAddress </td><td class="col1">да </td><td class="col2">строка </td><td class="col3">Адрес: улица, номер дома, квартиры и тп</td>
 +
</tr>
 +
<tr class="row52">
 +
<td class="col0">DocStringFormats </td><td class="col1">нет </td><td class="col2">сложный </td><td class="col3">Список форматов строк паспортных данных, которые будут отправлены в дополнение к стандартным.</td>
 +
 +
</tr>
 +
<tr class="row53">
 +
<td class="col0">DocStringFormat </td><td class="col1">да </td><td class="col2">строка </td><td class="col3">Формат данных, возможные значения: DOCS - строка формата DOCS, FOID - строка формата FOID. Установка данных в формате DOCS как правило необходима для последующей выписки в BSP среде. Установка FOID - всреде ТКП.</td>
 +
</tr>
 +
<tr class="row54">
 +
<td class="col0">PersonalInfo </td><td class="col1">да </td><td class="col2">сложный </td><td class="col3">Персональные данные пассажира</td>
 +
</tr>
 +
<tr class="row55">
 +
<td class="col0">DateOfBirth</td><td class="col1">да </td><td class="col2">строка </td><td class="col3">Дата рождения в формате dd.mm.yyyy (например 31.12.2000)</td>
 +
</tr>
 +
<tr class="row56">
 +
<td class="col0">Nationality </td><td class="col1">да </td><td class="col2">строка </td><td class="col3">Национальность/гражданство, двух буквенный код страны (RU, UA, US и т.д.)</td>
 +
 +
</tr>
 +
<tr class="row57">
 +
<td class="col0">Gender </td><td class="col1">да </td><td class="col2">строка </td><td class="col3">Пол пассажира, обязательный, возможные значения: M - мужской(Male); F - женский(Female).</td>
 +
</tr>
 +
<tr class="row58">
 +
<td class="col0">FirstName </td><td class="col1">да </td><td class="col2">строка </td><td class="col3">Имя пассажира</td>
 +
 +
</tr>
 +
<tr class="row59">
 +
<td class="col0">LastName </td><td class="col1">да </td><td class="col2">строка </td><td class="col3">Фамилия пассажира</td>
 +
</tr>
 +
<tr class="row60">
 +
<td class="col0">BMiddleName </td><td class="col1">да </td><td class="col2">строка </td><td class="col3">Отчество пассажира</td>
 +
</tr>
 +
<tr class="row61">
 +
<td class="col0">Meal </td><td class="col1">нет</td><td class="col2">строка </td><td class="col3">Код типа питания, возможные значения: NONE - отсутствует (по умолчанию); AVML - Азиатская вегетарианская кухня; BLML - Блюда щадящей диеты; CHML - Детское питание; CHPC - Детский холодный завтрак; СНСС - Детский горячий завтрак; CHHC - Детский ланч, ветчина и сыр; PBJS - Детский ланч, ореховое масло; CHMC - Детский обед макароны с сыром; DBML - Диабетическое питание; FPML - Фрукты; GFML - Питание без клейковины; HFML - Питание богатое клетчаткой; HNML - Индусская кухня; BBML - Питание для младенцев; KSML - Кошерная кухня; SMKB - Кошерный завтрак; SMKL - Кошерный ланч; SMKD - Кошерный обед; LPML - Малобелковое питание; LCML - Низкокалорийное питание; LFML - Низкохолестериновое питание; PRML - Низкопуриновое питание; LSML - Малосоленое питание; MOML - Мюсли; NLML - Безмолочные продукты; ORML - Восточная кухня; RVML - Сырые овощи; SFML - Морепродукты; SPML - Особое питание; VLML - Вегетарианское, молоко и яйца; VGML - Строго вегетарианское питание; VJML - Джайнизское вегетарианское; VOML - Восточное вегетарианское питание.</td>
 +
</tr>
 +
<tr class="row62">
 +
<td class="col0">LoyaltyCard </td><td class="col1">нет </td><td class="col2">сложный </td><td class="col3">Карточка часто летающего пассажира</td>
 +
 +
</tr>
 +
<tr class="row63">
 +
<td class="col0">OpCode </td><td class="col1">да </td><td class="col2">строка </td><td class="col3">IATA код компании авиаперевозчика</td>
 +
</tr>
 +
<tr class="row64">
 +
<td class="col0">Number </td><td class="col1">да </td><td class="col2">строка </td><td class="col3">Номер карточки</td>
 +
</tr>
 +
<tr class="row65">
 +
<td class="col0">ContactInfo</td><td class="col1">нет </td><td class="col2">сложный </td><td class="col3">Контактная информация для пассажира</td>
 +
</tr>
 +
<tr class="row66">
 +
<td class="col0">EmailID </td><td class="col1">нет </td><td class="col2">строка </td><td class="col3">Контактный email</td>
 +
 +
</tr>
 +
<tr class="row67">
 +
<td class="col0">Telephone </td><td class="col1">нет </td><td class="col2">сложный </td><td class="col3">Контактный телефон пассажира, описание аналогично описанию телефона агентства</td>
 +
</tr>
 +
<tr class="row68">
 +
<td class="col0">CancelBook</td><td class="col1">да</td><td class="col2">сложный</td><td class="col3">Контейнер для тела запроса отмены брони</td>
 +
</tr>
 +
<tr class="row69">
 +
<td class="col0">BookID</td><td class="col1">да</td><td class="col2">число</td><td class="col3">Номер брони, которая будет отменяться (для которой будет производится выписка, отмена выписки)</td>
 +
 +
</tr>
 +
<tr class="row70">
 +
<td class="col0">GetAirRules</td><td class="col1">да</td><td class="col2">сложный</td><td class="col3">Контейнер для тела запроса поиска тарифных правил</td>
 +
</tr>
 +
<tr class="row71">
 +
<td class="col0">AirAvail</td><td class="col1">да</td><td class="col2">сложный</td><td class="col3">Контейнер для тела запроса проверки доступности перелёта</td>
 +
 +
</tr>
 +
<tr class="row72">
 +
<td class="col0">Ticketing</td><td class="col1">да</td><td class="col2">сложный</td><td class="col3">Контейнер для тела запроса выписки брони</td>
 +
</tr>
 +
<tr class="row73">
 +
<td class="col0">ValCompany</td><td class="col1">нет</td><td class="col2">строка</td><td class="col3">Валидирующий перевозчик, на бланке которого выписывается билет</td>
 +
 +
</tr>
 +
<tr class="row74">
 +
<td class="col0">Comission</td><td class="col1">нет</td><td class="col2">сложный</td><td class="col3">Комиссия</td>
 +
</tr>
 +
<tr class="row75">
 +
<td class="col0">Amount</td><td class="col1">нет</td><td class="col2">число с плавающей точкой</td><td class="col3">Значение комиссии в валюте, если указано, то комиссия в процентах игнорируется</td>
 +
 +
</tr>
 +
<tr class="row76">
 +
<td class="col0">Percent</td><td class="col1">нет</td><td class="col2">число</td><td class="col3">Комиссия в процентах</td>
 +
</tr>
 +
<tr class="row77">
 +
<td class="col0">VoidTicket</td><td class="col1">да</td><td class="col2">сложный</td><td class="col3">Контейнер для тела запроса отмены выписки брони</td>
 +
 +
</tr>
 +
<tr class="row78">
 +
<td class="col0">Search</td><td class="col1">да</td><td class="col2">сложный</td><td class="col3">Контейнер для тела запроса поиска</td>
 +
</tr>
 +
<tr class="row79">
 +
<td class="col0">ODPairs</td><td class="col1">да</td><td class="col2">сложный</td><td class="col3">Контейнер для информации о перелёте</td>
 +
 +
</tr>
 +
<tr class="row80">
 +
<td class="col0">Type</td><td class="col1">да</td><td class="col2">строка</td><td class="col3">Тип перелёта, возможные значения: OW - в одну сторону, RT - туда-обратно, CR - сложный маршрут</td>
 +
</tr>
 +
<tr class="row81">
 +
<td class="col0">Direct</td><td class="col1">нет</td><td class="col2">булевский</td><td class="col3">Индикатор, указывающий какие перелёты искать, только прямые или с пересадками, возможные значения: false - с пересадками, true - только прямые. Если не указан, значение по умолчанию false.</td>
 +
</tr>
 +
<tr class="row82">
 +
<td class="col0">AroundDates</td><td class="col1">нет</td><td class="col2">число</td><td class="col3">Включает поиск по окружным датам, количество дней +/- от даты заезда/возвращения. Применим только для типов перелёта в одну сторону(OW) и туда-обратно(RT). Возможные значения: 0, 1, 2, 3</td>
 +
</tr>
 +
<tr class="row83">
 +
<td class="col0">ODPair</td><td class="col1">да</td><td class="col2">сложный</td><td class="col3">Контейнер для информации о сегменте перелёта. Может повторяться 1-6 раз. Поиск по расписанию использует только первый сегмент, поиск сложных перелётов и перелётов туда и обратно не поддерживается</td>
 +
 +
</tr>
 +
<tr class="row84">
 +
<td class="col0">DepDate</td><td class="col1">да</td><td class="col2">строка</td><td class="col3">Дата вылета, Формат ГГГГ-MM-DDTЧЧ:ММ:СС</td>
 +
</tr>
 +
<tr class="row85">
 +
<td class="col0">DepAirp</td><td class="col1">да</td><td class="col2">строка</td><td class="col3">Трёх буквенный код города отправления или конкретного аэропорта в городе отправления.</td>
 +
 +
</tr>
 +
<tr class="row86">
 +
<td class="col0">ArrAirp</td><td class="col1">да</td><td class="col2">строка</td><td class="col3">Трёх буквенный код города прибытия или конкретного аэропорта в городе прибытия.</td>
 +
</tr>
 +
<tr class="row87">
 +
<td class="col0">Count</td><td class="col1">да</td><td class="col2">число</td><td class="col3">Число пассажиров данного типа. Общее количество пассажиров всех типов должно быть не более 9.</td>
 +
 +
</tr>
 +
<tr class="row88">
 +
<td class="col0">Restrictions</td><td class="col1">нет</td><td class="col2">сложный</td><td class="col3">Контейнер дополнительной информации для поиска.</td>
 +
</tr>
 +
<tr class="row89">
 +
<td class="col0">ClassPref</td><td class="col1">нет</td><td class="col2">строка</td><td class="col3">Предпочитаемый класс перелёта, возможные значения: All - все, Economy - эконом, Business - бизнес, First - первый. Если не указан, то по умолчанию All.</td>
 +
 +
</tr>
 +
<tr class="row90">
 +
<td class="col0">OnlyAvail</td><td class="col1">нет</td><td class="col2">булевский</td><td class="col3">Искать только доступные, возможные значения: true - только доступные, false - все. Если не указан, то по умолчанию false.</td>
 +
</tr>
 +
<tr class="row91">
 +
<td class="col0">AirVPrefs</td><td class="col1">нет</td><td class="col2">сложный</td><td class="col3">Обёртка для списка авиакомпаний, по которым будет или не будет проводиться поиск.</td>
 +
 +
</tr>
 +
<tr class="row92">
 +
<td class="col0">AirVPref</td><td class="col1">да</td><td class="col2">сложный</td><td class="col3">Информация об авиакомпании.</td>
 +
</tr>
 +
<tr class="row93">
 +
<td class="col0">Include</td><td class="col1">нет</td><td class="col2">булевский</td><td class="col3">Индикатор, показывающий включить или исключить в результатах поиска перелёты данной авиакомпании: true - включить, false - исключить. Если не указан, то по умолчанию false.</td>
 +
 +
</tr>
 +
<tr class="row94">
 +
<td class="col0">IncludePrivateFare</td><td class="col1">нет</td><td class="col2">булевский</td><td class="col3">Включать приватные цены в результат или нет, возможные значения: true - включать, false - не включать. Если не указан, то по умолчанию false.</td>
 +
</tr>
 +
<tr class="row95">
 +
<td class="col0">ServiceTypes</td><td class="col1">нет</td><td class="col2">сложный хмл</td><td class="col3">Контейнер массива используемых веб-сервисов при поиске.</td>
 +
 +
</tr>
 +
<tr class="row96">
 +
<td class="col0">ServiceType</td><td class="col1">нет</td><td class="col2">строка</td><td class="col3">Тип веб-сервиса(поставщика). При указании нескольких элементов ServiceType поиск будет проведён для каждого сервиса. Возможные значения: Sirena2000 - поиск в Сирене; SirenaSchedule - поиск в Сирене по расписанию; SabreLFS - поиск в Сэйбр LFS; SabreBFM - поиск в Сэйбр BFM; SabreSchedule - поиск Сэйбр по расписанию; Galileo - поиск в Галилео; AmadeusMPTBS - поиск в Амадеус.</td>
 +
</tr>
 +
<tr class="row97">
 +
<td class="col0">DataItems</td><td class="col1">нет</td><td class="col2">сложный</td><td class="col3">Уницифированный блок данных для хранения различного контента брони.</td>
 +
</tr>
 +
<tr class="row98">
 +
<td class="col0">DataItem</td><td class="col1">нет</td><td class="col2">сложный</td><td class="col3">Контейнер для определенного типа передаваемой с запросом выписки информации.</td>
 +
</tr>
 +
<tr class="row99">
 +
<td class="col0">Remark</td><td class="col1">нет</td><td class="col2">сложный</td><td class="col3">Контейнер для записи ремарок.</td>
 +
</tr>
 +
<tr class="row100">
 +
<td class="col0">Type</td><td class="col1">нет</td><td class="col2">строка</td><td class="col3">Тип ремарки. Может принимать значения: General, Itinerary, Invoice, Historical, QueueControl, Vendor, NemoInternal, Confidential, MiniItinerary.</td>
 +
</tr>
 +
<tr class="row101">
 +
<td class="col0">Text</td><td class="col1">нет</td><td class="col2">строка</td><td class="col3">Содержание ремаркаи.</td>
 +
</tr>
 +
</table>
 +
</div>
 +
</div>
 +
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
 +
 +
==== Параметры, используемые в ответах ====
 +
<div class="mw-collapsible-content">
 +
<table border="1">
 +
 +
<tr bgcolor="#CCCCCC">
 +
<th class="col0 leftalign"> Имя элемента      </th><th class="col1 leftalign"> Обязательный      </th><th class="col2 leftalign"> Тип  </th><th class="col3 centeralign">    Описание  </th>
 +
</tr>
 +
<tr class="row1">
 +
<td class="col0">BookFlightResult </td><td class="col1">да </td><td class="col2">сложный </td><td class="col3">Контейнер для тела ответа бронирования</td>
 +
 +
</tr>
 +
<tr class="row2">
 +
<td class="col0">ID </td><td class="col1">да </td><td class="col2">число</td><td class="col3">Номер бронирования в системе Nemo.</td>
 +
</tr>
 +
<tr class="row3">
 +
<td class="col0 leftalign">Status  </td><td class="col1">да </td><td class="col2">строка </td><td class="col3">Статус брони, возможные значения: booked - забронировано, canceled - бронь отменена, ticket - выписана; UNDEFINED - статус не определён.</td>
 +
 +
</tr>
 +
<tr class="row4">
 +
<td class="col0">Code </td><td class="col1">да </td><td class="col2">строка </td><td class="col3">Номер бронирования в системе поставщика (в sabre, sirena и т.д.)/код тарифного правила</td>
 +
</tr>
 +
<tr class="row5">
 +
<td class="col0">QueryPlace </td><td class="col1">нет </td><td class="col2">сложный </td><td class="col3">Очередь, в которую помещено бронирование</td>
 +
 +
</tr>
 +
<tr class="row6">
 +
<td class="col0 leftalign">Number  </td><td class="col1">да </td><td class="col2">число </td><td class="col3">Номер очереди</td>
 +
</tr>
 +
<tr class="row7">
 +
<td class="col0">Flight </td><td class="col1">да </td><td class="col2">сложный </td><td class="col3">Перелёт, по которому была сделана бронь (Результаты проверки доступности для перелёта)</td>
 +
 +
</tr>
 +
<tr class="row8">
 +
<td class="col0">Agency </td><td class="col1">да </td><td class="col2">сложный </td><td class="col3">Информация об агентстве</td>
 +
</tr>
 +
<tr class="row9">
 +
<td class="col0">ItinReceipts</td><td class="col1">нет </td><td class="col2">сложный </td><td class="col3">Маршрут квитанция. Содержит строку в кодировки Encoding  (как правило в base64), представляющую маршрут квитанцию в формате Format.</td>
 +
 +
</tr>
 +
<tr class="row10">
 +
<td class="col0">Encoding </td><td class="col1">да </td><td class="col2">строка </td><td class="col3">Кодировка</td>
 +
</tr>
 +
<tr class="row11">
 +
<td class="col0">Format </td><td class="col1">да </td><td class="col2">строка</td><td class="col3">Формат</td>
 +
 +
</tr>
 +
<tr class="row12">
 +
<td class="col0">Travellers</td><td class="col1">да </td><td class="col2">сложный </td><td class="col3">Контейнер для информации о пассажирах</td>
 +
</tr>
 +
<tr class="row13">
 +
<td class="col0">Traveller </td><td class="col1">да </td><td class="col2">сложный </td><td class="col3">Информация о пассажире</td>
 +
 +
</tr>
 +
<tr class="row14">
 +
<td class="col0">Ticket </td><td class="col1">нет </td><td class="col2">сложный </td><td class="col3">Билет пассажира.</td>
 +
</tr>
 +
<tr class="row15">
 +
<td class="col0">TickectNum </td><td class="col1">да </td><td class="col2">строка </td><td class="col3">Номер билета</td>
 +
 +
</tr>
 +
<tr class="row16">
 +
<td class="col0">Seats</td><td class="col1">нет </td><td class="col2">сложный </td><td class="col3">Контейнер мест пассажира.</td>
 +
</tr>
 +
<tr class="row17">
 +
<td class="col0">Seat </td><td class="col1">да </td><td class="col2">сложный </td><td class="col3">Место в самолёте</td>
 +
 +
</tr>
 +
<tr class="row18">
 +
<td class="col0">Number </td><td class="col1">да </td><td class="col2">строка</td><td class="col3">Номер места(ряд+номер в ряду)</td>
 +
</tr>
 +
<tr class="row19">
 +
<td class="col0">Characteristic </td><td class="col1">нет</td><td class="col2">строка </td><td class="col3">Характеристика места в соответствии со стандартом EDIFACT. См справочник “Таблица характеристик мест”.</td>
  
−
'''Агентский АПИ''' поиска позволяет отправить в систему Nemo запрос на получение выдачи от лица заранее определенного пользователя, которому разрешено подключаться через АПИ. Полученная в ответе выдача будет эквивалентной выдаче на сайте агентства для этого пользователя (т.е. с примененными правилами сборов, фильтрами выдачи и т.п.). АПИ возвращает также ссылку (deeplink, диплинк) на результаты поиска на сайте агентства.  
+
</tr>
 +
<tr class="row20">
 +
<td class="col0">SmokingPreference </td><td class="col1">нет </td><td class="col2">строка </td><td class="col3">Статус курения на этом месте, если Y - место для курящих, если N - место для некурящих.</td>
 +
</tr>
 +
<tr class="row21">
 +
<td class="col0">SegmentNumber </td><td class="col1">да </td><td class="col2">число </td><td class="col3">Номер сегмента</td>
  
−
Агентский АПИ поиска использует АПИ к ХАБу для осуществления всех запросов в [[ГРС]].
+
</tr>
 +
<tr class="row22">
 +
<td class="col0">PersonalInfo </td><td class="col1">да </td><td class="col2">сложный </td><td class="col3">Личные данные</td>
 +
</tr>
 +
<tr class="row23">
 +
<td class="col0">LoyaltyCard </td><td class="col1">нет </td><td class="col2">сложный </td><td class="col3">Карточка часто летающего пассажира</td>
  
−
См. Техническую спецификацию на Агентский АПИ в разделе, посвященном Вебслужбе поиска и бронирования авиабилетов ([[Агентский АПИ поиска авиабилетов]]).
+
</tr>
 +
<tr class="row24">
 +
<td class="col0">ContactInfo </td><td class="col1">нет </td><td class="col2">сложный </td><td class="col3">Контактная информация для пассажира</td>
 +
</tr>
 +
<tr class="row25">
 +
<td class="col0">FareStored </td><td class="col1">нет </td><td class="col2">срока: Yes/No </td><td class="col3">Указывает установлена ли / гарантируется ли цена у поставщика. Если параметр отсутствует в ответе, то по умолчанию значение “Yes”.</td>
  
 +
</tr>
 +
<tr class="row26">
 +
<td class="col0">CancelBookResult</td><td class="col1">да</td><td class="col2">сложный</td><td class="col3">Контейнер для тела ответа отмены брони</td>
 +
</tr>
 +
<tr class="row27">
 +
<td class="col0">BookID</td><td class="col1">да</td><td class="col2">число</td><td class="col3">Номер брони, которая отменялась (Номер выписанной брони, выписка которой отменялась)</td>
  
−
== Агентский АПИ бронирования ==
+
</tr>
 +
<tr class="row28">
 +
<td class="col0">Result</td><td class="col1">да</td><td class="col2">сложный</td><td class="col3">Результат отмены (войдирования)</td>
 +
</tr>
 +
<tr class="row29">
 +
<td class="col0">Success</td><td class="col1">да</td><td class="col2">булевский</td><td class="col3">Индикатор, показывающий успешно или нет прошла отмена, возможные значения: true - успешно отменена (войдирование); false - не отменена</td>
  
−
Позволяет произвести создание [[ПНР]] в [[ГРС]] так, как если бы это было сделано пользователем на сайте агентства. Бронь будет создана не только в [[ГРС]], но и в системе Nemo и будет доступна через интерфейс Личного Кабинета.
+
</tr>
 +
<tr class="row30">
 +
<td class="col0">GetAirRulesResult</td><td class="col1">да</td><td class="col2">сложный</td><td class="col3">Контейнер для тела ответа поиска тарифных правил</td>
 +
</tr>
 +
<tr class="row31">
 +
<td class="col0">FlightId</td><td class="col1">да</td><td class="col2">число</td><td class="col3">Номер перелёта, для которого найдены тарифные правила (будет проводилась проверка доступности)</td>
  
 +
</tr>
 +
<tr class="row32">
 +
<td class="col0">Rules</td><td class="col1">да</td><td class="col2">сложный</td><td class="col3">Контейнер для правил</td>
 +
</tr>
 +
<tr class="row33">
 +
<td class="col0">Rule</td><td class="col1">да</td><td class="col2">сложный</td><td class="col3">Правило</td>
  
−
== Агентский АПИ выписки ==
+
</tr>
 +
<tr class="row34">
 +
<td class="col0">Tarrif</td><td class="col1">да</td><td class="col2">строка</td><td class="col3">Код тарифа, для которого правило применяется</td>
 +
</tr>
 +
<tr class="row35">
 +
<td class="col0">Name</td><td class="col1">да</td><td class="col2">строка</td><td class="col3">Имя правила</td>
 +
 
 +
</tr>
 +
<tr class="row36">
 +
<td class="col0">RuleText</td><td class="col1">да</td><td class="col2">строка</td><td class="col3">Текст правила</td>
 +
</tr>
 +
<tr class="row37">
 +
<td class="col0">AirAvailResult</td><td class="col1">да</td><td class="col2">сложный</td><td class="col3">Контейнер для тела ответа помещения брони в очередь</td>
 +
 
 +
</tr>
 +
<tr class="row38">
 +
<td class="col0">IsAvail</td><td class="col1">да</td><td class="col2">булевский</td><td class="col3">Индикатор, показывающий доступность перелёта, возможные значения: true - доступен; false - недоступен</td>
 +
</tr>
 +
<tr class="row39">
 +
<td class="col0">VoidTicketResult</td><td class="col1">да</td><td class="col2">сложный</td><td class="col3">Контейнер для тела ответа отмены выписки брони</td>
 +
 
 +
</tr>
 +
<tr class="row40">
 +
<td class="col0">SearchResult</td><td class="col1">нет</td><td class="col2">сложный</td><td class="col3">Контейнер тела ответа для результатов поиска.</td>
 +
</tr>
 +
<tr class="row41">
 +
<td class="col0">Flights</td><td class="col1">да</td><td class="col2">сложный</td><td class="col3">Контейнер для перелётов</td>
 +
 
 +
</tr>
 +
<tr class="row42">
 +
<td class="col0">Flight</td><td class="col1">нет</td><td class="col2">сложный</td><td class="col3">Представляет информацию о перелёте. Отсутствует если перелётов не найдено (используется в поисковом ответе)</td>
 +
</tr>
 +
<tr class="row43">
 +
<td class="col0">WebService</td><td class="col1">да</td><td class="col2">строка</td><td class="col3">Веб-сервис (поставщик) от которого был получен перелёт.</td>
 +
 
 +
</tr>
 +
<tr class="row44">
 +
<td class="col0">ValCompany</td><td class="col1">нет</td><td class="col2">строка</td><td class="col3">IATA код авиакомпании. Валидирующий перевозчик, на бланках которого должен выписываться билет.</td>
 +
</tr>
 +
<tr class="row45">
 +
<td class="col0">Segments</td><td class="col1">да</td><td class="col2">сложный</td><td class="col3">Контейнер для сегментов перелёта</td>
 +
 
 +
</tr>
 +
<tr class="row46">
 +
<td class="col0">Segment</td><td class="col1">да</td><td class="col2">сложный</td><td class="col3">Представляет информацию о сегменте</td>
 +
</tr>
 +
<tr class="row47">
 +
<td class="col0">SegNum</td><td class="col1">да</td><td class="col2">число</td><td class="col3">Номер сегмента в перелёте</td>
 +
 
 +
</tr>
 +
<tr class="row48">
 +
<td class="col0">DepAirp</td><td class="col1">да</td><td class="col2">строка</td><td class="col3">IATA код аэропорта отправления</td>
 +
</tr>
 +
<tr class="row49">
 +
<td class="col0">DepTerminal</td><td class="col1">нет</td><td class="col2">строка</td><td class="col3">Код терминала отправления</td>
 +
 
 +
</tr>
 +
<tr class="row50">
 +
<td class="col0">ArrAirp</td><td class="col1">да</td><td class="col2">строка</td><td class="col3">IATA код аэропорта прибытия</td>
 +
</tr>
 +
<tr class="row51">
 +
<td class="col0">ArrTerminal</td><td class="col1">нет</td><td class="col2">строка</td><td class="col3">Код терминала прибытия</td>
 +
 
 +
</tr>
 +
<tr class="row52">
 +
<td class="col0">OpAirline</td><td class="col1">да</td><td class="col2">строка</td><td class="col3">Код авиакомпании, выполняющей рейс</td>
 +
</tr>
 +
<tr class="row53">
 +
<td class="col0">MarkAirline</td><td class="col1">да</td><td class="col2">строка</td><td class="col3">Код авиакомпании, продающей билет</td>
 +
 
 +
</tr>
 +
<tr class="row54">
 +
<td class="col0">FlightNumber</td><td class="col1">да</td><td class="col2">число</td><td class="col3">Номер рейса</td>
 +
</tr>
 +
<tr class="row55">
 +
<td class="col0">AircraftType</td><td class="col1">да</td><td class="col2">строка</td><td class="col3">Код типа самолёта</td>
 +
 
 +
</tr>
 +
<tr class="row56">
 +
<td class="col0">DepDateTime</td><td class="col1">да</td><td class="col2">строка</td><td class="col3">Дата и время отправления, формат ГГГГ-MM-ДДTЧЧ:ММ:СС</td>
 +
</tr>
 +
<tr class="row57">
 +
<td class="col0">ArrDateTime</td><td class="col1">да</td><td class="col2">строка</td><td class="col3">Дата и время прибытия, формат ГГГГ-MM-ДДTЧЧ:ММ:СС</td>
 +
 
 +
</tr>
 +
<tr class="row58">
 +
<td class="col0">StopNum</td><td class="col1">да</td><td class="col2">число</td><td class="col3">Число остановок</td>
 +
</tr>
 +
<tr class="row59">
 +
<td class="col0">Meal</td><td class="col1">да</td><td class="col2">строка</td><td class="col3">Тип питания, возможные значения: UNDEFINED - неизвестно; N - Нет питания; P - Алкогольные напитки в продаже; B - Завтрак; O - Холодная еда; C - Бесплатные алкогольные напитки; K - Континтальный завтрак; D - Обед; F - Еда в продаже; G - Еда/напитки в продаже; H - Горячая еда; L - Ланч; M - Еда; R - Освежающие еда/напитки бесплатно; V - Освежающие еда/напитки за отдельную плату; S - Закуска</td>
 +
 
 +
</tr>
 +
<tr class="row60">
 +
<td class="col0">BookingCodes</td><td class="col1">да</td><td class="col2">сложный</td><td class="col3">Контейнер для классов перелёта.</td>
 +
</tr>
 +
<tr class="row61">
 +
<td class="col0">BookingCode</td><td class="col1">да</td><td class="col2">строка</td><td class="col3">Код класса перелёта. Если производится поиск по расписанию, то может встречаться несколько раз. Содержит информацию о классе перелета определенного сегмента.</td>
 +
 
 +
</tr>
 +
<tr class="row62">
 +
<td class="col0">FlightTime</td><td class="col1">нет</td><td class="col2">число</td><td class="col3">Время перелёта в минутах</td>
 +
</tr>
 +
<tr class="row63">
 +
<td class="col0">TimeZone</td><td class="col1">нет</td><td class="col2 rightalign"> сложный</td><td class="col3">Информация о временных зона прибытия и отправления</td>
 +
 
 +
</tr>
 +
<tr class="row64">
 +
<td class="col0">Departure</td><td class="col1">да</td><td class="col2">число</td><td class="col3">Часовой пояс отправления, UTC (смещение относительно Гринвича)</td>
 +
</tr>
 +
<tr class="row65">
 +
<td class="col0">Arrival</td><td class="col1">да</td><td class="col2">число</td><td class="col3">Часовой пояс прибытия, UTC (смещение относительно Гринвича)</td>
 +
 
 +
</tr>
 +
<tr class="row66">
 +
<td class="col0">ETicket</td><td class="col1">да</td><td class="col2">булевский</td><td class="col3 rightalign">Индикатор электронного билета,  возможные значения: true - билет является электронным, false - билет не является электронным.</td>
 +
</tr>
 +
<tr class="row67">
 +
<td class="col0">Baggage</td><td class="col1">нет</td><td class="col2">сложный</td><td class="col3">Информация о багаже</td>
 +
 
 +
</tr>
 +
<tr class="row68">
 +
<td class="col0">Measure</td><td class="col1">да</td><td class="col2">строка</td><td class="col3">Мера веса. K - килограммы, PC - сумки/клади</td>
 +
</tr>
 +
<tr class="row69">
 +
<td class="col0">Value</td><td class="col1">да</td><td class="col2">строка</td><td class="col3">Количество багажа</td>
 +
 
 +
</tr>
 +
<tr class="row70">
 +
<td class="col0">PricingInfo</td><td class="col1">нет</td><td class="col2">сложный</td><td class="col3">Контейнер для информации о ценах. Отсутствует в случае, если производится поиск по расписанию.</td>
 +
</tr>
 +
<tr class="row71">
 +
<td class="col0">Refundable</td><td class="col1">да</td><td class="col2">булевский</td><td class="col3">Индикатор показывающий является ли билет возвратным или нет,  возможные значения: true - возвратный (нет штрафов за возврат), false - невозвратный (могут быть штрафы за возврат)</td>
 +
 
 +
</tr>
 +
<tr class="row72">
 +
<td class="col0">PassengerFare</td><td class="col1">да</td><td class="col2">сложный</td><td class="col3">Информация о ценах для конкретного типа пассажиров.</td>
 +
</tr>
 +
<tr class="row73">
 +
<td class="col0">Quantity</td><td class="col1">да</td><td class="col2">число</td><td class="col3">Число пассажиров данного типа</td>
 +
 
 +
</tr>
 +
<tr class="row74">
 +
<td class="col0">BaseFare</td><td class="col1">да</td><td class="col2">сложный</td><td class="col3">Цена в базовой валюте(за одного пассажира)</td>
 +
</tr>
 +
<tr class="row75">
 +
<td class="col0">EquiveFare</td><td class="col1">нет</td><td class="col2">сложный</td><td class="col3">Цена в эквивалентной валюте(за одного пассажира), при поиске цены не возвращается</td>
 +
 
 +
</tr>
 +
<tr class="row76">
 +
<td class="col0">TotalFare</td><td class="col1">нет</td><td class="col2">сложный</td><td class="col3">Полная стоимость для пассажиров данного типа включая таксы (за одного пассажира), при поиске цены не возвращается</td>
 +
</tr>
 +
<tr class="row77">
 +
<td class="col0">Currency</td><td class="col1">да</td><td class="col2">строка</td><td class="col3">Трёх буквенный код валюты.</td>
 +
 
 +
</tr>
 +
<tr class="row78">
 +
<td class="col0">Amount</td><td class="col1">да</td><td class="col2">число с плавающей точкой</td><td class="col3">Значение стоимости.</td>
 +
</tr>
 +
<tr class="row79">
 +
<td class="col0">Taxes</td><td class="col1">нет</td><td class="col2">сложный</td><td class="col3">Контейнер для такс, при поиске цены не возвращается</td>
 +
 
 +
</tr>
 +
<tr class="row80">
 +
<td class="col0">Tax</td><td class="col1">да</td><td class="col2">сложный</td><td class="col3">Одна такса</td>
 +
</tr>
 +
<tr class="row81">
 +
<td class="col0">CurCode</td><td class="col1">да</td><td class="col2">строка</td><td class="col3">Трёх буквенный код валюты для таксы</td>
 +
 
 +
</tr>
 +
<tr class="row82">
 +
<td class="col0">TaxCode</td><td class="col1">да</td><td class="col2">строка</td><td class="col3">Код таксы</td>
 +
</tr>
 +
<tr class="row83">
 +
<td class="col0">Amount</td><td class="col1">да</td><td class="col2">число с плавающей точкой</td><td class="col3">Значение таксы</td>
  
−
Агентский АПИ выписки позволяет определить валидирующего перевозчика и значение комиссии от авиакомпании для брони, а также запустить процедуру выписки билета.
+
</tr>
 +
<tr class="row84">
 +
<td class="col0">Tariffs</td><td class="col1">да</td><td class="col2">сложный</td><td class="col3">Контейнер для тарифов</td>
 +
</tr>
 +
<tr class="row85">
 +
<td class="col0">Tariff</td><td class="col1">да</td><td class="col2">сложный</td><td class="col3">Контейнер для одного тарифа</td>
  
−
'''Как правило для выписки билета достаточно сформировать запрос на проставление статуса "ОПЛАЧЕНО". При включенной опции «Производить оформление билета: автоматически» билет будет выпущен в фоновом режиме.'''
+
</tr>
 +
<tr class="row86">
 +
<td class="col0">Code</td><td class="col1">да</td><td class="col2">строка</td><td class="col3">Код тарифа</td>
 +
</tr>
 +
<tr class="row87">
 +
<td class="col0">SegNum</td><td class="col1">да</td><td class="col2">число</td><td class="col3">Номер сегмента для которого применяется тариф, если тариф применяется для всех сегментов, то возвращается 0.</td>
  
 +
</tr>
 +
<tr class="row88">
 +
<td class="col0">FareCalc</td><td class="col1">нет</td><td class="col2">строка</td><td class="col3">Строка расчёта цены</td>
 +
</tr>
 +
<tr class="row89">
 +
<td class="col0">LastTicketDateTime</td><td class="col1">да</td><td class="col2">строка</td><td class="col3">Дата и время таймлимита по выписке в формате ГГГГ-MM-ДДTЧЧ:ММ:СС по московскому времени. Если бронирование не будет аннулировано или выписано до этого времени, то могут быть применены штрафы.</td>
  
−
----
+
</tr>
 +
</table>
 +
</div>
 +
</div>
  
−
См. также: [[АПИ]], [[выписка]], [[комиссия]], [[валидирующий перевозчик]], [[ГРС]], [[ПНР]]
+
{{Attention|В системе реализован усовершенствованный API-проект «Nemo Connect», настоятельно рекомендуем подключаться по схеме, описанной в документации по [http://docs.nemo.travel/ ссылке]}}
 +
== См. также ==
 +
*[http://docs.nemo.travel Nemo Connect]
 +
*[[Агентский интерфейс прикладного программирования (Агентский API)]]
 +
*[[Агентский API Отели]]
 +
*[[Бронирование]]
 +
*[[Электронный билет]]

Текущая версия на 10:47, 27 января 2020

Внимание! В системе реализован усовершенствованный API-проект «Nemo Connect», настоятельно рекомендуем подключаться по схеме, описанной в документации по ссылке

Схема использования агентского API (workflow)

Для авторизации в системе, в запросе необходимо указать APIKey и ClientID. Эти данные можно узнать в разделе Администрирование - Веб-сервис. Авторизация. Там же можно включить/выключить нотификацию для действий, совершенных через АПИ.

Необходимо придерживаться рекомендованной схемы использования API. Если вы планируете отступать от этой схемы - пожалуйста, согласуйте отклонения от нее со службой технической поддержки.

Внимание! Пользователь и агентство из Немо Тревел 2.0 и Немо Тревел 1.0 должны соответствовать друг другу.

Агентский АПИ поиска авиабилетов

Агентский АПИ бронирования авиабилетов

Агентский АПИ выписки

Агентский АПИ Оплаты

Агентский АПИ возврата авиабилетов

Агентский АПИ дополнительных запросов

Дополнительная информация по параметрам

Параметры, используемые в запросах

Имя элемента Обязательный Тип Описание
BookFlight да сложный Контейнер для тела запроса бронирования
FlightId да числоId перелёта для которого будет производится бронирование(поиск тарифных правил, проверка доступности)
CurrencyCode нетстрокаТрёх буквенный код валюты (обязателен для комиссии в валюте)
Agency да сложный Информация об агентстве
Name да строка Название агентства
Telephone нет сложный Контактный телефон агентства
Typeда строка Тип номера, возможные значения: M - мобильный, H - домашний, B - рабочий, A - агентство
PhoneNumber да строка Номер телефона
CountryAccessCode нет строка Код страны
AreaCityCode нет строкаКод региона/города
Addressда сложный Адрес агентства
Cityда строка Город, в котором расположено агентство
StreetAddress нет сложный Адрес агентства в городе (улица, дом, корпус, офис и т.д.)
PostalCode нет строка Почтовый код, индекс.
CountryCode нет строка Код страны (RU, UA, US и т.д.)
Travellers да сложный Контейнер для информации о пассажирах (для которых будет производится поиск перелёта, бронирование)
Traveller да сложный Информация о пассажире
TypeдастрокаТип пассажира возможные значения: ADT - взрослые, CNN - дети, UNN - дети без сопровождения взрослых, INF - младенцы, INS - младенцы с местом
IsContact нетбулевский Индикатор показывающий является ли данное лицо контактным, возможные значение: true - пассажир является контактным лицом, false - не является. Контактное лицо может быть только одно, если среди пассажиров есть взрослые, то только кто-то из них может быть контактным лицом. Если не указано, то по умолчанию false.
LinkedTo нет целое число Номер взрослого, к которому привязан младенец/ребёнок (привязка ребёнка ко взрослому является опциональной)
Num да число Номер пассажира.
PreferedPlace нет сложный Информация о предпочитаемом месте. Если указаны номер ряда и номер места, то параметры Smoking и Location игнорируются и могут быть не указаны.
SmokingAllowed нет булевский true - место для курящих, false - место для некурящих. По умолчанию false.
Location нет строка Расположение места, возможные значения: W - у окна (Window); M - где-то в середине ряда (Middle); NPW - возле прохода (NearPassengerWay); NS - нет предпочтения (NotSpecified).
RowNumberнетстрока Номер ряда
PlaceNumber нет строка Номер места
SegNumber да строка Номер сегмента
DocumentInfo да сложный Паспортные данные
DocType да строка Тип документа, обязательный.
DocNum да строка Номер документа
CountryCode да строка Страна выдачи, двух буквенный код(RU, US и т.д.)
DocElapsedTimeда строка Срок истечения срока действия паспорта в фирмате dd.mm.yyyy (например 31.12.2012)
VisaInfo нет сложный Информация о визе
Num да строка Номер визы
IssueDate да строка Дата выдачи визы в формате dd.mm.yyyy
IssueCountry да строка Страна выдачи визы
IssuePlace да строка Место выдачи визы
BirthCountry нет строка Страна рождения (IATA код страны)
BirthCity нетстрокаГород рождения (название)
ArrAddress нет сложный Адрес прибытия, для въезжающих в США (не граждан США) информация является обязательной. Если она не заполняется при оформлении брони, то её всё равно придётся заполнять при посадке на самолёт.
CountryCode да строка IATA код страны
State да строка Штат или область въезда
PostalCode да строка Почтовый код
City да строка Город
StreetAddress да строка Адрес: улица, номер дома, квартиры и тп
DocStringFormats нет сложный Список форматов строк паспортных данных, которые будут отправлены в дополнение к стандартным.
DocStringFormat да строка Формат данных, возможные значения: DOCS - строка формата DOCS, FOID - строка формата FOID. Установка данных в формате DOCS как правило необходима для последующей выписки в BSP среде. Установка FOID - всреде ТКП.
PersonalInfo да сложный Персональные данные пассажира
DateOfBirthда строка Дата рождения в формате dd.mm.yyyy (например 31.12.2000)
Nationality да строка Национальность/гражданство, двух буквенный код страны (RU, UA, US и т.д.)
Gender да строка Пол пассажира, обязательный, возможные значения: M - мужской(Male); F - женский(Female).
FirstName да строка Имя пассажира
LastName да строка Фамилия пассажира
BMiddleName да строка Отчество пассажира
Meal нетстрока Код типа питания, возможные значения: NONE - отсутствует (по умолчанию); AVML - Азиатская вегетарианская кухня; BLML - Блюда щадящей диеты; CHML - Детское питание; CHPC - Детский холодный завтрак; СНСС - Детский горячий завтрак; CHHC - Детский ланч, ветчина и сыр; PBJS - Детский ланч, ореховое масло; CHMC - Детский обед макароны с сыром; DBML - Диабетическое питание; FPML - Фрукты; GFML - Питание без клейковины; HFML - Питание богатое клетчаткой; HNML - Индусская кухня; BBML - Питание для младенцев; KSML - Кошерная кухня; SMKB - Кошерный завтрак; SMKL - Кошерный ланч; SMKD - Кошерный обед; LPML - Малобелковое питание; LCML - Низкокалорийное питание; LFML - Низкохолестериновое питание; PRML - Низкопуриновое питание; LSML - Малосоленое питание; MOML - Мюсли; NLML - Безмолочные продукты; ORML - Восточная кухня; RVML - Сырые овощи; SFML - Морепродукты; SPML - Особое питание; VLML - Вегетарианское, молоко и яйца; VGML - Строго вегетарианское питание; VJML - Джайнизское вегетарианское; VOML - Восточное вегетарианское питание.
LoyaltyCard нет сложный Карточка часто летающего пассажира
OpCode да строка IATA код компании авиаперевозчика
Number да строка Номер карточки
ContactInfoнет сложный Контактная информация для пассажира
EmailID нет строка Контактный email
Telephone нет сложный Контактный телефон пассажира, описание аналогично описанию телефона агентства
CancelBookдасложныйКонтейнер для тела запроса отмены брони
BookIDдачислоНомер брони, которая будет отменяться (для которой будет производится выписка, отмена выписки)
GetAirRulesдасложныйКонтейнер для тела запроса поиска тарифных правил
AirAvailдасложныйКонтейнер для тела запроса проверки доступности перелёта
TicketingдасложныйКонтейнер для тела запроса выписки брони
ValCompanyнетстрокаВалидирующий перевозчик, на бланке которого выписывается билет
ComissionнетсложныйКомиссия
Amountнетчисло с плавающей точкойЗначение комиссии в валюте, если указано, то комиссия в процентах игнорируется
PercentнетчислоКомиссия в процентах
VoidTicketдасложныйКонтейнер для тела запроса отмены выписки брони
SearchдасложныйКонтейнер для тела запроса поиска
ODPairsдасложныйКонтейнер для информации о перелёте
TypeдастрокаТип перелёта, возможные значения: OW - в одну сторону, RT - туда-обратно, CR - сложный маршрут
DirectнетбулевскийИндикатор, указывающий какие перелёты искать, только прямые или с пересадками, возможные значения: false - с пересадками, true - только прямые. Если не указан, значение по умолчанию false.
AroundDatesнетчислоВключает поиск по окружным датам, количество дней +/- от даты заезда/возвращения. Применим только для типов перелёта в одну сторону(OW) и туда-обратно(RT). Возможные значения: 0, 1, 2, 3
ODPairдасложныйКонтейнер для информации о сегменте перелёта. Может повторяться 1-6 раз. Поиск по расписанию использует только первый сегмент, поиск сложных перелётов и перелётов туда и обратно не поддерживается
DepDateдастрокаДата вылета, Формат ГГГГ-MM-DDTЧЧ:ММ:СС
DepAirpдастрокаТрёх буквенный код города отправления или конкретного аэропорта в городе отправления.
ArrAirpдастрокаТрёх буквенный код города прибытия или конкретного аэропорта в городе прибытия.
CountдачислоЧисло пассажиров данного типа. Общее количество пассажиров всех типов должно быть не более 9.
RestrictionsнетсложныйКонтейнер дополнительной информации для поиска.
ClassPrefнетстрокаПредпочитаемый класс перелёта, возможные значения: All - все, Economy - эконом, Business - бизнес, First - первый. Если не указан, то по умолчанию All.
OnlyAvailнетбулевскийИскать только доступные, возможные значения: true - только доступные, false - все. Если не указан, то по умолчанию false.
AirVPrefsнетсложныйОбёртка для списка авиакомпаний, по которым будет или не будет проводиться поиск.
AirVPrefдасложныйИнформация об авиакомпании.
IncludeнетбулевскийИндикатор, показывающий включить или исключить в результатах поиска перелёты данной авиакомпании: true - включить, false - исключить. Если не указан, то по умолчанию false.
IncludePrivateFareнетбулевскийВключать приватные цены в результат или нет, возможные значения: true - включать, false - не включать. Если не указан, то по умолчанию false.
ServiceTypesнетсложный хмлКонтейнер массива используемых веб-сервисов при поиске.
ServiceTypeнетстрокаТип веб-сервиса(поставщика). При указании нескольких элементов ServiceType поиск будет проведён для каждого сервиса. Возможные значения: Sirena2000 - поиск в Сирене; SirenaSchedule - поиск в Сирене по расписанию; SabreLFS - поиск в Сэйбр LFS; SabreBFM - поиск в Сэйбр BFM; SabreSchedule - поиск Сэйбр по расписанию; Galileo - поиск в Галилео; AmadeusMPTBS - поиск в Амадеус.
DataItemsнетсложныйУницифированный блок данных для хранения различного контента брони.
DataItemнетсложныйКонтейнер для определенного типа передаваемой с запросом выписки информации.
RemarkнетсложныйКонтейнер для записи ремарок.
TypeнетстрокаТип ремарки. Может принимать значения: General, Itinerary, Invoice, Historical, QueueControl, Vendor, NemoInternal, Confidential, MiniItinerary.
TextнетстрокаСодержание ремаркаи.

Параметры, используемые в ответах

Имя элемента Обязательный Тип Описание
BookFlightResult да сложный Контейнер для тела ответа бронирования
ID да числоНомер бронирования в системе Nemo.
Status да строка Статус брони, возможные значения: booked - забронировано, canceled - бронь отменена, ticket - выписана; UNDEFINED - статус не определён.
Code да строка Номер бронирования в системе поставщика (в sabre, sirena и т.д.)/код тарифного правила
QueryPlace нет сложный Очередь, в которую помещено бронирование
Number да число Номер очереди
Flight да сложный Перелёт, по которому была сделана бронь (Результаты проверки доступности для перелёта)
Agency да сложный Информация об агентстве
ItinReceiptsнет сложный Маршрут квитанция. Содержит строку в кодировки Encoding (как правило в base64), представляющую маршрут квитанцию в формате Format.
Encoding да строка Кодировка
Format да строкаФормат
Travellersда сложный Контейнер для информации о пассажирах
Traveller да сложный Информация о пассажире
Ticket нет сложный Билет пассажира.
TickectNum да строка Номер билета
Seatsнет сложный Контейнер мест пассажира.
Seat да сложный Место в самолёте
Number да строкаНомер места(ряд+номер в ряду)
Characteristic нетстрока Характеристика места в соответствии со стандартом EDIFACT. См справочник “Таблица характеристик мест”.
SmokingPreference нет строка Статус курения на этом месте, если Y - место для курящих, если N - место для некурящих.
SegmentNumber да число Номер сегмента
PersonalInfo да сложный Личные данные
LoyaltyCard нет сложный Карточка часто летающего пассажира
ContactInfo нет сложный Контактная информация для пассажира
FareStored нет срока: Yes/No Указывает установлена ли / гарантируется ли цена у поставщика. Если параметр отсутствует в ответе, то по умолчанию значение “Yes”.
CancelBookResultдасложныйКонтейнер для тела ответа отмены брони
BookIDдачислоНомер брони, которая отменялась (Номер выписанной брони, выписка которой отменялась)
ResultдасложныйРезультат отмены (войдирования)
SuccessдабулевскийИндикатор, показывающий успешно или нет прошла отмена, возможные значения: true - успешно отменена (войдирование); false - не отменена
GetAirRulesResultдасложныйКонтейнер для тела ответа поиска тарифных правил
FlightIdдачислоНомер перелёта, для которого найдены тарифные правила (будет проводилась проверка доступности)
RulesдасложныйКонтейнер для правил
RuleдасложныйПравило
TarrifдастрокаКод тарифа, для которого правило применяется
NameдастрокаИмя правила
RuleTextдастрокаТекст правила
AirAvailResultдасложныйКонтейнер для тела ответа помещения брони в очередь
IsAvailдабулевскийИндикатор, показывающий доступность перелёта, возможные значения: true - доступен; false - недоступен
VoidTicketResultдасложныйКонтейнер для тела ответа отмены выписки брони
SearchResultнетсложныйКонтейнер тела ответа для результатов поиска.
FlightsдасложныйКонтейнер для перелётов
FlightнетсложныйПредставляет информацию о перелёте. Отсутствует если перелётов не найдено (используется в поисковом ответе)
WebServiceдастрокаВеб-сервис (поставщик) от которого был получен перелёт.
ValCompanyнетстрокаIATA код авиакомпании. Валидирующий перевозчик, на бланках которого должен выписываться билет.
SegmentsдасложныйКонтейнер для сегментов перелёта
SegmentдасложныйПредставляет информацию о сегменте
SegNumдачислоНомер сегмента в перелёте
DepAirpдастрокаIATA код аэропорта отправления
DepTerminalнетстрокаКод терминала отправления
ArrAirpдастрокаIATA код аэропорта прибытия
ArrTerminalнетстрокаКод терминала прибытия
OpAirlineдастрокаКод авиакомпании, выполняющей рейс
MarkAirlineдастрокаКод авиакомпании, продающей билет
FlightNumberдачислоНомер рейса
AircraftTypeдастрокаКод типа самолёта
DepDateTimeдастрокаДата и время отправления, формат ГГГГ-MM-ДДTЧЧ:ММ:СС
ArrDateTimeдастрокаДата и время прибытия, формат ГГГГ-MM-ДДTЧЧ:ММ:СС
StopNumдачислоЧисло остановок
MealдастрокаТип питания, возможные значения: UNDEFINED - неизвестно; N - Нет питания; P - Алкогольные напитки в продаже; B - Завтрак; O - Холодная еда; C - Бесплатные алкогольные напитки; K - Континтальный завтрак; D - Обед; F - Еда в продаже; G - Еда/напитки в продаже; H - Горячая еда; L - Ланч; M - Еда; R - Освежающие еда/напитки бесплатно; V - Освежающие еда/напитки за отдельную плату; S - Закуска
BookingCodesдасложныйКонтейнер для классов перелёта.
BookingCodeдастрокаКод класса перелёта. Если производится поиск по расписанию, то может встречаться несколько раз. Содержит информацию о классе перелета определенного сегмента.
FlightTimeнетчислоВремя перелёта в минутах
TimeZoneнет сложныйИнформация о временных зона прибытия и отправления
DepartureдачислоЧасовой пояс отправления, UTC (смещение относительно Гринвича)
ArrivalдачислоЧасовой пояс прибытия, UTC (смещение относительно Гринвича)
ETicketдабулевскийИндикатор электронного билета, возможные значения: true - билет является электронным, false - билет не является электронным.
BaggageнетсложныйИнформация о багаже
MeasureдастрокаМера веса. K - килограммы, PC - сумки/клади
ValueдастрокаКоличество багажа
PricingInfoнетсложныйКонтейнер для информации о ценах. Отсутствует в случае, если производится поиск по расписанию.
RefundableдабулевскийИндикатор показывающий является ли билет возвратным или нет, возможные значения: true - возвратный (нет штрафов за возврат), false - невозвратный (могут быть штрафы за возврат)
PassengerFareдасложныйИнформация о ценах для конкретного типа пассажиров.
QuantityдачислоЧисло пассажиров данного типа
BaseFareдасложныйЦена в базовой валюте(за одного пассажира)
EquiveFareнетсложныйЦена в эквивалентной валюте(за одного пассажира), при поиске цены не возвращается
TotalFareнетсложныйПолная стоимость для пассажиров данного типа включая таксы (за одного пассажира), при поиске цены не возвращается
CurrencyдастрокаТрёх буквенный код валюты.
Amountдачисло с плавающей точкойЗначение стоимости.
TaxesнетсложныйКонтейнер для такс, при поиске цены не возвращается
TaxдасложныйОдна такса
CurCodeдастрокаТрёх буквенный код валюты для таксы
TaxCodeдастрокаКод таксы
Amountдачисло с плавающей точкойЗначение таксы
TariffsдасложныйКонтейнер для тарифов
TariffдасложныйКонтейнер для одного тарифа
CodeдастрокаКод тарифа
SegNumдачислоНомер сегмента для которого применяется тариф, если тариф применяется для всех сегментов, то возвращается 0.
FareCalcнетстрокаСтрока расчёта цены
LastTicketDateTimeдастрокаДата и время таймлимита по выписке в формате ГГГГ-MM-ДДTЧЧ:ММ:СС по московскому времени. Если бронирование не будет аннулировано или выписано до этого времени, то могут быть применены штрафы.

Внимание! В системе реализован усовершенствованный API-проект «Nemo Connect», настоятельно рекомендуем подключаться по схеме, описанной в документации по ссылке

См. также

Источник — https://support.nemo.travel/index.php?title=Агентский_API_Авиабилеты&oldid=16714