Megatec Integration Service:Индивидуальные особенности адаптера Excel (примеры шаблонов для импорта) — различия между версиями

[досмотренная версия]

Версия 14:50, 4 мая 2022

Версия статьи от 4-05-2022.

Содержание

1 Введение
2 Создание направления
- 2.1 Шаблоны
3 Процесс импорта цен
4 Список шаблонов импорта цен на отели
5 Список шаблонов импорта стопов на отели

Введение

Данный модуль позволяет импортировать цены из индивидуальных Excel-файлов системы бронирования туристических услуг Travco и туроператоров по следующим странам и континентам:

Австрия – Melur
Албания – Aler Travel, Inturs
Африка – Sugar Beach
Болгария – Avatar Tour, AYA Travel, Go2Holiday, KITT, Teddykam (+ Вариант 2), Tural, Vassy Travel (+ Акции в Мастер-Тур 15)
Венгрия – 1000 дорог
Великобритания – Amitours London Limited
Вьетнам – Buffalo Tours, Focus Asia, Focus Travel (+ вариант 2), Viktoria Travel
Греция – Ambotis, Beleon Tours (+вариант 2), Fenix Tours, Kanoulas Travel, Millenium Travel, Millenium Travel2, Mouzenidis Travel, TezTour
Доминиканская республика – Terramar
Египет – Flash Tour, Neffer Tours (+ вариант 2), Fun Trip Travel
Занзибар - Leptis Tours (+ Акции)
Израиль – Сaspi Aviation, Laisa Tour, Rubin (+ каскадные туры), Travellux
Индия – Caper Travel PVT LTD, Sita Travel (+ вариант 2)
Индонезия – Bounty Bali (+ вариант 2), Look Asia, Mac Asia Group, Navigator
Испания – Nika Viajes, Serhs Tourism, ITravex (+Акции), Ancodes
Италия – Gartour, Terracina Travel Inn
Камбоджа – Focus Asia, Green Lime
Китай – Prospeсt Travel, Tropic Sanya hotel
Куба – Welcome Systems
Лаос – Focus Asia
Маврикий - Emotions dmc
Малайзия – Lotus Asia Tours, World Express
Мальдивы – Bliss Maldives, Intour Maldives (+ вариант 2), Lets Go Maldives, Resort Life Maldives (+ вариант 2)
Мексика – Prime Travel, Travel Service
Монако – Via Travel
Мьянма – Buffalo Tours, Focus Asia
ОАЭ – Al Khalidiah, Arabian Explorers, Danat Al Khaleej Tourism, Desert adventure, Desert Globe (Gate), Planet Travel, Royal Arabian, Royal Park, Voyage Tours
Португалия – El Tour (+ Вариант 2), Vangular Tour
Россия – Azimut, Hyatt Sochi, Golden Tulip RK, Kempinski Grand Hotel Gelendzhik, Mercure RK, Mercure SC, Park Inn RK, Park Inn Sochi Center (+ вариант 2), Planeta Sochi, Pullman SC, Radisson RK, Swissotel Resort Sochi Kamelia, Radisson Blu Resort & Congress Centre Sochi, TariTour, Tulip Inn RK, АкадемСервис.
Сейшелы - Luxe Voyage
Сингапур – I Asia
Словакия – Florian Travel
Тайланд – Asia Jorney, Focus Asia, Ilves Tour (+ вариант 2), Sayama Travel, Buta Tour
Турция – Alaska Tour, Calypso Tour, Catttour, Cip Travel, Elite Class Travel, Fitholidays, Jazz Travel, Kilit Global, L-tour(+ вариант 2), Lemar (+ Вариант 2), Odeon Tours, Open Way Tours, MTS, Peninsula Tours, Sedna, Tau Travel, Tourbox, TTA Travel, TUI Turkey Contract/SPO (+Акции), Upjet Travel Group (+ вариант 2), Zemexpert
Фиджи – Rosie Holidays
Филиппины – Uni-Orient Travel (+ новый формат)
Франция – Petropolitan, UTA (+ вариант 2)
Хорватия – R-tours
Черногория- TALAS-M
Чехия – Best of Travel, Et Cetera Travel (+ вариант 2), ITravex, Vizit Europe
Швейцария – Via Travel
Шри-Ланка – A & A Travels, Tangerine Tours/Ceylon My Dream

Создание направления

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

Для создания нового направления следует нажать кнопку «Добавить».

Внимание! Длина названия направления не должна превышать 30 символов.

В данном окне три вкладки:

Внешние настройки;
Внутренние настройки;
Синхронизация.

Во внешних настройках необходимо выбрать файл макрос для данного шаблона. Шаблон с перечнем цен (.xlsx-файл) связан с соответствующим макросом (.cs-файл). Плагин закачивает данные из исходного .xlsx-файла с ценами, приводит полученную информацию к стандартному формату при помощи макроса и загружает ее в БД Мастер-Тура. Во внутренних настройках надо указать параметры импорта по умолчанию для данного направления. В настройках синхронизации указываются флаги для тех справочников, которые должны отображаться в данном адаптере.

Внимание! При выключенном чек боксе - Активировать после сохранения акция не создаётся.

Шаблоны

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

Внимание!! Если в эталонном образце есть рамки у таблицы с ценами, то в файле для импорта она тоже должна быть.

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

Сначала необходимо выбрать нужное направление.
Далее, загрузить в адаптер Excel-шаблон. Для этого необходимо нажать кнопку "Обзор" и выбрать нужный Excel-файл.
После этого нужно заполнить настройки импорта:

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

Импортировать в новый ценовой блок - создаем новый ЦБ, ниже в поле "Название ценового блока" записываем его название. Также существует возможность генерации названия ЦБ.
Импортировать в существующий ценовой блок - импортируем цены в уже имеющийся ЦБ Мастер-Тура, выбираем его ниже в поле "Выберите ценовой блок".

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

Поставщик цен ценового блока и поставщик цен из Excel должен быть одним партнером. В противном случае импорт невозможен.

Сезон - выбора сезона
Активировать после сохранения - ценовой блок будет активирован после импорта цен.
Активировать для цен нетто после сохранения - ценовой блок будет активирован после импорта для цен нетто.

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

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

Более подробно все возможности работы с окном Синхронизации продемонстрированы в статье Megatec Integration Service:Работа с окном Синхронизация .

По завершению процедуры импорта, загруженные цены отображаются в окне «Отели/Круизы (Цены)»:

Список шаблонов импорта цен на отели

Для модуля Импорт прайс-листов разработаны следующие шаблоны:

Шаблон 1

Правила импорта для «Шаблон 1»

1. Файл состоит из нескольких таблиц с ценами, каждая таблица – новый отель.
2. Заголовка перед таблицами нет, первая непустая строка – начало таблицы с ценами.
3. Таблицы разделяются пустыми строками.
4. Во всем файле первая колонка не заполнена, поэтому пустой считается строка, у которой не заполнена вторая ячейка.
5. Все строки рассматриваются начиная со второй ячейки.
Ограничения
Данные, которые содержатся между таблицами с ценами, не обрабатываются. Вся информация находится на первом листе xls-файла. Файл не должен быть защищен паролем и не должен содержать макросов (т.е. должен открываться сразу).

Поле в примере	Содержание поля	С каким значением справочника МТ сопоставляется
1	Название отеля	Данный текст сопоставляется с названием отеля в справочниках ПК «Мастер-тур»
2	Адрес отеля	Не обрабатывается и не сопоставлении не участвует
3	Адрес в интернете	Не обрабатывается и не сопоставлении не участвует
4	Общий период	Общий период, за который вводятся цены
5	Строка заголовков	-
6	Строка заголовков	-
6.1	RoomCategory	Строка заголовков
6.2	SGL	Тип номера
6.3	DBL	Тип номера
6.4	Suite	Тип номера (при импорте не используется)
6.5	Apt	Дополнительные места для данной категории номера
6.6	Adult	Дополнительное размещение для взрослых
6.7	Child	Дополнительное размещение для детей
6.8	Meal	Включена ли стоимость завтрака в стоимость проживания
6.9	Adult и Child (размещение для взрослых, основное и дополнительное)	Типы размещения, для которых в нижеследующих колонках задаются цены на завтрак
6.10	Adult и Child (размещение для взрослых, основное и дополнительное)	Типы размещения, для которых в нижеследующих колонках задаются цены на ланч
6.11	Adult и Child (размещение для взрослых, основное и дополнительное)	Типы размещения, для которых в нижеследующих колонках задаются цены на ланч
7	Период дат	Период дат, для которого импортируются цены

Шаблон 2

Правила импорта для «Шаблон 2»

1. В одной таблице цены должны быть только в одной валюте.
2. Импортируется только первый лист/страница, остальные игнорируются.
3. Город указывается в первом диалоговом окне сопоставления, при этом в сопоставлении не участвует.

Поле в примере	Содержание поля	Правила импорта в МТ
1	Название отеля	Данный текст сопоставляется с названием отеля в справочниках ПК «Мастер-тур»
2	Тип питания	Сопоставляется с типом питания в ПК «Мастер-Тур» (справочник «Типы питания»)
3	Категория комнаты	Сопоставляется с категорией номера в ПК «Мастер-Тур» (справочник «Категории номеров»)
4	Период действия цены	Дата начала действия цены в формате дд.мм.гггг - Дата окончания действия цены в формате дд.мм.гггг
5	RELEASE PERIOD	Релиз-период
6	Тип номера	Сопоставляется с типом номера в ПК «Мастер-Тур» (справочник «Типы номеров»)
7	Цена	Импортируется в ПК «Мастер-Тур» на указанное размещение, тип и категорию номера, в подходящий период выбранный период дат

Шаблон 3

Правила импорта для «Шаблон 4»

В таблице обязательно должны присутствовать колонки SGL, DBL либо UNIT, заменяющий их. При наличии всех трех, UNIT игнорируется. Если отсутствуют SGL и DBL, для импорта цен этих типов номеров используется значение UNIT. Для DBL используется значение UNIT/2 , для SGL значение UNIT. Например, если UNIT = 100, а значения SGL и DBL в файле цен отсутствуют, то после импорта цены будут равны SGL = 100 и DBL = 50.

Все поля обязательны для заполнения. Если цена отсутствует, значение ячейки должно быть N/A.

Поле в примере	Содержание поля	Правила импорта в МТ
1	Партнер	Справочник партнера
2	Название отеля	Данный текст сопоставляется с названием отеля в справочниках ПК «Мастер-тур»
3	Валюта	Сопоставляется с валютами в ПК «Мастер-Тур» (справочник «Курс национальной валют»)
4	Страна	Название страны
5	Город	Название города
6.1	Начало таблицы	В колонке «А» ячейка со словом «FROM».
6.2	Конец таблицы	Найти в колонке «А» первую пустую ячейку после ячейки со словом «FROM».
6.3	Строка с заголовком	Это одна строка, в которой встретилось слово «FROM» из предыдущих пунктов.
6.4	Последней колонки таблицы	Последняя непустая ячейка в строке заголовков.
7	Даты заезда	Дата начала находится в колонке «А», первая дата начала – под ячейкой со словом «FROM». Дата окончания всегда находится в ячейке столбца «В» рядом с датой начала. «дд/мм/гггг» – без пробелов, через прямой слеш.
8	Тип питания	Сопоставляется с типом питания в ПК «Мастер-Тур» (справочник «Типы питания»)
9	Тип номера	Сопоставляется с типом номера в ПК «Мастер-Тур» (справочник «Типы номеров»)

Шаблон 4

Правила импорта для «Шаблон 4»

1.Данные с ценами, которые нужно импортировать в ПК «Мастер-Тур» должны начинаться с колонки содержащей текст «Расчетные цены». Все данные, содержащиеся в таблице, начинающейся в этой колонке будут импортированы в ПК «Мастер-Тур», данные содержащиеся левее этой колонки и данные в отдельных таблицах правее будут проигнорированы.
2.По горизонтали цены на каждое новое средство размещения(Отель, пансионат, круизный лайнер) должны начинаться с названия средства размещения. Максимальное количество строк между двумя таблицами цен 20.
3. Город указывается в первом диалоговом окне сопоставления, при этом в сопоставлении не участвует.
4. Расчет цен происходит непосредственно в шаблоне, при помощи формул.

Поле в примере	Содержание поля	Правила импорта в МТ
1	Расчетные цены	Колонка, с которой начинаются данные для импорта в ПК «Мастер-Тур»
2	Название отеля	Сопоставляется с названием отеля из справочника ПК «Мастер-Тур»
3	Тип питания	Единожды сопоставляется с типом питания в ПК «Мастер-Тур»
4	Категория номера	Единожды сопоставляется с категорией номера в ПК «Мастер-Тур» (справочник «Категории номеров»)
5	Тип размещения	Единожды сопоставляется с типом номера (справочник «Типы номеров») и типом размещения (справочник «Типы размещения») в ПК «Мастер-Тур»
6	Период действия цен	Период действия цены в формате дд.мм.гг-дд.мм.гг
7	Цена	Импортируется в ПК «Мастер-Тур» на указанное размещение, тип и категорию номера, в подходящий период выбранный период дат

Шаблон 5

Правила импорта для «Шаблон 5»

1. Формат данных и названий полей таблицы должен строго соответствовать примеру.
2. Если отсутствует значение цены или времени пребывания, ячейка должна содержать 0.
3. Шаблон Вариант 2: Вкладка C/IN цены на заезд, даты из столбцов Data_from и data_to загружаются в даты заезда: Дата заезда с, Дата заезда по. Вкладка STAY цены на период, даты из столбцов Data_from и data_to загружаются в Дата с, Дата по.

Содержание поля	Правила импорта в МТ
Data_from	Период начала действия цены в формате дд/мм/гггг
Data_to	Период окончания действия цены в формате дд/мм/гггг
Страна	Не обрабатывается
Город	Не обрабатывается
Название отеля	Сопоставляется с названием отеля из справочника ПК «Мастер-Тур»
Вид номера	Сопоставляется с категорией номера в ПК «Мастер-Тур» (справочник «Категории номеров»)
Тип размещения + Тип Номера	Сопоставляется с типом номера (справочник «Типы номеров») и типом размещения (справочник «Типы размещения») в ПК «Мастер-Тур»
Продолжительность С	Минимальное количество ночей, импортируется в ПК «Мастер-Тур»(Продолжительность с)
Продолжительность По	Максимальное количество ночей, импортируется в ПК «Мастер-Тур»(Продолжительность по)
Питание	Сопоставляется с типом питания в ПК «Мастер-Тур»
Цена	Импортируется в ПК «Мастер-Тур» на указанное размещение, тип и категорию номера, в подходящий период выбранный период дат
Время прибытия (Шаблон 2)	Минимальное и максимальное количество ночей, импортируется в ПК «Мастер-Тур»(Продолжительность с/Продолжительность по)

Шаблон 6

Правила импорта для «Шаблон 6»

1. Данные с ценами, которые нужно импортировать в ПК «Мастер-Тур» должны начинаются с первой колонки, третьей строки.
2. Количество пустых строк между таблицами не должно превышать 9.
3. Количество столбцов не ограничено.
4. В одной таблице цены должны быть только в одной валюте.
5. Импортируется только первый лист/страница, остальные игнорируются.
6. Город указывается в первом диалоговом окне сопоставления, при этом в сопоставлении не участвует.

Поле в примере	Содержание поля	Правила импорта в МТ
1	Название города и отеля	Данный текст (до скобок) сопоставляется с названием отеля в справочниках ПК «Мастер-тур» - ячейка A3
2	Категория номера	Сопоставляется с категорией номера в ПК «Мастер-Тур» (справочник «Категории номеров») - ячейка A3
3	Acc. <

@@ Строка 69: / Строка 69: @@
 Перед импортом цен, в диалоговом окне предлагается выбирать партнера, пакет, параметры цены (за ночь, за день и т.п.), валюту цен, страну. Выбор этих параметров не влияет на импорт, так как в процессе будут учитываться значения обозначенные в файле цен, а не указанные в диалоге. Однако, выбор партнера в диалоге определяет, для какого партнера будут сохранены сделанные сопоставления.<br>
 Стандартный формат соответствует эталонному шаблону, т.е. любой шаблон в итоге преобразуется в эталонный (в соответствии с макросом из выбранного профиля):
+'''Внимание!! Если в эталонном образце есть рамки у таблицы  с ценами, то в файле для импорта она тоже должна быть.'''
 ==Процесс импорта цен==