Мастер-Тур(15):Программа туров. Внешние системы. Emerging Travel Group (Островок)

Версия статьи от 1-03-2024.

Поддерживаемые версии ПК «Мастер-Тур»: Начиная с 15 версии Доступна с релиза 15.8

Введение

Emerging Travel Group (Островок) – это единая платформа, для бронировании отелей и покупки авиа билетов.
Предназначена для использования цен и услуг из внешней системы без занесения их в локальную базу данных.

Системные требования

• Для корректной загрузки файлов, и обновления информации справочников – необходимо не менее 100 гигабайт свободного места на диске.
• Не менее 8 гигибайт оперативной памяти, для оптимального быстродействия.

Работа в экране «Внешние системы»

Страница Внешние системы (http://ip-адрес сервера/TourPrograms/ExternalSystems) представлена двумя вкладками:

• Внешние поставщики – раздел где происходит создание и редактирование пользователей системы;
• Синхронизация – раздел где осуществляется работа по сопоставлению данных из внешней системы.

Внешние поставщики

На вкладке Внешние поставщики представлен список поставщиков. Для каждого поставщика указан:

• Название (Задаётся при создании)
• Адаптер
• Адрес API
• Срок действия лицензии

Создание и редактирование адаптера

Любого поставщика можно отредактировать, выбрав по названию. Также можно добавить нового, нажав кнопку Добавить.

Список полей для заполнения ( * – обязательное):

• Адаптер * – значение Emerging Travel Group (отели) выбирается из списка;
• Название * – название поставщика;
• API адрес * – предоставляемый Emerging Travel Group (Островок) адрес службы поиска внешней системы;
• Логин – поле для ввода логина, полученного после заключения договора с поставщиком;
• Пароль * – поле для ввода API ключа, полученного после заключения договора с поставщиком;
• Язык * – язык который будет использоваться в названиях отелей;
  • Доступные варианты: bg - българский (болгарский); de - Deutsch (немецкий); el - Ελληνικά (греческий); en - English (английский); es - Español (испанский); fr - Français (французский); it - Italiano (итальянский); hu - Magyar (венгерский); pl - Polski (польский); pt - Português (португальский); ro - Română (румынский); ru - Русский (русский); sr - Српски (сербский); tr - Türkçe (турецкий).
• Время кэширования результатов поиска отелей в минутах - целое число, например "5", которое регулирует время кэширования данных в минутах *;
  
• Гражданство - гражданство, которое будет устанавливаться по умолчании при бронировании. Должно быть указано в формате "ru" (не более 2 симвлов), в формате ISO 3166-1 alpha-2;
• Адрес SQL сервера - адрес сервера, на котором располагается или будет располагаться база данных для загрузки справочников;
• Логин SQL сервера * – логин к серверу, на котором располагается или будет располагаться база данных для загрузки справочников;
• Пароль SQL сервера * – пароль к серверу, на котором располагается или будет располагаться база данных для загрузки справочников;
• База данных для загрузки справочников * – промежуточная база данных для загрузки справочников из внешней системы, отличная от основной. Если у клиента не заведена отдельная база данных для загрузки справочников, то достаточно указать в данном поле подходящее название, система сама создаст новую промежуточную базу данных. Из внешней системы в промежуточную базу загружаются следующие справочники:

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

• Папка для хранения данных для справочников – путь для сохранения файла от внешней системы, который нужен для загрузки данных в справочники. По умолчанию файл сохраняется в директорию: "C:\Windows\Temp". Так же возможно указать собственный путь для сохранения файла в формате: "C:\MasterTour\Ostrovok_Base\Ostrovok_Local".

• Разрешить сквозное бронирование для туристов – при включенной настройке при бронировании путевки частным лицом сразу осуществляется бронирование во внешней системе. При выключенной настройке при бронировании путевки частным лицом будет создана путевка только в ПК Мастер-Тур, при входе в путевку будет выведено предупреждение, что заявка создана без брони в системе внешнего поставщика. По умолчанию настройка включена.
  
  • Разрешить, если отмена без штрафов возможна в течение N дней с момента бронирования – количество дней можно задавать только при включенной настройке Разрешить сквозное бронирование для туристов. При выполнении условия при бронировании путевки частным лицом сразу осуществляется бронирование во внешней системе. При невыполнении условия при бронировании путевки частным лицом будет создана путевка только в ПК Мастер-Тур, при входе в путевку будет выведено предупреждение, что заявка создана без брони в системе внешнего поставщика.
    
• Разрешить сквозное бронирование для агентов – при включенной настройке при бронировании путевки агентом сразу осуществляется бронирование во внешней системе. При выключенной настройке при бронировании путевки агентом будет создана путевка только в ПК Мастер-Тур, при входе в путевку будет выведено предупреждение, что заявка создана без брони в системе внешнего поставщика. По умолчанию настройка включена.
  
  • Разрешить, если отмена без штрафов возможна в течение N дней с момента бронирования – количество дней можно задавать только при включенной настройке Разрешить сквозное бронирование для агентов. При выполнении условия при бронировании путевки агентом сразу осуществляется бронирование во внешней системе. При невыполнении условия при бронировании путевки агентом будет создана путевка только в ПК Мастер-Тур, при входе в путевку будет выведено предупреждение, что заявка создана без брони в системе внешнего поставщика.
• Дополнительные условия: при невыполнении условия отмены без штрафов, для бронирования достаточно выполнение одного из дополнительных условий ниже. При выполнении условия отмены без штрафов, дополнительные условия игнорируются.
  • Разрешить, если у агента установлен признак – признак задается в справочнике партнера. При наличии данного признака у агента при бронировании путевки сразу осуществляется бронирование во внешней системе. При отсутствии данного признака у агента при бронировании путевки будет создана путевка только в ПК Мастер-Тур, при входе в путевку будет выведено предупреждение, что заявка создана без брони в системе внешнего поставщика.
    
  • Разрешить при наличии остатка депозита у агента не менее N% от стоимости услуги, бронируемой во внешней системе – если используется данная настройка, то у агента должен быть заведен депозит. При выполнении условия при бронировании путевки агентом сразу осуществляется бронирование во внешней системе. При невыполнении условия при бронировании путевки агентом будет создана путевка только в ПК Мастер-Тур, при входе в путевку будет выведено предупреждение, что заявка создана без брони в системе внешнего поставщика.
    
• Проверка подключения - подключение к API адресу Emerging Travel Group (Островок) можно проверить по нажатию на кнопку Проверить подключение. Система производит пробное подключение к API и проверяет его доступность.
  

При сохранении внешнего поставщика Emerging Travel Group (Островок) в БД автоматически создается ценовой пакет и поставщик с названием, 
которое было введено при создании поставщика, в скобках указывается "внешняя система". Это необходимо для того, 
чтобы  была возможность внести стоимость услуги, по которой будет работать поиск (при условии, что разрешается
только бронирование услуги из внешней системы).

Получение и внесение данных от внешней системы

Внешняя система Emerging Travel Group (Островок) предоставляет данные в следующем виде:

• API адрес * – https://api.worldota.net/api/b2b/v3
• KEY ID (Логин) – 2347
• API KEY (Пароль) – fdce0674-ce4e-4342-a45d-64fb11498a3e

Синхронизация

Синхронизация служит для сопоставления справочных данных из Emerging Travel Group (Островок) со справочными данными, указанными в ПК Мастер-Тур. Для того, чтобы начать работу, нужно выбрать необходимые данные:

• В списке Поставщик выбираем интересующего поставщика (в списке отображаются названия поставщиков, созданные на вкладке Внешние поставщики);
• В списке Справочник выбираем необходимый справочник.
  

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

Слева отображаются справочные данные Emerging Travel Group (Островок). Справа отображаются справочные данные из ПК Мастер-Тур.
Данные, которые сопоставлены - подсвечены черным цветом. Не сопоставленные данные подсвечены красным цветом. Существует возможность фильтрации справочных данных по статусу ("Сопоставлен" или "Не сопоставлен") и поиска по названию.
В блоке Сопоставленные данные отображаются сопоставленные данные по выбранным элементам в левой или/и правой частях. Отображаемые данные сортируются по алфавиту. Данные можно сопоставлять и удалять сопоставление:

• Если нужно удалить сопоставление, можно воспользоваться кнопкой Удалить после нажатия данные станут не сопоставленными и подсвечены красным цветом. Если есть связанные сопоставления с удаляемой записью (к примеру, Страна->Город), то связанные сопоставления также будут удалены;
• Если нужно данные сопоставить, то есть два варианта:
  • Точечное сопоставление – т.е. нужно выбрать не сопоставленное значение (подсвеченное красным цветом) в левой части и аналогичное ему значение в правой части (или то значение, которое должно быть сопоставлено). После того как значения выбраны, станет активной кнопка Сопоставить. Нажимаем кнопку, данные станут сопоставленными и подсвечены черным цветом;
  • Автоматическое сопоставление (* – обязательное) - при нажатии кнопки Автоматическое сопоставление запускается процесс автоматического сопоставления справочников. Для TravelLine сопоставляются только следующие справочники:
    • Страны (по названию) * – обязательное сопоставление;
    • Города (по названию и стране) * – обязательное сопоставление. Возможно множественное сопоставление в обе стороны: один город из справочника Города внешней системы можно сопоставить с несколькими городами из справочника Города в ПК «Мастер-Тур»; несколько городов из справочника Города внешней системы можно сопоставить с одним городам из справочника Города в ПК «Мастер-Тур»;
    • Отели (по названию и городу) * – если было множественное сопоставление городов, то при сопоставлении отелей нужно учесть, что в фильтре подгружаются города из справочника Города в ПК «Мастер-Тур»;
    • Типы питания (по коду) – необязательное сопоставление;
    • Категории отелей (по коду) * – необязательное сопоставление;
      • Поставщик не передаёт данные о категории отелей, поэтому сопоставление не обязательно;
    • Категории номеров (по коду) * – необязательное сопоставление;
    • Валюты (по коду) * – обязательное сопоставление;
    • Типы номеров (по коду) * – из внешней системы приходит один тип номера "Без типа номера", который можно сопоставить с любым типом номера из справочника мастер-тура. Сопоставленный тип номера будет использоваться для всех категорий и типов размещений, корзина обрабатывает выбранные комбинации корректно;
      • Для более удобного сопоставления, необходимо создать в системе Мастер-тур, тип номера с количеством человек 50, с указанием всех возрастов.

Ддя корректной работы со справочниками, на стороне Мастер-Тур должен быть заполнен код ISO 3166-1 (2-х буквенный код). Полный список всех кодов указан в справочнике [[1]].

Настройка логирования

Для получения данных о работе адаптера внешнего поставщика используется логирование, настройки которого осуществляются в файле Megatec.TourSearchOwin.exe.config папки TourSearchOwin. Путь к папке лог-файлов прописывается в секции Loggers path. Включение логирования осуществляется в секции Logger level. Возможные значения: ALL или OFF.

№	Название	Описание	Настройка
1	Логирование	Разные настройки логирования отвечают за получение разной информации: HotelFromRemoteProviderMappingsLogger - включает получение информации о результатах и ошибках синхронизации HotelFromRemoteProviderMappingsAddLogger – включает получение информации о создании справочных данных и их синхронизации при бронировании HotelFromRemoteProviderErrorLogger - включает получение информации об ошибках, возникающих при работе с внешним поставщиком HotelsRemoteProviderRequestResponseLogger - включает получение информации об актуализации данных и бронировании туров SearchHotelsRemoteProviderRequestResponseLogger - включает получение информации о поисковых запросах туров	<Loggers path="Logs\"> <Logger level="ALL" name="HotelFromRemoteProviderMappingsLogger"/> <Logger level="ALL" name="HotelFromRemoteProviderMappingsAddLogger"/> <Logger level="ALL" name="HotelFromRemoteProviderErrorLogger"/> <Logger level="ALL" name="HotelsRemoteProviderRequestResponseLogger"/> <Logger level="ALL" name="SearchHotelsRemoteProviderRequestResponseLogger"/> </Loggers>

Так же настройки логирования можно задать в файле Web.config папки TourPrograms. Путь к папке лог-файлов прописывается в секции Loggers path. Включение логирования осуществляется в секции Logger level. Возможные значения: ALL или OFF.

№	Название	Описание	Настройка
2	Логирование	Разные настройки логирования отвечают за получение разной информации: HotelFromRemoteProviderMappingsLogger - включает получение информации о результатах и ошибках синхронизации, получение информации по закачке тарифов HotelFromRemoteProviderMappingsAddLogger – включает получение информации о создании справочных данных и их синхронизации при бронировании HotelFromRemoteProviderErrorLogger - включает получение информации об ошибках, возникающих при работе с внешним поставщиком HotelsRemoteProviderRequestResponseLogger - включает получение информации об актуализации данных и бронировании туров	<Loggers path="Logs\"> <Logger level="ALL" name="HotelFromRemoteProviderMappingsLogger"/> <Logger level="ALL" name="HotelFromRemoteProviderMappingsAddLogger"/> <Logger level="ALL" name="HotelFromRemoteProviderErrorLogger"/> <Logger level="ALL" name="HotelsRemoteProviderRequestResponseLogger"/> </Loggers>