Просмотр исходного текста страницы Megatec Integration Service:Индивидуальные особенности адаптеров TourML (Импорт цен из XML)

==Общие сведения==
Задача получения данных из программного комплекса Мастер-Тур и передача полученных данных сторонним системам, а также получение данных из сторонних систем в программном комплексе Мастер-Тур весьма актуальна. <br>
Предлагаемое компанией Мегатек решение состоит в использовании общепризнанного механизма взаимодействия между различными системами - WEB-сервис, работающий с единым, для туристической области в России, форматом – TourML. <br>
Формат TourML представляет из себя текстовый XML документ, использование которого позволяет избежать проблем, связанных с внутренними изменениями в программном комплексе Мастер-Тур. Использование веб-сервиса позволяет разработать систему один раз и забыть об особенностях реализации внутренних механизмов программного комплекса Мастер-Тур.  <br>
TourML позволяет осуществлять загрузку данных из Мастер-тур 9 версии в Мастер-тур 9 и 15 версии. <br>
Подробнее о веб-сервисе TourML: [[Web-сервисы:_Сервис_TourML|Web-сервис TourML]].
===Описание===
Данный адаптер предназначен для импортирования туров (услуг и пакетных цен на них) от другого туроператора из форматов TravelXML и TourML (далее – XML). Также во время импорта тура можно рассчитать его прайс-лист, выставить его в онлайн, скорректировать цены за тур.<br>
Внешней системой, из которой импортируется тур выступают:
*Веб-сервис TourML туроператора, для подключения к которому у ТО необходимо получить адрес веб-сервиса и логин/пароль для авторизации.
*Сгенерированный файл в формате XML.
Цена за импортированный тур является пакетной, общая цена за тур приходит на услугу проживания в отеле. <br>
 Импортитровать можно только одноотельные туры, импорт многоотельных туров не осуществляется.
===Установка===
*Запустив плагин «'''Megatec Integration Service'''» нажать на иконку [[Файл: Vh fsdfsd1719.PNG|Система обмена (три куба)]]. Нажать '''добавить систему обмена'''.
*Закрыть '''плагин MIS'''. Если плагин открыт, то выйдет предупреждающее сообщение о необходимости его закрытия.
[[Файл:Ud_046.png|800px|Установка адаптеров MIS]]
*Выбрать файл '''установочный_zip_архив_MIS_Tourml.zip'''. Нажать '''"Далее"'''.
*Нажать '''установить''' и дождаться окончания операции
[[Файл:Ud_185.png|установка/обновление установленных адаптеров]] <br />

==Работа с адаптером==
===Создание и редактирование направлений===
Для начала работы нужно создать направление - профиль источника внешней системы. <br>
Для этого нужно нажать на кнопку '''"Направления"''' [[Файл:Ud_186.png]] и нажать кнопку '''"Добавить"'''. <br>
Откроется окно создания и редактирования направления, состоящее из 3-х разделов: '''Внешние настройки''', '''Внутренние настройки''' и '''Синхронизация'''. <br>
[[Файл:Ud_177.png|Направление - внешние настройки]]  <br>
Здесь заполняются следующие поля: <br>
====Внешние настройки:====
*'''Название'''
*'''Источник''' - Web-сервис или XML-файл.
*'''Адрес веб-сервиса TourML''' - источника цен для отелей.
*'''Логин веб-сервиса'''
*'''Пароль веб-сервиса''' 
====Внутренние настройки:====
[[Файл:TP_22.png|Направление - внутренние настройки]] <br>
Во внутренних настройках устанавливаются значения параметров по умолчанию для всех следующих импортов туров.
*'''Партнер''' - выбор партнера из справочника Мастер-Тура.
*'''Доп. описание 1/2''' для дополнительных услуг.
*'''Тип цены: На заезд, На период.''' Для закачки цен из данного сервиса необходимо использовать тип цены - На заезд.
*'''Групповая цена''' - цена за номер.
*'''Комиссия''' - комиссионная цена.
*'''Расчет тура''' - будет ли тур рассчитываться сразу при импорте цен.
*'''Выставление в интернет''' - выставление тура в онлайн.

====Синхронизация====
'''Синхронизация''' - выбор активных справочников для синхронизации (для случаев, когда в туре отсутствуют некоторые услуги). <br>
[[Файл:Ud_187.png|Синхронизация]]
==Процесс импорта тура в Мастер-Тур==
Процесс импорта тура после выбора направления происходит в 4 шага: <br>
'''1. Поиск тура.''' <br>
'''2. Синхронизация''' - создание связи между услугами тура внешней системы и услугами, содержащихся в Мастер-Туре. <br>
'''3. Настройка параметров тура''' - выбор существующих тура и пакета Мастер-тура, в который будут загружен внешний тур или создание нового, его расчет, выставление в онлайн и другие. <br>
'''4. Импорт тура''' - выбор отелей и дат заезда импортируемого тура. <br>
===Поиск тура===
Если внешней системой является XML-файл, то для импорта тура выбираем в качестве источника '''XML''' и находим его в файловой системе компьютера. <br>
Если в роли внешней системы выступает веб-сервис TourML туроператора, то в качестве источника импорта выбираем признак '''"Web-сервис".'''<br>
При необходимости в верхней части экрана находятся следующие фильтры:
*'''Страна'''
*'''Город'''
*'''Дата создания с ... по'''
*'''Название тура'''
Для нахождения туров нужно нажать на кнопку '''"Загрузить туры"''', после чего на экране отобразится список найденных туров.<br>
Для фильтрации выгруженных туров действует кнопка '''"Отфильтровать туры"'''. <br> <br>
[[Файл:Ud_231.png|Главный экран]] <br>


В нижней части экрана выбираются существующие тур и пакет либо создается новый тур, в который будут загружены услуги импортируемого от поставщика-партнера тура. Если ранее было сопоставление пакетов данного тура в окне синхронизации, то пакет автоматически подставляется в данном экране, пользователь имеет возможность перевыбрать пакет и тур вручную. <br>
Также происходит настройка параметров тура, таких как период действия цен (на заезд/на период), выбор партнера, расчет тура, выставление в интернет, удаление существующих цен и т.д. <br>

===Синхронизация справочников===
====Сопоставление справочников====
Для передачи тура из внешней системы, необходимо сопоставить услуги тура из внешней с услугами ПК «Мастер-Тур», создать между ними связь. Для этого нужно выделить из списка тур и нажать кнопку '''Синхронизация'''. Откроется окно синхронизации справочников. <br>
[[Файл:Ud_180.png|Окно синхронизации справочников|900px]] <br>
В данном окне осуществляется сопоставление справочников из внешней системы со справочниками ПК «Мастер-Тур». Для создания сопоставления, связки между справочниками, нужно выделить услугу справочника внешней системы и соответствующий ему справочник из ПК «Мастер-Тур», после чего нажать на кнопку '''Сопоставить''' '''(Ctrl+S)'''. <br> 
Для поиска конкретных услуг у каждого справочника есть набор фильтров в верхней части экрана. <br> 
Сопоставления выделенных справочников отображаются в нижней части экрана в поле '''Сопоставленные данные'''. <br>
Одному справочнику внешней системы соответствует один справочник Мастер-Тура. Множественного сопоставления нет. <br>
Для удаления сопоставления между справочниками необходимо выделить нужный справочник и нажать кнопку '''"Удалить сопоставление"'''.

====Создание нового справочника в Мастер-Туре====
Если в справочнике Мастер-Тура отсутствует услуга, подобная услуге из внешней системы, то ее можно создать сразу из адаптера. Для этого нужно выделить услугу из списка внешней системы, на основе которой будет создана новая услуга в Мастер-Туре и нажать кнопку '''"Создать"'''. Откроемся окно создания новой услуги. После создания новой услуги, она автоматически сопоставится с ранее выделенной услугой из внешней системы.<br>
[[Файл:Ud_181.png|Создание новой услуги]] <br> <br>
Возможность создания новой записи из адаптера TourML доступна не для всех справочников. <br>
'''Справочники, которые можно создать из адаптера  TourML:''' Страны, Города, Отели, Типы размещений, Типы номеров, Категории номеров, Типы питаний, Валюты, Доп. описание 1, Доп. описание 2, Транспорт, Классы перелетов. <br>
'''Справочники, которые нельзя создать из адаптера TourML:''' Услуги, Рейсы, Трансферы, Экскурсии. <br>
====Автоподбор справочников по названию==== 
При активном признаке '''"Автоподбор"''' в верхней части экрана к выделенному в списке внешней системы справочника подбирается совпадающий с ним названию (или части названия) справочник из Мастер-Тура.  <br>
Если близкий по названию справочник Мастер-Тура не является подходящим можно нажать кнопку "Подобрать следующую" или "Подобрать предыдущую", в таком случае автоподбор будет искать следующий или предыдущий по списку справочник с похожим названием.

===Настройка параметров тура===
*'''Пакет'''
*'''Тур'''
Создание нового 
*'''Тип цены''' :
**'''На заезд''' - период цен на даты заезда в отель (check-in и check-out).
**'''На период''' - период продажи цен.
*'''Партнер''' - провайдер тура.
*'''Доп. описание 1'''
*'''Доп. описание 2'''
*'''Нетто''' - установить размер нетто-цены в зависимости от брутто-цен исходного тура.
*'''Фиксированная прибыль''' - наценка на цены тура.
*'''Групповая цена''' - цена за номер.
*'''Комиссия''' - комиссионная цена.
*'''Выставление в интернет''' - выставление тура в онлайн.
*'''Расчет тура''' - расчет прайс-листа.
*'''Удалять существующие цены''' - при импорте в тур будут удалены все имеющиеся цены
===Импорт тура в ПК «Мастер-Тур»===
После синхронизации и настройки параметров тура, осуществляется непосредственно его загрузка в ПК «Мастер-Тур». <br>
Для этого необходимо нажать кнопку '''Импорт''', после чего появится окно '''Выбор данных для импорта'''. <br>
[[Файл:Ud_183.png|Выбор данных для импорта]] <br> <br>
В данном окне выбираем '''отели''' и '''даты заезда''', которые будут импортированы. Также можно отключить импорт цен, сняв признак активности '''Импортировать цены'''.<br>
После нажатия кнопки '''ОК''' начнется импорт тура. <br>

[[Файл:Ud_184.png]]

Если не все услуги сопоставлены, то выходит информационное сообщение, в котором перечислены все несопоставленные услуги. Цены в ПК «Мастер-Тур» не будут импортированы до тех пор, пока эти услуги не будут сопоставлены. 
 
[[Файл:jk_217.png|Пример информационного сообщения]]<br>
Импорт тура в Мастер-тур 15. При импорте тура цена за тур кладется в цены по отелю.
Цены на услуги кладутся в разные ценовые блоки. Для каждого типа услуги свой ценовой блок. При выборе импорта в существующий ценовой блок, будут дозаписаны цены по отелю в выбранный блок, а для цен по оставшимся услугам будут созданы новые блоки.<br>