Master-Interlook:Дополнительный модуль Импорт прайс-листов (Price import)

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

Содержание

1 Введение
- 1.1 Установка модуля
2 Импорт прайс-листов
3 Работа с модулем
4 Шаблон для импорта

Введение

Дополнительный модуль Price import позволяет импортировать цены нетто от поставщика услуги (в настоящее время реализовано только для услуги проживания).

Данный модуль не входит в базовую поставку и поставляется за отдельную стоимость.

Установка модуля

Установка плагина осуществляется обновлением клиентской части: в рабочий каталог приложения копируются файлы: Megatec.MasterInterlook.Plugins.PriceImport.dll
Megatec.Interlook.PriceTemplateLoader
Megatec.Interlook.PriceImportProvider

Импорт прайс-листов

Импортируемые цены будут загружены в цены за проживание в отеле - Hotel Prices (подробнее о ценах за проживание см. Hotel Prices) Чтобы корректно импортировать цены, необходимо чтобы они были оформлены в соответствии с шаблоном.
В настоящее время реализовано два варианта шаблона импорта цен - одноотельный шаблон (поставляется вместе с ПК «Мастер-Interlook») и многоотельный шаблон (поставляется отдельно).
Чтобы запустить модуль необходимо выбрать следующий элемент меню - Plug-ins → Price import.

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

Service provider (Список поставщиков услуг);
Service (Список услуг, для которых доступен импорт цен);
Season (Сезон, для которого будет производиться импорт цен);
Cost offer (Ценовое предложение, для которого будет производиться импорт цен);
Tariff (Тариф);
Template (Шаблон);
Edit templates (Редактировать шаблоны);
Варианты отображения подготовленных к импорту/импортированных цен:
- Show saved prices (Показывать сохраненные цены);
- Show sync prices (Показывать синхронизированные цены);
- Show error prices (Показывать не готовые к импорту цены);
- Show hidden prices (Показывать скрытые цены).
Import (Выбрать файл для импорта);
Sync (Синхронизация данных);
Edit (Редактировать синхронизацию);
Save (Сохранить цены);
Total prices (Всего цен - количество цен, отображаемых согласно выбранным фильтрам Show saved prices,

Show sync prices, Show error prices, Show hidden prices);

Close (Закрыть модуль).

Работа с модулем

Выбор шаблона

Перед тем как начать импорт цен, необходимо выбрать шаблон для импорта или загрузить его. Для этого необходимо нажать кнопку Edit templates, после чего откроется окно Templates, в котором можно будет:

Добавить шаблон
Удалить шаблон
Редактировать шаблон

Для того, чтобы добавить новый шаблон - необходимо нажать Add template выбрать файл шаблона
(например, Megatec.Interlook.Template.SingleHotelTemplate.dll, по вопросам приобретения шаблонов можно обратиться в Департамент по работе с клиентами Компании «Мегатек» service@megatec.ru).
Добавленный шаблон отобразится в списке Template.
Чтобы выбрать шаблон для одноотельной загрузки данных (SingleHotelTemplate), в фильтре Service Provider нужно выбрать поставщика услуг, которому будут загружены цены из шаблона. Если в фильтре выбран All, то будет доступен только многоотельный шаблон загрузки цен (MultiHotelTemplate).
Шаблон можно привязать к одному из поставщиков услуг, для этого необходимо нажать кнопку Edit template и в открывшемся окне Available partners выбрать нужного партнера или нескольких партнеров (возможен поиск по названию/части названия). Если шаблон привязан к одному или нескольким партнерам, то он будет доступен для выбора - выпадающий список Template - только если в выпадающем списке Service provider выбран один из привязанных партнеров.

Импорт даннных

Для импорта цен необходимо нажать кнопку Import, и в открывшемся диалоговом окне выбрать нужный файл импорта, нажав Add template.

Внимание! Чтобы корректно импортировать цены, необходимо чтобы они были оформлены в соответствии с выбранным шаблоном.

После загрузки вариантов цен из выбранного файла таблица основного экрана модуля примет следующий вид:

где:

Service - услуга (отель), для которой будет производиться импорт цен;
Date from - Date to - период действия импортируемых цен;
Currency - валюта импортируемых цен;
Cost - цена;
Room category - категория комнаты, для которой будет производиться импорт цен;
Room type - тип комнаты, для которой будет производиться импорт цен;
Accommodation - размещение, для которого будет производиться импорт цен;
Pansion - тип питания, для которого будет производиться импорт цен;
State - статус цены.

Красным цветом выделены данные, для которых не была произведена синхронизация. Необходимо синхронизировать значения для следующих данных Currency; Room category, Room type, Accommodation; Pansion.

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

Для начала синхронизация необходимо выделить нужную ячейку в таблице и нажать кнопку Sync.

Если выбран стандартный шаблон импорта для одного отеля, то поставщик и отель, для которого будут скопированы цены, выбираются в выпадающих списках, в верхней части экрана Prices.
Если выбран мноотельный шаблон, то выпадающий список для выбора отеля блокируется. Для синхронизации отеля необходимо выбрать поставщика в выпадающем списке в верхней части экрана Prices.

Стандартный шаблон импорта поддерживает работу только с одним отелем. Специальный шаблон импорта может работать как с одним отелем, так и с несколькими.

Специальный шаблон поставляется отдельно.

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

Описанные далее действия одинаковы для обоих типов шаблонов.
После нажатия кнопки Sync откроется одно из окон (в зависимости от выбранного типа данных - Currency; Room category, Room type, Accommodation; Pansion) для выбора возможных вариантов значений для синхронизации.
Окно синхронизации для значений Currency:

Окно синхронизации для значений Room category, Room type, Accommodation:

Окно синхронизации для значений Pansion:

Варианты значений для синхронизации Room category, Room type, Accommodation и Pansion фильтруются по выбранному в главном экране отелю.
Каждое из окон содержит стандартные элементы управления:

В верхней части экрана указывается одно из значений, загруженное из файла импорта, которое будет

синхронизировано;

В центральной части экрана представлены значения из справочников ПК «Мастер-Interlook», которые будут

синхронизированы;

Кнопки Move previous и Move next используются для переключения вариантов значений, загруженных из файла импорта;
Кнопка Synchronize используется для синхронизации выбранных значений;
Кнопка Hide используется для скрытия вариантов значений, загруженных из файла импорта (цены для этих значений не будут импортированы);

Если нет больше вариантов для синхронизации, не выбрано значение для синхронизации или выбранное значение уже синхронизировано, то кнопки становятся неактивны.
У синхронизированных данных будет статус Sync.

Редактирование данных

Для редактирования синхронизированных значений нужно нажать кнопку Edit.

В открывшемся окне можно выбрать тип редактируемых данных:

Hotels - для редактирования отелей Hotel;
Room variants - для редактирования вариантов размещения Room category, Room type, Accommodation;
Pansion - для редактирования типа питания Pansion;
Rates - для редактирования валюты Currency.

Чтобы удалить сопоставление между значениями нужно нажать Remove Sync, для редактирования - Change Sync.
Для выхода из экрана редактирования данных нужно нажать кнопку Close.

Сохранение синхронизированных данных

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

После подтверждения (кнопка OК) появится сообщение с информацией о том, сколько цен было добавлено.

Шаблон для импорта

В данной части статьи описываются шаблоны для плагина Импорт прайс-листов (Price Import).
На данный момент в ПК «Мастер-Interlook» доступны два варианта шаблонов для импорта - одноотельный и многоотельный.

Установка шаблона

Для использования шаблона в плагине «Импорт прайс-листов» необходимо скопировать файлы:
Megatec.Interlook.Template.SingleHotelTemplate.dll для одноотельного шаблона
Megatec.Interlook.Template.MultiHotelTemplate.dll для многоотельного шаблона
в корневой каталог ПК «Мастер-Interlook».

Внимание! Для корректного импорта цен необходимо, чтобы диапазон цен был 
в формате DD/MM/YYYY-DD/MM/YYYY, DD.MM.YYYY-DD/MM/YYYY, DD-MM-YYYY-DD/MM/YYYY

Примеры файлов «MS Excel» с ценами

Для работы с шаблонами в плагине Импорт прайс-листов файлы «MS Excel» сценами должны иметь определенную структуру.

Одноотельный шаблон

Одноотельный шаблон может работать только с одним отелем.

Многоотельный шаблон №1

Многоотельный шаблон №1 может работать как с один отелем, так и с несколькими.

Период дат указывается через пробел!

Модуль Импорт прайс-листов поставляется отдельно.
Шаблон для модуля поставляется совместно с модулем.

Многоотельный шаблон №2

Многоотельный шаблон №2 работает также как с одним отелем, так и с несколькими.
В данном шаблоне отели располагаются на разных листах, но в одном файле.

Модуль Импорт прайс-листов поставляется отдельно.

Шаблон для модуля поставляется совместно с модулем.

В столбце "Имя" указывается название отеля, далее в таблице указывается категория номера и питание.
Ниже определяются периоды проживания в данном отеле, и строкой указываются следующие данные - продолжительность , на которую будет действовать цена(Nights 3-6) и цена за номер.
Ключевые требования к форматированию шаблона:
1. В заголовке в первом столбце не должно быть символа: «/».
2. Символ: «/» обязательно должен быть в тексте категории комнаты и питания.
3. Столбец "Nights" должен содержать числовой формат: текст.
4. В столбцу "Nights" нельзя объединять ячейки с данными.

Обработка Cost offers в данном экране происходит по следующим шагам:
1. Проверяется привязка отеля у выбранного Cost offer.
2. Если отель у выбранного Cost offer отсутствует, то происходит добавление отеля с продолжительностью цены в Cost offer во вкладку Hotel.
3. Если отель привязан, происходит проверка продолжительности, указанная в цене.
4. Если продолжительность совпадает, к цене принимается выбранный Cost offer.
5. Если продолжительность не совпадает, то осуществляется поиск нужной продолжительности в ранее скопированных Cost offers.
6. Если в ранее скопированном Cost offer находится нужная продолжительность, это Cost offer принимается к цене.
7. Если необходимой продолжительности нет в ранее скопированном Cost offer, то копируется новый Cost offer, привязывается отель и задается продолжительность сохраняемой цены.

Дополнительные шаблоны

Для других вариантов файлов «MS Excel» могут быть дополнительно разработаны шаблоны.