Megatec Integration Service:Индивидуальные особенности адаптеров Bnovo

Введение

Адаптер Bnovo является частью комплекса Megatec Integration Service (МИС) и предназначен для получения цен, квот из системы Bnovo, а также для передачи в Bnovo забронированных путевок. Адаптер Bnovo состоит из 3-х частей:

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

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

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

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

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

• Включить отели в список поставщиков – настройка позволяет добавить отели в список поставщиков для синхронизации справочных данных. При этом, реализована возможность множественного сопоставления поставщиков внешней системы с определённым поставщиком в ПК Мастер-Тур.
  
• Запись логов в базу данных – данная настройка позволяет хранить логи в промежуточной базе Bnovo в таблице Logs.
• Учитывать пакет при импорте стопов – настройка влияет на отображение стопов в главном окне Импорт квот. Если данная настройка включена, то данные будут отображаться только по синхронизированным турам (Синхронизация пакетов). Подробнее о настройке в разделе Стопы на тариф.
  
• Разрешить закачку стопов на заезд – для того, чтобы получать стопы на заезд в промежуточную базу необходимо включить данную настройку. Подробнее о настройке в разделе Стопы на заезд.
  
• Релиз-период – настройка, позволяющая задать релиз-период для импортированных квот. Значения обрабатываются и при ручном, и при автоматическом импорте.
  

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

• Синхронизация в момент импорта – если во время импорта присутствуют несопоставленные данные, то перед импортом появится окно Синхронизации.
• Закачка квот/наличия мест по несинхронизированным отелям - Если настройка не выбрана, то загружаться будут только квоты/наличия мест и стопы у которых сопоставлены отели, в случае если выбрана, то загружаются данные по всем отелям.
• Автоматический импорт квот и стопов в Мастер-Тур – раздел выбора автоматизации и персональных настроек импорта квот и стопов для каждого сопоставленного отеля.
  • Автоимпорт – Если данный параметр установлен, то для данного отеля загруженные квоты и стопы импортируются автоматически.
  • «Квота 0 = стоп» – Если данный параметр установлен, то при получении квоты равной 0 – загружается квота 0, а также проставляется стоп (независимо от значения "closed"). Если параметр «квота 0 = стоп» на отеле не установлен, стоп и квоты проставляются так как их передает система. После включения параметра требуется запросить полную перезагрузку квот и стопов. Стоп отображается в экране Показать квоты как стоп без тарифа.
  • Блок мест – данная настройка отображается только для типа импорта "Наличие мест". Для выбранных в данных столбце отелей производится импорт в Мастер-Тур квот, а не наличия мест. При импорте квот в Мастер-Тур будет происходить не суммирование, а перерасчет количества свободных мест. Например, если изначально у отеля в Мастер-Туре было два свободных и девять занятых мест, а от внешней системы пришла квота на одно место, то после импорта в экране наличия мест Мастер-Тура будет отображаться девять занятых и одно свободное место. Если ранее пользователь уже закачал по выбранным отелям наличие мест, то после выбора отелей в столбце Блок мест ему требуется запустить полную перезакачку квот.
    • Настройка работает следующим образом: если во Внутренних настройках, в столбце "Стоп на заезд" установлен чекбокс напротив одной, нескольких, или всех гостиниц, то по отмеченным гостиницам, в Megatec Integration Service будут загружены Стопы на заезд (на все категории номера, или только на одну сопоставленную), для дальнейшего импорта в промежуточную базу Мастер-Тур 9.
    • Если не проставлен чекбокс, ни по одной из гостиниц, то стопы в MIS загружены не будут. Данная настройка доступна только для Мастер-Тур 9.
  • Релиз-период – настройка, позволяющая задать релиз-период импортированных квот для каждого сопоставленного отеля. По умолчанию для всех отелей стоит значение параметра Релиз-период из вкладки Внешние настройки. Значения данной колонки обрабатываются и при ручном, и при автоматическом импорте.
• Настройка почты – предназначена для настройки уведомлений по электронной почте о получении стопов на тариф. Письма отправляются только при включенном аргументе для автоматической закачки ignore_tour_stops (не закачивать стопы на тариф в МТ).
  
  • Email отправителя – корреспондент
    
  • Email получателя – адресат, если несколько, то адреса электронной почты прописываются через запятую
    
  • Пароль для Email – пароль электронной почты корреспондента
    
  • Адрес Smtp-сервера – сетевой протокол для отправки электронной почты
    
  • Порт Smtp-сервера – порт сетевого протокола для отправки электронной почты
    
  • Разрешить SSL-доступ – безопасное соединение
    

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

Данные настройки общие для всех адаптеров (Создание направления. Настройки).

Логирование импорта квот

Настройка логирования производится в файле Web.config веб-сервиса: «Megatec Integration Service»

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

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

Данные настройки общие для всех адаптеров, и описаны в разделе(Создание направления. Настройки).

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

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

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

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

• Записывать в МТ номер подтверждения – если данная настройка включена, то после успешной отправки путевки и запроса статуса путевки возвращается номер брони. Его можно посмотреть в Работе менеджеров в поле Номер путевки партнера. В случае неудачной отправки, в этом поле отобразится сообщение об ошибке.
• Максимальное время обработки путевки в минутах - промежуток времени в минутах, в течение которого осуществляется и отправка путевки и получение статуса в автоматическом режиме. Если процесс отправки или получения статуса занимает более заданного в настройке времени, то в логах записывается сообщение Превышено максимальное время обработки путевки в минутах, статус обмена становится Ошибка. Отчёт времени, указанный в настройке, должен вестись с нуля при следующих условиях:
  • Если услуга проживания была подтверждена внешней системой (статус услуги "Confirm"), но в последующем в неё внесли изменения и статус обмена поменялся на "Требуется отправка";
  • Если услуга проживания не была подтверждена внешней системой (статус услуги "NotConfirm"), но в последующем в неё внесли изменения и статус обмена поменялся на "Требуется отправка";
  • Если при отправке услуги проживания во внешнюю систему был сбой (статус услуги "SendError"), но в последующем в услугу внесли изменения и статус обмена поменялся на "Требуется отправка";
  • Если отправленная услуга проживания была аннулирована, то попытки отправить аннуляцию ограничиваются временем, указанным в настройке;
  • Если услуга проживания была успешно отправлена (аннуляция в том числе), то для получения статуса отчёт времени, указанный в настройке, также начинается с нуля.
• Учитывать релиз период при отправке путевок – настройка учитывается только при отправке путевок в автоматическом режиме. У настройки есть три режима:
  • Не учитывать – не учитывается релиз период (ни для путевок, ни для квот);
  • Учитывать релиз для путевок - учитывается релиз период для путевок, выставленный в настройке Релиз период (по умолчанию выставлено 7 дней). Если от момента отправки путевки до даты начала тура времени меньше, чем указано в настройке, то эта путевка автоматически не отправляется. При повторной автоматической отправке ранее отправленной путевки и отправке аннуляции настройка не учитывается. При отправке путевки в ручном режиме настройка не учитывается;
  • Учитывать релиз для квот - учитывается релиз период для квот, выставленный в Импорт квот на отели во внутренних настройках для отелей. Если от момента отправки путевки до даты начала тура времени меньше, чем указано в настройке, то эта путевка автоматически не отправляется. При повторной автоматической отправке ранее отправленной путевки и отправке аннуляции настройка не учитывается. При отправке путевки в ручном режиме настройка не учитывается;
• Релиз период – задается количество дней релиз периода для путевок (по умолчанию выставлено 7 дней).

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

• В настройке Статус путевки на бронирование для автоматической отправки путевок, есть два варианта отправки:
  
  • Всегда – путевка отправляется проверки о том отправлялась ли путевка ранее.
    
  • Только повторные – путевка отправляется в случае если на данную путевку бронирование подтверждено.
    
• Авт. отправка – в этой колонке необходимо выбрать отели, по которым будут отправляться путевки в Bnovo при автоматической отправке путевок.
  
• Брутто – в этой колонке необходимо выбрать отели, по которым будут отправляться путевки в Bnovo с данными о ценах брутто по услугам проживания (при наличии в скидки будет отправляться сумма скидки и цены брутто). У невыбранных отелей будут отправляться путевки в TravelLine с данными о ценах нетто по услугам проживания. При отправке стоимости за каждую ночь отправляется стоимость брутто за каждую ночь в цене по услуге.
  
• Не отображать путевки с не сопоставленным пакетом. При выборе данной настройки путевки для которых не сопоставлен пакет, данная путевка не будет отображаться. Если настройка не выбрана, у путевки у которой не сопоставления по пакету, в колонке доп. информация будет выводится сообщение 'Нет сопоставления пакета'. В любом случае путевка не будет отправляться.
  

Настройки подключения сервиса к базе данных

Для правильной работы сервиса Bnovo необходимо произвести корректные настройки подключения к базам данных в файле Web.config

№	Название	Описание	Настройка
1	Строка подключения к основной базе данных	Задается строка подключения к основной базе данных приложения. Data Source — указывает на имя сервера базы данных. SERVER_NAME меняется на фактическое имя сервера. Initial Catalog — имя базы данных, к которой подключается приложение. Integrated Security — определяет, будет ли использоваться аутентификация Windows (True) или SQL Server (False). User ID и Password — учетные данные для подключения к базе данных, если не используется аутентификация Windows.	<add key="connectionString" value="Data Source=SERVER_NAME;Initial Catalog=DATABASE_NAME;Integrated Security=False;User ID=USERNAME;Password=PASSWORD" />
2	Строка подключения к промежуточной базе данных Bnovo	Задается строка подключения к промежуточной базе данных Bnovo для интеграции. Data Source — указывает на имя сервера промежуточной базы данных. SERVER_NAME меняется на фактическое имя сервера. Initial Catalog — имя промежуточной базы данных, к которой подключается приложение. Integrated Security — определяет, будет ли использоваться аутентификация Windows (True) или SQL Server (False). User ID и Password — учетные данные для подключения к промежуточной базе данных, если не используется аутентификация Windows.	<add key="bnovoAdapterConnectionString" value="Data Source=SERVER_NAME;Initial Catalog=DATABASE_NAME;User ID=USERNAME;Password=PASSWORD" />

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

Основная информация по синхронизации справочников находится в статье: Работа с окном Синхронизации.
Синхронизация справочников также является общей для всех 3-х его частей (Бронирование, Импорт цен и Импорт квот).
Для стран и городов присутствует множественная синхронизация.
Сопоставление данных происходит по следующим справочникам: Страны, Города, Отели, Партнеры поставщика, Типы размещений, Типы и категории номеров, Типы питаний, Валюты, Транспорт, Статусы услуг.

В адаптере Bnovo "Тип номера" и "Категория номера" объединены в единый справочник "Типы и категории номеров". 
Для объединенной записи из внешней системы "Типы и категории номеров" нужно отдельно сопоставить "Тип номера" и "Категория номера" из справочника Мастер-Тура. 

Настройка Эндпоинтов

Для работы системы с Bnovo необходимо настроить несколько эндпоинтов для эффективного обмена данными с Bnovo

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

• URL: http://localhost/MIS/BnovoService.svc/GetHotelInfo?hotel_id=12345
• Описание: Запрашивает информацию о гостинице по её идентификатору hotel_id. Этот запрос используется для получения данных о номерах и тарифах, доступных в гостинице.

Необходимые данные, такие как категории номеров, варианты размещения и тарифные планы, затем сохраняются в базе данных для дальнейшего использования.

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

• URL: http://localhost/MIS/BnovoService.svc/SaveMappings
• Описание: Этот метод используется для сохранения сопоставлений между категориями номеров, тарифами и вариантами размещения из Bnovo и внутренними данными. Например, категории номеров и тарифы, полученные через API Bnovo, должны быть правильно связаны с внутренними идентификаторами.

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

• URL: http://localhost/MIS/BnovoService.svc/Notify
• Описание: Этот метод используется для получения уведомлений о любых изменениях в Bnovo. Он передает информацию о изменениях в ценах, наличии номеров и других параметрах, связанных с управлением отелем. На основе этих уведомлений запрашиваются обновленные данные через соответствующие API Bnovo.

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

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

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

В открывшемся окне Загрузка из внешней системы доступны три кнопки:

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

После проставления страны и города появится список отелей из Мастер-тура, в котором необходимо прописать UID отеля полученных от Bnovo

После получения квот и стопов за отели их можно просмотреть нажав на кнопку Посмотреть квоты

Для импорта квот и стопов на отели необходимо нажать на кнопку Импортировать, импорт в Мастер-тур происходит в автоматическом режиме.

Стопы на заезд

За обработку стопа на заезд отвечает настройка Разрешить закачку стопов на заезд в МТ. Чтобы стоп на заезд учитывал пакет в Мастер туре требуется включить настройку Учитывать пакет при импорте стопов. В окне Импорт квот на отели необходимо предварительно синхронизировать туры Bnovo с пакетами Мастер -Тур.
Работа настроек зависит от версии ПК Мастер тур.

Обработка стопа на заезд в 15 версии

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

Обработка стопа на заезд в 2009 версии.

При импорте стопов на заезд в туре удаляются даты заезда, соответствующие датам стопов, если сопоставлены все тарифы. Стопы на заезд не создаются в экране Квоты. Если стоп на заезд пришёл по одному из нескольких сопоставленных тарифов не на все типы проживания, то дата продажи в ценах меняется на 01.01.2000. Для удаления стопов на заезд из ПК Мастер-Тур после отключения настройки требуется полностью перезагрузить стопы и квоты в МИС и импортировать новые данные в Мастер-тур.

Стопы на тариф

Стопом на тариф в сервисе Bnovo является стоп на категорию номера, тип питания, продолжительность, дату в отдельно взятом тарифе (туре).
За обработку стопа на тариф отвечает настройка Учитывать пакет при импорте стопов. Если настройка не включена, то любой стоп, полученный от сервиса Bnovo будет закачен в Мастер тур как стандартный стоп.
При включенной настройке программа обрабатывает только синхронизированные тарифы Bnovo с пакетами Мастер -Тур. После удаления синхронизации стоп не будет отображаться в экране Показать квоты.
Можно настроить получение электронных писем с информацией о стопе на тариф при отказе от импорта стопов на тариф в Мастер-Тур. Подробнее о настройке в разделе Настройки адаптера.
Работа настройки Учитывать пакет при импорте стопов зависит от версии ПК Мастер тур.

Обработка стопа на тариф в 15 версии 

Получение стопа на тариф.
В промежуточную базу закачиваются все стопы.
Если включена настройка Учитывать пакет при импорте стопов, при закачке стопа из промежуточной базы в МТ:
Стоп на все сопоставленные тарифы/категорию, Стоп на единственный сопоставленный тариф\категорию – в МТ устанавливается стандартный стоп и удаляются цены в МТ по указанной в стопе категории.
В этом случае в экране Показать квоты будет добавляться стоп без тарифа.

Стоп на не сопоставленный тариф – в МТ не импортируется стоп.
Cтоп на один тариф в МТ, во всех ценовых блоках по сопоставленному пакету удаляются цены при закачке стопа в МТ по указанной в стопе категории
Настройка Учитывать пакет при импорте стопов выключена
Все стопы, включая несинхронизированные тарифы закачиваются из промежуточной базы в МТ как стандартный стоп.

Снятие стопа на тариф.
В МТ установлен стандартный стоп, если с внешней системы приходит отметка на снятие стопа по всем синхронизированным тарифам\категориям или на стоп на категорию – стоп удаляется из МТ.
При получении отмены стопа только по одному синхронизированному тарифу или категории, стоп в Мастер туре будет удален, цены будут удалены из ценовых блоков в пакетах, синхронизированными с тарифами Bnovo, по которым отмена стопа не пришла .
Если были удалены цены в ценовых блоках согласно стопу на тариф\категории, из ТЛ приходит отметка о снятии стопов по всем синхронизированным или единственному тарифу\категории – в МТ закачиваются из ПБД удаленные ранее цены при следующей закачке цен в МТ. Старые цены будут закачаны в те ЦБ, из которых были удалены и в ручном и автоматическом режиме. Новые цены будут закачаны автоматом новый ЦБ, в ручном – в ЦБ указанным при закачке.
Удаленные из ценого блока цены в экране Просмотра цен отмечаются желтым цветом, статус импортированные остается. Новые цены, которые не были закачаны в Мастер-Тур из-за стопа на тариф тоже будут отмечены в экране Просмотр цен желтым цветом. При рассинхронизации/ удалении тарифов, если в промежуточной базе нет стопов по другим тарифам, на каждую конкретную дату, стопы помечаются как отмененные (колонка Отмена стопа = Дав в экране Просмотр квот). После импорта данных стопов в Мастер-Тур, стопы удаляются из базы Мастер-Тур. Отмена стопа и удаление квоты отмечается розовым цветом в колонке Импортировано экрана Просмотр квот. Такие стопы\квоты после удаления в Мастер-туре не отображаются в экране Просмотр стопов и квот

Обработка стопа на тариф в 2009 версии.

При получении стопа на тариф производится проверка наличия стопа на определенную дату по всем синхронизированным к отелю тарифам и категориям.
Если стоп есть только одном (нескольких) из нескольких (или всех) синхронизированных тарифах, то в цене по услуге в Мастер туре будет установлена прошедшая дата продажи 01.01.2000 на даты стопа в пакете, синхронизированным с тарифом Bnovo.
Пример:
Внимание! Необходимо включить настройку направления Перезатирание цен. Период цены = 01.01.2024-01.02.2024, дата стопа на тариф = 25.01.2024, в результате после импорта в Мастер-Тур получается три цены, но с разными периодами: 1). 01.01.2024-01.02.2024 (с датой заезда по = 01.01.2000), 2). 01.01.2024-24.01.2024 3). 26.01.2024-01.02.2024.
Рассчитанные цены будут удалены из таблицы рассчитанных цен, в таблицах для Мастер-веба цены останутся.
При получении отмены стопа на тариф (колонка Отмена стопа = Да в экране Просмотра квот )полученная дата будет удалена из цен. Если за время стопа пришли новые цены, то они будут закачаны при следующей закачке цен в Мастер тур из МИСа.
Если стоп есть во всех синхронизированных тарифах, то в Мастер туре будет установлен стандартный стоп на категорию и изменена дата продажи. При наличии только одного синхронизированного тарифа также будет установлен стандартный стоп на категорию и изменена дата продажи. В этом случае в экране Показать квоты будет добавляться стоп без тарифа. При получении отмены стопа только по одному синхронизированному тарифу, стоп в Мастер туре будет удален и установлена прошедшая дата продажи на даты стопа в пакетах, синхронизированными с тарифами Bnovo, по которым отмена стопа не пришла . Рассчитанные цены будут удалены.
Если был прислан стоп на один тариф из нескольких синхронизиро