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

Материал из Megatec
Перейти к: навигация, поиск
[досмотренная версия][ожидает проверки]
(Синхронизация справочников)
 
(не показаны 3 промежуточные версии этого же участника)
Строка 14: Строка 14:
 
'''Внешние настройки'''
 
'''Внешние настройки'''
 
   
 
   
[[Файл:Pb 065.png|Внешние настройки|600 px]]<br> <br>
+
[[Файл:Ag 372.png|Внешние настройки|600 px]]<br> <br>
  
 
На вкладке '''Внешние настройки''' указываются следующие настройки:
 
На вкладке '''Внешние настройки''' указываются следующие настройки:
Строка 21: Строка 21:
 
** '''Логин''' – имя (идентификатор) учетной записи пользователя во внешней системе (предоставляется внешней системой);
 
** '''Логин''' – имя (идентификатор) учетной записи пользователя во внешней системе (предоставляется внешней системой);
 
** '''Пароль''' – пароль для учетной записи (предоставляется внешней системой).
 
** '''Пароль''' – пароль для учетной записи (предоставляется внешней системой).
 +
* '''Справочники типов и категорий номеров''' – выбор режима работы со справочниками типов и категорий номеров (общий / раздельный). При выборе значения '''раздельный''' в МИС создаются отдельные справочники «Тип номера» и «Категория номера», что позволяет выполнять множественное сопоставление (см. раздел [[#Синхронизация справочников|Синхронизация справочников]]).
 +
* '''Обработка стопов для номера Любой''' – настройка включает особую логику обработки «общих» стопов, приходящих на условный тип номера ''Любая'':
 +
** при получении стопа по комбинации ''Любая / категория номера'' (например, ''Любая / SeaView'') система просматривает загруженные цены и автоматически создаёт стопы по всем конкретным типам номеров, для которых есть цены с указанной категорией номера; сам стоп ''Любая / категория'' также создаётся;
 +
** при получении стопа по комбинации ''Любая / Любая'' создаются стопы по всем комбинациям «тип номера / категория номера», для которых в МИС заведены цены;
 +
** при получении отмены такого стопа (по ''Любая / категория'' или ''Любая / Любая'') из МИС удаляется общий стоп и все автоматически созданные по нему стопы;
 +
** если настройка не активна, стопы загружаются только в том виде, в котором они пришли из внешней системы.
 +
  
 
'''Внутренние настройки'''<br><br>
 
'''Внутренние настройки'''<br><br>
Строка 111: Строка 118:
  
 
[[Файл:Pb 074.png|1000px|Импорт квот - главное окно]] <br> <br>
 
[[Файл:Pb 074.png|1000px|Импорт квот - главное окно]] <br> <br>
 +
===Особенности загрузки квот и стопов===
 +
 +
'''Обработка общих стопов по номеру "Любой"'''<br>
 +
Функциональность зависит от настройки '''Обработка стопов для номера Любой''' во внешних настройках направления.
 +
* При получении от поставщика стопа по комбинации ''Любая / категория номера'' (например, ''Любая / SeaView'') МИС просматривает загруженные цены и автоматически создаёт стопы по всем конкретным типам номеров, для которых есть цены с указанной категорией номера. Стоп по комбинации ''Любая / категория'' также создаётся.
 +
* При получении стопа по комбинации ''Любая / Любая'' создаются стопы по всем комбинациям «тип номера / категория номера», на которые в МИС заведены цены.
 +
* При получении отмены такого стопа (по ''Любая / категория'' или ''Любая / Любая'') удаляются как общий стоп, так и все автоматически созданные по нему стопы.
 +
* Если настройка выключена, стопы импортируются только в том виде, в котором они пришли из внешней системы.
 +
[[Файл:Ag 373.png|1000px|экран квоты после импорта]] <br> <br>
 +
 +
'''Загрузка квот с нулевым количеством мест'''<br>
 +
Квоты с количеством мест '''0''' в адаптере Mescomedia обрабатываются следующим образом:
 +
* при импорте в МИС новые записи квот с количеством мест '''0''' не создаются и в окно импорта квот не попадают – загружаются только квоты с положительным количеством мест;
 +
* если в ПК «Мастер-Тур» ранее уже была заведена квота и от поставщика приходит квота с количеством мест '''0''' по тем же параметрам (отель, тип/категория номера, тип питания, даты и т.п.), такая квота воспринимается как полное исчерпание мест:
 +
** количество свободных мест по квоте уменьшается до 0;
 +
** общее количество мест приравнивается количеству занятых мест.
  
 
==Импорт цен на отели==
 
==Импорт цен на отели==
Строка 151: Строка 174:
 
Для импорта акций сначала необходимо загрузить цены. Для этого нужно нажать на кнопку '''"Загрузка из внешней системы"''' [[Файл:Ud_242.png|Кнопка "Загрузка из внешней системы"]].
 
Для импорта акций сначала необходимо загрузить цены. Для этого нужно нажать на кнопку '''"Загрузка из внешней системы"''' [[Файл:Ud_242.png|Кнопка "Загрузка из внешней системы"]].
 
Акции отображаются в основном экране '''Импорт цен на отели''' как и основные цены, но имеют маркировку красного цвета.<br>
 
Акции отображаются в основном экране '''Импорт цен на отели''' как и основные цены, но имеют маркировку красного цвета.<br>
[[Файл:Ag 170.png|1650px]]
+
[[Файл:Ag 170.png|1650px]]<br>
 
'''Деактивация дублированных акций'''<br>
 
'''Деактивация дублированных акций'''<br>
 
При получении акций с номером, дублирующим ранее загруженные акции, указанные акции помечаются целиком к удалению в MIS. При импорте в ПК Мастер-Тур прежние акции деактивируются, а новая становится активной.<br>
 
При получении акций с номером, дублирующим ранее загруженные акции, указанные акции помечаются целиком к удалению в MIS. При импорте в ПК Мастер-Тур прежние акции деактивируются, а новая становится активной.<br>
 +
 +
'''Применений акций к новым ценовым блокам'''<br>
 +
При загрузке новых контрактных цен, во время импорта цены в Мастер-Тур МИС проверяет наличие активных акций по выбранным\выбранной гостинице и прикрепляет новые контрактные цены ко всем активным акциям. Если по гостинице нет акций, то новые контрактные цены просто импортируется в Мастер-Тур.<br>
 +
При прикреплении цен к акциям учитывается поставщик. Работает как для ручного, так и для автоматического импорта.
 +
 +
===Импорт комбинированных акций по номерам===
 +
Начиная с версии 9.2.22.41058 в рамках импорта акций из внешней системы реализована поддержка автоматического заполнения поля '''«По названию / номеру акции»''' на вкладке '''Условия акции''', в секции '''«Акцию можно использовать одновременно с другими акциями»''', в окне редактирования акции в [[Мастер-Тур(15):Программа туров. Акции#Логика расчета комбинированных акций|Мастер-Тур]].<br />
 +
[[Файл:Am 063.png]] автоматическое заполнения поля '''«По названию / номеру акции»''' работает только с новыми акциями. Все акции загруженные до обновления на версию 9.2.22.41058 не будут скомбинированы в данном поле.
 +
 +
[[Файл:Ag 325.png|1000px]] <br />
 +
 +
 +
Если в описании акции в столбце Группа содержится текст «Комбинируется с…» или «Combinable with…», система автоматически извлекает все указанные номера акций и добавляет их в поле '''«По названию / номеру акции»'''.
 +
 +
Пример:
 +
Название акции: RecId: 323387. Long Stay. Комбинируется с: 342242,343325,343324 (+4)
 +
В Мастер-Тур:
 +
Название будет: RecId: 323387. Long Stay. Комбинируется с 342242,343325,343324
 +
Поле «По названию / номеру акции»: RecId: 342242, RecId: 343325, RecId: 343324
 +
 +
Особенности логики:
 +
*При выборе скрещивания '''«По названию / номеру акции»''', поле '''«по типу акции»''' становится недоступным.
 +
*В списке для выбора отображаются только те акции, которые содержат подходящие отели из вкладки «Варианты размещения».
 +
*Применение нескольких акций происходит по дате создания от самой ранней.
  
 
==Бронирование путевок==
 
==Бронирование путевок==

Текущая версия на 18:20, 2 декабря 2025

Статья находится в стадии разработки.

Введение

Адаптер Mescomedia состоит из 3-х частей:

  • Бронирование путевок
  • Импорт квот на отели
  • Импорт цен на отели

Настройки адаптера

Основная информация по настройкам адаптеров находится в отдельной статье: Создание направления. Настройки. В данном разделе описаны только индивидуальные настройки Mescomedia.

Импорт квот на отели

Внешние настройки

Внешние настройки

На вкладке Внешние настройки указываются следующие настройки:

  • Параметры подключения к веб-сервису:
    • Адрес веб-сервиса – ссылка на веб-сервис внешней системы для загрузки справочников, цен;
    • Логин – имя (идентификатор) учетной записи пользователя во внешней системе (предоставляется внешней системой);
    • Пароль – пароль для учетной записи (предоставляется внешней системой).
  • Справочники типов и категорий номеров – выбор режима работы со справочниками типов и категорий номеров (общий / раздельный). При выборе значения раздельный в МИС создаются отдельные справочники «Тип номера» и «Категория номера», что позволяет выполнять множественное сопоставление (см. раздел Синхронизация справочников).
  • Обработка стопов для номера Любой – настройка включает особую логику обработки «общих» стопов, приходящих на условный тип номера Любая:
    • при получении стопа по комбинации Любая / категория номера (например, Любая / SeaView) система просматривает загруженные цены и автоматически создаёт стопы по всем конкретным типам номеров, для которых есть цены с указанной категорией номера; сам стоп Любая / категория также создаётся;
    • при получении стопа по комбинации Любая / Любая создаются стопы по всем комбинациям «тип номера / категория номера», для которых в МИС заведены цены;
    • при получении отмены такого стопа (по Любая / категория или Любая / Любая) из МИС удаляется общий стоп и все автоматически созданные по нему стопы;
    • если настройка не активна, стопы загружаются только в том виде, в котором они пришли из внешней системы.


Внутренние настройки

Внутренние настройки

  • Синхронизация в момент импорта – если во время импорта присутствуют несопоставленные данные, то перед импортом появится окно Синхронизации.
  • Стоп = 0 мест – настройка предназначена для обозначения отелей в которые будет загружаться доступное количество мест равное нулю. По умолчанию чек-боксы выключены, При включении чек-бокса выполняется следующий функционал:

– Для выбранного отеля в ПК "Мастер-тур" наличие мест не импортируется;
– На выбранные даты в ПК "Мастер-тур" импортируется ноль мест. Если в ПК "Мастер-тур" есть квота, а не наличие мест, то квота уменьшается до кол-ва занятых мест.
– В экране импорта квот после импорта нулевых мест в ПК "Мастер-тур" остановка продаж и квота отмечается как импортированная.
– При получении отмены остановки продаж нулевое значение остаётся в ПК "Мастер-тур".

  • Выбор статуса услуги – настройка позволяет загружать квоты с предустановленным статусом услуги.

Импорт цен на отели

Внешние настройки

Внешние настройки

На вкладке Внешние настройки указываются следующие настройки:

  • Параметры подключения к веб-сервису:
    • Адрес веб-сервиса – ссылка на веб-сервис внешней системы для загрузки справочников, цен;
    • Логин – имя (идентификатор) учетной записи пользователя во внешней системе (предоставляется внешней системой);
    • Пароль – пароль для учетной записи (предоставляется внешней системой)
  • Признаки цены
    • Комиссионная цена – признак комиссионной цены для Мастер-Тур;
    • Групповая цена – признак групповой цены для Мастер-Тур.

Внутренние настройки

Внутренние настройки

На вкладке Внутренние настройки доступны настройки:

  • Сезон по умолчанию
  • Выбор пакетов по умолчанию – настройка применяется при автоматической закачке цен в ПК Мастер-Тур. Для успешной закачки необходимо для каждой страны настроить ценовой пакет, в который будет импортироваться цены.
  • Синхронизация в момент импорта – при активации настройки: если сопоставлены не все данные, то, в момент импорта откроется окно синхронизации. Если настройка не активирована импорт цен будет произведен без открытия окна синхронизации.
  • Перезатирание цен в пакете – при активации данной настройки при повторном импорте старые цены будут удалены.
  • Закачка цен по несинхронизированным отелям в МИС – если настройка не выбрана, то загружаться будут только цены у которых сопоставлены отели, в случае если выбрана, то загружаются данные по всем отелям.
  • Импортировать цены, ранее загруженные из ВС – по умолчанию признак активности выключен.
  • Действие при создании ценового блока
    • Активировать после сохранения – настройка активирует ценовые блоки после сохранения в ПК Мастер-Тур 15.
    • Активировать для цен нетто после сохранения – настройка активирует ценовые блоки после сохранения только для цен нетто в ПК Мастер-Тур 15.

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

Внешние настройки

Внешние настройки

На вкладке Внешние настройки указываются следующие настройки:

  • Параметры подключения к веб-сервису:
    • Адрес веб-сервиса – ссылка на веб-сервис внешней системы для загрузки справочников, цен;
    • Логин – имя (идентификатор) учетной записи пользователя во внешней системе (предоставляется внешней системой);
    • Пароль – пароль для учетной записи (предоставляется внешней системой).

Внутренние настройки

Внутренние настройки

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

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

Синхронизация
На вкладке Синхронизация осуществляется выбор справочников для сопоставления данных.

Синхронизация справочников

Основная информация по синхронизации справочников находится в статье: Работа с окном Синхронизации.
Перед тем, как приступить к синхронизации справочников, их необходимо загрузить (на основном экране кнопка Загрузка из внешней системы Кнопка "Загрузка из внешней системы").
Mb 031.png
Для следующих справочников разрешено множественное сопоставление несколько значений из ВС к одному в МТ:

  • Города
  • Тип номера – множественное сопоставление доступно, если во внешних настройках направление выбран тип справочников "Раздельный"
  • Тип размещения – типы размещений отображаются в справочнике после загрузки цен.
  • Категории номеров – возможно множественное сопоставление нескольких значений из ВС к одному в МТ при включении настройки Mescomedia. Множественное сопоставление категории номеров в Модуле администрирования AdminMS. По умолчанию в значении disable.

Внимание! При использовании множественного сопоставления категорий номеров отправка путёвок во Внешнюю систему будет работать некорректно.
Синхронизация справочников

Импорт квот на отели

Основная информация по импорту квот на отели находится в отдельной статье: Работа с окном «Импорт квот на отели».

Для загрузки квот и стопов сначала необходимо загрузить справочники. Для этого нужно нажать на кнопку "Загрузка из внешней системы" Кнопка "Загрузка квот из внешней системы". Откроется следующее окно:
Загрузка квот из внешней системы

  • Загрузить справочники – для загрузки/обновления информации по справочникам, по которым доступно обновление квот и стопов.
  • Загрузить цены и квоты – для полной загрузки цен и квот на отели. Использовать при первичной загрузке квот и стопов.
  • Загрузить изменения по ценам и квотам – для загрузки изменений по ценам и квотам.
  • Отель – позволяет выбрать отель для загрузки цен, квот и стопов и изменений по ним.

Импорт квот - главное окно

Особенности загрузки квот и стопов

Обработка общих стопов по номеру "Любой"
Функциональность зависит от настройки Обработка стопов для номера Любой во внешних настройках направления.

  • При получении от поставщика стопа по комбинации Любая / категория номера (например, Любая / SeaView) МИС просматривает загруженные цены и автоматически создаёт стопы по всем конкретным типам номеров, для которых есть цены с указанной категорией номера. Стоп по комбинации Любая / категория также создаётся.
  • При получении стопа по комбинации Любая / Любая создаются стопы по всем комбинациям «тип номера / категория номера», на которые в МИС заведены цены.
  • При получении отмены такого стопа (по Любая / категория или Любая / Любая) удаляются как общий стоп, так и все автоматически созданные по нему стопы.
  • Если настройка выключена, стопы импортируются только в том виде, в котором они пришли из внешней системы.

экран квоты после импорта

Загрузка квот с нулевым количеством мест
Квоты с количеством мест 0 в адаптере Mescomedia обрабатываются следующим образом:

  • при импорте в МИС новые записи квот с количеством мест 0 не создаются и в окно импорта квот не попадают – загружаются только квоты с положительным количеством мест;
  • если в ПК «Мастер-Тур» ранее уже была заведена квота и от поставщика приходит квота с количеством мест 0 по тем же параметрам (отель, тип/категория номера, тип питания, даты и т.п.), такая квота воспринимается как полное исчерпание мест:
    • количество свободных мест по квоте уменьшается до 0;
    • общее количество мест приравнивается количеству занятых мест.

Импорт цен на отели

Основная информация по импорту цен на отели находится в отдельной статье: Работа с окном «Импорт цен на отели».
Для импорта цен сначала необходимо загрузить цены. Для этого нужно нажать кнопку Загрузка из внешней системы Кнопка "Загрузка из внешней системы". Откроется следующее окно:
Загрузка квот из внешней системы

  • Загрузить справочники – для загрузки/обновления информации по справочникам, по которым доступны новые цены.
  • Загрузить цены и квоты – для полной загрузки цен и квот на отели. Использовать при первичной загрузке цен на отели.
  • Загрузить изменения по ценам и квотам – для загрузки изменений по ценам и квотам.
  • Отель – позволяет выбрать отель для загрузки цен, квот и стопов и изменений по ним.

цены от Mescomedia закачиваются типа:

  • DAY – Проживание/оплата;
  • DIS – Скидка на контрактные цены;
  • EB – Скидка за раннее бронирование;
  • SPO – Специальная акция, которая имеет свои цены.

В промежуточную базу загружаются основные цены и цены СПО. В колонке группа отображается название СПО. Пример : СПО. EBO45 DISK 15%. Record date: 01.05.2023 18:16. Update date: 01.05.2023 18:16. Id: 41079, где: СПО – тип цены;
EBO45 DISK 15%. – название СПО;
Record date: 01.05.2023 18:16. Update date: 01.05.2023 18:16 - дата создания \обновления цены;
Id: 41079 id СПО\контракта.
Импорт квот - главное окно

После импорта цен статус импорта должен стать Загружено и Импортировано.
Ag 169.png

Обработка доплат за высокий период
Цены с доплатами за высокий период приходят от поставщика в ценовых блоках Extra. Доплаты могут быть за ночь или период и действуют на все категории контрактных цен и СПО.
Примеры:
1. На отель SEA BREEZE JOMTIEN RESORT действует доплата 14,58 USD за ночь на период с 27.12.24 по 07.01.25. От поставщика пришла контрактная цена 59,48 USD на размещение 1 взрослого, с доплатой 14,58 USD в ценовом блоке Extra цена за ночь будет 74,06 USD.
2. На отель SEA BREEZE JOMTIEN RESORT действует доплата 5,83 USD за ночь на период с 13.04.25 по 15.04.25. От поставщика пришла цена СПО 44,61 USD на размещение 1 взрослого, с доплатой 5,83 USD в ценовом блоке Extra цена за ночь будет 50,44 USD.
Удаление неактуальных цен
Неактуальные контракты\СПО Внешняя система отмечает текущей или прошедшей SaleDateEnd, значение id остаётся прежним. При получении такой даты цены, по указанному id, отмечаются к удалению в MIS с учётом возраста детских размещений, типами и категориями номеров, гостиницами. поставщиками. Акции отмечаются к удалению целиком. При следующем импорте в ПК Мастер-Тур эти цены удаляются, акция деактивируется. В колонке Удаленные отображается количество удаленных цен.
В 15 версии цены удаляются из ЦБ, ЦБ не деактивируется.

Импорт акций

Основная информация по импорту акций на отели находится в отдельной статье: Импорт акций.
Для импорта акций сначала необходимо загрузить цены. Для этого нужно нажать на кнопку "Загрузка из внешней системы" Кнопка "Загрузка из внешней системы". Акции отображаются в основном экране Импорт цен на отели как и основные цены, но имеют маркировку красного цвета.
Ag 170.png
Деактивация дублированных акций
При получении акций с номером, дублирующим ранее загруженные акции, указанные акции помечаются целиком к удалению в MIS. При импорте в ПК Мастер-Тур прежние акции деактивируются, а новая становится активной.

Применений акций к новым ценовым блокам
При загрузке новых контрактных цен, во время импорта цены в Мастер-Тур МИС проверяет наличие активных акций по выбранным\выбранной гостинице и прикрепляет новые контрактные цены ко всем активным акциям. Если по гостинице нет акций, то новые контрактные цены просто импортируется в Мастер-Тур.
При прикреплении цен к акциям учитывается поставщик. Работает как для ручного, так и для автоматического импорта.

Импорт комбинированных акций по номерам

Начиная с версии 9.2.22.41058 в рамках импорта акций из внешней системы реализована поддержка автоматического заполнения поля «По названию / номеру акции» на вкладке Условия акции, в секции «Акцию можно использовать одновременно с другими акциями», в окне редактирования акции в Мастер-Тур.
Am 063.png автоматическое заполнения поля «По названию / номеру акции» работает только с новыми акциями. Все акции загруженные до обновления на версию 9.2.22.41058 не будут скомбинированы в данном поле.

Ag 325.png


Если в описании акции в столбце Группа содержится текст «Комбинируется с…» или «Combinable with…», система автоматически извлекает все указанные номера акций и добавляет их в поле «По названию / номеру акции».

Пример: Название акции: RecId: 323387. Long Stay. Комбинируется с: 342242,343325,343324 (+4) В Мастер-Тур: Название будет: RecId: 323387. Long Stay. Комбинируется с 342242,343325,343324 Поле «По названию / номеру акции»: RecId: 342242, RecId: 343325, RecId: 343324

Особенности логики:

  • При выборе скрещивания «По названию / номеру акции», поле «по типу акции» становится недоступным.
  • В списке для выбора отображаются только те акции, которые содержат подходящие отели из вкладки «Варианты размещения».
  • Применение нескольких акций происходит по дате создания от самой ранней.

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

Основная информация по бронированию путёвок на отели находится в отдельной статье:Работа с окном в адаптере «Бронирование путевок».

Отправка путевок - главное окно
После заведения путевки в Мастер-Туре и синхронизации партнеров поставщика данной путевки она появляется в данном окне.

  • Номер путевки из Мастер-Тура.
  • Последний обмен – время последней отправки путевки.
  • Статус обмена:
    • Не обработана – путевка ни разу не отправлялась во внешнюю систему.
    • Требуется отправка – данный статус путевка принимает только в том случае, если после успешной отправки путевки были изменения в ПК "Мастер-Тур", которые необходимо повторно отправить.
    • Отправлена – путевка успешно отправлена во внешнюю систему.
    • Ошибка – при попытке отправки путевки произошел сбой или есть несинхронизированные данные.
    • Не отправлять – если путевка содержит статус, который не участвует в обмене, то ей присваивается статус 'Не отправлять'.
  • Статусы услуг – статусы услуг сопоставляются в окне синхронизации, после отправления заявки статус обновляется в зависимости от ответа. В экране Турпутевка «Мастер-Тур» для услуг, по которым пришел статус, будет изменен статус в соответствии с сопоставлениями, сделанными в справочнике Статусы услуг пользователем. Виды статусов:
    • Waiting – внешняя система не определилась с ответом.
    • Confirmed – услуга подтверждена.
    • NotConfirmed – услуга не подтверждена.
    • No answer – получение статуса ещё ни разу не производилось.
  • Статус путевки (МТ) – статус путевки в Мастер-Туре.
  • Нетто планируемое – цена из поля "Нетто планируемое" в Мастер-туре.
  • Нетто от партнера – цена, пришедшая от внешней системы.
  • Стоимость из МТ
  • Стоимость из ЛК
  • Филиал
  • Дата заезда – дата заезда в отель.
  • Покупатель
  • Туристов – количество туристов.
  • Дата создания
  • Отель - название отеля.
  • Доп. информация - номер путёвки партнера.

Контекстное меню путевки
В контекстном меню путевки возможны следующие действия:

  • Открыть путевку в Мастер-Туре
  • Отправить путевку
  • Проверить статус
  • Скопировать номер путевки в буфер обмена
Для Mescomedia нет отправки изменений по путевке и возможности аннулирования.