Мастер-Тур(15):Программа туров. Внешние системы. The DOME (ITravex) — различия между версиями

Материал из Megatec
Перейти к: навигация, поиск
[досмотренная версия][досмотренная версия]
м (Biryukov переименовал страницу Мастер-Тур(15):Программа туров. Внешние системы. iTravex в [[Мастер-Тур(15):Программа туров. Внешние системы. The DOME (IT…)
Строка 7: Строка 7:
 
</td></tr></table><br>
 
</td></tr></table><br>
 
==Введение==
 
==Введение==
Адаптер внешней системы '''iTravex''' предназначен для использования цен из внешней системы без занесения их на локальную БД.
+
Адаптер внешней системы '''The DOME (ITravex)''' предназначен для использования цен из внешней системы без занесения их на локальную БД.
  
 
==Работа в экране «Внешние системы»==
 
==Работа в экране «Внешние системы»==
Строка 27: Строка 27:
  
 
Список полей для заполнения ( * – обязательное):
 
Список полей для заполнения ( * – обязательное):
* Адаптер * – значение iTravex (отели) выбирается из списка;
+
* Адаптер * – значение ITravex (отели) выбирается из списка;
 
* Название * – название поставщика;
 
* Название * – название поставщика;
* API адрес * – предоставляемый iTravex адрес службы поиска внешней системы;
+
* API адрес * – предоставляемый The DOME (ITravex) адрес службы поиска внешней системы;
* Код туроператора * – предоставляемый iTravex код компании внутри внешней системы;
+
* Код туроператора * – предоставляемый The DOME (ITravex) код компании внутри внешней системы;
* Логин – предоставляемый iTravex логин, по которому будет происходить подключение к внешней системе;  
+
* Логин – предоставляемый The DOME (ITravex) логин, по которому будет происходить подключение к внешней системе;  
* Пароль – предоставляемый iTravex пароль к логину, по которому будет происходить подключение к внешней системе;
+
* Пароль – предоставляемый The DOME (ITravex) пароль к логину, по которому будет происходить подключение к внешней системе;
 
* Время кэширования результатов поиска отелей в минутах *.
 
* Время кэширования результатов поиска отелей в минутах *.
Подключение к API адресу iTravex можно проверить по нажатию на кнопку '''Проверить подключение'''. Система производит пробное подключение к API и проверяет его доступность.
+
Подключение к API адресу The DOME (ITravex) можно проверить по нажатию на кнопку '''Проверить подключение'''. Система производит пробное подключение к API и проверяет его доступность.
  
  При сохранении внешнего поставщика iTravex в БД автоматически создается ценовой пакет и поставщик с названием,  
+
  При сохранении внешнего поставщика The DOME (ITravex) в БД автоматически создается ценовой пакет и поставщик с названием,  
 
  которое было введено при создании поставщика, в скобках указывается "внешняя система". Это необходимо для того,  
 
  которое было введено при создании поставщика, в скобках указывается "внешняя система". Это необходимо для того,  
 
  чтобы  была возможность внести стоимость услуги, по которой будет работать поиск (при условии, что разрешается  
 
  чтобы  была возможность внести стоимость услуги, по которой будет работать поиск (при условии, что разрешается  
Строка 43: Строка 43:
 
===Синхронизация===
 
===Синхронизация===
  
Синхронизация служит для сопоставления справочных данных из iTravex со справочными данными, указанными в '''ПК Мастер-Тур'''. Для того, чтобы начать работу, нужно выбрать необходимые данные:
+
Синхронизация служит для сопоставления справочных данных из The DOME (ITravex) со справочными данными, указанными в '''ПК Мастер-Тур'''. Для того, чтобы начать работу, нужно выбрать необходимые данные:
 
* В списке '''Поставщик''' выбираем интересующего поставщика (в списке отображаются названия поставщиков, созданные на вкладке Внешние поставщики);
 
* В списке '''Поставщик''' выбираем интересующего поставщика (в списке отображаются названия поставщиков, созданные на вкладке Внешние поставщики);
 
* В списке '''Справочник''' выбираем необходимый справочник.
 
* В списке '''Справочник''' выбираем необходимый справочник.
Строка 49: Строка 49:
 
[[Файл:Nr046.png|Новый поставщик]]<br/>
 
[[Файл:Nr046.png|Новый поставщик]]<br/>
  
Слева отображаются справочные данные iTravex. Справа отображаются справочные данные из '''ПК Мастер-Тур'''.<br/>  
+
Слева отображаются справочные данные The DOME (ITravex). Справа отображаются справочные данные из '''ПК Мастер-Тур'''.<br/>  
 
Данные, которые сопоставлены - подсвечены черным цветом. Не сопоставленные данные подсвечены красным цветом. Существует возможность фильтрации справочных данных по статусу ("Сопоставлен" или "Не сопоставлен") и поиска по названию.<br/>  
 
Данные, которые сопоставлены - подсвечены черным цветом. Не сопоставленные данные подсвечены красным цветом. Существует возможность фильтрации справочных данных по статусу ("Сопоставлен" или "Не сопоставлен") и поиска по названию.<br/>  
 
В блоке '''Сопоставленные данные''' отображаются сопоставленные данные по выбранным элементам в левой или/и правой частях. Отображаемые данные сортируются по алфавиту. Данные можно сопоставлять и удалять сопоставление:
 
В блоке '''Сопоставленные данные''' отображаются сопоставленные данные по выбранным элементам в левой или/и правой частях. Отображаемые данные сортируются по алфавиту. Данные можно сопоставлять и удалять сопоставление:
Строка 55: Строка 55:
 
* Если нужно данные сопоставить, то есть два варианта:
 
* Если нужно данные сопоставить, то есть два варианта:
 
** Точечное сопоставление - т.е. нужно выбрать не сопоставленное значение (подсвеченное красным цветом) в левой части и аналогичное ему значение в правой части (или то значение, которое должно быть сопоставлено). После того как значения выбраны, станет активной кнопка '''Сопоставить'''. Нажимаем кнопку, данные станут сопоставленными и подсвечены черным цветом;
 
** Точечное сопоставление - т.е. нужно выбрать не сопоставленное значение (подсвеченное красным цветом) в левой части и аналогичное ему значение в правой части (или то значение, которое должно быть сопоставлено). После того как значения выбраны, станет активной кнопка '''Сопоставить'''. Нажимаем кнопку, данные станут сопоставленными и подсвечены черным цветом;
** Автоматическое сопоставление ('''*''' – обязательное) - при нажатии кнопки Автоматическое сопоставление запускается процесс автоматического сопоставления справочников. Для iTravex сопоставляются только следующие справочники:
+
** Автоматическое сопоставление ('''*''' – обязательное) - при нажатии кнопки Автоматическое сопоставление запускается процесс автоматического сопоставления справочников. Для The DOME (ITravex) сопоставляются только следующие справочники:
 
*** '''Страны (по названию) *''' – обязательное сопоставление
 
*** '''Страны (по названию) *''' – обязательное сопоставление
 
*** '''Города (по названию и стране) *''' – обязательное сопоставление
 
*** '''Города (по названию и стране) *''' – обязательное сопоставление
Строка 72: Строка 72:
 
==Работа в системе==
 
==Работа в системе==
  
После того, как создан внешний поставщик и данные из iTravex синхронизированы с данными '''ПК "Мастер-Тур"''', нужно создать тур, в который будут добавлены услуги от внешнего поставщика. Рассмотрим на примере создания тура, в котором содержится услуга - Отель/круиз.
+
После того, как создан внешний поставщик и данные из The DOME (ITravex) синхронизированы с данными '''ПК "Мастер-Тур"''', нужно создать тур, в который будут добавлены услуги от внешнего поставщика. Рассмотрим на примере создания тура, в котором содержится услуга - Отель/круиз.
  
 
===Создание услуги проживания и нового тура===
 
===Создание услуги проживания и нового тура===
Строка 88: Строка 88:
 
[[Файл:Nr047.png|Пример тура с услугой от внешнего поставщика]]<br /><br />
 
[[Файл:Nr047.png|Пример тура с услугой от внешнего поставщика]]<br /><br />
  
* При выборе подходящих данных в [[Мастер-Тур(15):Поиск вариантов программ туров|поиске вариантов программ туров]] система начнет искать туры с отелями из внешней системы iTravex.
+
* При выборе подходящих данных в [[Мастер-Тур(15):Поиск вариантов программ туров|поиске вариантов программ туров]] система начнет искать туры с отелями из внешней системы The DOME (ITravex).
  
 
[[Файл:Nr050.png|1000px|Поиск тура с отелем из внешней системы]]<br /><br />
 
[[Файл:Nr050.png|1000px|Поиск тура с отелем из внешней системы]]<br /><br />
Строка 96: Строка 96:
 
[[Файл:Nr048.png|1000px|Пример тура в поиске]]<br /><br />
 
[[Файл:Nr048.png|1000px|Пример тура в поиске]]<br /><br />
  
* При нажатии на цену, пользователь переходит в экран "Корзина", где может оформить бронирование тура с отелем из внешней системы iTravex. При этом будет указан размер штрафа, выплачиваемый за аннуляцию путевки до указанной даты.
+
* При нажатии на цену, пользователь переходит в экран "Корзина", где может оформить бронирование тура с отелем из внешней системы The DOME (ITravex). При этом будет указан размер штрафа, выплачиваемый за аннуляцию путевки до указанной даты.
  
 
[[Файл:Nr051.png|1000px|Бронирование тура в корзине]]<br /><br />
 
[[Файл:Nr051.png|1000px|Бронирование тура в корзине]]<br /><br />
Строка 110: Строка 110:
 
===Расчет скидок, наценок и доплат===
 
===Расчет скидок, наценок и доплат===
  
Пользователь может завести наценку или доплату на тур с проживанием из внешней системы. По умолчанию все цены из iTravex считаются комиссионными, поэтому на них действуют скидка покупателю при наличии [[Мастер-Тур:База данных «Партнеры»#Комиссия партнера|комиссии партнера]], однако стоит учитывать, что рассчитывается только для тех цен из внешней системы iTravex, к которым применены наценки.  
+
Пользователь может завести наценку или доплату на тур с проживанием из внешней системы. По умолчанию все цены из The DOME (ITravex) считаются комиссионными, поэтому на них действуют скидка покупателю при наличии [[Мастер-Тур:База данных «Партнеры»#Комиссия партнера|комиссии партнера]], однако стоит учитывать, что рассчитывается только для тех цен из внешней системы The DOME (ITravex), к которым применены наценки.  
  
 
[[Файл:Nr054.png|1000px|Наценка на услугу проживания от внешнего поставщика]]<br /><br />
 
[[Файл:Nr054.png|1000px|Наценка на услугу проживания от внешнего поставщика]]<br /><br />
Строка 120: Строка 120:
 
Общий алгоритм применения для разных вариантов скидок, наценок и доплат при их наличии таков:
 
Общий алгоритм применения для разных вариантов скидок, наценок и доплат при их наличии таков:
  
* Получение цены из iTravex -> начисление комиссионной доплаты -> начисление комиссионной наценки на цену и доплату -> вычитание скидки по комиссии партнера с цены, наценки и доплаты;  
+
* Получение цены из The DOME (ITravex) -> начисление комиссионной доплаты -> начисление комиссионной наценки на цену и доплату -> вычитание скидки по комиссии партнера с цены, наценки и доплаты;  
* Получение цены из iTravex -> начисление некомиссионной доплаты -> начисление некомиссионной наценки на цену и доплату -> вычитание скидки по комиссии партнера с цены;  
+
* Получение цены из The DOME (ITravex) -> начисление некомиссионной доплаты -> начисление некомиссионной наценки на цену и доплату -> вычитание скидки по комиссии партнера с цены;  
* Получение цены из iTravex -> начисление некомиссионной доплаты -> начисление комиссионной наценки на цену ->  вычитание скидки по комиссии партнера с цены и наценки;  
+
* Получение цены из The DOME (ITravex) -> начисление некомиссионной доплаты -> начисление комиссионной наценки на цену ->  вычитание скидки по комиссии партнера с цены и наценки;  
* Получение цены из iTravex -> начисление комиссионной доплаты -> начисление некомиссионной наценки на цену -> вычитание скидки по комиссии партнера с цены и доплаты.
+
* Получение цены из The DOME (ITravex) -> начисление комиссионной доплаты -> начисление некомиссионной наценки на цену -> вычитание скидки по комиссии партнера с цены и доплаты.
  
 
==Настройка логирования==
 
==Настройка логирования==

Версия 14:21, 25 сентября 2019

Версия статьи от 25-09-2019.

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


Введение

Адаптер внешней системы The DOME (ITravex) предназначен для использования цен из внешней системы без занесения их на локальную БД.

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

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

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

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

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

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

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

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

Новый поставщик

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

  • Адаптер * – значение ITravex (отели) выбирается из списка;
  • Название * – название поставщика;
  • API адрес * – предоставляемый The DOME (ITravex) адрес службы поиска внешней системы;
  • Код туроператора * – предоставляемый The DOME (ITravex) код компании внутри внешней системы;
  • Логин – предоставляемый The DOME (ITravex) логин, по которому будет происходить подключение к внешней системе;
  • Пароль – предоставляемый The DOME (ITravex) пароль к логину, по которому будет происходить подключение к внешней системе;
  • Время кэширования результатов поиска отелей в минутах *.

Подключение к API адресу The DOME (ITravex) можно проверить по нажатию на кнопку Проверить подключение. Система производит пробное подключение к API и проверяет его доступность.

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

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

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

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

Новый поставщик

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

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

Пример сопоставления

Работа в системе

После того, как создан внешний поставщик и данные из The DOME (ITravex) синхронизированы с данными ПК "Мастер-Тур", нужно создать тур, в который будут добавлены услуги от внешнего поставщика. Рассмотрим на примере создания тура, в котором содержится услуга - Отель/круиз.

Создание услуги проживания и нового тура

Создаем услугу Отель/Круиз от внешнего поставщика:

  • Во вкладке Внешние поставщики создаем удаленного поставщика, например ITravex и у нас автоматически создается ценовой пакет, который называется ITravex(внешняя система), поэтому в экране Выбор ценового пакета нужно выбрать именно этот ценовой пакет (т.е. услугу, подбираемую у внешнего поставщика, обязательно нужно заводить в ценовом пакете, созданном при создании внешнего поставщика).
  • Выбираем поставщика - выбираем именного внешнего поставщика. Он так же появляется в БД "Партнеры" автоматически, при создании внешнего поставщика во вкладке Внешние поставщики. В нашем случае это поставщик ITravex(внешняя система).
  • Затем выбираем тип услуги Отель/Круиз. Страну и город проживания выбираем те, которые нас интересуют для подбора отеля или круиза. Для нашего примера выберем страну Испанию и город Барселону.
  • При необходимости у пользователя есть возможности занести собственные цены на отели из внешней системы в экране Цены на отели ПК "Мастер-Тур".

Добавление услуги проживания от внешнего поставщика

Пример тура с услугой от внешнего поставщика

Поиск тура с отелем из внешней системы

  • В итоге получаем тур для поиска, в котором услуга Отель\Круиз будет подбираться от удаленного поставщика (т.е. в подобранном проживании страна и город будут соответствовать стране и городу проживания, заведенным в услуге Отель/Круиз от удаленного поставщика. Все остальные параметры услуги могут отличаться).

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

  • При нажатии на цену, пользователь переходит в экран "Корзина", где может оформить бронирование тура с отелем из внешней системы The DOME (ITravex). При этом будет указан размер штрафа, выплачиваемый за аннуляцию путевки до указанной даты.

Бронирование тура в корзине

  • После бронирования пользователь переходит в экран Информация о заказе, где может увидеть всю информацию по своей путевке, включая сумму штрафа за аннуляцию.

Информация о заказе

Если были найдены справочные данные из внешней системы, которые еще не сопоставлены, то при бронировании они создаются в базе данных ПК Мастер-Тур. Вместе со справочными данными создается запись в таблицу синхронизации, чтобы в дальнейшем оперировать уже только локальными справочниками.
Вся информация по автоматически созданным записям и сопоставлениям отправляется на электронный адрес администратора системы, указанный в настройках конфигурационного файла службы поиска rcptTo и addRcptTo, а также логируется в отдельный файл службы поиска HotelFromRemoteProviderMappingsAddLogger.txt для дальнейшего анализа администратором системы.


Расчет скидок, наценок и доплат

Пользователь может завести наценку или доплату на тур с проживанием из внешней системы. По умолчанию все цены из The DOME (ITravex) считаются комиссионными, поэтому на них действуют скидка покупателю при наличии комиссии партнера, однако стоит учитывать, что рассчитывается только для тех цен из внешней системы The DOME (ITravex), к которым применены наценки.

Наценка на услугу проживания от внешнего поставщика

В случае использования доплат скидка покупателю при наличии комиссии партнера рассчитывается только с тех доплат, у которых установлен признак «‎с доплаты дается комиссия».

Доплата на услугу проживания от внешнего поставщика

Общий алгоритм применения для разных вариантов скидок, наценок и доплат при их наличии таков:

  • Получение цены из The DOME (ITravex) -> начисление комиссионной доплаты -> начисление комиссионной наценки на цену и доплату -> вычитание скидки по комиссии партнера с цены, наценки и доплаты;
  • Получение цены из The DOME (ITravex) -> начисление некомиссионной доплаты -> начисление некомиссионной наценки на цену и доплату -> вычитание скидки по комиссии партнера с цены;
  • Получение цены из The DOME (ITravex) -> начисление некомиссионной доплаты -> начисление комиссионной наценки на цену -> вычитание скидки по комиссии партнера с цены и наценки;
  • Получение цены из The DOME (ITravex) -> начисление комиссионной доплаты -> начисление некомиссионной наценки на цену -> вычитание скидки по комиссии партнера с цены и доплаты.

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

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

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