Интеграция со сторонними системами АПИ: различия между версиями
Перейти к навигации
Перейти к поиску
(Новая страница: «==API Поиска авиабилетов== ==API Поиска отелей== ==API бронирования, аннуляции, войдирования ави…») |
м (→API Авиабилетов) |
||
| (не показано 118 промежуточных версий 4 участников) | |||
| Строка 1: | Строка 1: | ||
| − | ==API Поиска авиабилетов== | + | ==API Авиабилетов== |
| − | ==API | + | |
| − | ==API | + | Чтобы авторизоваться в системе, в запросе необходимо указать APIKey и ClientID. Эти данные можно узнать в разделе Администрирование - Веб-сервис. Авторизация. Там же можно включить/выключить нотификацию для действий, совершенных через АПИ. |
| − | == | + | |
| − | == | + | === API Поиска авиабилетов === |
| − | == | + | Это сервис внутри Nemo, который позволяет получить результаты поиска. |
| − | == | + | |
| − | == | + | Для подключения к веб-службе поиска авиабилетов необходимо открыть доступ нужному пользователю. Это можно сделать в разделе '''«Администрирование»''' ⇨ '''«Веб-служба. Авторизация»'''. |
| − | == | + | |
| − | == | + | Подробнее можно узнать в специальной статье [[Веб-служба поиска авиабилетов]] |
| − | ==API | + | |
| − | ==API Синхронизации пользователей и субагентов== | + | === API Бронирования авиабилетов === |
| + | Сервис позволяет забронировать/войдировать авиабилет с использованием API, описание подключения, запроса, ответов находится в этой статье [[Веб-служба бронирования]] | ||
| + | |||
| + | === API Выписки авиабилетов === | ||
| + | |||
| + | Агентский АПИ выписки позволяет определить валидирующего перевозчика и значение комиссии от авиакомпании для брони, а также запустить процедуру выписки билета. [[Веб-служба выписки]] | ||
| + | |||
| + | === API Оплаты === | ||
| + | |||
| + | Сервис внутри Nemo, который предназначен для выполнения различных операций, относящихся к оплате заказов. [[Агентские АПИ оплаты]] | ||
| + | |||
| + | === API Дополнительных запросов авиабилетов === | ||
| + | |||
| + | К дополнительных запросам относятся проверка на доступность, запрос на обновление заказа, чтение тарифных правил. [[Дополнительные запросы АПИ авиабилетов]] | ||
| + | |||
| + | === Используемые параметры === | ||
| + | |||
| + | <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> | ||
| + | </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> | ||
| + | |||
| + | </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> | ||
| + | |||
| + | </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> | ||
| + | |||
| + | ==API Отелей== | ||
| + | '''Агентский API Отелей''' - система, которая предоставляет возможность поиска и бронирования отелей а так же получение информации о времени и размерах штрафов, уникальной информации об отеле, получение статической информации. | ||
| + | |||
| + | Подробнее можно узнать в нашей специальной статье [http://support.nemo.travel/ru/%D0%90%D0%B3%D0%B5%D0%BD%D1%82%D1%81%D0%BA%D0%B8%D0%B9_API_%D0%9E%D1%82%D0%B5%D0%BB%D0%B5%D0%B9 Агентский АПИ отелей] | ||
| + | |||
| + | |||
| + | |||
| + | ==Выгрузки статистики продаж через API (Метапоиск)== | ||
| + | |||
| + | '''Метапоисковая система''' (метапоисковая машина, метапоисковик) — это поисковая система, которая в отличие от классических поисковых машин не имеет собственной базы данных и собственного поискового индекса, а формирует поисковую выдачу за счет смешивания и переранжирования результатов поиска других поисковых систем. | ||
| + | |||
| + | В разделе статистики заказов из метапоисков можно получить данные по статистике метапоиска (по источнику переходов модуля метрики) <u>за определенный период бронирования заказов</u> в виде файла данных в формате XML. | ||
| + | |||
| + | Можно получить список заказов с их статусом (забронирован, выписан, аннулирован), сделанных через метапоисковую систему. | ||
| + | |||
| + | Подробнее можно узнать в статье посвященной взаимодействию с метопоисковиками [[Взаимодействие с метапоисковиками]] | ||
| + | |||
| + | ==Выгрузка информации о заказах == | ||
| + | '''Выгрузка заказов''' — это экспорт данных заказа или заказов для различных компонентов системы Nemo. Модуль позволяет внешней системе получать данные по заказам для дальнейшей обработки. | ||
| + | Подробнее о процессе выгрузки, настройках, форматах выгрузки для различных компонент можно прочитать в статье [[Выгрузка]] | ||
| + | |||
| + | == API Синхронизации пользователей и субагентов == | ||
| + | Назначение данного модуля — обеспечение взаимодействия между сторонней программой (например, системой автоматизации туроператора "САМО-тур") и Nemo в части синхронизации списка B2B-пользователей. | ||
| + | Модуль является компонентом, включаемым и отключаемым из административной части. | ||
| + | |||
| + | О механизме авторизации B2B-пользователей, синхронизации учетных записей можно прочитать в статье [[Синхронизация пользователей]] | ||
| + | |||
==API Кроссавторизации== | ==API Кроссавторизации== | ||
| − | ==Передача параметров в форму поиска== | + | '''Авторизация пользователей из внешних систем''' — Система Nemo позволяет обращаться к ней как базе пользователей для авторизации из других систем (например форума на сайте, собственного ПО компании и т.п) |
| + | |||
| + | Для этого нужно подключиться к веб-службе авторизации, WSDL-описание которой располагается по адресу: | ||
| + | |||
| + | [http://hostname/authorization_reol.wsdl http://hostname/authorization_reol.wsdl] | ||
| + | |||
| + | <div class="toccolours mw-collapsible mw-collapsed" style="width:1000px"> | ||
| + | ===== Запрос ===== | ||
| + | <div class="mw-collapsible-content"> | ||
| + | |||
| + | <pre>?xml version ='1.0' encoding ='UTF-8' ?> | ||
| + | <definitions name='Authorization' | ||
| + | targetNamespace='http://example.org/Authorization' | ||
| + | xmlns:tns=' http://example.org/Authorization ' | ||
| + | xmlns:soap='http://schemas.xmlsoap.org/wsdl/soap/' | ||
| + | xmlns:xsd='http://www.w3.org/2001/XMLSchema' | ||
| + | xmlns:soapenc='http://schemas.xmlsoap.org/soap/encoding/' | ||
| + | xmlns:wsdl='http://schemas.xmlsoap.org/wsdl/' | ||
| + | xmlns='http://schemas.xmlsoap.org/wsdl/'> | ||
| + | |||
| + | <message name='getAuthorizationRequest'> | ||
| + | <part name='login' type='xsd:string'/> | ||
| + | <part name='pass' type='xsd:string'/> | ||
| + | </message> | ||
| + | <message name='getAuthorizationResponse'> | ||
| + | <part name='session_id' type='xsd:string'/> | ||
| + | <part name='user_id' type='xsd:string'/> | ||
| + | <part name='login' type='xsd:string'/> | ||
| + | <part name='status' type='xsd:string'/> | ||
| + | </message> | ||
| + | |||
| + | <portType name='AuthorizationPortType'> | ||
| + | <operation name='getAuthorization'> | ||
| + | <input message='tns:getAuthorizationRequest'/> | ||
| + | <output message='tns:getAuthorizationResponse'/> | ||
| + | </operation> | ||
| + | </portType> | ||
| + | |||
| + | <binding name='AuthorizationBinding' type='tns:AuthorizationPortType'> | ||
| + | <soap:binding style='rpc' | ||
| + | transport='http://schemas.xmlsoap.org/soap/http'/> | ||
| + | <operation name='getAuthorization'> | ||
| + | <soap:operation soapAction='urn:xmethods-delayed-quotes#getAuthorization'/> | ||
| + | <input> | ||
| + | <soap:body use='encoded' namespace='urn:xmethods-delayed-quotes' | ||
| + | encodingStyle='http://schemas.xmlsoap.org/soap/encoding/'/> | ||
| + | </input> | ||
| + | <output> | ||
| + | <soap:body use='encoded' namespace='urn:xmethods-delayed-quotes' | ||
| + | encodingStyle='http://schemas.xmlsoap.org/soap/encoding/'/> | ||
| + | </output> | ||
| + | </operation> | ||
| + | </binding> | ||
| + | |||
| + | <service name='AuthorizationService'> | ||
| + | <port name='AuthorizationPort' binding='AuthorizationBinding'> | ||
| + | <soap:address location='http://nemo.local/controllers/authorization/auth_server.php'/> | ||
| + | </port> | ||
| + | </service> | ||
| + | </definitions></pre> | ||
| + | </div></div> | ||
| + | |||
| + | ==Передача параметров в форму поиска (FastSearch)== | ||
| + | |||
| + | В системе Nemo имеется возможность перенаправлять пользователей на страницу с уже заполненными параметрами поиска или сразу напрямую на результаты поиска. | ||
| + | |||
| + | Примеры FastSearch запросов и используемые переменные подробно описаны в статье [[FastSearch - передача параметров в форму]] | ||
| + | |||
| + | FastSearch так же работает и для отелей, подробности в статье [[Fast Search для отелей]] | ||
| + | |||
| + | <!-- Т.к. это внутренний формат обмена данными между Немо и одним клиентом, то данную инфу скроем в комментарии | ||
==Проверка в сторонней системе возможности тикетинга== | ==Проверка в сторонней системе возможности тикетинга== | ||
| − | == | + | |
| − | == | + | При выписки билета через стороннюю систему 1С, отправляется запрос "GetDebtCounterparty", который спрашивает, можно ли с счета в 1С списать средства для оплаты. В ответе содержится заключение от 1С, в случае если ошибок нет, то в ответе будет |
| + | <pre><m:Opportunity>Да</m:Opportunity></pre> | ||
| + | Пример запроса "GetDebtCounterparty" | ||
| + | <pre> | ||
| + | <?xml version="1.0" encoding="UTF-8"?> | ||
| + | |||
| + | <SOAP-ENV:Body> | ||
| + | <ns1:GetDebtCounterparty> | ||
| + | <ns1:ExternalUserId>00000001</ns1:ExternalUserId> | ||
| + | <ns1:ExternalPaymentId>00000001</ns1:ExternalPaymentId> | ||
| + | <ns1:BaseFare>2490</ns1:BaseFare> | ||
| + | <ns1:Tax>643</ns1:Tax> | ||
| + | <ns1:ValVendorCommission>49.8</ns1:ValVendorCommission> | ||
| + | <ns1:Locator>0X97T6</ns1:Locator> | ||
| + | <ns1:Discount>0</ns1:Discount> | ||
| + | <ns1:Charge>0</ns1:Charge> | ||
| + | <ns1:Sum>3133</ns1:Sum> | ||
| + | <ns1:TotalPrice>3658.1</ns1:TotalPrice> | ||
| + | <ns1:GDSCurrency>RUB</ns1:GDSCurrency> | ||
| + | <ns1:OrderCurrency>RUB</ns1:OrderCurrency> | ||
| + | <ns1:OrderCurrencyRate>1</ns1:OrderCurrencyRate> | ||
| + | <ns1:beginDate>2014-08-30T11:05:00</ns1:beginDate> | ||
| + | </ns1:GetDebtCounterparty> | ||
| + | </SOAP-ENV:Body> | ||
| + | </SOAP-ENV:Envelope> | ||
| + | |||
| + | </pre> | ||
| + | Пример ответа "GetDebtCounterparty" | ||
| + | <pre> | ||
| + | <?xml version="1.0"?> | ||
| + | <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> | ||
| + | <soap:Header/> | ||
| + | <soap:Body> | ||
| + | <m:GetDebtCounterpartyResponse xmlns:m="http://DOMEN_NAME/avia"> | ||
| + | <m:return xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="m:AnswerDebt"> | ||
| + | <m:Opportunity>Да</m:Opportunity> | ||
| + | <m:Message1/> | ||
| + | </m:return> | ||
| + | </m:GetDebtCounterpartyResponse> | ||
| + | </soap:Body> | ||
| + | </soap:Envelope> | ||
| + | |||
| + | </pre> | ||
| + | |||
| + | == Загрузка счетов из сторонней системы == | ||
| + | |||
| + | При взаимодействии с веб-сервисом 1С, на этапе бронирования отправляется запрос, на создание аккаунта 1С, содержащий в себе данные счета. В системе логирования этот запрос можно найти под именем «[GDS] Запрос "NewAccount"» и ответ «[GDS] Ответ "NewAccount"» | ||
| + | |||
| + | <div class="toccolours mw-collapsible mw-collapsed" style="width:800px"> | ||
| + | |||
| + | === Пример запроса === | ||
| + | <div class="mw-collapsible-content"> | ||
| + | |||
| + | <pre> | ||
| + | |||
| + | <?xml version="1.0" encoding="UTF-8"?> | ||
| + | <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://DOMEN_NAME" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> | ||
| + | <SOAP-ENV:Body> | ||
| + | <ns1:NewAccount> | ||
| + | <ns1:Input> | ||
| + | <ns1:CompanyID>0001</ns1:CompanyID> | ||
| + | <ns1:ID>123321</ns1:ID> | ||
| + | <ns1:ExternalUserId>00123321</ns1:ExternalUserId> | ||
| + | <ns1:Locator>11KW22</ns1:Locator> | ||
| + | <ns1:ExternalPaymentId>0</ns1:ExternalPaymentId> | ||
| + | <ns1:Tickets> | ||
| + | <ns1:IATAValidator>92222616</ns1:IATAValidator> | ||
| + | <ns1:ValVendor>UT</ns1:ValVendor> | ||
| + | <ns1:GDSCurrency>RUB</ns1:GDSCurrency> | ||
| + | <ns1:OrderCurrency>RUB</ns1:OrderCurrency> | ||
| + | <ns1:OrderCurrencyRate>1</ns1:OrderCurrencyRate> | ||
| + | <ns1:BaseFare>8990</ns1:BaseFare> | ||
| + | <ns1:Tax> | ||
| + | <ns1:Code>YQ</ns1:Code> | ||
| + | <ns1:Amount>975</ns1:Amount> | ||
| + | </ns1:Tax> | ||
| + | <ns1:Tax> | ||
| + | <ns1:Code>YR</ns1:Code> | ||
| + | <ns1:Amount>75</ns1:Amount> | ||
| + | </ns1:Tax> | ||
| + | <ns1:Segment> | ||
| + | <ns1:StartDate>2015-02-17T20:20:00</ns1:StartDate> | ||
| + | <ns1:StartAirportCode>VKO</ns1:StartAirportCode> | ||
| + | <ns1:EndAirportCode>SGC</ns1:EndAirportCode> | ||
| + | <ns1:CompanyCode>UT</ns1:CompanyCode> | ||
| + | <ns1:Tariffs>OSSOW</ns1:Tariffs> | ||
| + | <ns1:FlightNumber>295</ns1:FlightNumber> | ||
| + | <ns1:StopOver>O</ns1:StopOver> | ||
| + | <ns1:ClassTypeCode>O</ns1:ClassTypeCode> | ||
| + | </ns1:Segment> | ||
| + | <ns1:FullName>PASSANGER NAME</ns1:FullName> | ||
| + | </ns1:Tickets> | ||
| + | <ns1:Options> | ||
| + | <ns1:Name>Service</ns1:Name> | ||
| + | <ns1:StringValue>GALILEO</ns1:StringValue> | ||
| + | <ns1:NumericValue xsi:nil="true"/> | ||
| + | <ns1:DateValue xsi:nil="true"/> | ||
| + | </ns1:Options> | ||
| + | <ns1:Options> | ||
| + | <ns1:Name>AAA</ns1:Name> | ||
| + | <ns1:StringValue>000A</ns1:StringValue> | ||
| + | <ns1:NumericValue xsi:nil="true"/> | ||
| + | <ns1:DateValue xsi:nil="true"/> | ||
| + | </ns1:Options> | ||
| + | <ns1:Options> | ||
| + | <ns1:Name>Checkbox</ns1:Name> | ||
| + | <ns1:StringValue>YES</ns1:StringValue> | ||
| + | <ns1:NumericValue xsi:nil="true"/> | ||
| + | <ns1:DateValue xsi:nil="true"/> | ||
| + | </ns1:Options> | ||
| + | </ns1:Input> | ||
| + | </ns1:NewAccount> | ||
| + | </SOAP-ENV:Body> | ||
| + | </SOAP-ENV:Envelope> | ||
| + | |||
| + | |||
| + | </pre> | ||
| + | </div></div> | ||
| + | |||
| + | <div class="toccolours mw-collapsible mw-collapsed" style="width:800px"> | ||
| + | === Пример ответа === | ||
| + | <div class="mw-collapsible-content"> | ||
| + | <pre> | ||
| + | |||
| + | <?xml version="1.0"?> | ||
| + | <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> | ||
| + | <soap:Header/> | ||
| + | <soap:Body> | ||
| + | <m:NewAccountResponse xmlns:m="http://DOMEN_NAME"> | ||
| + | <m:return xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="m:outInvoice"> | ||
| + | <m:NoDoc>00015365</m:NoDoc> | ||
| + | <m:DateInvoice>2015-02-04T00:00:00</m:DateInvoice> | ||
| + | <m:ExternalUserId>00017483</m:ExternalUserId> | ||
| + | <m:TicketsSum> | ||
| + | <m:Price>10040</m:Price> | ||
| + | <m:Discount>0</m:Discount> | ||
| + | <m:Charge>0</m:Charge> | ||
| + | <m:Sum>10040</m:Sum> | ||
| + | </m:TicketsSum> | ||
| + | </m:return> | ||
| + | </m:NewAccountResponse> | ||
| + | </soap:Body> | ||
| + | </soap:Envelope> | ||
| + | |||
| + | |||
| + | </pre> | ||
| + | </div></div> | ||
| + | |||
| + | --> | ||
Текущая версия на 14:43, 28 ноября 2018
Содержание
API Авиабилетов
Чтобы авторизоваться в системе, в запросе необходимо указать APIKey и ClientID. Эти данные можно узнать в разделе Администрирование - Веб-сервис. Авторизация. Там же можно включить/выключить нотификацию для действий, совершенных через АПИ.
API Поиска авиабилетов
Это сервис внутри Nemo, который позволяет получить результаты поиска.
Для подключения к веб-службе поиска авиабилетов необходимо открыть доступ нужному пользователю. Это можно сделать в разделе «Администрирование» ⇨ «Веб-служба. Авторизация».
Подробнее можно узнать в специальной статье Веб-служба поиска авиабилетов
API Бронирования авиабилетов
Сервис позволяет забронировать/войдировать авиабилет с использованием API, описание подключения, запроса, ответов находится в этой статье Веб-служба бронирования
API Выписки авиабилетов
Агентский АПИ выписки позволяет определить валидирующего перевозчика и значение комиссии от авиакомпании для брони, а также запустить процедуру выписки билета. Веб-служба выписки
API Оплаты
Сервис внутри Nemo, который предназначен для выполнения различных операций, относящихся к оплате заказов. Агентские АПИ оплаты
API Дополнительных запросов авиабилетов
К дополнительных запросам относятся проверка на доступность, запрос на обновление заказа, чтение тарифных правил. Дополнительные запросы АПИ авиабилетов
Используемые параметры
Параметры, используемые в запросах
| Имя элемента | Обязательный | Тип | Описание |
|---|---|---|---|
| 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 - поиск в Амадеус. |
Параметры, используемые в ответах
| Имя элемента | Обязательный | Тип | Описание |
|---|---|---|---|
| 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 Отелей
Агентский API Отелей - система, которая предоставляет возможность поиска и бронирования отелей а так же получение информации о времени и размерах штрафов, уникальной информации об отеле, получение статической информации.
Подробнее можно узнать в нашей специальной статье Агентский АПИ отелей
Выгрузки статистики продаж через API (Метапоиск)
Метапоисковая система (метапоисковая машина, метапоисковик) — это поисковая система, которая в отличие от классических поисковых машин не имеет собственной базы данных и собственного поискового индекса, а формирует поисковую выдачу за счет смешивания и переранжирования результатов поиска других поисковых систем.
В разделе статистики заказов из метапоисков можно получить данные по статистике метапоиска (по источнику переходов модуля метрики) за определенный период бронирования заказов в виде файла данных в формате XML.
Можно получить список заказов с их статусом (забронирован, выписан, аннулирован), сделанных через метапоисковую систему.
Подробнее можно узнать в статье посвященной взаимодействию с метопоисковиками Взаимодействие с метапоисковиками
Выгрузка информации о заказах
Выгрузка заказов — это экспорт данных заказа или заказов для различных компонентов системы Nemo. Модуль позволяет внешней системе получать данные по заказам для дальнейшей обработки. Подробнее о процессе выгрузки, настройках, форматах выгрузки для различных компонент можно прочитать в статье Выгрузка
API Синхронизации пользователей и субагентов
Назначение данного модуля — обеспечение взаимодействия между сторонней программой (например, системой автоматизации туроператора "САМО-тур") и Nemo в части синхронизации списка B2B-пользователей. Модуль является компонентом, включаемым и отключаемым из административной части.
О механизме авторизации B2B-пользователей, синхронизации учетных записей можно прочитать в статье Синхронизация пользователей
API Кроссавторизации
Авторизация пользователей из внешних систем — Система Nemo позволяет обращаться к ней как базе пользователей для авторизации из других систем (например форума на сайте, собственного ПО компании и т.п)
Для этого нужно подключиться к веб-службе авторизации, WSDL-описание которой располагается по адресу:
http://hostname/authorization_reol.wsdl
Запрос
?xml version ='1.0' encoding ='UTF-8' ?>
<definitions name='Authorization'
targetNamespace='http://example.org/Authorization'
xmlns:tns=' http://example.org/Authorization '
xmlns:soap='http://schemas.xmlsoap.org/wsdl/soap/'
xmlns:xsd='http://www.w3.org/2001/XMLSchema'
xmlns:soapenc='http://schemas.xmlsoap.org/soap/encoding/'
xmlns:wsdl='http://schemas.xmlsoap.org/wsdl/'
xmlns='http://schemas.xmlsoap.org/wsdl/'>
<message name='getAuthorizationRequest'>
<part name='login' type='xsd:string'/>
<part name='pass' type='xsd:string'/>
</message>
<message name='getAuthorizationResponse'>
<part name='session_id' type='xsd:string'/>
<part name='user_id' type='xsd:string'/>
<part name='login' type='xsd:string'/>
<part name='status' type='xsd:string'/>
</message>
<portType name='AuthorizationPortType'>
<operation name='getAuthorization'>
<input message='tns:getAuthorizationRequest'/>
<output message='tns:getAuthorizationResponse'/>
</operation>
</portType>
<binding name='AuthorizationBinding' type='tns:AuthorizationPortType'>
<soap:binding style='rpc'
transport='http://schemas.xmlsoap.org/soap/http'/>
<operation name='getAuthorization'>
<soap:operation soapAction='urn:xmethods-delayed-quotes#getAuthorization'/>
<input>
<soap:body use='encoded' namespace='urn:xmethods-delayed-quotes'
encodingStyle='http://schemas.xmlsoap.org/soap/encoding/'/>
</input>
<output>
<soap:body use='encoded' namespace='urn:xmethods-delayed-quotes'
encodingStyle='http://schemas.xmlsoap.org/soap/encoding/'/>
</output>
</operation>
</binding>
<service name='AuthorizationService'>
<port name='AuthorizationPort' binding='AuthorizationBinding'>
<soap:address location='http://nemo.local/controllers/authorization/auth_server.php'/>
</port>
</service>
</definitions>
Передача параметров в форму поиска (FastSearch)
В системе Nemo имеется возможность перенаправлять пользователей на страницу с уже заполненными параметрами поиска или сразу напрямую на результаты поиска.
Примеры FastSearch запросов и используемые переменные подробно описаны в статье FastSearch - передача параметров в форму
FastSearch так же работает и для отелей, подробности в статье Fast Search для отелей
