Интеграция со сторонними системами АПИ: различия между версиями

Версия 18:20, 13 мая 2015

!!!СТАТЬЯ В РАЗРАБОТКЕ!!!

Содержание

1 API Авиабилетов
2 API Отелей
3 Выгрузки статистики продаж через API (Метапоиск)
4 Выгрузка информации о заказах
5 Фиксация оплаты внешним запросом
6 API универсального платежного шлюза
7 API Синхронизации пользователей и субагентов
8 API Кроссавторизации
- 8.1 Запрос
9 Передача параметров в форму поиска
10 Проверка в сторонней системе возможности тикетинга
11 Загрузка счетов из сторонней системы
- 11.1 Пример запроса
- 11.2 Пример ответа

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.

Процесс выгрузки

Схематично процесс выгрузки заказов представлен на блок-схеме.

Статусы выгрузки заказа

Коды статусов выгрузки заказа соответствуют кодам состояния HTTP. Фактически указывается последний полученный код состояния HTTP, полученный при выгрузке данных по адресу, указанному в настройках выгрузки. Коды относятся к серверу, на который происходит выгрузка заказов.

Код	Описание
0	Неизвестный ответ. Адрес для выгрузки не доступен.
200	OK — успешный запрос.
301	Запрошенный документ был окончательно перенесен на новый URI, указанный в поле Location заголовка.
403	Сервер понял запрос, но он отказывается его выполнять из-за ограничений в доступе для клиента к указанному ресурсу.
404	Сервер понял запрос, но не нашёл соответствующего ресурса по указанному URI.
422	Unprocessable Entity — сервер успешно принял запрос, может работать с указанным видом данных, в теле запроса XML-документ имеет верный синтаксис, но имеется какая-то логическая ошибка, из-за которой невозможно произвести операцию над ресурсом.
500	Любая внутренняя ошибка сервера.

Выгрузка заказа для компонента «Авиабилеты»

Для компонента «Авиабилеты» доступна выгрузка заказов в форматах Nemo и/или Софи (при включенном модуле «Выгрузка заказов Софи»).

Формат Nemo

  1 <?xml version="1.0" encoding="UTF-8"?>
  2 <PNR>
  3   <Common>
  4     <id>277749</id>
  5     <Type>FLIGHTS</Type>
  6     <Service>SABRE</Service>
  7     <Locator>SQLJNK</Locator>
  8     <ExternalId>1234567</ExternalId> <!-- Внешний идентификатор -->
  9     <Stamp>123456789</Stamp>
 10     <UtmSource>100</UtmSource> <!-- Источник перехода -->
 11     <BeginDateTime>2014.12.18-10:45</BeginDateTime>
 12     <EndDateTime>2014.12.25-16:40</EndDateTime>
 13     <TicketingDateTime>2014.12.09-15:02</TicketingDateTime>
 14     <VoidDateTime/>
 15     <TotalPrice>
 16       <Amount>10773.8</Amount>
 17       <CurrencyCode>RUB</CurrencyCode>
 18     </TotalPrice>
 19     <UserId>2964</UserId>
 20     <EEUserId/>
 21     <UserLogin>userLogin</UserLogin>
 22     <GroupId>2963</GroupId>
 23     <CompanyId>2963</CompanyId>
 24     <UserStatus>Менеджер</UserStatus>
 25     <DateCreate>2014.12.09-14:59</DateCreate>
 26     <ExtServices> <!-- Дополнительные услуги -->
 27       <ExtService>
 28         <Type>AeroExpress</Type>
 29         <Price>
 30           <Amount>1440</Amount>
 31           <CurrencyCode>RUB</CurrencyCode>
 32         </Price>
 33       </ExtService>
 34       <ExtService>
 35         <Type>AlphaInsurance</Type>
 36         <Price>
 37           <Amount>480</Amount>
 38           <CurrencyCode>RUB</CurrencyCode>
 39         </Price>
 40         <Insurances>
 41           <Insurance>
 42             <Number>Z694.198TEST.2765282</Number>
 43             <Fio>IVANOV IVAN</Fio>
 44           </Insurance>
 45           <Insurance>
 46             <Number>Z694.198TEST.2765283</Number>
 47             <Fio>PETROV PETR</Fio>
 48           </Insurance>
 49         </Insurances>
 50       </ExtService>
 51     </ExtServices>
 52   </Common>
 53   <Payment>
 54     <Title>Testpay</Title>
 55     <Method>Testpay</Method>
 56     <BillingId>117607091</BillingId>
 57     <Date>2014-12-09 15:00:39</Date>
 58     <CreateDate>2014-12-09 15:00:34</CreateDate>
 59     <Status>ticket</Status>
 60     <PenaltyDate/>
 61     <Timelimit>2014-12-10 14:59:55</Timelimit>
 62     <PaymentCharge> <!-- Сбор платежного шлюза -->
 63       <Amount>313.8</Amount>
 64       <CurrencyCode>RUB</CurrencyCode>
 65     </PaymentCharge>
 66     <Charge> <!-- Общий сбор минус сбор платежного шлюза -->
 67       <Amount>1920</Amount>
 68       <CurrencyCode>RUB</CurrencyCode>
 69     </Charge>
 70     <BaseFare> <!-- Тариф -->
 71       <Amount>1600</Amount>
 72       <CurrencyCode>RUB</CurrencyCode>
 73     </BaseFare>
 74     <Book> <!-- Тариф плюс таксы -->
 75       <Amount>8540</Amount>
 76       <CurrencyCode>RUB</CurrencyCode>
 77     </Book>
 78     <Penalty>
 79       <Amount>0</Amount>
 80       <CurrencyCode>RUB</CurrencyCode>
 81     </Penalty>
 82     <Total>
 83       <Amount>10773.8</Amount>
 84       <CurrencyCode>RUB</CurrencyCode>
 85     </Total>
 86     <Commission>
 87       <Amount>0</Amount>
 88       <CurrencyCode>RUB</CurrencyCode>
 89     </Commission>
 90     <PaidValue>
 91       <Amount>10773.8</Amount>
 92       <CurrencyCode>RUB</CurrencyCode>
 93     </PaidValue>
 94   </Payment>
 95   <Client>
 96     <LastName/>
 97     <Name>SIDOROV PETR</Name>
 98     <MiddleName/>
 99     <Number/>
100     <Birth/>
101     <Email>mail@host.com</Email>
102     <Phone>+74950000000</Phone>
103   </Client>
104   <PassengersCount>2</PassengersCount>
105   <Passengers>
106     <Passenger>
107       <passenger_type>ADT</passenger_type>
108       <lastname>IVANOV</lastname>
109       <name>IVAN</name>
110       <gender>F</gender>
111       <date_of_birth>12.12.1987</date_of_birth>
112       <doc_type>C</doc_type>
113       <passport_number>1234567890</passport_number>
114       <currency_of_passport>24.03.2023</currency_of_passport>
115       <middlename/>
116       <passenger_id>37667</passenger_id>
117       <nationality>RU</nationality>
118       <email>mail@host.com</email>
119       <Tickets>
120         <Active>0</Active>
121         <Seg/>
122         <Num>5553984070962</Num>
123         <Date>2014-12-09 16:01:00</Date>
124       </Tickets>
125       <Tickets>
126         <Active>1</Active>
127         <Seg/>
128         <Num>5553984070964</Num>
129         <Date>2014-12-09 16:03:00</Date>
130       </Tickets>
131       <PriceInfo>
132         <BaseFare>
133           <Amount>800</Amount>
134           <CurrencyCode>RUB</CurrencyCode>
135         </BaseFare>
136         <TotalFare>
137           <Amount>4270</Amount>
138           <CurrencyCode>RUB</CurrencyCode>
139         </TotalFare>
140         <Commission>
141           <Amount>0</Amount>
142           <CurrencyCode>RUB</CurrencyCode>
143         </Commission>
144         <AirlineCommission>
145           <Amount>0</Amount>
146           <CurrencyCode>RUB</CurrencyCode>
147         </AirlineCommission>
148       </PriceInfo>
149     </Passenger>
150     <Passenger>
151       <passenger_type>ADT</passenger_type>
152       <doc_type>C</doc_type>
153       <middlename/>
154       <passenger_id>37668</passenger_id>
155       <lastname>PETROV</lastname>
156       <name>PETR</name>
157       <gender>M</gender>
158       <date_of_birth>20.12.1984</date_of_birth>
159       <passport_number>1234567899</passport_number>
160       <currency_of_passport>20.12.2029</currency_of_passport>
161       <nationality>RU</nationality>
162       <email>mail@host.com</email>
163       <Tickets>
164         <Active>0</Active>
165         <Seg/>
166         <Num>5553984070963</Num>
167         <Date>2014-12-09 16:01:00</Date>
168       </Tickets>
169       <Tickets>
170         <Active>1</Active>
171         <Seg/>
172         <Num>5553984070965</Num>
173         <Date>2014-12-09 16:03:00</Date>
174       </Tickets>
175       <PriceInfo>
176         <BaseFare>
177           <Amount>800</Amount>
178           <CurrencyCode>RUB</CurrencyCode>
179         </BaseFare>
180         <TotalFare>
181           <Amount>4270</Amount>
182           <CurrencyCode>RUB</CurrencyCode>
183         </TotalFare>
184         <Commission>
185           <Amount>0</Amount>
186           <CurrencyCode>RUB</CurrencyCode>
187         </Commission>
188         <AirlineCommission>
189           <Amount>0</Amount>
190           <CurrencyCode>RUB</CurrencyCode>
191         </AirlineCommission>
192       </PriceInfo>
193     </Passenger>
194   </Passengers>
195   <FlightType>Внутренний</FlightType>
196   <OrderInfo>
197     <Info>
198       <Company>Аэрофлот - Российские авиалинии</Company>
199       <CompanyCode>SU</CompanyCode>
200       <OperatingCompanyCode>FV</OperatingCompanyCode>
201       <StartDate>2014.12.18</StartDate>
202       <StartTime>10:45</StartTime>
203       <StartDayOfWeek>Thursday</StartDayOfWeek>
204       <FlightNumber>6128 (FV6128)</FlightNumber>
205       <StartAirportCode>VKO</StartAirportCode>
206       <StartAirportName>Внуково, Москва</StartAirportName>
207       <StartCountry>Россия</StartCountry>
208       <StartCountryCode>RU</StartCountryCode>
209       <EndAirportCode>LED</EndAirportCode>
210       <EndAirportName>Санкт-Петербург, Пулково</EndAirportName>
211       <EndCountry>Россия</EndCountry>
212       <EndCountryCode>RU</EndCountryCode>
213       <Time>1:30</Time>
214       <Equip>
215         <Name>Airbus 319</Name>
216         <Type>319</Type>
217       </Equip>
218       <ClassType>economy</ClassType>
219       <ClassTypeCode>R</ClassTypeCode>
220       <Meal/>
221     </Info>
222     <Info>
223       <Company>Аэрофлот - Российские авиалинии</Company>
224       <CompanyCode>SU</CompanyCode>
225       <OperatingCompanyCode>FV</OperatingCompanyCode>
226       <StartDate>2014.12.25</StartDate>
227       <StartTime>15:10</StartTime>
228       <StartDayOfWeek>Thursday</StartDayOfWeek>
229       <FlightNumber>6153 (FV6153)</FlightNumber>
230       <StartAirportCode>LED</StartAirportCode>
231       <StartAirportName>Санкт-Петербург, Пулково</StartAirportName>
232       <StartCountry>Россия</StartCountry>
233       <StartCountryCode>RU</StartCountryCode>
234       <EndAirportCode>VKO</EndAirportCode>
235       <EndAirportName>Внуково, Москва</EndAirportName>
236       <EndCountry>Россия</EndCountry>
237       <EndCountryCode>RU</EndCountryCode>
238       <Time>1:30</Time>
239       <Equip>
240         <Name>Airbus 319</Name>
241         <Type>319</Type>
242       </Equip>
243       <ClassType>economy</ClassType>
244       <ClassTypeCode>R</ClassTypeCode>
245       <Meal/>
246     </Info>
247   </OrderInfo>
248   <Remarks>Debit</Remarks>
249 </PNR>

Ремарка <Remarks>Debit</Remarks> является не обязательной, означает что заказ был оплачен с помощью способа оплаты «Депозит»; если же заказ был оплачен с использованием депозитного кредита, и депозит ушел в минус даже на 1 руб., то будет <Remarks>Credit</Remarks>.

Элемент <TotalFare> возвращает стоимость уже оплаченного заказа. Если же заказ забронирован, но не оплачен, то значение будет 0 RUB.

Элемент <CreateDate> в зависимости от состояния брони возвращает время окончания бронирования, если бронирование было завершено, иначе возвращает время создания брони.

Формат поддерживает возможность передачи нескольких номеров электронных билетов на одного пассажира (в том числе войдированных и аннулированных).

Формат Софи

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <order_snapshot xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 3   <header currency="RUB" time_gmt="2015-01-13 08:10:54" time="2015-01-13 12:10:54" ord_id="279307" corp_ord_id="MKQFBZ" site="2806"/>
 4   <customer email="cepogilixe@lackmail.net" phone="XXXX9048" name="" corp_code="2806"/>
 5   <products>
 6     <product>
 7      <!--@stamp - валидатор. Парсится из заказа(Сирена и Галилео). Если получить из ГДС не удалось, то передаётся валидатор, настроенный в реквизитах подключения к ГДС.-->
 8       <air_ticket_prod prod_id="0" psg_type="A" title="Москва - Ленинград" taxes="1776" fare="400" origin="MOW" service_fee="100" form_owner="SU" validating_carrier="SU" destination="LED" comission="0.4" stamp="92354802">
 9         <air_seg segment_id="0" carrier="SU" flight_number="6128" op_carrier="FV" departure_datetime="2015-01-16 10:45:00" arrival_datetime="2015-01-16 12:15:00" departure_airport="VKO" arrival_airport="LED" fare_basis="RPROWRF"/>
10       </air_ticket_prod>
11     </product>
12     <product>
13       <ral_ticket_prod rsrv_id="2496500" prod_id="200" origin="Киевский вокзал" destination="Внуково, Москва" departure_datetime="2015-01-16 06:45:00" cartype="standart" fare="360"/>
14     </product>
15     <product>
16       <service_prod prod_id="300" provider_type="INSURANCE" provider_id="AlphaInsurance" offer_type="alpha_insurance" ext_id="Z694.198TEST.2774397" price="100" count="1" psgr_id="0"/>
17     </product>
18     <product>
19       <payment_prod price="123"/>
20     </product>
21   </products>
22   <reservations>
23     <reservation rsrv_id="279307" crs="SABRE" rloc="MKQFBZ"/>
24     <reservation rsrv_id="2496500" crs="AeroExpress" rloc="218812"/>
25   </reservations>
26   <passengers>
27     <passenger doc_number="1234567890" psgr_id="0" doc_country="RU" psgr_type="A" doc_type="C" birth_date="1990-01-04" name="IVAN" gender="M" first_name="IVANOV"/>
28   </passengers>
29   <travel_docs>
30     <travel_doc>
31       <air_ticket_doc tkt_oper="TKT" tkt_number="5555871998698" tkt_date="2015-01-13 12:10:50" prod_id="0" psgr_id="0" issuingAgent="2807"/>
32     </travel_doc>
33     <travel_doc>
34       <aex_doc rsrv_id="2496500" prod_id="200" psgr_id="0" tkt_oper="TKT" tkt_date="2015-01-13 12:10:54" tkt_number="394612"/>
35     </travel_doc>
36     <travel_doc>
37       <insur_doc main_prod_id="0" prod_id="300" psgr_id="0" tkt_oper="TKT" tkt_date="2015-01-13 12:10:54" tkt_number="Z694.198TEST.2774397"/>
38     </travel_doc>
39   </travel_docs>
40   <payments>
41     <payment pay_id="117607839" pay_oper="PAY" pay_time="2015-01-13 12:09:52" psp_code="024" psp_name="Rapida" psp_pay_id="" pay_system="ES" amount="2859" fop="CA"/>
42   </payments>
43 </order_snapshot>

service_fee — сбор агентский (только сервисный сбор, не включает в себя сбор за эквайринг).
comission - комиссия АК
stamp - код Валидатора в ПСС, берется из настроек Немо, если в настройках он не указан, то не передается.
ord_id — идентификатор заказа в НЕМО
corp_ord_id — PNR из ГДС
site — идентификатор агентства в Немо
payment pay_id — номер биллинга Немо.
pay_system — код платежной системы
- SB — для сбербанка
- ES — для Рапиды
- UNT — для Юнителлера
cardholder — держатель карты.
expire_date — срок действия карты, у тех ПШ, что не приходит в ответе — пустой.
card_number — номер карты, в формате: 415481XXXXXX1734
approval_code — код подтверждения.
payment_prod price — сбор за эквайринг.
main_prod_id - ID основного продукта (авиабилета).
tkt_number - номер полиса для пассажира;
tkt_date - дата и время операции;
tkt_oper - тип операции (TKT/REF).
provider_type - тип поставщика (INSURANCE).
provider_id - AlphaInsurance;
offer_type - название полиса;
price - цена полиса для пассажира;
rloc - номер заказа у поставщика.

Выгрузка заказа для компонента «Отели»

Для компонента «Отели» доступна выгрузка заказов в формате Nemo.

Формат Nemo

  1 <?xml version="1.0" encoding="UTF-8"?>
  2 <PNR>
  3    <Common>
  4       <id>263462</id>
  5       <Type>HOTELS</Type>
  6       <Service>ACADEM</Service>
  7       <Locator>3028655</Locator>
  8       <BeginDateTime>2014.04.15-00:00</BeginDateTime>
  9       <EndDateTime>2014.04.16-00:00</EndDateTime>
 10       <TotalPrice>
 11          <Amount>1950</Amount>
 12          <CurrencyCode>RUB</CurrencyCode>
 13       </TotalPrice>
 14       <UserId>123</UserId>
 15       <EEUserId />
 16       <UserLogin>userLogin</UserLogin>
 17       <GroupId>332</GroupId>
 18       <UserStatus>Менеджер</UserStatus>
 19       <DateCreate>2014.03.21-16:11</DateCreate>
 20    </Common>
 21    <Payment>
 22       <Status>booked</Status>
 23       <PenaltyDate>2014.04.13-00:00</PenaltyDate>
 24       <Timelimit>2014-04-13 00:00:00</Timelimit>
 25       <Charge>
 26          <Amount>0</Amount>
 27          <CurrencyCode>RUB</CurrencyCode>
 28       </Charge>
 29       <Book>
 30          <Amount>1950</Amount>
 31          <CurrencyCode>RUB</CurrencyCode>
 32       </Book>
 33       <Penalty>
 34          <Amount>0</Amount>
 35          <CurrencyCode>RUB</CurrencyCode>
 36       </Penalty>
 37       <Total>
 38          <Amount>1950</Amount>
 39          <CurrencyCode>RUB</CurrencyCode>
 40       </Total>
 41       <Commission>
 42          <Amount>112</Amount>
 43          <CurrencyCode>RUB</CurrencyCode>
 44       </Commission>
 45       <PaidValue>
 46          <Amount>0</Amount>
 47          <CurrencyCode>RUB</CurrencyCode>
 48       </PaidValue>
 49    </Payment>
 50    <Client>
 51       <LastName>Сидоров</LastName>
 52       <Name>Владимир</Name>
 53       <MiddleName>Константинович</MiddleName>
 54       <Number>1806326598</Number>
 55       <Birth>1987-05-20</Birth>
 56       <Email>mail@host.com</Email>
 57       <Phone>+79871234567</Phone>
 58    </Client>
 59    <Passengers>
 60       <Passenger>
 61          <nationality>RU</nationality>
 62          <lastname>IVANOV</lastname>
 63          <name>IVAN</name>
 64       </Passenger>
 65    </Passengers>
 66    <Info>
 67       <Name>Интурист</Name>
 68       <City>
 69          <Code>34</Code>
 70          <Name>Великий Новгород</Name>
 71       </City>
 72       <Location />
 73       <StarRating>3</StarRating>
 74       <Days>2</Days>
 75       <Nights>1</Nights>
 76       <CheckInDate>2014.04.15</CheckInDate>
 77       <CheckOutDate>2014.04.16</CheckOutDate>
 78       <CheckInTime>14:00</CheckInTime>
 79       <CheckOutTime>12:00</CheckOutTime>
 80       <OnRequest>false</OnRequest>
 81    </Info>
 82    <Rooms>
 83       <Room>
 84          <Name>Двухместный стандарт (две кровати)</Name>
 85          <Type>SNGL</Type>
 86          <FareId>1</FareId>
 87       </Room>
 88    </Rooms>
 89    <Fares>
 90       <Fare>
 91          <Id>1</Id>
 92          <Price>
 93             <Amount>1950</Amount>
 94             <CurrencyCode>RUB</CurrencyCode>
 95          </Price>
 96          <Meals>Завтрак "Шведский стол",Отсутствует</Meals>
 97          <Description>Одноместный</Description>
 98       </Fare>
 99    </Fares>
100    <CancelCharges>
101       <Charge>
102          <DateFrom>2014.04.13-00:00</DateFrom>
103          <DateTo>2014.04.15-00:00</DateTo>
104          <Amount>1488</Amount>
105          <CurrencyCode>RUB</CurrencyCode>
106       </Charge>
107    </CancelCharges>
108    <ModifyCharges />
109    <ModificationMethods>
110       <Method>MOD_PASS_NAMES</Method>
111       <Method>MOD_DATES</Method>
112    </ModificationMethods>
113 </PNR>

Выгрузка заказа для компонента «ЖД»

Для компонента «ЖД» доступна выгрузка заказов в формате Nemo.

Формат Nemo

  1 <?xml version="1.0" encoding="UTF-8"?>
  2 <PNR>
  3    <Common>
  4       <id>123456</id>
  5       <Type>TRAINS</Type>
  6       <Service>UFS</Service>
  7       <Locator>64345987</Locator>
  8       <BeginDateTime>2014.04.26-00:15</BeginDateTime>
  9       <EndDateTime>2014.04.26-13:33</EndDateTime>
 10       <TicketingDateTime>2014.06.06-15:10</TicketingDateTime>
 11       <VoidDateTime>2014.06.07-14:19</VoidDateTime>
 12       <TotalPrice>
 13          <Amount>57505.8</Amount>
 14          <CurrencyCode>RUB</CurrencyCode>
 15       </TotalPrice>
 16       <UserId>123</UserId>
 17       <EEUserId />
 18       <UserLogin>mikhalevtur</UserLogin>
 19       <GroupId>122</GroupId>
 20       <UserStatus>Менеджер</UserStatus>
 21       <DateCreate>2014.04.24-15:03</DateCreate>
 22    </Common>
 23    <Payment>
 24       <Title>Testpay</Title>
 25       <Method>Testpay</Method>
 26       <BillingId>117603370</BillingId>
 27       <Date>2014-04-24 15:10:12</Date>
 28       <CreateDate>2014-06-06 15:10:00</CreateDate>
 29       <Status>cancelled</Status>
 30       <PenaltyDate />
 31       <Timelimit>2014-04-24 15:18:01</Timelimit>
 32       <Charge>
 33          <Amount>52278</Amount>
 34          <CurrencyCode>RUB</CurrencyCode>
 35       </Charge>
 36       <Book>
 37          <Amount>5227.8</Amount>
 38          <CurrencyCode>RUB</CurrencyCode>
 39       </Book>
 40       <Penalty>
 41          <Amount>0</Amount>
 42          <CurrencyCode>RUB</CurrencyCode>
 43       </Penalty>
 44       <TotalAgencyChargeForRefund>
 45          <Amount>100</Amount>
 46          <CurrencyCode>RUB</CurrencyCode>
 47       </TotalAgencyChargeForRefund>
 48       <Total>
 49          <Amount>57505.8</Amount>
 50          <CurrencyCode>RUB</CurrencyCode>
 51       </Total>
 52       <PaidValue>
 53          <Amount>0</Amount>
 54          <CurrencyCode>RUB</CurrencyCode>
 55       </PaidValue>
 56    </Payment>
 57    <Client>
 58       <LastName>Сидоров</LastName>
 59       <Name>Владимир</Name>
 60       <MiddleName>Константинович</MiddleName>
 61       <Number>1806326598</Number>
 62       <Birth>1987-05-20</Birth>
 63       <Email>mail@host.com</Email>
 64       <Phone>+79871234567</Phone>
 65    </Client>
 66    <Passengers>
 67       <Passenger>
 68          <name>Владимир</name>
 69          <middlename>Константинович</middlename>
 70          <phone>
 71             <country />
 72             <city />
 73             <number>+79271031610</number>
 74             <expansion />
 75          </phone>
 76          <email>mlsdsar@gmail.com</email>
 77          <nationality>RU</nationality>
 78          <passenger_type>ADT</passenger_type>
 79          <lastname>Сидоров</lastname>
 80          <doc_type>C</doc_type>
 81          <passport_number>1806326598</passport_number>
 82          <passenger_id>1</passenger_id>
 83          <gender>M</gender>
 84          <date_of_birth>20.04.1984</date_of_birth>
 85          <TotalPrice>28752.9</TotalPrice>
 86          <FarePrice>2613.9</FarePrice>
 87          <Charge>26139</Charge>
 88          <RefundMoney>8649.3</RefundMoney>
 89          <ChargeForRefund>100</ChargeForRefund>
 90          <TicketNumber>74944708487545</TicketNumber>
 91          <SeatNumber>033</SeatNumber>
 92          <HasSeat>true</HasSeat>
 93       </Passenger>
 94       <Passenger>
 95          <nationality>RU</nationality>
 96          <middlename>Константинович</middlename>
 97          <passenger_type>ADT</passenger_type>
 98          <lastname>Сидоров</lastname>
 99          <name>Иван</name>
100          <doc_type>C</doc_type>
101          <passport_number>1806326554</passport_number>
102          <passenger_id>2</passenger_id>
103          <gender>M</gender>
104          <date_of_birth>05.04.1984</date_of_birth>
105          <TotalPrice>28752.9</TotalPrice>
106          <FarePrice>2613.9</FarePrice>
107          <Charge>26139</Charge>
108          <TicketNumber />
109          <SeatNumber>034</SeatNumber>
110          <HasSeat>true</HasSeat>
111       </Passenger>
112    </Passengers>
113    <Info>
114       <trainNumber>098ХА</trainNumber>
115       <trainName />
116       <departureStation>МОСКВА КАЗ</departureStation>
117       <arrivalStation>КАЗАНЬ ПАС</arrivalStation>
118       <trainCategory>1</trainCategory>
119       <beginStation>Москва</beginStation>
120       <endStation>Казань</endStation>
121       <startDate>2014-04-26 00:15:00</startDate>
122       <endDate>2014-04-26 13:33:00</endDate>
123       <timeInRoad>47880</timeInRoad>
124       <carNumber>8</carNumber>
125       <carType>4</carType>
126       <choosenSeats>
127          <type>
128             <lower>1</lower>
129          </type>
130          <type>
131             <upper>1</upper>
132          </type>
133          <type>
134             <lower_side>0</lower_side>
135          </type>
136          <type>
137             <upper_side>0</upper_side>
138          </type>
139          <type>
140             <undefined>0</undefined>
141          </type>
142       </choosenSeats>
143       <choosenRange>
144          <start>0</start>
145          <end>0</end>
146       </choosenRange>
147       <serviceClass>В стоимость входит - постельное белье. Наличие установки кондиционирования воздуха не гарантировано.</serviceClass>
148    </Info>
149 </PNR>

Элемент PNR Элемент PNR — Passenger Name Record — запись, состоящая из группы отдельных элементов (полей), содержащих информацию об одном или более пассажирах, путешествующих вместе, и деталях путешествия.

Элемент	Описание	Допустимые значения
Common	Общая информация по заказу.	Элементы id, Type, Service, Locator, BeginDateTime, EndDateTime, TicketingDateTime, TotalPrice, UserId, EEUserId, UserLogin, GroupId, UserStatus, DateCreate.
Payment	Информация о стоимости, штрафах, статусе заказа.	Элементы Status, PenaltyDate, Timelimit, Charge, Book, Penalty, Total, PaidValue.
Client	Информация о заказчике.	Элементы Name, MiddleName, Number, Birth, Email, Phone.
Passengers	Записи о пассажирах.	Элементы Passenger.
Info	Типовая информация по заказу в контексте услуги.	Элементы trainNumber, trainName, departureStation, arrivalStation, trainCategory, beginStation, endStation, startDate, endDate, timeInRoad, carNumber, carType, choosenSeats, choosenRange, serviceClass.

Элемент Common

Элемент	Описание	Допустимые значения
id	Номер заказа в Немо.	Число. Пример: 268281.
Type	Тип услуги.	Строка: Пример: FLIGHTS. Допустимые значения: FLIGHTS — авиа, HOTELS — отели, TRAINS — ЖД.
Service	Поставщик услуги.	Строка. Пример: UFS.
Locator	Идентификатор в системе поставщика.	Число. Пример: 65525140.
BeginDateTime	Дата и время отправления первого сегмента.	Дата и время. Пример: 2014.03.06-00:15.
EndDateTime	Дата и время прибытия последнего сегмента.	Дата и время. Пример: 2014.03.06-13:33.
TicketingDateTime	Дата и время выписки билета.	Дата и время. Пример: 2014.10.17-17:23
VoidDateTime	Дата и время возврата билета.	Дата и время. Пример: 2014.10.17-17:23
TotalPrice	Общая стоимость заказа.	Элементы Amount — номинал стоимости, CurrencyCode — валюта стоимости.
UserId	Идентификатор пользователя в системе Немо, оформившего заказ.	Число. Пример: 123.
UserLogin	Логин пользователя в системе Немо, оформившего заказ.	Строка. Пример: userLogin.
GroupId	Идентификатор группы пользователя в системе Немо, оформившего заказ.	Число. Пример: 122.
UserStatus	Тип пользователя в системе Немо.	Строка. Пример: Менеджер.
DateCreate	Дата и время резервирования в системе поставщика.	Дата и время. Пример: 2014.03.05-15:08

Элемент TotalPrice

Элемент	Описание	Допустимые значения
Amount	Номинал.	Число. Пример: 1884.
CurrencyCode	Валюта.	Строка (Код ISO 4217 alfa-3). Пример: RUB.

Элемент Payment

Элемент	Описание	Допустимые значения
Title	Название платежного шлюза^*.	Строка. Пример: Testpay.
Method	Тип формы оплаты^*.	Строка. Пример: Testpay.
BillingId	Идентификатор транзакции Немо.	Строка. Пример: 117603370.
Date	Дата и время оплаты платежной транзакции Немо.	Строка. Пример: 2014-04-24 15:10:12.
CreateDate	Дата и время создания платежной транзакции Немо.	Строка. Пример: 2014-06-06 15:10:00.
Status	Статус заказа в системе Немо.	Строка. Пример: booked. Допустимые значения: pending — в ожидании, booked — зарезервирован, ticket — выписан, cancelled — отменен.
PenaltyDate	Дата и время наступления штрафных санкций.	Дата и время. Пример: 2014-03-05 15:23:40.
Timelimit	Таймлимит на оплату и подтверждение заказа.	Дата и время. Пример: 2014-03-05 15:23:40.
Charge	Сбор агентства.	См. элемент Common.TotalPrice.
Book	Тариф.	См. элемент Common.TotalPrice.
Penalty	Штраф. Внимание! На данный момент параметр неактуален и при выгрузке всегда принимает нулевое значение.	См. элемент Common.TotalPrice.
TotalAgencyChargeForRefund	Общий сбор агентства за возврат.	См. элемент Common.TotalPrice.
Total	Общая стоимость.	См. элемент Common.TotalPrice.
PaidValue	Оплачено.	См. элемент Common.TotalPrice.

^* — список возможный платежных шлюзов:
Acquiro, Chronopay, Copayco, CourierNew, Deposit, EasyPay, GatelineNew, ITransfer, Invoice, Offices, PayU, Payture, Platron, PrivatBank, Qiwi, Rapida, Receipt, Sberbank, Sirena, Sirena2, UnitellerNew, WebMoney.

Элемент Client

Элемент	Описание	Допустимые значения
Name	Фамилия и имя заказчика.	Строка. Пример: Иванов Иван.
MiddleName	Отчество заказчика.	Строка. Пример: Иванович.
Number	Серия и номер документа.	Строка. Пример: 1806123456.
Birth	Дата рождения заказчика.	Дата. Пример: 1984-06-30.
Email	Адрес электронной почты заказчика.	Строка. Пример: client@host.com.
Phone	Номер телефона заказчика.	Строка. Пример: +74951234567

Элемент Passenger

Элемент	Описание	Допустимые значения
lastname	Фамилия пассажира.	Строка. Пример: Сидоров.
name	Имя пассажира.	Строка. Пример: Владимир.
middlename	Отчество пассажира.	Строка. Пример: Константинович.
doc_type	Тип документа.	Строка. Пример: C. Допустимые значения: C — Российский паспорт P — Заграничный паспорт A — Иностранный документ S — Паспорт моряка M — Военный билет B — Свидетельство о рождении
passport_number	Серия и номер документа.	Строка. Пример: 1806123456.
gender	Пол пассажира.	Строка. Пример: M. Допустимые значения: M — мужской F — женский
date_of_birth	Дата рождения пассажира.	Дата. Пример: 20.05.1987.
nationality	Гражданство пассажира.	Строка (ISO 3166-1 Alpha-2). Пример: RU.
passenger_type	Тип пассажира.	Строка. Пример: ADT. Допустимые значения: ADT — взрослый CLD — ребенок до 10 лет^{, } INF — ребенок до 5 лет^{, ***}
passenger_id	Порядковый номер пассажира в заказе.	Число. Пример: 2.
TotalPrice	Общая стоимость билета со сборами для данного пассажира.	Число. Пример: 1934.
FarePrice	Стоимость по тарифу тарифу.	Число. Пример: 1884.
Charge	Сбор агентства.	Число. Пример: 50.
RefundMoney	Сумма к возврату. Значение, полученное от поставщика, уменьшенное на сумму сбора агентства за возврат.	Число. Пример: 1643.
ChargeForRefund	Cбор агентства за возврат.	Число. Пример: 100.
TicketNumber	Номер билета.	Число. Пример: 73944708472624.
SeatNumber	Номер места.	число. Пример: 21.
TariffType	Наименование тарифа.	Строка. Пример: ПОЛНЫЙ.
HasSeat	Занимает ли пассажир отдельное место.	Допустимые значения: true — с местом, false — без места.

^* — Не включая верхний предел. Возраст ребенка определяется на день совершения поездки.

^** — Нижний и верхний пределы определяются видом сообщения:

от 5 до 10 лет — Внутригосударственное сообщение, а также международное сообщение со странами-участниками СНГ, Литовской, Латвийской, Эстонской Республиками, Республикой Абхазия.
от 6 до 17 лет — Международное сообщение в дальнем зарубежье по глобальным ценам. Направление Россия-Финляндия.
от 4 до 12 лет — Международное сообщение в дальнем зарубежье по глобальным ценам. Направление Восток-Запад.

^*** — Верхний предел определяется видом сообщения:

до 5 лет — Внутригосударственное сообщение, а также международное сообщение со странами-участниками СНГ, Литовской, Латвийской, Эстонской Республиками, Республикой Абхазия.
до 6 лет — Международное сообщение в дальнем зарубежье по глобальным ценам. Направление Россия-Финляндия.
до 4 лет — Международное сообщение в дальнем зарубежье по глобальным ценам. Направление Восток-Запад.

Элемент Passenger

Элемент	Описание	Допустимые значения
trainNumber	Номер поезда.	Строка. Пример: 098ХА.
trainName	Имя фирменного поезда. Приходит от поставщика.	Строка. Пример: Россия.
departureStation	Станция отправления пассажира.	Строка. Пример: МОСКВА КАЗ.
arrivalStation	Станция прибытия пассажира.	Строка. Пример: КАЗАНЬ ПАС.
trainCategory	Тип поезда.	Число. Пример: 1. Допустимые значения: 0 — неизвестный тип поезда 1 — скорый поезд 2 — фирменный поезд 3 — скоростной поезд 4 — фирменный скоростной поезд
beginStation	Начальная станция в маршруте поезда.	Строка. Пример: Казань
endStation	Конечная станция в маршруте поезда.	Строка. Пример: Москва
startDate	Дата и время отправления со станции отправления пассажира.	Дата и время. Пример: 2014-03-06 00:15:00.
endDate	Дата и время прибытия со станции отправления пассажира.	Дата и время. Пример: 2014-03-06 13:33:00.
timeInRoad	Время в пути от станции отправления до станции прибытия пассажира.	Число (секунд). Пример: 47880.
carNumber	Номер вагона.	Число. Пример: 7.
carType	Тип вагона.	Число. Пример: 1. Допустимые значения: 1 - общий вагон 2 - сидячий вагон 3 - плацкарта 4 - купе 5 - люкс 6 - мягкий 7 - неизвестный тип
choosenSeats	Элемент описывает количество нижних, нижних боковых, верхних, верхних боковых мест.	Элементы type.
choosenRange	Выбранный диапазон мест в вагоне.	Элементы start, end.
serviceClass	Описание услуг. Приходит от поставщика.	Текст. Пример: В стоимость входит - постельное белье. Наличие установки кондиционирования воздуха не гарантировано.

Элемент type

Элемент	Описание	Допустимые значения
lower	Количество нижних мест.	Число. Пример: 1.
upper	Количество верхних мест.	Число. Пример: 0.
lower_side	Количество нижних боковых мест.	Число. Пример: 1.
upper_side	Количество верхних боковых мест.	Число. Пример: 1.
undefined	Количество мест неопределенного типа.	Число. Пример: 0.

Элемент choosenRange

Элемент	Описание	Допустимые значения
start	Начало выбранного диапазон мест в вагоне^*.	Число. Пример: 4.
end	Конец выбранного диапазон мест в вагоне^*.	Число. Пример: 17.

^* — Если диапазон не был зада пользователем на этапе выбора мест, то поля start и end будут содержать нули.

Пакетный экспорт заказов по категориям в формате Nemo

Сервис выгрузки заказов позволяет экспортировать интересующие выборки по заказам в формате XML. Например, можно выбрать все заказы по дате бронирования и получить информацию по ним в XML-виде.

Экспорт заказов под авторизованным пользователем (в личном кабинете)

Фильтры пакетного экспорта заказов в личном кабинете

Порядок пользования сервисом:

Перейти в личный кабинет
В адресной строке браузера к текущему адресу дописать параметр &exportxml. Должен получиться адрес вида:
```
http://DOMAIN/index.php?go=poffice/table&exportxml
```
После обновления страницы под блоком фильтров должна появиться кнопка «Экспортировать в XML». При ее нажатии на странице появляется предложение сохранить в XML-файл выборку отфильтрованных заказов.

Выгружаются только заказы выбранного пользователя/компании с учетом примененных параметров фильтра.

Пользователь может произвести выгрузку только своих заказов.

Пакетный экспорт заказов по категориям в формате СОФИ

Для использования выгрузки заказов в формате СОФИ у агентства должен быть включен модуль "Выгрузка заказов Софи" и заданы настройки:

"Тип выгрузки СОФИ" должен иметь значение "Выгрузка заказов СОФИ" или должна быть включена настройка "Выгрузка одновременно и Nemo, и Софи",
Должен быть указан "Url скрипта для выгрузки в формате СОФИ",
Должен быть указан "Код сайта в системе СОФИ".

Выгрузка конкретного заказа:

http://DOMAIN/booking__sofi_export_bookings&booking_id=123456
где booking_id — номер заказа в системе Немо.

Выгрузка заказов забронированных за определенный период:

http://DOMAIN/booking__sofi_export_bookings&date_begin=01.01.2014&date_end=01.01.2015
где [date_begin; date_end] — период бронирования заказа (забронированные заказы с датой бронирования совпадающей с началом/окончанием периода, заданного в запросе, попадают в экспорт), формат — дд.мм.гггг.

Фиксация оплаты внешним запросом

!!! не нашел, есть просто фиксация оплаты, но это вроде немного не то !!!

API универсального платежного шлюза

!!! сказано спросить у КШ, я спросил, у него нет информации !!!

API Синхронизации пользователей и субагентов

Назначение данного модуля — обеспечение взаимодействия между сторонней программой (например, системой автоматизации туроператора "САМО-тур") и Nemo в части синхронизации списка B2B-пользователей.

Модуль является компонентом, включаемым и отключаемым из административной части.

Авторизация B2B-пользователей

Все B2B-пользователи, загруженные через модуль взаимодействия со сторонней программой, будут иметь случайным образом сгенерированный криптостойкий пароль. Механизм авторизации работает следующим образом:

1.Система пытается авторизовать пользователя через собственную службу авторизации. 2.В случае неудачи, но присутствия в системе введенного логина, она должна попытаться авторизовать пользователя во внешней службе авторизации («САМО-тур»), при включенном компоненте взаимодействия с «САМО-тур». 3.В случае неудачного опознавания пользователя выводится соответствующее сообщение и процедура может быть повторена путем повторного ввода логина и пароля.

Регистрация неудачных попыток входа производится только в двух случаях:

Компонент взаимодействия выключен.
Компонент взаимодействия включен и провалены обе попытки авторизации (внутренней и внешней).

Для сторонней авторизации пользователей в системе Nemo внешняя программа должна иметь веб-службу, основанную на WSDL определенного формата. Ссылка на веб-службу прописывается в настройках системы Nemo на странице конфигурации интеграции с внешней системой.

Для импортированных пользователей в Nemo имеется поле «Идентификатор внешней системы», который отвечает за сопоставление с ID пользователя в сторонней системе. Для менеджеров агентств оно равно номеру партнера (агента) во внешней системе, для пользователей — номеру пользователя в «САМО-туре».

Для пользователей, имеющих какое-либо значение в поле «идентификатор во внешней системе», запрещен функционал смены пароля или его восстановления по электронной почте.

Пример запросов и ответов на авторизацию:

Request

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
 xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <getAuthorization xmlns="http://tempuri.org/">
      <login>string</login>
      <pass>string</pass>
    </getAuthorization>
  </soap12:Body>
</soap12:Envelope>

Response

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <getAuthorizationResponse xmlns="http://tempuri.org/">
      <getAuthorizationResult>
        <session_id>string</session_id>
        <user_id>string</user_id>
        <login>string</login>
        <status>string</status>
      </getAuthorizationResult>
    </getAuthorizationResponse>
  </soap12:Body>
</soap12:Envelope>

Сервис реализует функцию «getAuthorization», на вход которой передается конструкция «getAuthorizationRequest»:

login (строка) - введенный пользователем логин
pass (строка) - введенный пользователем пароль

Функция должна отдавать системе конструкцию getAuthorizationResponse:

session_id (строка) - пустое значение
user_id (строка) - идентификатор менеджера в системе «САМО-тур»
login (строка) - логин пользователя (для контроля)
status (строка) - может иметь значения:

1. adm - администратор 2. mgr - менеджер 3. usr - пользователь (возвращается всегда это значение)

Импорт и синхронизация учетных записей

Со стороны внешней системы должно быть приложение, отправляющее в формате XML данные по учетным записям B2B-клиентов (агентств и пользователей). Со стороны Nemo имеется скрипт, который принимает XML в формате, приведенном в описании документов, передаваемых в Nemo, с ключом авторизации, определенным в Nemo в административной части модуля.

Передаваемые элементы с описанием учетных записей и партнеров имеют аккаунт (Account ID) во внешней системе и атрибут action, который может быть в состоянии update или delete, т.е. обновления/добавления и удаления, соответственно.

В административной части модуля в Nemo задается ключ авторизации для защиты от несанкционированного доступа. Значение не должно быть пустым.

Скрипт получает данные об обновлении и добавлении (проходят как одно и то же действие) или удалении информации по аккаунту. XML-данные могут содержать несколько элементов.

Описание передаваемых в Nemo XML-документов:

<?xml version="1.0" encoding="UTF-8" ?>
<changes key="ключ_авторизации">
    <accounts> - список изменений по аккаунтам пользователей
        <item id=3 partnerId=10 action="update" admin="1">
            <login>Логин пользователя</login>
        </item>
        <item id=6 partnerId=15 action="update">
            ...
        </item>
        <item id=9 partnerId=30 action="delete" />
    </accounts>
    <partners> - список изменений по партнерам
        <item id=140 action="update">
            <name>Название агентства</name>
            <ofname>Официальное Название агентства</ofname>
            <phone>Телефон</phone>
            <tax>Форма налогообложения</tax>
            <group>123</group>
            <code>ABCD</item>
  </partners></changes></code>

При импорте информации об агентствах будут возвращаться следующие значения:

Поле во внешней системе	Путь к элементу xml	Тип данных	Сопоставляемое поле в Nemo	Примечание
Идентификатор партнера	/changes/partners/item[@id]	Целое число	Идентификатор во внешней системе для менеджера / администратора
Название юридического лица	/changes/partners/item/ofname	Строка	Полное официальное название юридического лица	Необходимо для выписки счетов юридическими лицами
Сокращенное название	/changes/partners/item/name	Строка	Имя агентства
Код агентства	/changes/partners/item/code	Строка	Используется при создании логина администратора
Номер группы в самотуре	/changes/partners/item/group	Целое число, либо пусто	На основании таблицы сопоставлений (см. ниже) определяется, к какой группе агентство принадлежит в Nemo
Форма налогообложения	/changes/partners/item/tax	Целое число, равное идентификатору во внешней системе

Для каждого возвращенного агентства Nemo проверяет наличие его в своей базе. Если агентство не найдено, то создается новое, для него создается менеджер (админ) с логином ABCD-1234, где ABCD – буквенный идентификатор партнера во внешней системе, 1234 — id партнера во внешней системе. Пароль генерируется случайный и криптостойкий.

Если агентство найдено, то в случае необходимости производится обновление всех полей на основании данных из внешней системы. Если изменился буквенный код агентства, то Nemo переименовывает менеджера в соответствии с новым кодом. При импорте информации о пользователях агентств в Nemo будут посылаться следующие поля:

Поле во внешней системе	Путь к элементу xml	Тип данных	Сопоставляемое поле в Nemo	Примечание
Идентификатор пользователя	/changes/accounts/item[@id]	Целое число	Идентификатор внешней системы	Храним как дополнительное поле
Идентификатор партнера	/changes/accounts/item[@partnerId]	Целое число	Идентификатор внешней системы менеджера агентства
Логин	/changes/accounts/item/login	Строка	Логин пользователя
Администратор	/changes/accounts/item[@admin]	0 - нет, 1 - да	Эксперт по бронированию

Для каждого возвращенного пользователя Nemo проверяет наличие его в своей базе. Если пользователь не найден, то создается новый. Пароль генерируется случайный и криптостойкий.

Если пользователь найден, то в случае необходимости производится обновление всех полей на основании данных из внешней системы. При запросе на удаление пользователя, в Nemo указанный логин удаляться не будет в целях сохранения целостности старых данных, а просто помечается как удаленный, и логин переименовывается и становится вида [логин_пользователя]_X_[числовой идентификатор_пользователя в Само].

<item id=[идентификатор] action="delete" />

Таблица сопоставлений групп

В административной части Nemo надо создать отдельную страницу, на которой можно сопоставить имеющиеся группы в Nemo номерам групп в САМО-тур (поле group в XML). Выводится список существующих групп для текущего (корневого) агентства.

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>

Передача параметров в форму поиска

Описанная функциональность не входит в стандартную поставку системы.

Для получения возможности использовать ее, пожалуйста, обратитесь в коммерческий отдел.

В системе Nemo имеется возможность перенаправлять пользователей на страницу с уже заполненными параметрами поиска или сразу напрямую на результаты поиска.

Применение

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

Также, при указании всех необходимых параметров, пользователя можно перебрасывать сразу на процесс поиска авиабилетов с указанными критериями.

Для использования заполнения формы из URL следует включить опцию: Администрирование → Настройки системы → Включить FastSearch (передачу параметров поиска)

После этого можно использовать ссылки на форму поиска вида

http://SITEMANE/?trip_type=OW&out_iata=MOW&in_iata=BER&departure_date=21.10.2009&adults=1&children=0&input_vendors=SU,PS&param_by_get=on

Переменные FastSearch

Имена полей - такие же как имена инпутов на поисковой форме.

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

Переменные, которые предполагают в качестве значения "true" можно просто не включать в запрос, чтобы их логика не отработала.

Форма поиска

Чтобы перенаправить пользователя на страницу с заполненными параметрами поиска, необходимо указать get-параметр &param_by_get=on, иначе сработают стандартные предустановки полей формы поиска.

Процесс поиска

Если вы указываете все необходимые для поиска параметры, то для того чтобы отправить пользователя сразу на результаты поиска, нужно указать get-параметр &fast_search=on.

Маршрут «В одну сторону» и «Туда и обратно»

Элемент

Переменная

Допустимые значения

Тип маршрута

trip_type

OW	В одну сторону
RT	Туда и обратно
CR	Сложный маршрут

Пункт вылета

out_iata

MOW	Код аэропорта ИАТА

Пункт прилета

in_iata

LED	Код аэропорта ИАТА

Дата вылета

departure_date

25.10.2013	Дата в формате ДД.ММ.ГГГГ

Дата обратного вылета

back_departure_date

27.10.2013	Дата в формате ДД.ММ.ГГГГ

Время вылета

prefered_departure_type

not_important	Любое время
morning	Утром
afternoon	Днем
evening	Вечером
night	Ночью

Время обратного вылета

prefered_back_departure_type

not_important	Любое время
morning	Утром
afternoon	Днем
evening	Вечером
night	Ночью

Поиск только среди прямых рейсов ("Без пересадок")

direct

true

Дополнительные параметры

Элемент

Переменная

Допустимые значения

Нижнее ограничение по цене по умолчанию

money_from

0	Целое число большее либо равное 0

Верхнее ограничение по цене по умолчанию

money_to

10000	Целое число большее 0

Поиск в окружных датах

district_date

true

Диапазон соседних дат +(-) [дней]

date_range

1	Целое число большее [1..3]

Поиск по соседним аэропортам

district_airport

true

Класс обслуживания

class

econom	Перелет эконом-классом
business	Перелет бизнес-классом
first	Перелет первым-классом

Фильтр по авиакомпании

input_vendors

SU,PS	Коды авиакомпании ИАТА через запятую без пробелов

Сортировка

sort

price	По стоимости
out_date	По расписанию
company	По авиакомпании
fltduration	По длительности перелёта

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

! Данные переменные применимы только для сложного маршрута (trip_type=CR).

[X] - номера отдельных перелетов. Нумерация начинается с 0, что означает первый перелет.

Максимальное количество сегментов для сложного маршрута определяется одноименной настройкой в разделе Авиабилеты ⇨ Поиск ⇨ Ограничения поиска.

Элемент

Переменная

Допустимые значения

Пункты вылета

cr_iata[0]

cr_iata[1]
...
cr_iata[8]

MOW

Код аэропорта ИАТА

Пункты прилета

cr_back_iata[0]

cr_back_iata[1]
...
cr_back_iata[8]

LED

Код аэропорта ИАТА

Дата вылета

cr_date[0]

cr_date[1]
...
cr_date[8]

25.10.2013

Дата в формате ДД.ММ.ГГГГ

Время вылета

cr_pref_departure[0]

cr_pref_departure[1]
...
cr_pref_departure[8]

not_important	Любое время
morning	Утром
afternoon	Днем
evening	Вечером
night	Ночью

Класс обслуживания

cr_class[0]

cr_class[1]
...
cr_class[8]

econom	Перелет эконом-классом
business	Перелет бизнес-классом
first	Перелет первым классом

Окружные аэропорты (±XX км)

cr_district_airport[0]

cr_district_airport[1]
...
cr_district_airport[8]

true

Пассажиры

Элемент

Переменная

Допустимые значения

Взрослых от 12 лет

adults

1	Целое число большее либо равное 0

Детей от 2 до 12 лет

children

1	Целое число большее либо равное 0

Младенцев до 2 лет

infants

1	Целое число большее либо равное 0

Младенцев с местом до 2 лет

infants_seat

1	Целое число большее либо равное 0

Молодых от 12 до 24 лет

youths

1	Целое число большее либо равное 0 ! Данный параметр доступен только в новой базовой теме.

Пожилых от 65 лет

seniors

1	Целое число большее либо равное 0 ! Данный параметр доступен только в новой базовой теме.

Примеры FastSearch запросов

В одну сторону (простой)

Рейс в одну сторону из Москвы в Париж, дата вылета: 25.10.2013, без пересадок, 1 взрослый

форма поиска

http://SITEMANE/?trip_type=OW&out_iata=MOW&in_iata=PAR&departure_date=25.10.2013
&direct=true&adults=2&param_by_get=on

процесс поиска

http://SITEMANE/?trip_type=OW&out_iata=MOW&in_iata=PAR&departure_date=25.10.2013
&direct=true&adults=2&param_by_get=on&fast_search=on

В одну сторону (с фильтрами по авиакомпаниям)

Рейс в одну сторону из Москвы в Париж, дата вылета 25.10.2013, Пассажиры: пожилых - 2, Авиакомпании: Аэрофлот - Российские авиалинии, Международные Авиалинии Украины

форма поиска

http://SITEMANE/?trip_type=OW&out_iata=MOW&in_iata=PAR&departure_date=25.10.2013
&seniors=2&input_vendors=SU,PS&param_by_get=on

процесс поиска

http://SITEMANE/?trip_type=OW&out_iata=MOW&in_iata=PAR&departure_date=25.10.2013
&seniors=2&input_vendors=SU,PS&param_by_get=on&fast_search=on

Туда-обратно

Рейсы туда-обратно Москва ↔ Париж, дата вылета: 25.10.2013, обратно: 27.10.2013, класс перелета: Эконом, Пассажиры: взрослых - 2 младенцев - 1

форма поиска

http://SITEMANE/?trip_type=RT&out_iata=MOW&in_iata=PAR&departure_date=25.10.2013
&back_departure_date=27.10.2013&class=econom&adults=2&infants=1&param_by_get=on

процесс поиска

http://SITEMANE/?trip_type=RT&out_iata=MOW&in_iata=PAR&departure_date=25.10.2013
&back_departure_date=27.10.2013&class=econom&adults=2&infants=1&param_by_get=on&fast_search=on

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

из Москвы в Париж, дата вылета 25.10.2013,
из Парижа в Санкт-Петербург, дата вылета 26.10.2013,
из Санкт-Петербурга в Москву, дата вылета 29.10.2013,
1 взрослый

форма поиска

http://SITEMANE/?trip_type=CR
&cr_iata[0]=MOW&cr_back_iata[0]=PAR&cr_date[0]=25.10.2013
&cr_iata[1]=PAR&cr_back_iata[1]=LED&cr_date[1]=26.10.2013
&cr_iata[2]=LED&cr_back_iata[2]=MOW&cr_date[2]=29.10.2013
&adults=1&param_by_get=on

процесс поиска

http://SITEMANE/?trip_type=CR
&cr_iata[0]=MOW&cr_back_iata[0]=PAR&cr_date[0]=25.10.2013
&cr_iata[1]=PAR&cr_back_iata[1]=LED&cr_date[1]=26.10.2013
&cr_iata[2]=LED&cr_back_iata[2]=MOW&cr_date[2]=29.10.2013
&adults=1&param_by_get=on&fast_search=on

Взаимодействие FastSearch и Метрики

Для того, чтобы переход был зарегистрирован системой как переход с определенного источника, необходимо передать в запросе дополнительный параметр utm_source (Metrics Session ID). Например:

http://SITEMANE/?(some_parameters=vals&)utm_source=source_alias

где source_alias - алиас источника переходов. Дополнительная информация по использованию модуля Метрики.

Пример FastSearch запроса с параметром для модуля Метрики

FastSearch (с учетом источника перехода для модуля Метрики)

Рейс в одну сторону из Москвы в Париж, дата вылета: 25.10.2013, без пересадок, 1 взрослый (с учетом источника перехода для модуля Метрики).

форма поиска

http://SITEMANE/?trip_type=OW&out_iata=MOW&in_iata=PAR&departure_date=25.10.2013
&direct=true&adults=2&param_by_get=on&utm_source=source_alias

процесс поиска

http://SITEMANE/?trip_type=OW&out_iata=MOW&in_iata=PAR&departure_date=25.10.2013
&direct=true&adults=2&param_by_get=on&fast_search=on&utm_source=source_alias

Проверка в сторонней системе возможности тикетинга

При выписки билета через стороннюю систему 1С, отправляется запрос "GetDebtCounterparty", который спрашивает, можно ли с счета в 1С списать средства для оплаты. В ответе содержится заключение от 1С, в случае если ошибок нет, в ответе будет

<m:Opportunity>Да</m:Opportunity>

Пример запроса "GetDebtCounterparty"

<?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>

Пример ответа "GetDebtCounterparty"

<?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>

Загрузка счетов из сторонней системы

При взаимодействии с веб-сервисом 1С, на этапе бронирования отправляется запрос, на создание аккаунта 1С, содержащий в себе данные счета. В системе логирования этот запрос можно найти под именем «[GDS] Запрос "NewAccount"» и ответ «[GDS] Ответ "NewAccount"»

Пример запроса


<?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>

Пример ответа


<?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>

@@ Строка 688: / Строка 688: @@
 В разделе статистики заказов из метапоисков можно получить данные по статистике метапоиска (по источнику переходов модуля метрики) <u>за определенный период бронирования заказов</u> в виде файла данных в формате XML.
-Можно получить статистику метапоиска как для агентства, так и для субагентств.
+Можно получить список заказов с их статусом (забронирован, выписан, аннулирован), сделанных через метапоисковую систему.
-=== Статистика продаж ===
+Подробнее можно узнать в статье посвященной взаимодействию с метопоисковиками [[Взаимодействие с метапоисковиками]]
-Можно получить список заказов с их статусом (забронирован, выписан, аннулирован), сделанных через метапоисковую систему.
 ==Выгрузка информации о заказах ==

Интеграция со сторонними системами АПИ: различия между версиями

Версия 18:20, 13 мая 2015

Содержание

API Авиабилетов

API Поиска авиабилетов

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

API Выписки авиабилетов

API Оплаты

API Дополнительных запросов авиабилетов

Используемые параметры

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

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

API Отелей

Выгрузки статистики продаж через API (Метапоиск)

Выгрузка информации о заказах

Процесс выгрузки

Статусы выгрузки заказа

Выгрузка заказа для компонента «Авиабилеты»

Формат Nemo

Формат Софи

Выгрузка заказа для компонента «Отели»

Формат Nemo

Выгрузка заказа для компонента «ЖД»

Формат Nemo

Пакетный экспорт заказов по категориям в формате Nemo

Экспорт заказов под авторизованным пользователем (в личном кабинете)

Пакетный экспорт заказов по категориям в формате СОФИ

Фиксация оплаты внешним запросом

API универсального платежного шлюза

API Синхронизации пользователей и субагентов

Авторизация B2B-пользователей

Импорт и синхронизация учетных записей

Таблица сопоставлений групп

API Кросс­авторизации

Запрос

Передача параметров в форму поиска

Применение

Переменные FastSearch

Форма поиска

Процесс поиска

Маршрут «В одну сторону» и «Туда и обратно»

Дополнительные параметры

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

Пассажиры

Примеры FastSearch запросов

Взаимодействие FastSearch и Метрики

Пример FastSearch запроса с параметром для модуля Метрики

Проверка в сторонней системе возможности тикетинга

Загрузка счетов из сторонней системы

Пример запроса

Пример ответа

Навигация

Поиск

API Кроссавторизации