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

Интеграция

Материал из Центр поддержки системы бронировании
Версия от 13:14, 7 ноября 2017; Алина Алексеенко (обсуждение | вклад)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к навигации Перейти к поиску
Nemo logo 300 45.png

Мы можем предложить вам что-нибудь получше!

Здесь идет речь об устаревшей или замороженной функциональности.

Для интеграции Nemo.travel с другими системами имеются инструменты обмена данными.

Легкая форма на сайт

«Лёгкая форма»

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

IMG 13092012 112041.png

Настройка легкой формы

В архиве собраны все необходимые файлы для установки легкой формы на вашем сайте.

Архив легкой формы: Файл:Light-form.zip.

1. Подключить у себя на странице внутри тега <head> нужные файлы:

<link rel="stylesheet" href="css/ui.datepicker.css" type="text/css" media="screen">
<link rel="stylesheet" href="css/style.css" type="text/css" media="screen">
<script type="text/javascript" src="js/jquery-1.3.1.min.js"></script>
<script type="text/javascript" src="js/nano_loader.js"></script>

Если ранее вы использовали http://DOMAIN/static/js/jquery-1.3.1.min.js — обратите внимание на изменение пути.

Внимание! Здесь и далее замените в адресах ссылок DOMAIN на имя вашего домена!

2. Также необходимо разместить скрипт инициализации формы:

<script>
	$(document).ready(function(){
		$('#nano_flght_form').nanoLoad({
			url:"http://DOMAIN/",
			typeSearch:"RT",
			arrDate: 2,
			depDate: 7,
			outSearch: "MOW",
			inSearch: "PAR"
		});
	});
</script>

Здесь:

  • typeSearch может принимать значения OW или RT (в один конец или туда и обратно);
  • arrDate — через сколько дней вылет;
  • depDate — через сколько дней обратный вылет;
  • outSearch — текст запроса в автокомплит для предзаполнения поля "Вылет";
  • inSearch — текст запроса в автокомплит для предзаполнения поля "Прилет";

Дефолтным пунктом вылета/прилета в полях формы установится первый пункт, который подгружается в автокомплит по вводу этого текста.

3. Разместить на html-странице в желаемом месте код формы:

развернуть

Код формы

развернуть

Код стилей (их можно изменять по своему желанию)

В настройках системы (если доступно) перечислите домены, на которых будет размещена легкая форма.

Внимание! Легкая форма работает на сайтах с кодировкой UTF-8.

Сайты-спутники

Альтернативой функционалу «Легкая форма поиска» является функционал «Сайты-спутники».

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

IMG 13092012 112049.png

Для настройки функционала необходимо:

  1. Создать компанию-партнер в разделе Аккаунт менеджмент → Агенты и пользователи → Управление.
  2. В настройки этой компании-партнера в разделе Управление сайтом → Домены и протоколы указать Доменное имя сайта для загрузки настроек — доменное имя сайта компании-партнера. Здесь может быть домен второго уровня. А на домене первого уровня — на основном сайте компании-партнера можно разместить «Легкую форму» поиска.
  3. Также необходимо выполнить привязку сайта к доменному имени агентства.
  4. Стили основного сайта на сайт компании-партнера не распространяются. Их можно прописать отдельно в разделе Управление сайтом → Настройки внешнего вида.

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

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

Сервис вызывается следующим образом: http://CLIENT_DOMAIN/index.php?go=payment/bill

Подпись запроса

Подпись sig сверяется c md5($booking_id.$secret), где:

  • $booking_id — Id заказа в системе Nemo.Travel;
  • $secret — значение настройки Ключ безопасности для сервиса выставления оплаты и получения XML выгрузки в разделе Управление сайтом → Домены и протоколы.

Пример

Если

booking_id: 263330
ключ безопасности: 12345

То

sig=md5(26333012345) = a439a4492131f4b866ed1a17d018d3a6

Для фиксации оплаты получается такая ссылка:

http://CLIENT_DOMAIN/index.php?go=payment/bill&booking_id=263330&sig=a439a4492131f4b866ed1a17d018d3a6

FastSearch — передача параметров в форму

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

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

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

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

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

http://DOMAIN/?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

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

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

Подробная информация о данном функционале для отелей находится по ссылке Fast Search для отелей

Интеграция со Сторонней системой — Авторизация

В Nemo.Travel существует возможность авторизоваться в системе менеджерам агентства и субагентам, прежде не работавшим в системе, при помощи интеграции со Сторонней системой (СС).

Настраивается данный функционал в разделе: Для техподдержки → Устаревшие настройки → Реквизиты подключения, где логин и пароль используется для доступа к системе.

Shema avtopizacii.png

Пример: Интеграция с Eagle Eye — авторизация

Процесс авторизации:

  1. Пользователь на странице авторизации в системе Nemo.Travel вводит Логин и Пароль, которые отправляются в СС для авторизации.

Сценарий успешной авторизации:

  1. Если авторизация пользователя в СС прошла успешно, то идёт проверка, есть ли в базе данных пользователей Nemo.Travel пользователь с таким ID.
  2. Если такой пользователь существует в базе Nemo.Travel, то данные о пользователе и агентстве обновляются, исходя из информации, содержащейся в ответе на авторизацию.Обновляется логин и пароль.
  3. Логин пользователя Nemo.Travel может быть обновлен на актуальный.
  4. Если в Nemo.Travel отсутствует пользователь с данным ID — то происходит добавление пользователя.

Сценарий неуспешной авторизации:

  1. Если авторизация в СС прошла не успешно, то система Nemo.Travel проверяет, существует ли в СС ID для пользователя с запрашиваемым логином.
  2. Если в СС пользователь с ID был сохранен, значит данный пользователь выключен в системе СС, пользователю будет отказано в авторизации.
  3. Если в СС пользователь с данным ID отсутствует, то данного пользователя нет в системе СС и, если шаг 1 был успешным, то он авторизуется в Nemo.Travel как при обычной авторизации Nemo.Travel.

Внимание! Если в системе пытается авторизоваться субагент агентства, которое ещё не создано в системе, то в регистрации ему будет отказано, т.к. родительское агентство отсутствует.

Синхронизация данных о пользователях и компаниях

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

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

Авторизация

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

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

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

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

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

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

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

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

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

<?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 (строка) — может иметь значения:
    • oadm — администратор
    • omgr — менеджер
    • ousr — пользователь (возвращается всегда это значение)

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

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

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

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

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

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

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

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

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

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

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

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

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

См. также