Мастер-Тур:Дополнительный модуль Импорт прайс-листов
Содержание
Введение
Обзор
Данный модуль предназначен для импортирования прайс-листов определенного партнера на основе шаблона, а также для синхронизации справочников. В отличие от стандартного мастера импорта цен плагин обрабатывает и импортирует таблицы с ценами автоматически, базируясь на определенных шаблонах.
- C помощью плагина за одну операцию импорта можно загрузить цены на все отели для данного партнера.
- Клиент может использовать уже готовые шаблоны, либо заказать разработку нового, если таблицы с ценами отеля-партнера по своему формату не подходят ни под один из существующих шаблонов.
Установка модуля
В ПК «Мастер-Тур» версии 2009.2 и выше модуль устанавливается путем обновления клиентской части — в рабочий каталог приложения копируются два файла:
- Megatec.MasterTour.Plugins.PriceLists.Import.dll
- Megatec.MasterTour.Plugins.Synchronization.dll
Работа с модулем
Доступ к данному модулю осуществляется из окна «Отели/Круизы (Цены)» раздела Справочники, далее Надстройки → Импорт прайс-листов.
Шаблон с перечнем цен (.xls-файл) связян с соответствующим макросом (.cs-файл). Плагин закачивает данные из исходного .xls-файла с ценами, приводит полученную информацию к стандартному формату при помощи макроса и загружает ее в БД Мастер-Тура.
Шаблоны
Перед импортом цен, в диалоговом окне предлагается выбирать партнера, пакет, параметры цены (за ночь, за день и т.п.), валюту цен, страну. Выбор этих параметров не влияет на импорт, так как в процессе будут учитываться значения обозначенные в файле цен, а не указанные в диалоге. Однако, выбор партнера в диалоге определяет, для какого партнера будут сохранены сделанные сопоставления.
Стандартный формат соответствует эталонному шаблону, т.е. любой шаблон в итоге преобразуется в эталонный (в соответствии с макросом из выбранного профиля):
Правила импорта для «Эталонный шаблон»
1. Анализ данных в фале начинается с первой ячейки – то есть первая строка, первый столбец.
2. Количество столбцов с ценами не ограничено.
3. На одном листе могут быть данные по одному отелю. Если есть данные по нескольким отелям, цены для них должны быть расположены на разных страницах.
4. Данные должны располагаться точно в тех ячейках, как указано в примере ниже.
| Поле в примере | Содержание поля | С каким значением справочника МТ сопоставляется |
|---|---|---|
| 1 | Партнер | Краткое названием партнера |
| 2 | Название пакета | Название туристического пакета |
| 3 | Валюта | Код валюты |
| 4 | Цена за | Сопоставляется с типом периода, за который указана цена, в диалоге импорта ПК «Мастер-Тур» это одноименное поле. |
| 5 | Страна | Название страны |
| 6 | Город | Название города |
| 7 | Название отеля | Поле Название справочника отелей |
| 8 | Тип питания | Код типа питания в справочнике питаний |
| 9 | Дата начала действия цены | В формате дд.мм.гггг |
| 10 | Дата окончания действия цены | В формате дд.мм.гггг |
| 11 | Продолжительность | Импортируется в колонки «Продолжительность с…» и «Продолжительность по…» |
| 12 | Нетто и брутто по первому дню | Если 2 - равносильно отмеченному чек-боксу в диалоге импорта; 1 - чек-бокс не отмечен; 0 - анализируется, был ли отмечен чек-бокс в форме и учитывается это значение. |
| 13 | Room type | Тип номера |
| 14 | Room Category | Категория номера |
| 15 | Accomm type | Тип размещения |
| 16 | Дни недели действия цены | Порядковые номера дней недели по порядку, без пробелов. Дни первой строки соответствуют ценам первой строки, дни второй ценам второй и т.д. |
- Эталонный шаблон
Для модуля Импорт прайс-листов разработаны следующие шаблоны:
- Шаблон 1
- Шаблон 2
- Шаблон 3
- Шаблон 4
- Шаблон 5
- Шаблон 6
- Шаблон 7
- Шаблон 8
Правила импорта для «Шаблон 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»
1. В одной таблице цены должны быть только в одной валюте.
2. Импортируется только первый лист/страница, остальные игнорируются.
3. Город указывается в первом диалоговом окне сопоставления, при этом в сопоставлении не участвует.
| Поле в примере | Содержание поля | Правила импорта в МТ |
|---|---|---|
| 1 | Название отеля | Данный текст сопоставляется с названием отеля в справочниках ПК «Мастер-тур» |
| 2 | Тип питания | Сопоставляется с типом питания в ПК «Мастер-Тур» (справочник «Типы питания») |
| 3 | Категория комнаты | Сопоставляется с категорией номера в ПК «Мастер-Тур» (справочник «Категории номеров») |
| 4 | Период действия цены | Дата начала действия цены в формате дд.мм.гггг - Дата окончания действия цены в формате дд.мм.гггг |
| 5 | RELEASE PERIOD | Релиз-период |
| 6 | Тип номера | Сопоставляется с типом номера в ПК «Мастер-Тур» (справочник «Типы номеров») |
| 7 | Цена | Импортируется в ПК «Мастер-Тур» на указанное размещение, тип и категорию номера, в подходящий период выбранный период дат |
Правила импорта для «Шаблон 4»
1.Данные с ценами, которые нужно импортировать в ПК «Мастер-Тур» должны начинаться с колонки содержащей текст «Расчетные цены». Все данные, содержащиеся в таблице, начинающейся в этой колонке будут импортированы в ПК «Мастер-Тур», данные содержащиеся левее этой колонки и данные в отдельных таблицах правее будут проигнорированы.
2.По горизонтали цены на каждое новое средство размещения(Отель, пансионат, круизный лайнер) должны начинаться с названия средства размещения. Максимальное количество строк между двумя таблицами цен 20.
3. Город указывается в первом диалоговом окне сопоставления, при этом в сопоставлении не участвует.
| Поле в примере | Содержание поля | Правила импорта в МТ |
|---|---|---|
| 1 | Расчетные цены | Колонка, с которой начинаются данные для импорта в ПК «Мастер-Тур» |
| 2 | Название отеля | Сопоставляется с названием отеля из справочника ПК «Мастер-Тур» |
| 3 | Тип питания | Единожды сопоставляется с типом питания в ПК «Мастер-Тур» |
| 4 | Категория номера | Единожды сопоставляется с категорией номера в ПК «Мастер-Тур» (справочник «Категории номеров») |
| 5 | Тип размещения | Единожды сопоставляется с типом номера (справочник «Типы номеров») и типом размещения (справочник «Типы размещения») в ПК «Мастер-Тур» |
| 6 | Период действия цен | Период действия цены в формате дд.мм.гг-дд.мм.гг |
| 7 | Цена | Импортируется в ПК «Мастер-Тур» на указанное размещение, тип и категорию номера, в подходящий период выбранный период дат |
Правила импорта для «Шаблон 5»
1. Формат данных и названий полей таблицы должен строго соответствовать примеру.
2. Если отсутствует значение цены или времени пребывания, ячейка должна содержать 0.
3. В файле цен допустима только одна страница (или лист). Данные на других страницах игнорируются.
| Поле в примере | Содержание поля | Правила импорта в МТ |
|---|---|---|
| 1 | Data_from | Период начала действия цены в формате дд/мм/гггг |
| 2 | Data_to | Период окончания действия цены в формате дд/мм/гггг |
| 3 | Страна | Сопоставляется с названием страны из справочника ПК «Мастер-Тур» |
| 4 | Город | Сопоставляется с названием города из справочника ПК «Мастер-Тур» |
| 5 | Название отеля | Сопоставляется с названием отеля из справочника ПК «Мастер-Тур» |
| 6 | Вид номера | Сопоставляется с категорией номера в ПК «Мастер-Тур» (справочник «Категории номеров») |
| 7 | Тип размещения + Тип Номера | Сопоставляется с типом номера (справочник «Типы номеров») и типом размещения (справочник «Типы размещения») в ПК «Мастер-Тур» |
| 8 | Время пребывания | Соответствует значению поля «Продолжительность по…» экрана цен ПК «Мастер-тур»
Начиная с релиза 2009.2.16 существует возможность в поле «Время пребывания» задавать продолжительность в виде «x-y», где х – значение, которое будет записано в поле «Продолжительность с», y – значение, которое будет записано в поле «Продолжительность по». |
| 9 | Питание | Сопоставляется с типом питания в ПК «Мастер-Тур» |
| 10 | Цена | Импортируется в ПК «Мастер-Тур» на указанное размещение, тип и категорию номера, в подходящий период выбранный период дат |
Формирование нового профиля
Для начала нужно создать профиль для импорта. Окно создания профиля вызывается при нажатии кнопки Обзор в окне Импорт прайс-листа, далее в окне Список профилей нажатием на кнопку Добавить новый элемент.
В окне создания профиля нужно указать название профиля, назначить партнера из списка партнеров, указать цену за… — за какой период будет считаться цена (за ночь, за день, за весь период), указать валюту, страну, тип цены. В поле Макрос необходимо указать физический путь к файлу макроса, на основе которого будет формироваться профиль. В данном случае это файл macroShablon_X.cs. Теперь в окне Список профилей отобразился созданный профиль с названием Shablon_X.
Импорт прайс-листа на основе профиля
Теперь можно приступить к самому импорту прайс-листа на основе профиля:
В поле Профиль для импорта выбираем созданный профиль с названием Shablon_X. Все данные, выбранные при создании этого профиля, автоматически перенеслись сюда. Можно выбрать название тура из списка Пакет, а также обязательно нужно указать физический путь к .xls-файлу шаблона, из которого будут импортироваться цены. В данном случае это файл Shablon_X.xls. После этого нажимаем кнопку Импорт — происходит сопоставление (синхронизация) всех предложенных надстройкой параметров из выбранного файла с соответствующими значениями в БД Мастер-Тура.
Если найдено значение, которое невозможно сопоставить автоматически, выводится диалог сопоставления справочников. В таком случае нужно выбрать из списка соответствующее значение. Если сопоставимого значения не существует в базе данных, его можно добавить в соответствующий справочник Мастер-Тура, нажав на кнопку Открыть справочник. После синхронизации всех справочных значений откроется предварительное окно перед импортом прайс-листа, где можно просмотреть, что с чем синхронизировалось:
При нажатии на кнопку Excel можно просмотреть исходные данные, преобразованные в стандартный формат (в эталонный шаблон):
Для завершения процедуры нажмите Импорт. Загруженные цены отображаются в окне «Отели/Круизы (Цены)»:
